MPE/iX Intrinsics Reference Manual (32650-90875)

278 Chapter6
Command Definitions (FLUSHLOG-GETUSERMODE)
FSPACE
FSPACE
NM and CM callable.
Moves a record pointer forward or backward on a magnetic tape or disk file, spaces
physical records on magnetic tape files and logical records on disk files.
Syntax
I16V I16V
FSPACE(
filenum,displacement );
Parameters
filenum 16-bit signed integer by value (required)
Passes the file number of the file on which spacing is to be done.
displacement 16-bit signed integer by value (required)
Passes the number of logical records for buffered disk files, or blocks for
NOBUF files and all tape files, to be spaced over, relative to the current
position of the logical record pointer.
A positive value signifies forward spacing, a negative value signifies
backward spacing. The maximum positive value is 32,767, the maximum
negative value is -32,768.
If RIO access is used,
displacement includes both active and inactive
records. Attempts to backspace beyond the beginning of the file are
ignored by the system. The logical record pointer points to record 0 (the
first record), and no error codes are returned.
Operation Notes
The FSPACE intrinsic cannot be used with variable-length record files, message files, or
with spooled files on disk. An attempt to use this intrinsic on such files results in CCL (1),
and the logical record pointer is left at its current position.
FSPACE intrinsic fails with a CCL condition:
•If filenum references a byte stream file.
•IfFCHECK intrinsic is called to obtain the error code associated with a CCL condition
code.
(KSAM) The logical record pointer is repositioned in key sequence. The spacing is based on
the primary key unless an alternate key has been specified in a prior call to FFINDN,
FFINDBYKEY, or FREADBYKEY.
Condition Codes
CCE (2) Request granted.