XFILE
9.0D
The XFILE instructions define files that are used for XML file I/O. The instruction uses one of the following formats:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Where:
label
Optional. A Program Execution Label.
%
Optional. Denotes the item as being GLOBAL.
*
Optional. Denotes the item as being COMMON.
arraysize
Optional. An Integer decimal constant, CONST variable or equated value indicating the number of array items.
parm
Optional. One of the valid parameters listed below.
^
Optional. Denotes the item as being a POINTER.
target
Optional. A previously declared XFILE variable that initializes the array.
???
Optional. The initialization for the array based on the order given.
%%
Optional. Denotes the item as GLOBAL but does not initialize it in any way.
Flags Affected: NONE
Note the following:
An XFILE must have been defined with an XFILE Definition instruction before being referenced in a I/O instruction.
If the operand field begins with an asterisk (*), the file is a Common Data Item. An attempt is made to maintain the OPEN status (with existing file pointers intact) of a corresponding file declaration in the program that initiated the chain. However, if the UDA of the chained to program is not in alignment (same File Definition types, sizes, and locations) with those in the program that initiated the CHAIN, a CHAIN error occurs.
The ^ denotes a Pointer Variable.
If the % form is used, the data item is placed in the Global Data Area. The variable would be available to other programs that also declared it with the percent form. Global Data Items are available with PLBCMP only.
If the %% form is used, the data label is placed in the Global Data Area but no initialization takes place if it has not already been defined in the Global Data Area. Global Data Items are available with PLBCMP only.
Array definition and referencing is handled in the same manner as DIM variables.
See Also: File Definitions
|
|