メッセージ・ヘッダーのフィールドおよびプロパティーと IBM MQ フォーマット間のマッピング
サービス統合は、メッセージを IBM MQ フォーマットに変換する際、 サービス統合メッセージ・ヘッダーのフィールドおよびプロパティーに基づいて、MQMD および MQRFH2 のフィールドを設定します (メッセージに適用される JMS メッセージ・ヘッダーのフィールドおよびプロパティーなど)。 サービス統合は、メッセージを IBM MQ フォーマットから変換する際、 IBM MQ メッセージの MQMD および MQRFH2 から、サービス統合メッセージ・ヘッダーのフィールドおよびプロパティーを設定します。
サービス統合経由の JMS プログラムと IBM MQ
サービス統合は、文字と数字のエンコードを含め適切な変換を自動的に実行するので、通常はサービス統合と IBM MQ との間で JMS メッセージを交換するためのメッセージ形式の変換を意識する必要はありません。 ただし、ご使用の JMS アプリケーションが予想外の動きをする場合や、サービス統合構成が非 JMS IBM MQ プログラムとの間でメッセージを処理する JMS プログラムまたはメディエーションを含む場合は、メッセージ変換に関する知識が必要になる場合があります。
ご使用のサービス統合アプリケーションが 、IBM MQ アプリケーションと MapMessage オブジェクトを交換する場合、デフォルトではないマップ・メッセージ・エンコード形式を指定する必要がある場合があります。
IBM MQ メッセージ・プロパティー: MQMD および MQRFH2
同様に、サービス統合は、MQRFH2 のないメッセージを生成する IBM MQ アプリケーションからメッセージを受け取ることもできます。 サービス統合は、MQRFH2 のないメッセージを受け取ると、 MQMD からできる限り多くの情報を取得して、その他のフィールドでデフォルト値を使用することによって、 「最も適当と思われる」サービス統合ヘッダーを作成します。
メッセージ記述子およびメッセージ・ヘッダーの内容の詳細については、 IBM MQ アプリケーション・プログラミング・リファレンスを参照してください。IBM MQ が MQMD および MQRFH2 に JMS メッセージのプロパティーおよびヘッダー・フィールドを格納する方法の詳細など、IBM MQ JMS サポートの詳細については、IBM MQ を参照してください。
IBM MQ メッセージ・プロパティー: JMS ヘッダー・フィールド
下表では、メッセージと IBM MQ フォーマット間の変換を行う際の、 サービス統合による JMS ヘッダー・フィールドと MQMD および MQRFH2 フィールド間のマッピングを示します。
MQRFH2 フィールドを folder.field として、表で示しています。この場合、folder はフィールドが含まれている MQRFH2 フォルダーの名前であり、field は MQRFH2 フォルダー内のフィールドの名前です。
いくつかの JMS ヘッダー・フィールドでは、MQMD フィールドと MQRFH2 フィールドの両方があります。 サービス統合は、メッセージを IBM MQ フォーマットに変換する際に、MQMD フィールドと MQRFH2 フィールドの両方を設定します。 サービス統合は、メッセージを IBM MQ フォーマットから変換する際、 MQRFH2 フィールドからの JMS ヘッダー・フィールドが使用可能であればそれを設定し、それ以外の場合は MQMD フィールドからの JMS ヘッダー・フィールドを設定します。
JMS ヘッダー・フィールド | MQMD フィールド | MQRFH2 フィールド | 注意 |
---|---|---|---|
JMSCorrelationID | CorrelId | jms.Cid | 注 1 を参照。 |
JMSDeliveryMode | パーシスタンス | jms.Dlv | 注 15 を参照。 |
JMSDestination | jms.Dst | 注 16 を参照。 | |
JMSExpiration | 有効期限 | jms.Exp | |
JMSMessageID | MsgId | ||
JMSPriority | 優先順位 | 注 2 を参照。 | |
JMSRedelivered | BackoutCount | 注 3 を参照。 | |
JMSReplyTo | ReplyToQ および ReplyToQMgr | jms.Rto | 注 16 を参照。 |
JMSTimestamp | PutDate および PutTime | jms.Tms | |
JMSType | mcd.Type |
IBM MQ メッセージ・プロパティー: JMS 定義のプロパティー
下表では、メッセージと IBM MQ フォーマット間の変換を行う際の、 サービス統合による JMS 定義のプロパティーと MQMD および MQRFH2 フィールド間のマッピングを示します。
MQRFH2 フィールドを folder.field として、表で示しています。この場合、folder はフィールドが含まれている MQRFH2 フォルダーの名前であり、field は MQRFH2 フォルダー内のフィールドの名前です。
いくつかの JMS 定義のプロパティーでは、MQMD フィールドと MQRFH2 フィールドの両方があります。 サービス統合は、メッセージを IBM MQ フォーマットに変換する際に、MQMD フィールドと MQRFH2 フィールドの両方を設定します。 サービス統合は、メッセージを IBM MQ フォーマットから変換する際、MQRFH2 フィールドからの JMS 定義のプロパティーが使用可能であればそれを設定し、それ以外の場合は MQMD フィールドからの JMS 定義のプロパティーを設定します。
JMS 定義のプロパティー | MQMD フィールド | MQRFH2 フィールド | 注意 |
---|---|---|---|
JMSXAppID | PutApplName | ||
JMSXDeliveryCount | BackoutCount | ||
JMSXGroupID | GroupId | jms.Gid | 注 4 および 5 を参照。 |
JMSXGroupSeq | MsgSeqNumber | jms.Seq | |
JMSXUserID | UserIdentifier |
IBM MQ メッセージ・プロパティー: JMS プロバイダー固有プロパティー
下表では、メッセージと WebSphere MQ フォーマット間の変換を行う際の、 サービス統合による JMS プロバイダー固有プロパティーと MQMD および MQRFH2 フィールド間のマッピングを示します。 通常、これらのプロパティーを使用して、受信側アプリケーションで特殊要件を満たすため、受信側アプリケーションの開発者または管理者に、必要なプロパティー値の詳細について問い合わせる必要があります。
JMS プロバイダー固有プロパティー | MQMD フィールド | MQRFH2 フィールド | 注意 |
---|---|---|---|
JMS_IBM_ArmCorrelator | mqext.Arm | 注 6 を参照。 | |
JMS_IBM_Character_Set | CodedCharacterSetId | CodedCharacterSetId | 注 7 を参照。 |
JMS_IBM_Encoding | エンコード | エンコード | 注 7 を参照。 |
JMS_IBM_Feedback | フィードバック | ||
JMS_IBM_Format | フォーマット | フォーマット | 注 7 を参照。 |
JMS_IBM_Last_Msg_In_Group | MQMF_LAST_MSG_IN_GROUP | 注 8 を参照。 | |
JMS_IBM_MQMD_CorrelId | CorrelId | 注 9 および 10 を参照。 | |
JMS_IBM_MQMD_MsgId | MsgId | 注 9 および 11 を参照。 | |
JMS_IBM_MQMD_Persistence | パーシスタンス | 注 9、12、および 15 を参照。 | |
JMS_IBM_MQMD_ReplyToQ | ReplyToQ | 注 9、13、および 16 を参照。 | |
JMS_IBM_MQMD_ReplyToQMgr | ReplyToQMgr | 注 9、13、および 16 を参照。 | |
JMS_IBM_MsgType | MsgType | ||
JMS_IBM_PutDate | PutDate | ||
JMS_IBM_PutTime | PutTime | ||
JMS_IBM_Report_* | レポート | 注 14 を参照。 | |
JMS_IBM_RMCorrelator | mqext.Wrm | ||
JMS_TOG_ARM_Correlator | mqext.Arm | 注 6 を参照。 |
サービス統合は、メッセージを IBM MQ フォーマットから変換する際、 対応する MQMD フィールドからこれらの各プロパティーを設定します。
サービス統合は、メッセージを IBM MQ フォーマットから変換する際、 MQRFH2 jms.Cid フィールドの値が存在してもその値にかかわらず、 JMS_IBM_MQMD_CorrelId プロパティーを MQMD CorrelId フィールドの値 (byte[]) に設定します。
サービス統合は、メッセージを IBM MQ フォーマットから変換する際、 JMS_IBM_MQMD_MsgId プロパティーを MQMD MsgId フィールドの値 (byte[]) に設定します。
サービス統合は、メッセージを IBM MQ フォーマットから変換する際、 MQRFH2 jms.Dlv フィールドの値が存在してもその値にかかわらず、 JMS_IBM_MQMD_Persistence プロパティーを MQMD Persistence フィールドの値 (整数) に設定します。
サービス統合は、メッセージを IBM MQ フォーマットから変換する際、 MQRFH2 jms.Rto フィールドの値が存在してもその値にかかわらず、 JMS_IBM_MQMD_ReplyToQ および JMS_IBM_MQMD_ReplyToQMgr プロパティーを MQMD ReplyToQ および ReplyToQMgr フィールドの値 (ストリング) に設定します。