MPE/iX Intrinsics Reference Manual (32650-90905)

372 Chapter7
Command Definitions (HP32208-HPLOACNMPROC)
HPFOPEN
NOTE An itemnum takes precedence over any previously specified duplicate
itemnum . Any duplicated itemnum is flagged as a warning.
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 that is interpreted according to
MPE-escaped semantics (unless another syntax has been chosen via item
41). The first charater is interpreted as a delimiter, and all subsequent
characters, up to the next occurrence of the delimiter, comprise the formal
designator. The file name must be terminated by a nonalphanumeric
character other than a period (.), a slash (/), a hyphen (-), and an
underscore (_). Use of matched starting and ending name delimiters (a
quoted name) alleviates the need for a terminating character other than
the quote characters.
The file referred to by
formaldesig can be either an MPE file (i.e., one
that uses MPE syntax) or it can follow HFS syntax. If
formaldesig follows
MPE syntax, the file name can include password, group, and account
specifications. The file name can backreference a file equation and
optionally be preceded by an asterisk. If
formaldesig follows HFS syntax,
the file name must start with either a dot (.) or a slash (/).
The file referred to by
formaldesig may reside either in an MPE group or
in an HFS directory. For files located in HFS directories, traverse directory
entries (TD) access is required to all directories specified in
formaldesig .
If there is no TD access, HPFOPEN fails and a value of -180 is returned in
the
status.info parameter. If you are using HPFOPEN to create a file or
hierarchical directory and you lack create directory entry (CD) access,
status . info will return a value of -179.
If
formaldesig is an escaped pathname:
• you cannot reference remote files
• it cannot express a name equivalent to
filename : envid
• you cannot use the device parameter ( device = node #) to specify the
remote location of a device
If
formaldesig is the name of a user-defined file, it can begin with an
asterisk (*). If
formaldesig is the name of a system-defined file, it can
begin with a dollar sign ($). When creating a KSAM file,
formaldesig
must be a unique file name, that is, one not currently existing in the
permanent file directory.
The formal file designator can contain command interpreter variables and