Guardian Procedure Calls Reference Manual

Syntax for C Programmers
#include <cextdecs(WRITEREAD)>
_cc_status WRITEREAD ( short filenum
,short _near *buffer
,unsigned short write-count
,unsigned short read-count
,[ unsigned short _near *count-read ]
,[ __int32_t tag ] );
#include <cextdecs(WRITEREADX)>
_cc_status WRITEREADX ( short filenum
,char _far *buffer
,unsigned short write-count
,unsigned short read-count
,[ unsigned short _far *count-read ]
,[ __int32_t tag ] );
• 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 WRITEREAD[X], 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
CALL WRITEREAD[X] ( filenum ! i
,buffer ! i,o
,write-count ! i
,read-count ! i
,[ count-read ] ! o
,[ tag ] ); ! i
Parameters
filenum
input
INT:value
is the number of an open file that identifies the file where the WRITE/READ is to occur.
buffer
input, output
(for WRITEREAD)INT:ref:*
(for WRITEREADX)STRING .EXT:ref:*
on input, is an array containing information to be written to the file.
On return, buffer contains the information read from the file.
WRITEREAD[X] Procedures 1505