Reference Guide

ZCOM C I/F Library Routines
ZGET_SHRCVR_LIST (3X)
Chapter 4234
PAR AMETER S
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.