Guardian Procedure Calls Reference Manual

FILE_CONTROLBUF64_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Messages
Summary
The FILE_CONTROLBUF64_ procedure is used to perform device-dependent I/O operations requiring
a data buffer.
FILE_CONTROLBUF64_ extends the capabilities of the CONTROLBUF procedure in the following
ways:
• It is callable from both 32-bit and 64-bit processes.
• It allows the control buffer and count-transferred arguments to reside in the 64-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_CONTROLBUF64_ 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_CONTROLBUF64_)>
short FILE_CONTROLBUF64_ ( short filenum
,short operation
,short _ptr64 *buffer
,short count
,[ short _ptr64 *count-transferred ]
,[ long long tag ] );
Syntax for TAL Programmers
?SETTOG _64BIT_CALLS
?SOURCE EXTDECS(FILE_CONTROLBUF64_)
error := FILE_CONTROLBUF64_ ( filenum ! i
,operation ! i
,buffer ! i
,count ! i
,[ count-transferred ] ! o
,[ tag ] ); ! i
382 Guardian Procedure Calls (F)