Guardian Procedure Calls Reference Manual

Syntax for C Programmers
#include <cextdecs(WRITEUPDATE)>
_cc_status WRITEUPDATE ( short filenum
,short _near *buffer
,unsigned short write-count
,[ unsigned short _near *count-written ]
,[ __int32_t tag ] );
#include <cextdecs(WRITEUPDATEX)>
_cc_status WRITEUPDATEX ( short filenum
,const char *buffer
,unsigned short write-count
,[ unsigned short _far *count-written ]
,[ __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 WRITEUPDATE[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 WRITEUPDATE[X] ( filenum ! i
,buffer ! i
,write-count ! i
,[ count-written ] ! o
,[ tag ] ); ! i
Parameters
filenum
input
INT:value
is a number of an open file that identifies the file to be written.
buffer
input
(for WRITEUPDATE)INT:ref:*
(for WRITEUPDATEX)STRING .EXT:ref:*
is an array containing the information to be written to the file.
write-count
input
INT:value
is the number of bytes to be written to the file:
for disk files (see Disk File Considerations (page 1513)){0:4096}
for magnetic tapes{0:32767}
1510 Guardian Procedure Calls (W-Z)