Guardian Procedure Calls Reference Manual

FILE_WRITE64_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Disk File Considerations
Interprocess Communication Considerations
Related Programming Manuals
Summary
The FILE_WRITE64_ procedure writes data from an array in the application program to an open
file. FILE_WRITE64_ is intended for use with 64-bit addresses. The data buffer for FILE_WRITE64_
can be either in the caller's stack segment or any extended data segment.
FILE_WRITE64_ extends the capabilities of WRITEX in the following ways:
• It permits the write buffer to reside outside of the 32-bit addressable range.
• It is callable from both 32-bit and 64-bit processes.
• It allows for the future capability to write more than 56kb in a single operation by widening
the write count to 32 bits.
• It allows the returned count-written argument to reside outside of the 32-bit addressable
range.
• It allows a 64-bit nowait I/O tag to be passed.
• Rather than returning a condition code status, the procedure returns a file management error.
A return value of zero indicates success.
NOTE: The FILE_WRITE64_ procedure is supported on systems running H06.24 and later H-series
RVUs and J06.13 and later J-series RVUs. Its use is recommended for new code.
Syntax for C Programmers
#include <cextdecs(FILE_WRITE64_)>
short FILE_WRITE64_( short filenum
,const char _ptr64 *buffer
,__int32_t write-count
,[ __int32_t _ptr64 *count-written ]
,[ long long tag ] );
Syntax for TAL Programmers
e?SETTOG _64BIT_CALLS
?SOURCE EXTDECS(FILE_WRITE64_)
error := FILE_WRITE64_ ( filenum ! i
,buffer ! i
,write-count ! i
,[ count-written ] ! o
,[ tag ] ); ! i
524 Guardian Procedure Calls (F)