Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (O)
Guardian Procedure Calls Reference Manual—522629-013
11-31
OPEN^FILE Procedure
•
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 the following 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.
The following literals can be combined using signed addition because bit 0 is not
used:
ABORT^OPENERR KEEP^LASTOPENTIME PURGE^DATA
ABORT^XFERERR LEVEL3^SPOOL^ENABLE READ^TRIM
AUTO^CREATE MUSTBENEW VAR^FORMAT
AUTO^TOF NOWAIT WRITE^FOLD
BLOCKED OLD^RECEIVE WRITE^PAD
CRLF^BREAK PRINT^ERR^MSG WRITE^TRIM
See “General Considerations,” later, for the meanings of literals used with
flags.
Literal declarations are contained in the file $SYSTEM.SYSTEM.GPLDEFS.
flags-mask input
INT(32):value
specifies which bits of the flag field are used to alter the file transfer characteristics.
A characteristic to be altered is indicated by entering a 1 in the bit position