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 Felds Options
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 keine Nachrichtenkennung 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, dann 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
- Dieser Wert bedeutet, 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.