Chapter 4 243
Command Definition F-K
FILE
Parameters for Access
NOCCTL or CCTL Indicates whether or not carriage-control characters are specified.
NOCCTL indicates that carriage-control characters are not being specified
in writes to the file. CCTL indicates that carriage-control characters are
being supplied in writes to the file. Default is NOCCTL.
NOMULTI, MULTI, or GMULTI Indicates if the sharing of files in jobs and sessions is
allowed. NOMULTI prohibits sharing files in MULTI mode and is the default.
MULTI allows concurrent accesses of the file and may regard the file as if
no buffering is taking place. Access control information can be shared by
the processes of the same CI process tree (that is parent-to-child processes)
with MULTI. GMULTI is the same as MULTI except it allows accesses to be
in different jobs/sessions.
NOMR or MR Indicates if multirecord access is permitted. NOMR specifies that no
multirecord access is permitted. MR allows multirecord access to the file.
Default is NOMR.
WAIT or NOWAIT Indicates if I/O requests are to be completed or queued before control
returns to the program. WAIT completes I/O requests to the file before
control is returned to the program. NOWAIT returns control to the program
as soon as I/O requests are queued by MPE/iX; only privileged mode
programs are allowed. In this way, the program does not have to wait for
the physical I/O to be complete before resuming execution, and it also
implies NOBUF.
Only MSG files may be opened in NOWAIT mode without privileged mode.
IN, OUT, UPDATE, OUTKEEP,
APPEND, or INOUT Defines the type of file access. IN only permits READ access to the file
and is the default for all input devices. OUT only permits WRITE access to
the file and is the default for output devices. UPDATE permits any type of
access to the file. OUTKEEP only permits WRITE access to the file, except
previous data is not deleted. APPEND only permits APPEND access to any
file. INOUT only permits INPUT/OUTPUT access; any file intrinsic except
FUPDATE can be issued against the file.
BUF= numbuffers or NOBUF Specifies whether buffers are to be allocated to the file. The
numbuffers parameter is the number of buffers (1 to 16) to be allocated for
the file. The numbuffers parameter is ignored for terminals. The default is
BUF=2 buffers. NOBUF specifies that no buffers are allocated for the file.
This parameter has no meaning for NM files.
NOLOCK or LOCK Indicates if dynamic locking and unlocking is to be permitted. NOLOCK
prohibits dynamic locking/unlocking of file through the FLOCK and
FUNLOCK intrinsics. LOCK allows dynamic locking and unlocking through
FLOCK and FUNLOCK intrinsics. Default is NOLOCK.
COPY or NOCOPY Indicates if files can be copied. COPY allows MSG, KSAM, CIR, and SPOOL
files to be either copied (logical data record read) or replicated (block read
and write completely duplicating file) to another file. NOCOPY accesses the
file in its natural mode, that is, as a MSG file. Default is NOCOPY.
