ZCOM C I/F Library Routines
ZSETQL (3X)
PARAMETERS
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 | = |
| 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). | |
RETURN VALUE | Routine zsetql returns 0 if successful. Otherwise, a | |
| 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 queue limit to zero will prevent the queue from accepting new |
messages. The queue is still readable, but new data can’t be added to the queue.
Chapter 4 | 289 |