Accessing Files Programmer's Guide (32650-90885)

Chapter 2 43
Creating A File
The HPFOPEN Intrinsic
effect as specifying final disposition option itemnum =2,
except that tape files are not rewound. In the case of
unlabeled magnetic tape, if the FCLOSE is the last done on
the device (with no other FOPEN/HPFOPEN calls
outstanding), the tape is rewound and unloaded. If the file
resides on a labeled magnetic tape, the tape is positioned
to the beginning of the next file on the tape.
4 Released file. The file is deleted from the system.
5 Convert a permanent file to a temporary file. The file is
removed from the permanent file directory and placed in
the temporary file directory. (Privileged mode capability is
required to use this option.)
Default: 0
For more information on file disposition at close time, refer to the
description of the FCLOSE intrinsic.
(ASC) Not used for asynchronous devices.
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