Updating the CSD

This section describes the updates required for the CICS system definition (CSD) data set for the CICS adapter. If you intend to use the CICS sample application programs, see the WebSphere MQ Application Programming Guide .

You must use resource definition online (RDO) to add new groups to the CSD data set. The new groups must contain definitions of:

• The supplied adapter programs

• The supplied adapter management transactions

• The supplied sets of BMS maps, required for the adapter panels

To update the CSD, run the CICS offline utility program, DFHCSDUP, with the supplied sample input data sets:

This data set...	Provides the definitions required for...
thlqual.SCSQPROC(CSQ4B100)	CICS adapter	Required
thlqual.SCSQPROC(CSQ4S100)	Supplied samples	Optional

Each of these data sets contains sample CICS definitions that must be tailored. To preserve the originals, copy these data sets into a user JCL library whose name contains the WebSphere MQ subsystem name, for example, MQS.CSQ1.USERJCL, and tailor them there.

Note:

With some versions of CICS, you might receive warning messages about obsolete keywords; we can ignore these.

Ensure that any user-written CICS applications that issue MQI calls, and the resources they use, are also defined to the CSD. We can edit the input data set, to include definitions of user-programs and their resources.

We can add this fragment of JCL to your CSD upgrade (DFHCSDUP) job to define the WebSphere MQ supplied groups to the CICS CSD:

Figure 9. JCL fragment for upgrading the CICS CSD

//SYSIN  DD DSN=thlqual.SCSQPROC(CSQ4B100),DISP=SHR
//       DD DSN=thlqual.SCSQPROC(CSQ4S100),DISP=SHR
//       DD *
  ADD GROUP(CSQCAT1) LIST(yourlist)
  ADD GROUP(CSQ4SAMP) LIST(yourlist)
/*

Here,

yourlist is the name of a CICS list that contains a list of groups to be installed by CICS during a cold start of the system. This is specified in the GRPLIST parameter of your CICS system initialization table (SIT). For details of CICS SIT parameters, see the CICS System Definition Guide.

Include the new resource groups in the CICS startup group list. For information about resource groups, installing them in CICS, the CICS CSD, and DFHCSDUP, see the CICS Resource Definition Guide.

Note:

If you use the CEDA transaction to install redefined adapter resources in an active CICS system, first shut down the adapter and wait until the alert monitor has finished its work.

If you want to use CICS program autoinstall rather than define the programs to the CICS CSD, ensure that the required programs are available to WebSphere MQ. To do this, ensure that the autoinstalled definitions map to those supplied in member thlqual.SCSQPROC(CSQ4B100).