Guardian Procedure Calls Reference Manual

SETMODE Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Functions
Considerations
Disk File Considerations
Interprocess Communication Considerations
Messages
Examples
Related Programming Manuals
Summary
The SETMODE procedure is used to set device-dependent functions.
A call to the SETMODE procedure is rejected with an error indication if incomplete nowait operations
are pending on the specified file.
NOTE: There is no parallel FILE_SETMODE64_ procedure for SETMODE; the
FILE_SETMODENOWAIT64_ Procedure (page 511) must be used instead. Like SETMODENOWAIT,
FILE_SETMODENOWAIT64_ may also be called on files opened for waited I/O and is
recommended for new code.
Key differences in FILE_SETMODENOWAIT64_ for waited I/O are:
• The pointer parameter is 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(SETMODE)>
_cc_status SETMODE ( short filenum
,short function
,[ short param1
,[ short param2
,[ short _near *last-params );
• The function value returned by SETMODE, 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 SETMODE ( filenum ! i
,function ! i
,[ param1 ] ! i
,[ param2 ] ! i
,[ last-params ] ); ! o
SETMODE Procedure 1317