MQSeries-Kontexteigenschaften
Der MQSeries-Adapter bietet eine Reihe von Kontexteigenschaften, die für MQSeries spezifisch sind und die in Ihren Anwendungen verwendet werden können. Sie können diese Eigenschaften in Filterausdrücken und in Ihren Orchestrierungen verwenden.
Wenn Sie MQSeries-Kontexteigenschaften einer Nachricht zuweisen möchten, die an einen Sendeport gerichtet ist, der an den MQSeries-Adapter gebunden ist, dann verwenden Sie den Nachrichtenzuweisungsoperator, und geben Sie eine der verfügbaren Kontexteigenschaften im MQSeries-Namespace an.
Im Folgenden finden Sie ein Beispiel für das Festlegen der mqSeries-MQMD_UserIdentifier-Eigenschaft :
Message_2(MQSeries.MQMD_UserIdentifier) = "MeMyselfAndI";
Sie müssen aufgezählte Werte aus den Headerdateien der C-Programmiersprache abrufen, die im IBM MQSeries SDK enthalten sind. Diese Dateien befinden sich im Ordner Programme\IBM\WebSphere MQ\Tools\c\include. Diese Dateien definieren die beim Festlegen oder Lesen der MQSeries-Kontexteigenschaftenwerte zu verwendenden Werte.
Hexadezimale Zeichenfolgenwerte sind Zeichenfolgen, die Binärwerte darstellen. Sie besitzen kein Präfix wie „0x“. Die enthalten Ziffern von 0 bis 9 und Buchstaben von „a“ bis „f“ oder von „A“ bis „F“. Der Adapter ignoriert darin enthaltene Leerzeichen.
Weitere Informationen zu diesen Eigenschaften finden Sie in der IBM WebSphere MQ-Dokumentation.
In der folgenden Tabelle wird der komplette Satz der verfügbaren Message Descriptor-Eigenschaften (MQMD-Struktur) zusammen mit den entsprechenden Typen und Werten angezeigt.
| Name | Typ | Länge | Wert |
|---|---|---|---|
| MQMD_AccountingToken | Zeichenfolge | 64 | Hexadezimale Zeichenfolge |
| MQMD_ApplIdentityData | Zeichenfolge | 32 | Hexadezimale Zeichenfolge |
| MQMD_ApplOriginData | Zeichenfolge | 4 | String Standard: Leerzeichen |
| MQMD_BackoutCount | unsigned int | 4 | Number Nur Lesezugriff Standardwert: 0 |
| MQMD_CodedCharSetId | unsigned int | 4 | Number Standardwert: 0 |
| MQMD_CorrelId | Zeichenfolge | 48 | Hexadezimale Zeichenfolge |
| MQMD_Encoding | unsigned int | 4 | Number Headerdateiwert verwenden. Standardwert: 0 |
| MQMD_Expiry | unsigned int | 4 | Number |
| MQMD_Feedback | unsigned int | 4 | Number Headerdateiwert verwenden. Standardwert: 0 |
| MQMD_Format | Zeichenfolge | 8 | String Wenn auf MQXMIT eingestellt, müssen Sie sicherstellen, dass die MQXQH-Eigenschaften Werte besitzen. |
| MQMD_GroupID | Zeichenfolge | 48 | Hexadezimale Zeichenfolge |
| MQMD_MsgFlags | unsigned int | 4 | Number Headerdateiwert verwenden. Standardwert: 0 |
| MQMD_MsgId | Zeichenfolge | 48 | Hexadezimale Zeichenfolge |
| MQMD_MsgSeqNumber | unsigned int | 4 | |
| MQMD_MsgType | unsigned int | 4 | Number Headerdateiwert verwenden. |
| MQMD_Offset | unsigned int | 4 | |
| MQMD_OriginalLength | unsigned int | 4 | |
| MQMD_Persistence | unsigned int | 4 | Number Headerdateiwert verwenden. |
| MQMD_Priority | unsigned int | 4 | Number |
| MQMD_PutApplName | Zeichenfolge | 28 | String Standard: Leerzeichen |
| MQMD_PutApplType | unsigned int | 4 | Number Headerdateiwert verwenden. Standardwert: 0 |
| MQMD_PutDate | Zeichenfolge | 8 | Date |
| MQMD_PutTime | Zeichenfolge | 8 | Time |
| MQMD_ReplyToQ | Zeichenfolge | 48 | String Standard: Leerzeichen |
| MQMD_ReplyToQMgr | Zeichenfolge | 48 | String Standard: Leerzeichen |
| MQMD_Report | unsigned int | 4 | Number Headerdateiwert verwenden. |
| MQMD_UserIdentifier | Zeichenfolge | 12 | String Enthält den Benutzerbezeichner, wenn Sie die SSOAffiliateApplication-Eigenschaft verwenden. |
Wenn Nachrichten direkt aus MQSeries-Übertragungswarteschlangen empfangen werden, dann formatiert der MQSeries-Adapter die Headereigenschaften der Übertragungswarteschlange (die MQXQH-Datenstruktur) und stellt sie in ihre entsprechenden Kontexteigenschaften. Beim direkten Senden von Nachrichten an MQSeries-Übertragungswarteschlangen werden die Headereigenschaften nur formatiert und Werten aus den entsprechenden Kontexteigenschaften zugewiesen, wenn die MQMD_Format-Eigenschaft den Wert MQXMIT aufweist. In der folgenden Tabelle werden die Eigenschaften beschrieben.
| Name | Typ | Länge | Wert |
|---|---|---|---|
| MQXQH_RemoteQMgrName | Zeichenfolge | 48 | Zeichenfolge |
| MQXQH_RemoteQName | Zeichenfolge | 48 | Zeichenfolge |
Zusammen mit den zuvor in diesem Thema aufgeführten Eigenschaften füllt der Adapter die folgenden Message Descriptor-Werte, wobei dieselben Regeln befolgt werden. Der Adapter stellt diesen Eigenschaftennamen das Präfix MQXQH_ anstelle von MQMD_ voran, aber ansonsten werden sie direkt den Eigenschaften zugeordnet, die in der Message Descriptor-Tabelle definiert sind:
MQXQH_MsgDesc_AccountingToken
MQXQH_MsgDesc_ApplIdentityData
MQXQH_MsgDesc_ApplOriginData
MQXQH_MsgDesc_BackoutCount
MQXQH_MsgDesc_CodedCharSetId
MQXQH_MsgDesc_CorrelId
MQXQH_MsgDesc_Encoding
MQXQH_MsgDesc_Expiry
MQXQH_MsgDesc_Feedback
MQXQH_MsgDesc_Format
MQXQH_MsgDesc_MsgId
MQXQH_MsgDesc_MsgType
MQXQH_MsgDesc_Persistence
MQXQH_MsgDesc_Priority
MQXQH_MsgDesc_PutApplName
MQXQH_MsgDesc_PutApplType
MQXQH_MsgDesc_PutDate
MQXQH_MsgDesc_PutTime
MQXQH_MsgDesc_ReplyToQ
MQXQH_MsgDesc_ReplyToQMgr
MQXQH_MsgDesc_Report
MQXQH_MsgDesc_UserIdentifier
Es sind zusätzliche MQSeries-bezogene Eigenschaften im Eigenschaftenschema enthalten, die in Filterausdrücken verwendet werden können. In der folgenden Tabelle werden diese Eigenschaften aufgeführt.
| Name | Typ | Länge | Wert |
|---|---|---|---|
| MQCIH_AbendCode | Zeichenfolge | 4 | |
| MQCIH_ADSDescriptor | unsigned int | 4 | |
| MQCIH_AttentionId | Zeichenfolge | 4 | |
| MQCIH_Authenticator | Zeichenfolge | 8 | Legen Sie das SSO-Kennwort fest, wenn Sie die SSOAffiliateApplication-Eigenschaft verwenden. Hinweis: Dieser Wert wird vom MQSeries-Adapter auf leer festgelegt, wenn die Länge des SSO-Kennworts 8 Zeichen überschreitet. |
| MQCIH_CancelCode | Zeichenfolge | 4 | |
| MQCIH_CompCode | unsigned int | 4 | |
| MQCIH_ConversationalTask | unsigned int | 4 | |
| MQCIH_CursorPosition | unsigned int | 4 | |
| MQCIH_ErrorOffset | unsigned int | 4 | |
| MQCIH_Facility | Zeichenfolge | 16 | Hexadezimale Zeichenfolge |
| MQCIH_FacilityKeepTime | unsigned int | 4 | |
| MQCIH_FacilityLike | Zeichenfolge | 4 | |
| MQCIH_Flags | unsigned int | 4 | |
| MQCIH_Format | Zeichenfolge | ||
| MQCIH_Function | Zeichenfolge | 4 | |
| MQCIH_GetWaitInterval | unsigned int | 4 | |
| MQCIH_LinkType | unsigned int | 4 | |
| MQCIH_NextTransactionId | Zeichenfolge | 4 | |
| MQCIH_OutputDataLength | unsigned int | 4 | |
| MQCIH_Reason | unsigned int | 4 | |
| MQCIH_ReplyToFormat | Zeichenfolge | ||
| MQCIH_ReturnCode | unsigned int | 4 | |
| MQCIH_StartCode | Zeichenfolge | 4 | |
| MQCIH_TaskEndStatus | unsigned int | 4 | |
| MQCIH_TransactionId | Zeichenfolge | 4 | |
| MQCIH_UOWControl | unsigned int | 4 | |
| MQIIH_Authenticator | Zeichenfolge | 8 | Legen Sie das SSO-Kennwort fest, wenn Sie die SSOAffiliateApplication-Eigenschaft verwenden. Hinweis: Dieser Wert wird vom MQSeries-Adapter auf leer festgelegt, wenn die Länge des SSO-Kennworts 8 Zeichen überschreitet. |
| MQIIH_CommitMode | Zeichenfolge | ||
| MQIIH_Flags | unsigned int | 4 | |
| MQIIH_Format | Zeichenfolge | ||
| MQIIH_LTermOverride | Zeichenfolge | 8 | |
| MQIIH_MFSMapName | Zeichenfolge | 8 | |
| MQIIH_ReplyToFormat | Zeichenfolge | ||
| MQIIH_SecurityScope | Zeichenfolge | ||
| MQIIH_TranInstanceId | Zeichenfolge | 32 | Hexadezimale Zeichenfolge |
| MQIIH_TranState | Zeichenfolge |
Weitere Informationen
MQSeries-Adaptereigenschaften
Auf BizTalk Server bezogene Eigenschaften
Datentypkonvertierung von Eigenschaften