Setting up the CICS Transaction Server for z/OS Channel Connectivity sample

To set up the CICS Transaction Server for z/OS Channel Connectivity sample, configure the connection from IBM WebSphere Message Broker to CICS Transaction Server for z/OS by using the CICSConnection configurable service. You can then translate, compile, and link the WMBCHAN1 CICS program, and deploy it on your target CICS region.

Before you import and deploy the CICS Transaction Server for z/OS Channel Connectivity sample, you must configure the connection between WebSphere Message Broker and CICS by using the CICSConnection configurable service:

Before you run the CICS Transaction Server for z/OS Channel Connectivity sample, you must translate, compile, and link the WMBCHAN1 program on your target CICS region:

Configure WebSphere Message Broker to connect to your CICS region

The following steps describe the minimum configuration that is required to import and deploy the sample.

Create a CICSConnection configurable service called CICSSampleConnectionService by using the mqsicreateconfigurableservice command or, by using the WebSphere Message Broker Explorer.

You can now import and deploy the sample; for more information, see CICS Transaction Server for z/OS Channel Connectivity sample

Translate, compile, and link the CICS program, WMBCHAN1

Complete the following steps to translate, compile, and link the WMBCHAN1 CICS program.

  1. The CICS program is stored in the sample project, CICSConnectivity Channel Message Flow, as WMBCHAN1.c. Extract this file and place it in an MVS dataset.
  2. CICS provides a sample JCL procedure that can be used to compile the sample program. To use this procedure, follow the instructions from the CICS Transaction Server for z/OS version 4.1 infocenter under the heading Sample JCL to install C application programs.
    1. Customize the sample JCL that is found at <cicshlq>.SDFHPROC(DFHYITDL) and place it in your procedure library.
    2. Customize WMBCHAN1.c to set the correct Job Control header and translator options (according to the CICS information center instructions).
    3. Customize the load module name at the bottom of WMBCHAN1.c and submit it as a job.
    4. Check that the response is successful; otherwise, refer to the CICS information center topic, CICS Transaction Server for z/OS version 4.1 infocenter under the heading Sample JCL to install C application programs.
    5. After the program is translated successfully, compiled, and linked into the load module, ensure that the load module is named in the DFHRPL JCL statement for the CICS region.
    6. Create a PROGRAM definition for the new WMBCHAN1 program and install the definition.

You can now run the CICS Transaction for z/OS Connectivity sample; for more information, see Running the CICS Transaction for z/OS Connectivity sample.

Back to sample home