IBM MQ のメッセージグループでメッセージを送信する

MQOutput ノードは、 IBM® MQ メッセージグループを構成する複数のメッセージを送信できます。 Compute ノードまたは JavaCompute ノードを設定し、MQMDフィールドを設定してメッセージグループのオプションを指定します。

このタスクの概要

メッセージ・フローでは、以下の MQMD フィールドを設定する必要があります。
  • GroupId
  • MsgSeqNumber
  • MsgFlags
Compute ノードで以下の ESQL コードの例を使用することができます。これは、これらのフィールドの設定方法を示しています。
DECLARE MSGNUM INT 0;
  DECLARE MSGTOTAL INT 5;
  WHILE MSGNUM < MSGTOTAL DO
    SET MSGNUM = MSGNUM + 1;
    CALL CopyMessageHeaders();
    -- Manually set the groupId since we cant ask the queue manager to generate one.
    -- the UUIDASBLOB function could be used here to generate one, but this must be done
    -- outside the loop to keep the same groupId throughout!
    SET OutputRoot.MQMD.GroupId = X'000000000000000000000000000000000000000000000001';
    SET OutputRoot.MQMD.MsgSeqNumber = MSGNUM;
    SET OutputRoot.MQMD.MsgFlags = MQMF_MSG_IN_GROUP;
    IF (MSGNUM = MSGTOTAL) THEN
      SET OutputRoot.MQMD.MsgFlags = MQMF_LAST_MSG_IN_GROUP;
    END IF;
    SET OutputRoot.XML.TestCase = MSGNUM;
    PROPAGATE;
  END WHILE;
  RETURN FALSE;

JavaCompute ノードでは、以下の Java™ コードの例を使用できます。これは、これらのフィールドの設定方法を示しています。
public class mq_group_java_JavaCompute extends MbJavaComputeNode {
      public void evaluate(MbMessageAssembly assembly) throws MbException {
        MbOutputTerminal out = getOutputTerminal("out");
        int MSGTOTAL = 5;
        for(int MSGNUM = 1 ; MSGNUM <= MSGTOTAL;MSGNUM++){
           MbMessage newMessage = new MbMessage();
           MbElement root = newMessage.getRootElement();
           MbElement mqmd = root.createElementAsFirstChild("MQMD");
           mqmd.createElementAsLastChild(MbElement.TYPE_NAME_VALUE, 
           "GroupId", new byte[]{0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1});
           mqmd.createElementAsLastChild(MbElement.TYPE_NAME_VALUE, "MsgSeqNumber", MSGNUM);
           if (MSGNUM == MSGTOTAL){
               mqmd.createElementAsLastChild(MbElement.TYPE_NAME_VALUE, 
               "MsgFlags", 16); // MQMF_LAST_MSG_IN_GROUP 0x00000010
           }
           else{
               mqmd.createElementAsLastChild(MbElement.TYPE_NAME_VALUE, 
               "MsgFlags", 8);  // MQMF_MSG_IN_GROUP      0x00000008
           }
           MbElement xmlnsc = root.createElementAsLastChild("XMLNSC");
           MbElement body = xmlnsc.createElementAsLastChild(MbElement.TYPE_NAME,"TestCase",null);
           body.setValue(MSGNUM);
           MbMessageAssembly newAssembly = new MbMessageAssembly(assembly,newMessage);
           out.propagate(newAssembly);
        }
    }
}

メッセージ・フローが 1 つの入力メッセージから複数のメッセージを送信する場合、GroupId 値を作成し、MsgSeqNumber 値を増分して、MsgFlags フィールドを設定することができます。 ESQL および Java コードの例は、これらの値を設定する方法を示しています。 ただし、メッセージ・フローが複数の入力メッセージから複数のメッセージを送信する場合には、メッセージ・フローはフロー・インスタンス間で GroupId 値と MsgSeqNumber 値を保管する必要があります。共有変数を使用することで、これが可能になります。

メッセージのグループ化に関する詳細については、 IBM MQ のオンライン製品ドキュメント「メッセージグループ」 の項目を参照してください。 IBM MQ フィールドの詳細については、 IBM MQ の製品ドキュメント(オンライン版)「MQMD - メッセージ記述子」 を参照してください。