MPE/iX Intrinsics Reference Manual (32650-90875)

394 Chapter7
Command Definitions (HP32208-HPLOACNMPROC)
HPFOPEN
51/String Pascal XL string:
Passes a formal file designator that follows MPE/iX file naming
conventions, using the Pascal XL STRING type format. This option is
identical to
itemnum =2 except for the type of item. No delimiters are
needed.
Default: No string passed
When you use HPFOPEN to open a file, you may use either
itemnum =2 or you
may use
itemnum =51; you may not use both.
As the default, the formal file designator is interpreted according to
MPE-escaped semantics. To choose another syntax, use
itemnum 41.
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 of create directory entry (CD) access,
status . info will return a value of -179.
52 File equation string:
Passes a character string that matches the file equation specification
syntax exactly. (Refer to the FILE command in the MPE/iX Commands
Reference Manual.) This option allows the specification of options available
in the FILE command.
The
formaldesig parameter and filereference parameter can contain
embedded command interpreter variables and expressions. However, there
cannot be more than 8-characters in each of these components (
filename,
lockword, groupname, accountname
) including the command
interpreter variable and expression characters.
Default: No string passed
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:
%fileequation% (% is the delimiter, fileequation is the
designator)
fabcxyzf ( f is the delimiter, abcxyz is the designator)
The
formaldesignator in the file equation string must belong to the MPE