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 von der Warteschlangeneigenschaft PropertyControl definiert dargestellt werden. Wenn ein Nachrichtenhandle (
MsgHandle
) angegeben ist, wird diese Option ignoriert und die Eigenschaften der Nachricht sind mitMsgHandle
verfügbar, wenn der Wert der Warteschlangeneigenschaft PropertyControl nichtMQPROP_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 dem Präfix "mcd.", "jms.", "usr." oder "mqext." enthält, werden alle Nachrichteneigenschaften der Anwendung in einem MQRFH2-Header zugestellt. 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.