MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 6 227
Command Definitions (FLUSHLOG-GETUSERMODE)
FOPEN
If formaldesig is the name of a user-defined file, it can begin with an
asterisk (*). If
formaldesig is the name of a system-defined file, it can
begin with a dollar sign ($). When creating a KSAM file,
formaldesig
must be a unique file name, that is, one not currently existing in the
permanent file directory.
The formal file designator can contain command interpreter variables and
expressions that are evaluated before
formaldesig is parsed and
validated.
As the default, FOPEN creates a nameless file that can be read or written to,
but not saved. (The domain option of a nameless file must specify a new
file unless it is a device file.)
(ASC) This parameter is recommended for use with asynchronous device
files because of the flexibility it provides.
foption 16-bit unsigned integer by value (optional)
Specifies up to eight different file characteristics by setting corresponding
bit groupings:
NOTE For old files, default conditions are specified in the file label.
Device characteristics may override some foption s.
Bits Value/Meaning
14:2 Domain
Indicates which file domain is searched to locate a file. A nameless disk file must
always be a new file. A device file (such as a tape or terminal) always resides in
the system file domain (permanent file directory). Always specify a device file as
old or permanent.
The following bit settings are valid:
00 The file is new. No search is necessary.
01 The file is a permanent file. The system file domain (permanent
file directory) is searched.
10 The file is a temporary file. The job file domain (temporary
file directory) is searched.
11 The file is an old (permanent or temporary) file. The job
file domain (temporary file directory) is searched. If not
found, the system file domain is searched.
Default: 00
Bits Value/Meaning
13.1 ASCII/binary
Indicates which code, ASCII or binary, a new file is in when written to a
device that supports both codes. For disk files, this also affects padding
(zeros for a binary file, blank characters for an ASCII file) that can occur