Accessing Files Programmer's Guide (32650-90885)

34 Chapter2
Creating A File
The HPFOPEN Intrinsic
Default: No node name passed (local file access)
A character placed in the first element designates the delimiter used by
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,
%envname% (% is the delimiter, envname is the designator)
fabcxyzf ( f is the delimiter, abcxyz is the designator)
A remote environment cannot be specified when creating or opening files
in the HFS name space or in byte stream files.
27/I32 Output priority:
Passes the output priority to be attached to the file for spooled output. This
option is applicable only to spooled devices. The output priority must be a
number between 1 (lowest priority) and 13 (highest priority), inclusive. If
the value specified is less than the current outfence set by the system
operator, file printing is deferred until the operator raises the output
priority of the file or lowers the outfence. This option can be specified for a
file already opened (for example, $STDLIST), where the highest value
supplied before the last FCLOSE takes effect. This option is ignored for
nonspooled devices.
Default: 8
28/CA Spooled message:
Passes a spooler message associated with a spoolfile. For example, a
message is passed that can be used for telling the system operator what
type of paper to use in the line printer. This message must be displayed to
the system operator and verified before the file can be printed on a line
printer. The number of characters allowed <=48; any quantity > 48
characters is truncated.
Default: No spooled message specified
A character placed in the first element designates the delimiter used by
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:
%message% (% is the delimiter, message is the designator)
fabcxyzf ( f is the delimiter, abcxyz is the designator)
29/I32 Privileged access:
Passes a value that temporarily restricts access to the file number
returned from HPFOPEN to a calling process whose execution level is equal
to or less than the value specified in this option. This restriction lasts until
the file associated with the restricted file number is closed. Do not specify
a value less than the execution level of the calling process.
The following values are valid: