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:
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.
Creating a CICSConnection configurable service by using the
mqsicreateconfigurableservice command
- Use the following example to create a CICSConnection configurable
service for the CICS instance that is running at
mycicsregion.com on port
12345. The broker is identified by the
application ID (APPLID) BRKApp and qualifier
BRKQual.
mqsicreateconfigurableservice MB8BROKER -c CICSConnection -o CICSSampleConnectionService -n cicsServer -v tcp://mycicsregion.com:12345
- Restart the broker in the WebSphere Message Broker Explorer
or by using the mqsistop and
mqsistart commands; for example:
mqsistop MB8BROKER
mqsistart MB8BROKER
- To find out more about creating a configurable service to which the
CICSRequest node or message flow refers for connection information at run time,
and to view the available CICSConnection configurable service properties, see
Changing connection information for the CICSRequest node
and Configurable services properties
in the WebSphere Message Broker documentation.
Creating a CICSConnection configurable service by using the WebSphere
Message Broker Explorer
- In the Navigator view, expand the broker to which you want to add a new
configurable service.
- Right-click the Configurable Services folder and click
New > Configurable Service. The
Configurable Service window opens.
- In the Name field, enter
CICSSampleConnectionService as the name for your
configurable service.
- In the Type field, select
CICSConnection as the type of configurable
service to create.
- In the Template field, select
CICSConnectionTemplate as the type of template
to create.
- Enter the value for the configurable service
cicsServer property in the format
tcp://mycicsregion.com, where
mycicsregion is your CICS region.
- Click Finish to create the new configurable
service.
- Restart the broker in the WebSphere Message Broker Explorer
or by using the mqsistop and
mqsistart commands; for example:
mqsistop MB8BROKER
mqsistart MB8BROKER
- To find out more about using the WebSphere Message Broker Explorer to
create a configurable service to which the CICSRequest node or message flow
refers at run time, see
Creating a new configurable service
in the WebSphere Message Broker documentation. To view the available
CICSConnection configurable service properties, see
Configurable services properties
in the WebSphere Message Broker documentation.
You can now import and deploy the sample; for more information, see
CICS Transaction Server for z/OS Channel Connectivity sample
Complete the following steps to translate, compile, and link the WMBCHAN1
CICS program.
- 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.
- 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.
- Customize the sample JCL that is found at <cicshlq>.SDFHPROC(DFHYITDL)
and place it in your procedure library.
- Customize WMBCHAN1.c to set the correct
Job Control header and translator options (according to the CICS information
center instructions).
- Customize the load module name at the bottom of WMBCHAN1.c
and submit it as a job.
- 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.
- 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.
- 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