Using KSAM/XL and KSAM 64 (32650-90886)

154 Chapter9
KSAM Intrinsics
HPFOPEN
NOTE An itemnum takes precedence over any previously specified duplicate
itemnum . Any duplicated itemnum is flagged as a warning.
Table 9-7. HPFOPEN Itemnum/Item Values
Itemnum Mnemonic Item Description
0 End of option list: There is no corresponding item . The absence of an
itemnum after the last itemnum,item pair is equivalent to specifying
this option.
2 CA Formal designator:
Passes a formal file designator, following MPE/iX file naming
conventions. The file name must begin with an alphabetic character and
contain alphanumeric characters, slashes, or periods. If the file name is
the name of a user-defined file, it can begin with an asterisk (*). If the
file name is the name of a system-defined file, it can begin with a dollar
sign ($). Specify the remote location of a device as filename:envid . The
file, lockword, group, and account names are each limited to eight
characters in length. The formal file designator may contain command
interpreter variables and expressions that are evaluated by HPFOPEN
before the formal file designator is parsed and validated.
A character placed in the first element designates the delimiter used by
HPFOPEN to search for the end of the character array. The delimiter can
appear again only following the last valid character of the character
array, for example:
%devname% (% is the delimiter, devname is the designator)
fabcxyzf ( f is the delimiter, abcxyz is the designator)
For a KSAM file, the device must be a random access device such as a
disk.
The following are examples of valid MPE/iX formal file designators:
&file/lock.group.account:node.dest.level&
&filename&
&!myfile&
&!afile/![FINFO("!afile",33)]&
The following are examples of invalid formal file designators:
"filename.group (missing delimiter (”))
file.group" ( ’f’ is used as delimiter, missing at end)