Working with WebSphere MQ

From within Z Data Tools, you can access WebSphere® MQ queues on the local z/OS® system where Z Data Tools is running.

From the Primary Option Menu panel, select option 9 WebSphere MQ. Z Data Tools displays the Websphere MQ Functions panel:
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
 Z Data Tools                Websphere MQ Functions

 1  List          List Managers and queues.
 2  View          View a WMQ queue.
 3  Edit          Edit a WMQ queue.

⋮
To access WebSphere MQ queues, from the Websphere MQ Functions panel select option 1 List to display the Websphere MQ Managers panel.
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
  Z Data Tools               Websphere MQ Managers             Row 0001 of 0004

   SSID   ↓ Name     Active   Code     Reason
   <---+--> <---+--> <---+--> <---+--> <---+----10---+----2--->
   CSQ1     CSQ1MSTR Active          0 MQRC_NONE
   CSQ2     CSQ2MSTR Active          0 MQRC_NONE
   CSQ3     CSQ3MSTR Active          0 MQRC_NONE
   CSQ4     CSQ4MSTR Active          2 MQRC_Q_MGR_NOT_AVAILABLE
 ****  End of data  ****

⋮

The WebSphere MQ Managers panel shows a list of WebSphere MQ queue managers and, for each one, whether Z Data Tools is able to connect to the queue manager.

If Z Data Tools cannot connect to a queue manager, the connection completion code and the MQ mnemonic for the reason code are displayed in the list.

If the required WebSphere MQ libraries are not available to Z Data Tools, the queue managers are shown but the connection status shows "*NOLIB*".
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
  Z Data Tools               Websphere MQ Managers             Row 0001 of 0004

   SSID   ↓ Name     Active   Code     Reason
   <---+--> <---+--> <---+--> <---+--> <---+----10---+----2--->
   *NOLIB*

⋮

To view a WebSphere MQ queues, from the Websphere MQ Functions panel select option 2 View to display the Websphere MQ Queue Editor Entry panel.

To edit a WebSphere MQ queues, from the Websphere MQ Functions panel select option 3 Edit to display the Websphere MQ Queue Editor Entry panel.

Note: Editing a queue retrieves messages in browse mode into virtual storage for the edit session. In an edit session, you can perform deletes, updates and inserts.

For messages that are updated in the edit session, at save time (including the save and exit performed as a result of pressing the F3 function key) the original message is destructively read from the queue and the updated message PUT to the queue. Messages are read in physical order. This means that updated messages appear in a different physical order than when the queue was first read by the editor. Because the messages are loaded into virtual storage, for queues with a high depth, not all of the messages may be able to be loaded into storage. If this does not provide all of the messages that you are expecting, then it is recommended you use a template to select the particular messages that you are interested in.

Related topics