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.

PARAMETERS

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->zluis

 

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->zluis the ZLU of an entry

 

in the PTT).

 

2 - Physical Terminal Table Shared Receivers for “control”

 

messages (zap->zluis the ZLU of a terminal in the PTT).

 

3 - DSC Event Receivers (The zap parameter is not used)

 

4 - Node Status Event Receivers (zap->nodeis 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

This is a returned array of all shared receivers currently

(Return

configured. Each entry in the array is a single receiver for

Param)

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.

234

Chapter 4