MQSeries 內容屬性
MQSeries 配接器提供一組 MQSeries 專用的內容屬性,可在應用程式中使用。 您可以在篩選運算式與協調流程中使用這些屬性。
若要指派 MQSeries 內容屬性給要傳送到繫結至 MQSeries 配接器之傳送埠的訊息,請使用訊息設定運算子,然後在 MQSeries 命名空間中指定其中一個可用的內容屬性。
以下是設定 MQSeries MQMD_UserIdentifier 屬性的範例:
Message_2(MQSeries.MQMD_UserIdentifier) = "MeMyselfAndI";
您必須從 IBM MQSeries SDK 所含的 C 程式設計語言標頭檔中取得列舉值。 您可以在 Program Files\IBM\WebSphere MQ\Tools\c\include 資料夾中找到這些檔案。 這些檔案定義在設定或讀取 MQSeries 內容屬性值時所要使用的值。
十六進位字串值是代表二進位值的字元字串。 它們沒有諸如 0x 的前置詞。 它們包含從 0 至 9 的數字,以及從 "a" 至 "f" 或 "A" 至 "F" 的字母。 此配接器會忽略其中的空白。
如需有關這些屬性的詳細資訊,請參閱 IBM WebSphere MQ 文件。
下表顯示一組完整、可用的「訊息描述元」(MQMD 結構)」屬性及其對應的類型與值。
名稱 | 類型 | 長度 | 值 |
---|---|---|---|
MQMD_AccountingToken | 字串 | 64 | 十六進位字串 |
MQMD_ApplIdentityData | 字串 | 32 | 十六進位字串 |
MQMD_ApplOriginData | 字串 | 4 | 字串 預設值: 空格 |
MQMD_BackoutCount | 不帶正負號的整數 | 4 | 數字 唯讀 預設值: 0 |
MQMD_CodedCharSetId | 不帶正負號的整數 | 4 | 數字 預設值: 0 |
MQMD_CorrelId | 字串 | 48 | 十六進位字串 |
MQMD_Encoding | 不帶正負號的整數 | 4 | 數字 使用標頭檔值。 預設值: 0 |
MQMD_Expiry | 不帶正負號的整數 | 4 | 數字 |
MQMD_Feedback | 不帶正負號的整數 | 4 | 數字 使用標頭檔值。 預設值: 0 |
MQMD_Format | 字串 | 8 | 字串 若設為 MQXMIT,請確定 MQXQH 屬性有值。 |
MQMD_GroupID | 字串 | 48 | 十六進位字串 |
MQMD_MsgFlags | 不帶正負號的整數 | 4 | 數字 使用標頭檔值。 預設值: 0 |
MQMD_MsgId | 字串 | 48 | 十六進位字串 |
MQMD_MsgSeqNumber | 不帶正負號的整數 | 4 | |
MQMD_MsgType | 不帶正負號的整數 | 4 | 數字 使用標頭檔值。 |
MQMD_Offset | 不帶正負號的整數 | 4 | |
MQMD_OriginalLength | 不帶正負號的整數 | 4 | |
MQMD_Persistence | 不帶正負號的整數 | 4 | 數字 使用標頭檔值。 |
MQMD_Priority | 不帶正負號的整數 | 4 | 數字 |
MQMD_PutApplName | 字串 | 28 | 字串 預設值: 空格 |
MQMD_PutApplType | 不帶正負號的整數 | 4 | 數字 使用標頭檔值。 預設值: 0 |
MQMD_PutDate | 字串 | 8 | Date |
MQMD_PutTime | 字串 | 8 | 時間 |
MQMD_ReplyToQ | 字串 | 48 | 字串 預設值: 空格 |
MQMD_ReplyToQMgr | 字串 | 48 | 字串 預設值: 空格 |
MQMD_Report | 不帶正負號的整數 | 4 | 數字 使用標頭檔值。 |
MQMD_UserIdentifier | 字串 | 12 | 字串 當您使用 SSOAffiliateApplication 屬性時,會包含使用者識別碼。 |
直接從 MQSeries 傳輸佇列接收訊息時,MQSeries 配接器會將傳輸佇列標頭屬性 (MQXQH 資料結構) 格式化,然後放在對應的內容屬性中。 直接將訊息傳送至 MQSeries 傳輸佇列時,只有當 MQMD_Format 屬性具有 MQXMIT 的值時,標頭屬性才會格式化並指派來自對應內容屬性的值。 下表描述這些屬性。
名稱 | 類型 | 長度 | 值 |
---|---|---|---|
MQXQH_RemoteQMgrName | 字串 | 48 | 字串 |
MQXQH_RemoteQName | 字串 | 48 | 字串 |
此配接器會根據相同規則將本主題稍早所列的屬性一起填入下列「訊息描述元」值中。 此配接器會在這些屬性名稱之前加上 MQXQH_ 而不是 MQMD_,否則它們會直接對應至「訊息描述元」表格中所定義的那些屬性:
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
在屬性結構描述中還包含其他與 MQSeries 相關的屬性,並可用於篩選運算式中。 下表列出這些屬性。
名稱 | 類型 | 長度 | 值 |
---|---|---|---|
MQCIH_AbendCode | 字串 | 4 | |
MQCIH_ADSDescriptor | 不帶正負號的整數 | 4 | |
MQCIH_AttentionId | 字串 | 4 | |
MQCIH_Authenticator | 字串 | 8 | 當您使用 SSOAffiliateApplication 屬性時,請設定為 SSO 密碼。 注意: 如果 SSO 密碼長度超過 8 個字元,MQSeries 配接器會將此值設定為空白。 |
MQCIH_CancelCode | 字串 | 4 | |
MQCIH_CompCode | 不帶正負號的整數 | 4 | |
MQCIH_ConversationalTask | 不帶正負號的整數 | 4 | |
MQCIH_CursorPosition | 不帶正負號的整數 | 4 | |
MQCIH_ErrorOffset | 不帶正負號的整數 | 4 | |
MQCIH_Facility | 字串 | 16 | 十六進位字串 |
MQCIH_FacilityKeepTime | 不帶正負號的整數 | 4 | |
MQCIH_FacilityLike | 字串 | 4 | |
MQCIH_Flags | 不帶正負號的整數 | 4 | |
MQCIH_Format | 字串 | ||
MQCIH_Function | 字串 | 4 | |
MQCIH_GetWaitInterval | 不帶正負號的整數 | 4 | |
MQCIH_LinkType | 不帶正負號的整數 | 4 | |
MQCIH_NextTransactionId | 字串 | 4 | |
MQCIH_OutputDataLength | 不帶正負號的整數 | 4 | |
MQCIH_Reason | 不帶正負號的整數 | 4 | |
MQCIH_ReplyToFormat | 字串 | ||
MQCIH_ReturnCode | 不帶正負號的整數 | 4 | |
MQCIH_StartCode | 字串 | 4 | |
MQCIH_TaskEndStatus | 不帶正負號的整數 | 4 | |
MQCIH_TransactionId | 字串 | 4 | |
MQCIH_UOWControl | 不帶正負號的整數 | 4 | |
MQIIH_Authenticator | 字串 | 8 | 當您使用 SSOAffiliateApplication 屬性時,請設定為 SSO 密碼。 注意: 如果 SSO 密碼長度超過 8 個字元,MQSeries 配接器會將此值設定為空白。 |
MQIIH_CommitMode | 字串 | ||
MQIIH_Flags | 不帶正負號的整數 | 4 | |
MQIIH_Format | 字串 | ||
MQIIH_LTermOverride | 字串 | 8 | |
MQIIH_MFSMapName | 字串 | 8 | |
MQIIH_ReplyToFormat | 字串 | ||
MQIIH_SecurityScope | 字串 | ||
MQIIH_TranInstanceId | 字串 | 32 | 十六進位字串 |
MQIIH_TranState | 字串 |