Envoy ACP/XF Application Programming Manual

System Procedure Call Specifics for EnvoyACP/XF
EnvoyACP/XF Application Programming Manual–132179
4-6
DEFINELIST Procedure
DEFINELIST Procedure
Use the DEFINELIST procedure when the application process acts as a supervisor or
tributary station in a centralized, multipoint configuration.
EnvoyACP/XF requires that you build a list of station addresses within the supervisor
application and each tributary application. A single tributary application controlling one
physical line can respond to more than one station address. In each tributary application,
the defined station list specifies the station addresses to which that particular tributary
will respond. In the supervisor application, the defined station list specifies all tributary
station addresses in the entire multipoint configuration. When you initiate polling,
EnvoyACP/XF progresses from top to bottom through the supervisor's station list until
either a particular station responds with data or all stations respond negatively. In the
latter case, polling continues once again at the top of the list. When you initiate polling,
you can specify either continuous (infinite loop) or noncontinuous (finite loop) polling.
With noncontinuous polling, EnvoyACP/XF notifies the application when it has
completed the specified number of passes through the polling list.
In a supervisor station, DEFINELIST specifies the station addresses of each tributary
station with which the application process needs to communicate.
In a tributary station, DEFINELIST specifies the station addresses to which the
particular line responds.
The addresses are in the form of a station list array whose name is passed to the
DEFINELIST procedure by way of the DEFINELIST calling sequence.
Also use the DEFINELIST procedure to specify extended addresses for both NRM and
ABM configurations.
The form of the DEFINELIST procedure is:
filenum input
INT:value
is the number returned by the OPEN call that opened the line.
Note. The DEFINELIST procedure resets the line and places the local station in disconnect
state. Therefore, use a DEFINELIST procedure before (not after) a call to activate the line.
CALL DEFINELIST ( filenum
!i
, station-list
!i
, entry-size
!i
, num-entries
!i
, polling-count
!i
, polling-type );
!i