Guardian Procedure Calls Reference Manual

SETMODENOWAIT Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Related Programming Manuals
Summary
The SETMODENOWAIT procedure is used to set device-dependent functions in a nowait manner
on nowait files.
Whereas the SETMODE procedure is a waited operation and suspends the caller while waiting
for a request to complete, the SETMODENOWAIT procedure returns to the caller after initiating a
request. A call to SETMODENOWAIT completes in a call to AWAITIO[X]. The
count-transferred parameter to AWAITIO[X] has no meaning for SETMODENOWAIT
completions. The buffer-addr parameter is set to the address of last-params parameter of
SETMODENOWAIT.
NOTE: The SETMODENOWAIT procedure performs the same operation as the
FILE_SETMODENOWAIT64_ Procedure (page 511), which is recommended for new code.
Key differences in FILE_SETMODENOWAIT64_ are:
• The pointer and tag parameters are 64 bits wide.
• The procedure returns an error code value rather than a condition code, simplifying
error-handling code.
Syntax for C Programmers
#include <cextdecs(SETMODENOWAIT)>
_cc_status SETMODENOWAIT ( short filenum
,short function
,[ short param1 ]
,[ short param2 ]
,[ short _near *last-params ]
,[ __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 SETMODENOWAIT, which indicates the condition code, can
be interpreted by _status_lt(), _status_eq(), or _status_gt() (defined in the file
tal.h).
SETMODENOWAIT Procedure 1345