Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Tools : $GETATTRIBUTE

$GETATTRIBUTE
Queries the current attributes for the field of the screen table, in the specified screen. (F)
Invocation
flag = $GETATTRIBUTE(screen, table, field, attribute)
 
A character string specifying the screen. Its syntax is C (fixed-length character string) with length 16.
D – The field is light-pen-detectable. The data-mapped graphical object is detectable by cursor (allow focus).
Usage Notes
Not all display devices can support the extended attributes. The extended attributes are supported only on some 3270 terminals on a z/OS system.
Valid values must be supplied for all the arguments or an error occurs.
$GETATTRIBUTE operates only on a screen table that has real occurrences, and has the current position set by a table access. If the current position is not set in the screen table, $GETATTRIBUTE returns an empty string.
Example
The following rule queries the highlighting attribute of the FCNKEYS field of the example screen, displays the screen, and reports the value of the highlighting attribute:

 
GETATTRIBUTE_1;
_ LOCAL HIGH;
_ ------------------------------------------------------------------------
_ ------------------------------------------------------------+-----------
_ FCNKEY_SPECS.FCNKEYS = FCNKEY_MSG('NEW_EMPLOYEE'); | 1
_ INSERT FCNKEY_SPECS('NEW_EMPLOYEE'); | 2
_ HIGH = $GETATTRIBUTE('NEW_EMPLOYEE', 'FCNKEY_SPECS', | 3
_ 'FCNKEYS', 'H'); |
_ DISPLAY NEW_EMPLOYEE: | 4
_ CALL ENDMSG('HIGHLIGHTING': || HIGH); | 5
_ ------------------------------------------------------------------------

 

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved