Guardian Procedure Calls Reference Manual

Parameters
filenum
input
INT:value
is the number of an open file. It identifies the file on which the CONTROLBUF procedure
performs an I/O operation.
operation
input
INT:value
defines the operation to be performed. (See Table 10: CONTROL Operation 1 (page 207) and
Table 11: CONTROL Operations 2 Through 27 (page 209) for the list of available operations.)
buffer
input
INT:ref:*
is an array that contains the information to be used for the CONTROLBUF operation (see
Table 10: CONTROL Operation 1 (page 207) and Table 11: CONTROL Operations 2 Through
27 (page 209) for more information).
count
input
INT:value
is the number of bytes contained in buffer.
count-transferred
output
INT:ref:1
returns a count of the number of bytes transferred from buffer (for wait I/O only).
tag
input
INT(32):value
is for nowait I/O only. The tag parameter is a value you define that uniquely identifies the
operation associated with this CONTROLBUF call.
NOTE: The system stores the tag value until the I/O operation completes. The system then
returns the tag information in the tag parameter of the call to AWAITIO, thus indicating that
the operation finished.
Condition Code Settings
indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).< (CCL)
indicates that the CONTROLBUF was successful.= (CCE)
for a process file, indicates that the process is not accepting process CONTROLBUF messages.> (CCG)
CONTROLBUF Procedure 213