MPE/iX Intrinsics Reference Manual (32650-90875)

390 Chapter7
Command Definitions (HP32208-HPLOACNMPROC)
HPFOPEN
HPFOPEN to search for the end of the character array. The delimiter can
appear again only following the last valid character of the character array,
for example:
%devclass% (% is the delimiter, devclass is the designator)
fabcxyzf ( f is the delimiter, abcxyz is the designator)
This
itemnum may not be specified when creating hierarchical directories.
Hierarchical directories created on the system volume set is allocated on
any volume within the set. Hierarchical directories created on non-system
volume sets is allocated on the master volume.
43/record UFID:
Passes a unique file identifier (UFID) to provide a fast opening of an old
disk file. A UFID is a record structure, 20 bytes in length, that uniquely
identifies a disk file. Using this option avoids a directory search. Obtain
the UFID of an opened file by calling FFILEINFO. The UFID can then be
passed to HPFOPEN. The file represented by the UFID must be accessible to
the process calling HPFOPEN. (All file system security checks are made.)
New files cannot be opened with this option. If the file to be opened by the
UFID contains a lockword, use
itemnum =2 to specify the file name with the
lockword.
Only files in the MPE name space may be opened by UFID. An attempt to
open a file outside the MPE name space by UFID results in a
status.info
of -321 being returned. Only system code may open a file by UFID in the
POSIX name space.
Default: No UFID passed (a directory search is performed)
(ASC) Not used for asynchronous devices.
44/I32 Numbuffers:
Passes the number of buffers to allocate to the file. Ignored for standard
disk files. This option is useful only for slow devices (such as tapes) used in
a buffered mode. Not applicable for files representing interactive
terminals; a system-managed buffering method is always used.
The valid range for this option is dependent upon the file type:
• For standard and KSAM files, the valid range is 1..31.
• For circular and RIO files, the valid range is 1..16.
• For message files, the valid range is 2..16. (If a 1 is specified, the file
system sets this option to 2 and no error is returned.)
This option must not specify a number of buffers whose combined size
exceeds the physical capacity of the file.
This
itemnum is ignored when creating hierarchical directories.
Default: 2
(ASC) Not used for asynchronous devices.