Guardian Procedure Calls Reference Manual

DEFINELIST Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Related Programming Manual
Summary
The DEFINELIST procedure is used only when the application process is acting as a supervisor or
tributary station in a centralized multipoint configuration.
• Within a supervisor station, DEFINELIST specifies the station addresses of each tributary station
that the application process wishes to communicate with.
• Within a tributary station, DEFINELIST specifies the station addresses that the particular line
responds to.
The addresses are in the form of a "station list" array whose name passes to the DEFINELIST
procedure by way of the DEFINELIST calling sequence.
Syntax for C Programmers
#include <cextdecs(DEFINELIST)>
_cc_status DEFINELIST ( short filenum
,short _near *address-list
,short address-size
,short num-entries
,short polling-count
,short polling-type );
• The function value returned by DEFINELIST, 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 DEFINELIST ( filenum ! i
,address-list ! i
,address-size ! i
,num-entries ! i
,polling-count ! i
,polling-type ); ! i
Parameters
filenum
input
INT:value
is the name of the one-word integer variable specified in the call to FILE_OPEN_ or OPEN that
opened the line.
DEFINELIST Procedure 267