Envoy ACP/XF Application Programming Manual
System Procedure Call Specifics for EnvoyACP/XF
EnvoyACP/XF Application Programming Manual–132179
4-9
Priority Polling
CALL DEFINELIST (fnum,station^list,entry^size,num^entries,
poll^count,poll^type);
In the following example, another tributary application responds to a single station
address:
LITERAL addr^c = %41400, ! station C address
entry^size = 4, ! entry size (4 words)
num^entries = 1, ! number of entries in list
poll^count = 1, ! number of entries in list
poll^type = 0; ! dummy parameter
INT .STATION^LIST[0:3] := [ addr^c,3 * [0] ]; ! station C
! entry
CALL DEFINELIST (fnum,station^list,entry^size,num^entries,
poll^count,poll^type);
Priority Polling
To determine the order in which stations are polled, your application process makes a
call to the DEFINELIST procedure to pass a list of stations to EnvoyACP/XF.
For a multipoint supervisor, you can pass a priority polling list; that is, the same station
address can appear more than once in the list. Then, that station is polled more often
than other stations on the line.
Extended Addresses
For ADCCP-NRM, you can use the DEFINELIST procedure to refer to addresses in an
extended address field. You can use SCF to set the address-field size by specifying the
ADDRESSSIZE modifier or you can specify extended addressing through SETMODE
19.
Individual stations on a link can have different address-field lengths. When
ADDRESSIZE is greater than 1, the low-order bit of an octet is an address stop bit. If no
address stop bit is present, an address length of one octet is assumed.
Example:
In the following example, the station list refers to a multipoint supervisor station using
4-octet addresses.
DEFINES addr^ab15 = %040502,%030465#, ! Station AB15 address
addr^ab25 = %040502,%031065#, ! Station AB25 address
addr^ab35 = %040502,%031465#; ! Station AB35 address
LITERAL entry^size = 4, ! Entry size (4 octets)
num^entries = 3, ! Number entries in list
polling^count = 3, ! Number entries in list
polling^type = 0; ! Continuous polling
INT .STATION^LIST[0:11] := ! AUTO-POLL station list
[addr^ab15,2 * [0], ! Station AB15 entry
addr^ab25,2 * [0], ! Station AB25 entry