|Command||ue.01ad User Exit/PROC
Applicable release versions: AP, OA/RT, R83 2.2
|Description||retrieves a value from an attribute of an item in a file.
The next line of the PROC specifies the file information.
"file.name" is the name of the file. If file.name is prefixed with an asterisk (*), the DICT portion of the file will be accessed.
"item.name" is the item name.
"attribute.ref" is the attribute name (or number)
a = Outputs to alternative output buffer.
p = Outputs to Primary input buffer.
s = Outputs to current output buffer.
t = Outputs to terminal.
v = Verifies that the file exists
va= Verifies that the attribute exists.
This function allows "indirect" references to values from the input and output buffers by using the following special symbols:
"%" indicates the current input buffer value.
"#" indicates the current output buffer value.
file.name item-id attribute.ref code.number
Example of direct reference: pq u01ad control-file co.name 1 s xcan't find co.name or control-file Reads attribute 1 of the item called "co.name" in the file called "control-file" and places it in the current output buffer. Example of indirect reference: pq u01ad %2 %3 %4 p xsomething went wrong... d0 Reads the attribute number as defined in the fourth location of the input buffer, using the item-id from the third location and the filename from the second location.