Accessing Files Programmer's Guide (32650-90885)

Chapter 2 37
Creating A File
The HPFOPEN Intrinsic
dependent upon both the record size and the number of extents defined
for the file:
— For circular and RIO files,
recsize =256 bytes and numextent =32.
This option is applicable only at file creation.
Default: 2 gigabytes
This
itemnum may not be specified when creating hierarchical directories.
(ASC) Not used for asynchronous devices.
36/I32 Initial allocation:
Passes a positive integer value indicating the number of records to be
allocated to the file initially. This option is applicable only at file creation.
Default: 0
This
itemnum may not be specified when creating hierarchical directories.
(ASC) Not used for asynchronous devices.
37/I32 File code:
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..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..32,767. Programs running in privileged mode can access
files with a file code in the range -32,768..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).
File codes cannot be specified for hierarchical directories. Negative file
codes may be used only for files in MPE groups. A
status.info of -315 is
returned when negative file codes are specified for files outside MPE
groups.
Default: 0
(ASC) Not used for asynchronous devices.
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: