Accessing Files Programmer's Guide (32650-90885)

Chapter 2 45
Creating A File
The HPFOPEN Intrinsic
(ASC) Not used for asynchronous devices.
55
Reserved for the operating system
56/I32 Object class:
Passes a user object class number, in the range 0..10, that is associated
with the file.
Default: Determined by the file code for system and subsystem files, and
by the file type and record type for normal user files.
57
Reserved for the operating system
58 Reserved for the operating system
59 Reserved for the operating system
60 Reserved for the operating system
61 Reserved for the operating system
64/BA Access Control Definition:
Passes a byte array defining the access control definition (ACD) to be
attached to a new file. The byte array has a length of 1 to 279 bytes. Unlike
other HPFOPEN options that expect a delimiter at both the beginning and
the end of the byte array, this option only expects a trailing carriage return
character as a delimiter, for example,
(X:@.@;R,W:MGR.SYS;RACD:JOHN.SMITH)<cr>
Where, the <cr> is the carriage return character (13, 0x0D).
The ACD assigned to a newly created file or directory may be different
from the ACD specified as the value of this itemnum . If a process' file mode
creation mask (cmask) is initialized, it modifies the ACD.
65-76
Reserved for the operating system
77/I32 Data format
Allows the caller to select a different format to view the data in the file.
The current valid values for this item are:
0 Use the standard record based view of accessing the file.
This is the default value for all opens. For conventional
files, the file is record based. For directories, the standard
non-privileged directory information is returned when the
HPDIRREAD intrinsic is called. When this value is specified
with a byte stream file, access to the file is emulated to
appear like a buffered variable record file. This is the
default.
1 When this value is specified, calls to HPDIRREAD returns
privileged directory information including the UFID and
link ID of the entry. Note that this value is only applicable
to directory files. This value is ignored for all other file
types. In order to specify this value, the caller must be