ZLTMX (3X)

NAME

zltmx - Control logical terminal multiplexing

SYNOPSIS

#include  <zcom/zcomsys.h>
#include  <zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */
 
int32 zltmx (zap, mode)
 
zaddr_type   *zap; 
int32        mode;

DESCRIPTION

Routine zltmx is used to enable or disable the multiplexing of logical terminals. This routine allows dynamic control of the ZCOM_LTFLAG_OMX and ZCOM_LTFLAG_IMX logical terminal flag bits. These flag bits are initialized for each terminal ZLU by TTGEN, and may be changed by use of this call.

After calling this routine, the subsequent zrcvr and zsend calls will work according to the new settings.

The libraries libzcom_c.a and libpthread.a must be linked into the calling program by giving the options “-lzcom_c -lpthread” to cc(1) or ld(1).

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:

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

PARAMETERS

zap	ZCOM address.
mode	Multiplexing control mode
	ZcENB_OUTB_MLTPLXG	(1) - Enable outbound multiplexing
	ZcENB_INB_MLTPLXG	(2) - Enable inbound multiplexing
	ZcDSB_OUTB_MLTPLXG	(3) - Disable outbound multiplexing
	ZcDSB_INB_MLTPLXG	(4) - Disable inbound multiplexing

NOTES

For a more detailed description of the multiplexing facilities available under ZCOM, see the section of the manual under the heading “ZCOM Message Handling”.

RETURN VALUE

Routine zltmx returns 0 if successful. 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.

EXAMPLE

#include     <zcom/zcomsys.h>
#include          <zcom/zcomcall.h>
 
int32          ierr;
zaddr_type     zaddr;
int32          mode;
 
if (ierr = zltmx (&zaddr, mode)) {
       /* error return code */
}
else {
       /* good return code */
}

FILES

/opt/acc/include/zcom/zcomsys.h	ZCOM system general include file, containing data types, data structures, constants, error codes, masks, etc. Note that this must be the first include file before any other ZCOM include files.
/opt/acc/include/zcom/zcomcall.h	ZCOM routine function prototypes (requires ANSI C compilation).