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 configured.

 

(Return

Each entry in the array is a single receiver for the type of data

 

Param)

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.

Chapter 4

215

Page 215
Image 215
HP UX 11i v1 I/O Cards Table entry from which you want the shared receivers list, Should have ZcMAXSHAREDRCVRS+1 entries