Guardian Procedure Calls Reference Manual

following a process startup. The size of the file control block differs between TNS processes
and native processes.
file-fcb
input
INT:ref:*
is an array of FCBSIZE or FCBSIZE^D00 words for use by the SIO procedures. The file FCB
uniquely identifies this file to other SIO procedures. The file FCB must be initialized with the
name of the file to be opened before OPEN^FILE is called. The size of the file control block
differs between TNS processes and native processes.
For information about the FCB structure, see the Guardian Programmer's Guide.
block-buffer
input
INT:ref:*
is an array used for one of four different purposes:
• When reading a structured file, the presence of this parameter indicates a request for
sequential block buffering. If more than one file refers to the same block-buffer address,
they share the same sequential block buffer.
• When reading or writing an EDIT file, the buffer is used by SIO to contain EDIT file pages
being assembled or disassembled. The buffer must be supplied for an EDIT file.
• When using level-3 spooling, the buffer is used by SIO to hold records that are to be sent
to a spooler collector.
• If block-buffer is not being used for any of the other three purposes, then the array is used
for SIO record blocking and deblocking. No blocking is performed if any of these occurs:
◦ block-buffer or block-bufferlen is omitted.
◦ The value of block-bufferlen is insufficient according to the record length for the
file.
◦ Read/write access is indicated.
Blocking occurs when block-buffer is supplied, the block buffer is of sufficient
length (as indicated by block-bufferlen), and blocking is appropriate for the
device.
For TNS processes, the block buffer must be located within ‘G'[0:32767 ] of the data
area. This limit does not apply to native processes.
block-bufferlen
input
INT:value
indicates the length, in bytes, of the block buffer. This length must be able to contain at least
one logical record. For an EDIT file, the minimum length on read is 144 bytes; on write, the
minimum length is 1024 bytes. For use with level-3 spooling, the minimum length is 1024
bytes.
flags
input
INT(32):value
if present, is used with the flags-mask parameter to set file transfer characteristics. If omitted,
all positions are treated as zeros.
OPEN^FILE Procedure 909