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

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

RETURN VALUE

Routine zsetql returns 0 if successful. Otherwise, a non-zeroerror 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 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