Running the X12 sample

This topic explains how to put the test messages through the X12 sample message flow.

The input messages

The X12 sample contains the following three test messages.

• PurchaseOrder1.mbtest
• PurchaseOrder2.mbtest
• PurchaseOrder_Missing_BEG.mbtest

All three input messages are 850 Purchase Order messages. The first two input messages are valid. The third input message is not valid: the BEG field is missing from the message.

Running the sample

To run the sample, you must put messages on the input queues, and get messages from the output queues. Follow the instructions below:

1. Put one of the input messages on the X12_TO_XML_IN queue:
   1. In the Message Brokers Toolkit, switch to the Broker Application Development perspective.
   2. In the X12 Message Flows project, double-click one of the .mbtest files to open it in the Test Client.
   3. In the Test Client click Enqueue
   4. Click Send Message. The message in the .mbtest file is written to the queue.

   When you put a message on the X12_TO_XML_IN queue, the X12_TO_XML_IN MQInput node in the first message flow (called VALIDATINGX122XML.msgflow) parses the message and validates it against the message set:

   • If the message is a valid X12 message, it is passed to the Compute node which converts the X12 message to an XML message. The Compute node then passes the message to the X12_TO_XML_OUT MQOutput node which puts the message on the X12_TO_XML_OUT queue.
   • If the message is not a valid X12 message, the message is passed to the X12_FAIL node, which puts the message on the X12_FAIL queue.
     
2. Get the transformed message from the X12_TO_XML_OUT queue using Dequeue:
   1. In the Test Client, click Dequeue.
   2. Click Get Message to read a message from the X12_TO_XML_OUT queue.
   3. Right click on the contents of the message and Select All, and then Copy to take a copy of the message.
3. Put your copied message from step 2 on the XML_TO_X12_IN queue using the Test Client.
   1. In the Test Client, click on Enqueue
   2. In the Source pane, right click on the Source message and click Select All and then right click and select Paste to replace the existing source message.
   3. In the Queue name field, type XML_TO_X12_IN.
   4. Click Send Message to put the copied message onto the queue.
   
   When you put the message on the XML_TO_X12_IN queue, the XML_TO_X12_IN MQInput node in the second message flow (called VALIDATINGXML2X12.msgflow) parses the message and validates it against the message set:
   • If the message is a valid XML message, it is passed to the Compute node which converts the XML message to an X12 message. The Compute node then passes the message to the XML_TO_X12_OUT MQOutput node which puts the message on the XML_TO_X12_OUT queue.
   • If the message is not a valid XML message, the message is passed to the X12_FAIL node, which puts the message on the X12_FAIL queue.
4. Get the message from the XML_TO_X12_OUT queue. The message is now an X12 message.

If there is no message on the X12_TO XML_OUT or XML_TO_X12_OUT queues, see Diagnosing problems.. The message might still be on the input queue, or it might be on the X12_FAIL queue, or on one of the system queues.

The PurchaseOrder_Missing_BEG.mbtest message

When you put the PurchaseOrder_Missing_BEG.mbtest message through the first message flow, the validation on the X12_TO_XML_IN MQInput node fails because the BEG field is missing from the message. The X12_TO_XML_IN MQInput node puts the message on the X12_FAIL queue.

Back to sample home