メッセージキューイングアクセス機能 TP1/Message Queue - Access 使用の手引
JMSメッセージとTP1/Message Queueのメッセージとの対応
MQCクライアント機能のJMSインタフェースで作成したメッセージ(JMSメッセージ)と,TP1/Message Queueのメッセージとの対応を次の図に示します。
図7-3 JMSメッセージとTP1/Message Queueのメッセージとの対応
JMSメッセージは,ヘッダ,プロパティ,およびメッセージ本体で構成されています。
一般的なJMSメッセージのヘッダは,クライアントとプロバイダの双方がメッセージを識別・送信するための値を含みます。プロパティは,アプリケーション固有の値を格納するためのフィールドを定義する組み込み機能を提供します。
TP1/Message Queue - Accessでは,図7-3に示すとおり,JMSメッセージのヘッダとプロパティがMQMD構造体に対応づけられてキューに格納されます。また,プロパティは,MQMD構造体の各フィールドに値を設定・取得するために使用されます。アプリケーション固有のプロパティ値はTP1/Message Queueのキューには格納されません。
JMSヘッダと対応するMQMD構造体のフィールド,およびJMSプロパティと対応するMQMD構造体のフィールドを次の表に示します。設定者が「クライアント」以外のヘッダは指定できません。
ヘッダ | 型 | 対応するMQMD構造体のフィールド | 設定者 | 備考 |
---|---|---|---|---|
JMSDestination | Destination | − | 送信時プロバイダ | 送信時に設定しても無視されます。 |
JMSMessageID | String | MsgId | 送信時プロバイダ | 送信時に設定しても無視されます。 |
JMSTimestamp | long | PutDate,PutTime | 送信時プロバイダ | 送信時に設定しても無視されます。 |
JMSRedelivered | boolean | BackoutCount | 受信時プロバイダ | 送信時に設定しても無視されます。 |
JMSCorrelationID | String※1 | CorrelId | クライアント(Message) | − |
JMSReplyTo | Destination | ReplyToQ,ReplyToQMgr | クライアント(Message) | − |
JMSType | String | − | クライアント(Message) | TP1/Message Queueでは使用されません。 |
JMSDeliveryMode | int | Persistence | クライアント(QueueSender) | − |
JMSExpiration | long | Expiry | クライアント(QueueSender) | − |
JMSPriority | int | Priority | クライアント(QueueSender) | − |
表7-6 JMSプロパティと対応するMQMD構造体のフィールド
プロパティ | 型 | 対応するMQMD構造体のフィールド | 設定者 | 備考 |
---|---|---|---|---|
JMSXAppID | String | PutApplName | 送信時プロバイダ | 送信時に設定しても無視されます。 |
JMSXUserID | String | UserIdentifier | 送信時プロバイダ | 送信時に設定しても無視されます。 |
JMSXDeliveryCount | int | BackoutCount | 受信時プロバイダ | 送信時に設定しても無視されます。 |
JMSXGroupID※1 | String※2 | GroupId | クライアント(Message) | − |
JMSXGroupSeq | int | MsgSeqNumber | クライアント(Message) | − |
JMS_HITACHI_PutApplType | int | PutApplType | 送信時プロバイダ | 送信時に設定しても無視されます。 |
JMS_HITACHI_CodedCharSetId | int | CodedCharSetId | クライアント(Message) | − |
JMS_HITACHI_Encoding | int | Encoding | クライアント(Message) | − |
JMS_HITACHI_Feedback | int | Feedback | クライアント(Message) | − |
JMS_HITACHI_MsgType | int | MsgType | クライアント(Message) | − |
JMS_HITACHI_Report | int | Report | クライアント(Message) | − |
JMS_HITACHI_Format | String※3 | Format | クライアント(Message) | − |
JMS_HITACHI_MQMF_LAST_MSG_IN_GROUP※1 | boolean | MsgFlags | クライアント(Message) | − |
JMSXGroupIDの文字列 | JMS_HITACHI_MQMF_LAST_MSG_IN_GROUPの値 | |
---|---|---|
false | true | |
無効 | MQMF_NONE | |
有効 | MQMF_MSG_IN_GROUP | MQMF_LAST_MSG_IN_GROUP |
JMSプロパティに設定できる型は,boolean,byte,short,int,long,float,double,およびStringです。書き込まれたときとは異なる型でJMSプロパティを読み込む場合,次の表に示すように型が変換されます。
表7-7 JMSプロパティの型変換
プロパティの型 | 読み込むときの型 | ||||||||
---|---|---|---|---|---|---|---|---|---|
boolean | byte | short | int | long | float | double | String | ||
書き込まれたときの型 | boolean | ○ | ○ | ||||||
byte | ○ | ○ | ○ | ○ | ○ | ||||
short | ○ | ○ | ○ | ○ | |||||
int | ○ | ○ | ○ | ||||||
long | ○ | ○ | |||||||
float | ○ | ○ | ○ | ||||||
double | ○ | ○ | |||||||
String※ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
All Rights Reserved. Copyright (C) 2006, 2007, Hitachi, Ltd.
(C) Copyright International Business Machines Corporation 1994, 1999. All rights reserved.