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 コンテキスト プロパティ値の設定または読み取りを行うときに使用する値が定義されています。
16 進数文字列値は、バイナリ値を表す文字列です。 これらの文字列値に 0x などのプレフィックスは付いていません。 0 ～ 9 の数字と、a ～ f、または A ～ F の文字が含まれています。 MQSeries アダプタでは、スペースは無視されます。
これらのプロパティの詳細については、IBM WebSphere MQ のドキュメントを参照してください。
次の表は、使用可能なメッセージ記述子 (MQMD 構造) プロパティの完全なセットと、それらに対応する型と値を示しています。
| 名前 | Type | 長さ | 値 |
|---|---|---|---|
| MQMD_AccountingToken | string | 64 | 16 進数文字列 |
| MQMD_ApplIdentityData | string | 32 | 16 進数文字列 |
| MQMD_ApplOriginData | string | 4 | String 既定値: スペース |
| MQMD_BackoutCount | unsigned int | 4 | 数値 読み取り専用 既定値: 0 |
| MQMD_CodedCharSetId | unsigned int | 4 | 数値 既定値: 0 |
| MQMD_CorrelId | string | 48 | 16 進数文字列 |
| MQMD_Encoding | unsigned int | 4 | 数値 ヘッダー ファイルの値を使用します。 既定値: 0 |
| MQMD_Expiry | unsigned int | 4 | 数値 |
| MQMD_Feedback | unsigned int | 4 | 数値 ヘッダー ファイルの値を使用します。 既定値: 0 |
| MQMD_Format | string | 8 | String MQXMIT に設定した場合、MQXQH プロパティに値が設定されていることを確認してください。 |
| MQMD_GroupID | string | 48 | 16 進数文字列 |
| MQMD_MsgFlags | unsigned int | 4 | 数値 ヘッダー ファイルの値を使用します。 既定値: 0 |
| MQMD_MsgId | string | 48 | 16 進数文字列 |
| MQMD_MsgSeqNumber | unsigned int | 4 | |
| MQMD_MsgType | unsigned int | 4 | 数値 ヘッダー ファイルの値を使用します。 |
| MQMD_Offset | unsigned int | 4 | |
| MQMD_OriginalLength | unsigned int | 4 | |
| MQMD_Persistence | unsigned int | 4 | 数値 ヘッダー ファイルの値を使用します。 |
| MQMD_Priority | unsigned int | 4 | 数値 |
| MQMD_PutApplName | string | 28 | String 既定値: スペース |
| MQMD_PutApplType | unsigned int | 4 | 数値 ヘッダー ファイルの値を使用します。 既定値: 0 |
| MQMD_PutDate | string | 8 | Date |
| MQMD_PutTime | string | 8 | Time |
| MQMD_ReplyToQ | string | 48 | String 既定値: スペース |
| MQMD_ReplyToQMgr | string | 48 | String 既定値: スペース |
| MQMD_Report | unsigned int | 4 | 数値 ヘッダー ファイルの値を使用します。 |
| MQMD_UserIdentifier | string | 12 | String SSOAffiliateApplication プロパティを使用する場合のユーザー識別子を格納します。 |
MQSeries 転送キューから直接メッセージを受信するとき、MQSeries アダプタでは、転送キューのヘッダー プロパティ (MQXQH データ構造) をフォーマットし、それらを対応するコンテキスト プロパティに配置します。 MQSeries 伝送キューにメッセージを直接送信する場合、ヘッダー・プロパティーは、 MQMD_Format ・プロパティーの値が MQXMIT の場合にのみ、対応するコンテキスト・プロパティーからフォーマットされ、値が割り当てられます。 次の表では、ヘッダー プロパティについて説明します。
| 名前 | Type | 長さ | 値 |
|---|---|---|---|
| MQXQH_RemoteQMgrName | string | 48 | string |
| MQXQH_RemoteQName | string | 48 | string |
ここまで記載したプロパティに加えて、アダプタでは、同じ規則に従って次のメッセージ記述子の値を作成します。 アダプタによってこれらのプロパティ名に付けられるプレフィックスは MQMD_ ではなく MQXQH_ ですが、それ以外の場合はこれらのプロパティ名が、メッセージ記述子テーブルで定義されているプロパティに直接マップされます。
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 関連のプロパティが他にも含まれています。 次の表は、これらのプロパティを示しています。
| 名前 | Type | 長さ | 値 |
|---|---|---|---|
| MQCIH_AbendCode | string | 4 | |
| MQCIH_ADSDescriptor | unsigned int | 4 | |
| MQCIH_AttentionId | string | 4 | |
| MQCIH_Authenticator | string | 8 | SSOAffiliateApplication プロパティを使用する場合は、SSO パスワードに設定します。 メモ： SSO パスワードの長さが 8 文字を超える場合、この値は MQSeries アダプターによってブランクに設定されます。 |
| MQCIH_CancelCode | string | 4 | |
| MQCIH_CompCode | unsigned int | 4 | |
| MQCIH_ConversationalTask | unsigned int | 4 | |
| MQCIH_CursorPosition | unsigned int | 4 | |
| MQCIH_ErrorOffset | unsigned int | 4 | |
| MQCIH_Facility | string | 16 | 16 進数文字列 |
| MQCIH_FacilityKeepTime | unsigned int | 4 | |
| MQCIH_FacilityLike | string | 4 | |
| MQCIH_Flags | unsigned int | 4 | |
| MQCIH_Format | string | ||
| MQCIH_Function | string | 4 | |
| MQCIH_GetWaitInterval | unsigned int | 4 | |
| MQCIH_LinkType | unsigned int | 4 | |
| MQCIH_NextTransactionId | string | 4 | |
| MQCIH_OutputDataLength | unsigned int | 4 | |
| MQCIH_Reason | unsigned int | 4 | |
| MQCIH_ReplyToFormat | string | ||
| MQCIH_ReturnCode | unsigned int | 4 | |
| MQCIH_StartCode | string | 4 | |
| MQCIH_TaskEndStatus | unsigned int | 4 | |
| MQCIH_TransactionId | string | 4 | |
| MQCIH_UOWControl | unsigned int | 4 | |
| MQIIH_Authenticator | string | 8 | SSOAffiliateApplication プロパティを使用する場合は、SSO パスワードに設定します。 メモ： SSO パスワードの長さが 8 文字を超える場合、この値は MQSeries アダプターによってブランクに設定されます。 |
| MQIIH_CommitMode | string | ||
| MQIIH_Flags | unsigned int | 4 | |
| MQIIH_Format | string | ||
| MQIIH_LTermOverride | string | 8 | |
| MQIIH_MFSMapName | string | 8 | |
| MQIIH_ReplyToFormat | string | ||
| MQIIH_SecurityScope | string | ||
| MQIIH_TranInstanceId | string | 32 | 16 進数文字列 |
| MQIIH_TranState | string |