kc_queue_str - Eigenschaften temporärer Queues

Für den Objekttyp KC_QUEUE ist die Datenstruktur kc_queue_str definiert.
Bei KC_GET_OBJECT liefert UTM in kc_queue_str Informationen über die in der Anwendung existierenden temporären Queues zurück.

Datenstruktur kc_queue_str

char qu_name[8];

char qlev[5];

char queue_length[8];

char q_mode;

Die Felder der Datenstruktur haben die folgende Bedeutung:

qu_name

Name, der beim Erzeugen der Queue mit QCRE vereinbart oder von UTM automatisch vergeben wurde.

qlev

enthält die maximale Anzahl von Nachrichten, die gleichzeitig in der Queue stehen dürfen.

UTM berücksichtigt die für die Queue erzeugten Nachrichten erst am Ende der Transaktion. Daher kann die in qlev festgelegte Anzahl von Nachrichten für eine Message Queue überschritten werden, wenn in einer Transaktion mehrere Nachrichten für dieselbe Queue erzeugt wurden.

qlev=32767 bedeutet, dass die Anzahl der Nachrichten in der Queue nicht beschränkt ist.

queue_length

enthält die Anzahl der Nachrichten in der Queue, die gerade bearbeitet werden oder auf Bearbeitung warten.

q_mode

zeigt an, wie sich UTM verhält, wenn die maximale Anzahl der erlaubten Nachrichten für die Queue erreicht ist. Mögliche Werte sind:

'S'	(STD) UTM lehnt weitere Nachrichten für diese Queue ab.
'W'	(WRAP-AROUND) UTM nimmt weitere Nachrichten auf. Beim Eintrag einer neuen Nachricht wird die älteste in der Queue stehende Nachricht gelöscht.