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

Chapter 9 167
KSAM Intrinsics
HPFOPEN
36 I32 Initial allocation:
Passes a positive integer value indicating the number of extents to be
allocated to the file initially. This option is applicable only at file
creation.
Default: 0
37 I32 Filecode:
Passes a value that can be used as a file code to identify the type of file.
This code is recorded in the file label and is accessible through the
FFILEINFO intrinsic. This option is applicable only at file creation (except
when opening an old file that has a negative file code).
If the program is running in user mode, specify a file code in the range 0
to 32,767 to indicate the file type being created. Programs running in
user mode can access files with positive file codes only.
If the program is running in privileged mode, specify a file code in the
range -32,768 to 32,767. Programs running in privileged mode can access
files with a file code in the range -32,768 to 32,767. If an old file is opened
that has a negative file code in its file label, the file code specified must
match the file code in the file label (otherwise, an error results).
Default: 0
38 I32 File privilege:
Passes a value that determines a permanent privilege level to be
associated with a newly created file. This option permanently restricts
file access to a process whose execution level is less than or equal to the
specified value. A value cannot be specified for less than the execution
level of the calling process. This option is applicable only at file creation.
The following values are valid:
0 Privilege level zero (most privileged level)
1 Privilege level one
2 Privilege level two
3 Privilege level three (least privileged level)
Default: 3
A file created with levels 0, 1, or 2 can be opened only with the HPFOPEN
intrinsic; the FOPEN intrinsic cannot be used.
41 Reserved for MPE/iX.
Table 9-7. HPFOPEN Itemnum/Item Values
Itemnum Mnemonic Item Description