MPE/iX Intrinsics Reference Manual (32650-90905)
Chapter 6 241
Command Definitions (FLUSHLOG-GETUSERMODE)
FOPEN
.[
volid
[,
type
[,
exp
[,
seq
]]]];
The period is required so that the tape label information is not mistaken
for a forms message.
volid
Volume identifier, consisting of <=6 printable characters.
In a multivolume set, specify only the first
volid
.
type
Label type, identified by three alphabetic characters:
ANS - ANSI standard labels (default)
IBM - IBM standard labels
exp
Month/day/year of the file expiration date or the date
when the file information is no longer valid. The file can be
overwritten after this date. If the default is 00/00/00, the
file can be overwritten immediately. In a volume set, file
expiration dates must be equal to or earlier than the date
on the previous file.
seq
Use one of the following methods to specify the position of
the file in relation to other files on the tape:
• A zero, which causes a search of all volumes until the
file is found.
• An unsigned integer (1-9999), which specifies the
position of the file relative to the current file on the
tape.
• ADDF which causes the tape to be positioned to add a
new file on the end of the volume (or last volume in a
multivolume set).
• NEXT which positions the tape at the next file on the
tape. If this is not the first FOPEN for the file and a
rewind occurred on the last close, then the position
remains at the beginning of the previous file.
Default: NEXT
(KSAM) Contains a description of the primary key and up
to 15 alternate keys:
• If a new file is being created, this parameter must be
specified.
• If this is an existing file, check flagword field to see if
the default values are acceptable; if not acceptable,
specify this field explicitly.
For KSAM XL and KSAM64 files, refer to the Using KSAM
XL (32650-90168) for a complete description of this
parameter.
For KSAM/3000 files, refer to the KSAM/3000 Reference
Manual (30000-90079) for a complete description of this