ZCOM C I/F Library Routines

 

 

ZSET_RCVR (3X)

PARAMETERS

 

 

action

Type of action to perform.

 

 

ZcADD_PRIMARY

- Sets the program ZLU as the primary receiver.

 

ZcDEL_PRIMARY

- Deletes the primary receiver.

 

ZcADD_SHARED

- Adds the program ZLU to the list of shared receiv

 

ZcDEL_SHARED

- Removes the program ZLU from the list of shared

zap

ZCOM address of terminal.

 

mode

Receiver mode:

 

 

ZcNORMAL

(0) - Set receiver for normal messages

 

ZcINB_MLTPLX

(1) - Set inbound multiplexer receiver

 

ZcOUTB_MLTPLX

(2) - Set outbound multiplexer receiver

 

ZcCONTROL

(3) - Set receiver for control messages

 

Note: Only one constant value can be specified per call for this field. You cannot

 

OR these values in one call

 

rzap

ZCOM address of the receiver program.

NOTES

Usually, an application uses only mode ZcNORMAL to set up itself as the

 

receiver for normal data and status messages. An application uses mode

 

ZcCONTROL only if it needs to receive “control” messages. Control

 

messages are generated by ZCOM protocol modules. You should refer to

 

the specific ZCOM Protocol Manual to determine the “control” messages

 

generated by that protocol, if any.

 

Modes ZcINB_MLTPLX and ZcOUTB_MLTPLX require the terminal to

 

be an inbound and outbound multiplexed terminal, respectively.

 

Otherwise, error ZERTYPE (-54) is returned. A multiplexed terminal is

 

usually set up by defining the proper device type in the TTGEN

 

configuration file (using TERM or LTERM statements). It may also be

 

modified by using zltmx.

When inbound multiplexing is enabled for a terminal, an inbound receiver must be set up (using mode ZcINB_MLTPLX) by the multiplexing program, which will be responsible for receiving messages from the terminal and passing them to the “normal receivers” kept in the logical terminal tables.

Chapter 4

293