Guardian Procedure Calls Reference Manual

SETPARAM Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Related Programming Manuals
Summary
The SETPARAM procedure is used to set and fetch various values such as the station characteristics
of network addresses. The operation can be performed in a nowait manner by use of the
nowait-tag parameter and in that case is completed by a call to AWAITIO[X].
Syntax for C Programmers
#include <cextdecs(SETPARAM)>
_cc_status SETPARAM ( short filenum
,short function
,[ short _near *param-array ]
,[ short param-count ]
,[ short _near *last-param-array ]
,[ short _near *last-param-count ]
,[ short last-param-max ]
,[ __int32_t nowait-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 SETPARAM, 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 SETPARAM ( filenum ! i
,function ! i
,[ param-array ] ! i
,[ param-count ] ! i
,[ last-param-array ] ! o
,[ last-param-count ] ! o
,[ last-param-max ] ! i
,[ nowait-tag ] ); ! i
Parameters
filenum
input
INT:value
is the number of an open file for which special information is sent.
SETPARAM Procedure 1349