Overview of the MQSeries client

This is a sample Java application to show a simple case of using MQSeries to access a CICS
application on a different system, with the standard MQSeries to CICS DPL bridge. The CICS server program that is used is NACT02. This application makes use of the Enquire function Read without Lock) of NACT02 to retrieve customer details when the Customer Number is supplied by the user.

Note: This code does not demonstrate all the techniques required for a large application. It is not a template and should not be used as the foundation for your next mission critical application.

Prerequisites

To run the MQSeries client you need:

  • The COBOL application installed and running on a CICS for OS/390 region
  • MQSeries for OS/390 installed and configured
  • MQSeries for Windows NT installed and configured
  • JDK 1.2 which includes Swing
  • Appropriate TCP/IP LAN connections.

Installing and running MQSeries client

This sample requires that the NACT02 program is installed on your CICS for OS/390 server and that the MQSeries to CICS DPL bridge has been set up and is active.

In order to connect to NACT02, an MQSeries queue manager must be set up and started on the Windows NT machine on which this Java application is to run, along with the required MQSeries channel to the server machine and a listener. To do this four command files are provided. Select each of the four files in sequence to set and run the MQSeries client:

  1. MQSeries Java Client\MQSeries Client\1. Start MQSeries

    2. This step stops, defines and starts a queue manager on MQSeries for Windows NT.

  2. MQSeries Java Client\MQSeries Client\2. Load MQ for MVS definitions

    3. This defines the queues and channels for your Windows NT machine. You need to edit the admvs.def file to ensure that the correct IP address has been defined.

  3. MQSeries Java Client\MQSeries Client\3. Start ServicesMVS

    4. This starts the channels and queues on your Windows NT machine

  4. MQSeries Java Client\4. Client

    This starts the Java code for the client.

Full details about setting up this sample is provided in Chapter15 of "Designing and Programming CICS Applications".