kc_queue_str - Properties of temporary queues

The kc_queue_str data structure is defined for the KC_QUEUE object type. In the case of KC_GET_OBJECT, UTM returns information in kc_queue_str about the temporary queues that exist in the application.

Data structure kc_queue_str

char qu_name[8];

char qlev[5];

char queue_length[8];

char q_mode;

The fields of the data structure have the following meanings:

qu_name

Name defined or assigned automatically by UTM when the queue was created with QCRE.

qlev

Contains the maximum number of messages that can be in the queue at any one time.

UTM does not take into account the messages created for the queue until the end of the transaction. The number of messages defined in qlev for a message queue can therefore be exceeded if several messages were created for the same queue in a single transaction.

qlev=32767 means there is no limit on the number of messages in the queue.

queue_length

Contains the number of messages in the queue that are currently being processed or waiting to be processed.

q_mode

Indicates how UTM responds when the maximum number of messages permitted for the queue is reached. Possible values are:

'S'	(STD) UTM rejects any further messages for this queue.
'W'	(WRAP-AROUND) UTM accepts any further messages. When a new message is entered, the oldest message in the queue is deleted.