ACC Programmer's Reference Guide

Chapter 4 215
ZCOM C I/F Library Routines
ZGET_SHRCVR_LIST (3X)
fork unsafe It cannot be called by a child process after fork(2)
but before exec(2).
See the NOTES section below for more information
on using this routine in a multi-threaded application.
zap ZCOM address pointer. The uses of node, zlu and zcs depend on the
specified mode. But in general this is used to select the specific
table entry from which you want the shared receivers list.
mode Specifies which shared receiver list to return.
0 - Logical Terminal Table Shared Receivers (zap->zlu is the ZLU
of a terminal entry in the LTT, node and zcs are not used)
1 - Physical Terminal Table Shared Receivers for “normal” data and
Status messages (zap->zlu is the ZLU of an entry in the PTT).
2 - Physical Terminal Table Shared Receivers for “control”
messages (zap->zlu is the ZLU of a terminal in the PTT).
3 - DSC Event Receivers (The zap parameter is not used)
4 - Node Status Event Receivers (zap->node is the required node
number, zcs and zlu are not used)
mlen Maximum number of receivers to be returned in the zrcvrs array. To
get the full list of receivers, this should be
ZcMAX_SHARED_RCVRS+1.
zrcvrs
(Return
Param)
This is a returned array of all shared receivers currently configured.
Each entry in the array is a single receiver for the type of data
specified by the mode parameter. The list is terminated by an entry
with a zlu value of 0. The maximum number of receivers in each
type of shared receiver list is set to ZcMAX_SHARED_RCVRS
(currently, 64). Hence, to get the full list of receivers, this array
should have ZcMAX_SHARED_RCVRS+1 entries.