ZCOM C I/F Library Routines

 

 

ZLTQUEUE (3X)

Threads

This routine may be called from a multi-threaded application using the

Considerations

POSIX (1003.1c) kernel threads API package. This routine has the

 

following characteristics when called by a multi-threaded application:

 

cancellation point

Thread cancellation can occur when a thread calls this

 

 

routine.

 

async-cancel unsafe

The calling thread’s cancelability type must be

 

 

PTHREAD_CANCEL_DEFERRED if cancellation is

 

 

enabled.

 

async-signal unsafe

It cannot be called from a signal handler.

 

fork unsafe

It cannot be called by a child process after fork(2) but

PARAMETERS

 

before exec(2).

(Return Param)

Application number of terminal group.

 

appln

 

label

Queue label name.

 

queuep

Data queue number (or ZCOM error, if negative)

NOTES

The data queue returned should only be used for terminals within the

 

specified application group (there is NO queue ownership validation

 

when it is used in ltqdget and ltqdput). An application value of zero

 

means terminals in ALL application groups. This zero application value

 

allows the queue to be used to store global data for all terminals in the

 

system.

 

Routine zltqueue returns an already assigned queue if the queue label matches a previously assigned queue (in this case the specified application number is not used or validated). This provides a facility to share a data queue between different programs and enables program restartability.

Chapter 4

231

Page 231
Image 231
HP UX 11i v1 I/O Cards manual Application number of terminal group, Appln