| u01a6 | Index Level | u01b8 |
| Syntax |
u01ad
file.name item-id attribute.ref code.number |
| Category | PROC |
| Type | User Exit |
| 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. |
| Options | |
| See Also | user exits, PROC u21ad u11ad a (algebraic) |
| 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. |
| Warnings |
NOTE: The same function can be performed with the following correlative:
a0(t<file.reference>;x<n>;;<a/amc>) Where: <file.reference> is the name of the file <n> is the Nth value to retrieve <a/amc> is the attribute number (attribute-mark count) to use. |
| Compatibility | D3 7.0 AP OA/RT R83 2.2 |
| u01a6 | Index Level | u01b8 |