MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 7 393
Command Definitions (HP32208-HPLOACNMPROC)
HPFOPEN
parameter in a FILE command can override this option, unless file
equations are disallowed with
itemnum =9.
The following values are valid:
0 No change. The disposition remains as it was before the
file was opened. If the file is new, it is deleted by FCLOSE;
otherwise, the file is assigned to the domain it belonged to
previously. An unlabeled tape file is rewound. If the file
resides on a labeled tape, the tape is rewound and
unloaded.
1 Permanent file. If the file is a disk file, it is saved in the
system file domain. A new or temporary file on disk has an
entry created for it in the system (permanent) file
directory. If a file of the same name already exists in the
directory, an error code is returned at close time and the
file remains open. If the file is a permanent file on disk,
this domain disposition has no effect. If the file is stored on
magnetic tape, the tape is rewound and unloaded.
2 Temporary job file (rewound). The file is retained in your
temporary (job/session) file domain and can be requested
by any process within your job/session. If the file is a disk
file, the uniqueness of the file name is checked. If a file of
the same name already exists in the temporary file
domain, an error code is returned at close time and the file
remains open. When a file resides on unlabeled magnetic
tape, the tape is rewound. However, if the file resides on
labeled magnetic tape, the tape is backspaced to the
beginning of the presently opened file.
3 Temporary job file (not rewound). This value has the same
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.