Accessing Files Programmer's Guide (32650-90885)

Chapter 2 21
Creating A File
The HPFOPEN Intrinsic
A device file (such as a tape drive, terminal, spooled printer or hot printer)
always resides in the system file domain (permanent file directory).
Always specify a device file as old or permanent.
The following values are valid:
0 The file is a new temporary file. It is not placed in a
directory.
1 The file is a permanent file, found in the system file
domain.
2 The file is a temporary file, found in the job file domain.
3 The file is an old (permanent or temporary) file. The job
file domain is searched first. If the file is not found, the
system file domain is searched.
4 The file is created, placed in the permanent file directory,
and becomes a permanent file.
Hierarchical directories must be created in the permanent file domain by
specifying the create file domain (4).
Default: 0
5/I32 Designator:
Passes a value indicating a special file opening. Any of the following
special files can be specified with the
itemnum =2. For example, a file name
of $STDLIST opens the standard list device. The following values are valid:
0 Allows all other options to specify the file.
1 The actual file designator is $STDLIST.
2 The actual file designator is $NEWPASS.
3 The actual file designator is $OLDPASS.
4 The actual file designator is $STDIN.
5 The actual file designator is $STDINX.
6 The actual file designator is $NULL.
Default: 0
For example, if MYFILE is passed in
itemnum =2, then using itemnum =5 and
item =4 to equate it with $STDIN is equivalent to the file equation FILE
MYFILE=$STDIN.
This option is not equated with
itemnum =2 if both of the following
conditions are true:
• The
itemnum =9 option allows file equations for the file opening.
• An explicit or implicit FILE command equating the formal file
designator to a different actual file designator occurs in the job/session.
A leading * in a formal file designator passed by
itemnum =2 overrides an