ue.01ad

User Exit/PROC, Releases: AP, OA/RT, and R83 2.2

Retrieves a value from an attribute of an item.

Syntax

u01ad file.name item-id attribute.ref code.number

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.

Example

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.

See Also

Command Name Type Description
proc.user.exits Command List of PROC user exits.
ue.21ad User Exit Retrieves all values of an attribute.
ue.11ad User Exit Retrieves all multi-values of an attribute.
pc.a Processing Code Defines algebraic processing expression.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.