Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual522629-013
3-136
CONTROLBUF Procedure
CONTROLBUF Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Messages
Summary
The CONTROLBUF procedure is used to perform device-dependent I/O operations
requiring a data buffer.
Syntax for C Programmers
CEXTDECS (through the included file TNSINTH) defines 32-bit values as the
typedef __int32_t which for TNS and TNS/R compiles is defined as long and for
TNS/E compiles is defined as
int.
The function value returned by CONTROLBUF, which indicates the condition code,
can be interpreted by
_status_lt(), _status_eq(), or _status_gt()
(defined in the file
tal.h).
Syntax for TAL Programmers
Parameters
filenum input
INT:value
#include <cextdecs(CONTROLBUF)>
_cc_status CONTROLBUF ( short filenum
,short operation
,short _near *buffer
,short count
,[ short _near *count-transferred ]
,[ __int32_t tag ] );
CALL CONTROLBUF ( filenum ! i
,operation ! i
,buffer ! i
,count ! i
,[ count-transferred ] ! o
,[ tag ] ); ! i