Envoy Application Programming Manual

Table Of Contents
File-System Procedures
Envoy Application Programming Manual427159-001
C-16
DEFINELIST
Because the DEFINELIST procedure expects the address list to be an integer array, you
have to redefine the array as follows before calling DEFINELIST:
INT .addr^list := @saddr^list ’>’ 1;
The most significant bit of the first byte in each poll and select address is interpreted as
the poll bit or select-state bit. In a supervisory station address list, the poll bit or select-
state bit has the following meanings:
0 = enable polling of this station
1 = disable polling of this station
In a tributary station address list, the poll bit or select- state bit has the following
meanings:
For poll addresses:
0 = port active; the READ completes with ENQ received (CCL, FILEINFO error
code 166)
1 = port inactive; Envoy responds to a poll with an EOT and the READ does not
complete
For select addresses:
0 = port active; Envoy responds with ACK0, accepts the text, and the READ
completes
1 = port inactive; Envoy responds with RVI and the READ does not complete
Condition Codes
Example C-3. Address List
LITERAL addr^size = 3,
num^entries = 6,
polling^count = 3,
SYN = %26,
ENQ = 5;
STRING
.saddr^list [0:addr^size * num^entries * 2 - 1] :=
[ SYN, “AA01”, ENQ, ! entry 0, trib 1 poll.
SYN, “BB01”, ENQ, ! entry 1, trib 2 poll.
SYN, “CC01”, ENQ, ! entry 2, trib 3 poll.
SYN, “aa01”, ENQ, ! entry 3, trib 1 select.
SYN, “bb01”, ENQ, ! entry 4, trib 2 select.
SYN, “cc01”, ENQ ]; ! entry 7, trib 3 select.
< (CCL) Indicates that an error occurred (call FILEINFO).
= (CCE) Indicates that the DEFINELIST procedure was executed successfully.