MQ Get-Nachrichtenoptionen
MQ Get-Nachrichtenoptionen steuern die Aktion von MQGET.
- Hinzufügen (fügen Sie dieselbe Konstante nicht mehrmals hinzu) oder
- Mithilfe der Operation 'bitweises ODER' kombinieren (wenn die Programmiersprache Bitoperationen unterstützt).
Der Anfangswert des Feldes Optionen ist MQGMO_NO_WAIT plus MQGMO_PROPERTIES_AS_Q_DEF.
Eigenschaftsoptionen
- MQGMO_PROPERTIES_AS_Q_DEF
Eigenschaften der Nachricht, mit Ausnahme der Eigenschaften im Nachrichtendeskriptor (bzw. in der Erweiterung) müssen so wie vom Warteschlangenattribut PropertyControl definiert dargestellt werden. Wenn ein Nachrichtenhandle (MsgHandle) angegeben ist, wird diese Option ignoriert und die Eigenschaften der Nachricht sind mit MsgHandle verfügbar, wenn der Wert des Warteschlangenattributs PropertyControl nicht MQPROP_FORCE_MQRFH2 ist.
Dies ist die Standardaktion, wenn keine Eigenschaftenoptionen angegeben sind.
- MQGMO_PROPERTIES_IN_HANDLE
Eigenschaften der Nachricht müssen mithilfe des Nachrichtenhandles (MsgHandle) zur Verfügung gestellt werden. Wenn kein Nachrichtenhandle angegeben ist, schlägt der Aufruf mit der Ursache MQRC_HMSG_ERROR fehl.
- MQGMO_NO_PROPERTIES
Es werden keine Eigenschaften der Nachricht, mit Ausnahme der Eigenschaften im Nachrichtendeskriptor (bzw. in der Erweiterung), abgerufen. Wenn ein Nachrichtenhandle (MsgHandle) angegeben ist, wird es ignoriert.
- MQGMO_PROPERTIES_FORCE_MQRFH2
Eigenschaften der Nachricht, mit Ausnahme der Eigenschaften im Nachrichtendeskriptor (bzw. in der Erweiterung), müssen mithilfe der MQRFH2-Header dargestellt werden. Dadurch wird für Anwendungen, die das Abrufen von Eigenschaften erwarten, jedoch nicht so geändert werden können, dass sie Nachrichtenhandle verwenden, die Kompatibilität mit älteren Version gewährleistet. Wenn ein Nachrichtenhandle (MsgHandle) angegeben ist, wird es ignoriert.
- MQGMO_PROPERTIES_COMPATIBILITY
- Wenn die Nachricht eine Eigenschaft mit einem der folgenden Präfixe enthält, werden alle Nachrichteneigenschaften der Anwendung in einem MQRFH2-Header zugestellt: mcd., jms., usr. oder mqext.. Andernfalls werden alle Eigenschaften der Nachricht, außer den Eigenschaften, die im Nachrichtendeskriptor (oder in der Erweiterung) enthalten sind, gelöscht und sind nicht mehr für die Anwendung verfügbar.
Standardoption
- MQGMO_NONE
- Verwenden Sie diesen Wert, um anzugeben, dass keine anderen Optionen angegeben wurden. Alle Optionen nehmen ihre Standardwerte an. MQGMO_NONE unterstützt die Programmdokumentation. Diese Option soll mit keiner anderen Option verwendet werden, aber da ihr Wert null ist, kann solch eine Verwendung nicht erkannt werden.