Guardian Procedure Calls Reference Manual

FILE_SETMODENOWAIT64_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manuals
Summary
The FILE_SETMODENOWAIT64_ procedure is used to set device-dependent functions.
FILE_SETMODENOWAIT64_ extends the capabilities of SETMODENOWAIT in the following ways:
It is callable from both 32-bit and 64-bit processes.
It allows a 64-bit nowait I/O tag to be passed.
It allows the returned last-params argument to reside outside of the 32-bit addressable
range.
Rather than returning a condition code status, the procedure returns a file management error.
A return value of zero indicates success.
NOTE: There is no parallel FILE_SETMODE64_ procedure for SETMODE;
FILE_SETMODENOWAIT64_ must be used instead. Like SETMODENOWAIT,
FILE_SETMODENOWAIT64_ may also be called on files opened for waited I/O. See Considerations
(page 513).
A nowait call to FILE_SETMODENOWAIT64_ completes in a call to FILE_AWAITIO64_ or
FILE_COMPLETEL_. The count-transferred parameter to FILE_AWAITIO64_ has no meaning
for FILE_SETMODENOWAIT64_ completions. The buffer-addr parameter is set to the address
of last-params parameter of FILE_SETMODENOWAIT64_.
A waited call to FILE_SETMODENOWAIT64_ suspends the caller while waiting for a request to
complete, the FILE_SETMODENOWAIT64_ procedure returns to the caller after initiating a request.
NOTE: The FILE_SETMODENOWAIT64_ 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_SETMODENOWAIT64_)>
short FILE_SETMODENOWAIT64_ ( short filenum
,short function
,[ short param1 ]
,[ short param2 ]
,[ short _ptr64 *last-params ]
,[ long long tag ] );
FILE_SETMODENOWAIT64_ Procedure 511