ACC Programmer's Reference Guide

Chapter 4 225
ZCOM C I/F Library Routines
ZLTMG (3X)
Threads
Considerations
This routine may be called from a multi-threaded application using the
POSIX (1003.1c) kernel threads API package. This routine has the
following characteristics when called by a multi-threaded application:
In the ZCOM subsystem, a group of logical terminals may be defined to
link to a single physical terminal. This routine allows a logical terminal
to be moved from one terminal group to another, thus all its physical
input/output may be handled by a different physical device.
This call is intended for advanced ZCOM programmers, and
should be used with care.
Routine zltmg returns 0 if s uccessful. Otherwise, a non-zero error code
is returned. See /opt/acc/include/zcom/zcomsys.h for the list of ZCOM
error codes and their meanings.
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
before exec(2).
zaddr Terminal to be moved
nzaddr A group member of the new group