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

170 Chapter9
KSAM Intrinsics
HPFOPEN
50 Cont I32 Final disposition:
2 Temporary job file (rewound). The file is retained in
your temporary (job or session) file domain and can be
requested by any process within your job or session. If
the file is a disk file, the uniqueness of the file name is
checked. Should a file of the same name already exist
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,
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.
51 Pascal XL string:
Passes a formal file designator, following MPE/iX file naming
conventions, but using the Pascal/iX STRING type format. This option is
identical to itemnum =2 except for the type of item. No delimiters are
needed.
Default: No string passed
Only one of the following options can be in effect when a file is opened:
itemnum =2
itemnum =51
Table 9-7. HPFOPEN Itemnum/Item Values
Itemnum Mnemonic Item Description