MQ Get-Nachrichtenoptionen

MQ Get-Nachrichtenoptionen steuern die Aktion von MQGET.

Sie können keine, eine oder mehrere der Optionen angeben, die weiter unten in diesem Abschnitt beschrieben werden. Wenn Sie mehrere Optionen benötigen, können Sie folgende Aktionen mit den Werten ausführen:
  • 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

Die folgenden Optionen beziehen sich auf die Eigenschaften der Nachricht:
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 mit MsgHandle verfügbar, wenn der Wert der Warteschlangeneigenschaft 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 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

Wenn keine der Optionen, die zuvor beschrieben wurden, erforderlich ist, kann die folgende Option verwendet werden:
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.