ue.01ad User Exit/PROC


Command ue.01ad User Exit/PROC
Applicable release versions: AP, OA/RT, R83 2.2
Category PROC (92)
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)

"code.number" is:

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.
Syntax u01ad
file.name item-id attribute.ref code.number
Example of direct reference: 
  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: 

  u01ad %2 %3 %4 p
  xsomething went wrong...
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.
Related proc.user.exits