MPE/iX Intrinsics Reference Manual (32650-90875)

242 Chapter6
Command Definitions (FLUSHLOG-GETUSERMODE)
FOPEN
parameter.
userlabels 16-bit signed integer by value (optional)
Passes the number, in the range 0..254, of user-label
records to be created for the file. Applicable to new disk
files only.
Default: 0
(ASC) Not valid for asynchronous device files.
blockfactor 16-bit signed integer by value (optional)
Passes the number of logical records in one physical record
(block). This value is used to calculate the physical record
size for disk and magnetic tape files. The valid range for
this option is 1..255. If a value greater than 255 is
specified, FOPEN resets the value to 255. If a value less
than 1 is specified, FOPEN resets the value to the default
blockfactor setting.
For fixed-length records,
blockfactor specifies the actual
number of records in a block. For variable-length records,
blockfactor is interpreted as a multiplier used to
compute the block size (
recsize*blockfactor ). For
undefined-length records,
blockfactor is always one
logical record per block.
Default: For files opened BUF, the default is calculated by
dividing the specified
recsize into the physical record size
(block size) configured for the device. For files opened
NOBUF, the default is 1.
(ASC) Not valid for asynchronous device files.
numbuffer 16-bit signed integer by value (optional)
Passes the number of buffers, number of copies, and
output priority indicated by setting the following bits:
Bits Value/Meaning
11:5 Numbuffers
Indicates the number of buffers to allocate to the file. The valid range is
dependent on file type:
• For standard files, the valid range is 1..31.
• For circular and RIO files, the valid range is 1..16.
• For message files, the valid range is 2..16 (if a 1 is specified, the file
system sets this option to 2 and no error is returned).
• For KSAM/3000 files, the valid range is 1..20.
• Not used for KSAM XL and KSAM64 files.
This option is ignored for standard disk files, useful only for slow devices