Filter
Top Products
Chapter 2 115
Command Definitions A-B
BUILD
RIO and NORIO specifications affect only the physical characteristics of the
file. If NOBUF is specified in the FILE command, the file is not accessed in
RIO mode; otherwise, RIO access is used with RIO files. Special operations
on RIO files, such as replicating an RIO file, set NOBUF access. Refer to the
Accessing Files Programmer's Guide for a discussion of relative I/O.
STD, MSG, CIR, KSAMXL, SPOOL Defines the type of file.
The default is STD (standard MPE/iX disk file). You do not need to specify
STD; in fact, if you do specify it, you will see the error message The STD
keyword is not appropriate in the context of a BUILD
command. (CIERR 216).
A MSG (message file) allows communication between any set of processes in
a first in, first out (FIFO) manner. Records are read from the start of the
file and are logically deleted and/or are appended to the end of the file.
CIR (circular file) acts as a normal sequential file until full. When full, the
first physical block is deleted when the next record is written, and
remaining blocks are logically shifted to the front of the file. A circular file
cannot be simultaneously accessed by readers and writers.
KSAMXL specifies a native mode KSAM file (KSAM XL file).
SPOOL specifies an unlinked output spool file. The default outpri on the
spool file is 8; the default number of copies is 1. The unlinked output spool
file must be created on a disk device. Specify the target printer device at
SPOOLF...;PRINT time; if you do not, an error results.
The characteristics of a file created with the SPOOL keyword are:
• variable length records of 1008 bytes each
• a blocking factor of 1
• ASCII format
• permanent file
• record limit of 1023
• undefined maximum number of extents with 0 extents initially
allocated
These characteristics override any other characteristics, such as binary
format, which may be specified.
numlabels The number of user label records to be created for the new file. Up to 255
labels can be specified. This parameter applies to any type of file.
^filereference or keyinfo filereference is a file containing key information. This parameter only
applies to new KSAM files; it is required for new KSAM files. The caret (^)
indicates that the contents of the file will be used.
keyinfo has the following format: