ACC Programmer's Reference Guide

Chapter 4 289
ZCOM C I/F Library Routines
ZSETQL (3X)
PARAMETERS
RETURN VALUE Routine zsetql 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.
NOTES 1. Queue limit does not affect data messages that are already in a
queue. If the new limit is below the amount of queued data, no new
data is accepted until the queued data drops below the limit. Setting
a queu e limit to zero will pre vent the queue from accepting new
messages. The queue is still readable, but new data can’t be added to
the queue.
zap ZCOM address.
mode Type of queue:
ZcPROGRAM_Q (0) - Program input queue
ZcLOGICAL_TERM_Q (1) - Logical terminal queue
ZcPHYSICAL_TERM_Q (2) - Physical terminal queue
If bit ZCOM_QLIM_MFLAG (0x8000) is set, the queue is changed to use a message
limit. If bit ZCOM_QLIM_BFLAG (0x4000) is set, the queue is changed to use a byte
limit. If neither are set, the limit mode is unchanged. They should not be set together.
qnum Queue number. Depending on mode, it specifies which queue to set:
mode 0- (ZcPROGRAM_Q)qnum parameter not used
mode 1 - (ZcLOGICAL_TERM_Q) Data queue number
0 = Sub-packet holding queue
1 = Data holding queue A
2 = Data holding queue B, etc.
mode 2 - (ZcPHYSICAL_TERM_Q) Data queue number
0 = High priority transmit queue
1 = Low priority transmit queue
2 = Unacknowledged transmit queue
3 = Express transmit queue
limit New queue limit. Allowable range is 0 to
ZCOM_MAXQLIM (0x7FFFFFFF).