Overriding the dynamically created CICS resource definitions for CICSPlex SM

You do not have to update your CSD to obtain the default resource definitions supplied by CICSPlex® SM.

You do not typically run user transactions in a CMAS. However, if you do choose to define your own transactions to the CMAS, be aware that transaction IDs used by CICSPlex SM in the CMAS have no specific format. To avoid conflict between your names and those that are used by CICSPlex SM, review the transactions that are defined in EYU$CDEF. For a list of these transactions, see Default CICS resource definitions for CICSPlex SM.

If you do want to modify a definition, you can do so using the required definition from the EYU$CDEF (CMAS), or EYU$WDEF (WUI) samples.

For MAS definitions use the following:

EYU$M660: This sample includes the default CICS resource definitions used for a MAS agent at the CICS TS 5.4 level and the CICS region at CICS R660.
EYU$M670: This sample includes the default CICS resource definitions used for a MAS agent at the CICS TS 5.4 level and the CICS region at CICS R670.
EYU$M680: This sample includes the default CICS resource definitions used for a MAS agent at the CICS TS 5.4 level and the CICS region at CICS R680.
EYU$M690: This sample includes the default CICS resource definitions used for a MAS agent at the CICS TS 5.4 level and the CICS region at CICS R690.
EYU$M700: This sample includes the default CICS resource definitions used for a MAS agent at the CICS TS 5.4 level and the CICS region at CICS R700.
EYU$MDEF: This sample includes the default CICS resource definitions used for a MAS agent at the CICS TS 5.4 level and the CICS region at CICS R710.

Copy the required definitions from the appropriate sample into a DFHCSDUP job, and make the required changes, including specifying a CSD group. Specify this CSD group in an appropriate GRPLIST for the CMAS, MAS, or WUI server. The region is then COLD or INITIAL started, as required, to process the change.

Some CICS resource definitions are enforced. If an inappropriate definition is found, a message is produced during CICSPlex SM initialization. If CICSPlex SM cannot dynamically correct the error, CICSPlex SM initialization can fail.

You can update the CSD for CICSPlex SM if CMAS journaling is required; see CMAS journaling.

Another reason you might want to update the CSD for CICSPlex SM is if your WUI servers require additional import or export TDQs to make copying WUI view or menu definitions easier. You can use the COVI and COVE definitions from EYU$WDEF as a model. For example, if the WUI servers can access the same MVS data sets, make your updates in this way:

Copy the COVI and COVE definitions from EYU$WDEF into a DFHCSD job.
Rename the COVE TDQ; for example, to MYEX. This TDQ definition must have the data set name specified. Also, this data set must be preallocated using data set characteristics.
Include the MYEX definition in a group that is to be used by the exporting WUI.
Install the MYEX TDQ, after the definition has been made on the CSD in one of these ways:
- A COLD start of the exporting WUI, if the group is in the exporting WUI's group list, or
- CEDA INSTALL, if the WUI server is running.
Rename the COVI TDQ; for example, to MYIM. This TDQ definition must have the same data set name specified on the MYEX TDQ definition.
Include the MYIM definition in a group that is to be used by the importing WUI.
Install the MYIM TDQ, after the definition has been made on the CSD in one of these ways:
- A COLD start of the importing WUI, if the group is in the importing WUI's group list, or
- CEDA INSTALL, if the WUI server is running.
Use COVC, on the exporting WUI, to export the required definitions to the MYEX TDQ. Wait for the Export to complete.
Use COVC, on the importing WUI, to import the required definitions to the MYIM TDQ.

If the WUI servers cannot access the same data sets, the export data set must be copied from the exporting system (after the COVC Export is complete) to the importing system (before the COVC Import is run).

The following DFHCSDUP SYSIN control statements contain the default definitions, copied from EYU$WDEF, with the modification to the default definitions, to allow the same data set to be used to export to a copy of the COVE output TD queue and the COVI input TD queue to import into another WUI. The modification is in bold type.

//CSDUP   EXEC PGM=DFHCSDUP
//STEPLIB  DD  DSN=cics.index.SDFHLOAD,DISP=SHR
//DFHCSD   DD  DSN=cics.dfhcsd,DISP=SHR
//SYSPRINT DD  SYSOUT=*
//SYSIN    DD   *                                                            
*---------------------------------------------------------------------*
* Create TDQUEUE definitions for import/export                        *
*---------------------------------------------------------------------*
DELETE  GROUP(group_name)
DEFINE TDQUEUE(MYIM) GROUP(group_name)                                 
DESCRIPTION(CPSM WUI IMPORT DATASET)                                   
     TYPE(EXTRA) DATABUFFERS(1) DDNAME(EYUCOVI) DSNAME(hlq.wui.screens)
     ERROROPTION(IGNORE) OPENTIME(DEFERRED) TYPEFILE(INPUT) 
     RECORDSIZE(32000) BLOCKSIZE(0) RECORDFORMAT(VARIABLE) 
     BLOCKFORMAT(BLOCKED) DISPOSITION(SHR)      
*                                                                      
DEFINE TDQUEUE(MYEX) GROUP(group_name)                                 
DESCRIPTION(CPSM WUI EXPORT DATASET)                                   
     TYPE(EXTRA) DATABUFFERS(1) DDNAME(EYUCOVE) DSNAME(hlq.wui.screens)
     ERROROPTION(IGNORE) OPENTIME(DEFERRED) TYPEFILE(OUTPUT) 
     RECORDSIZE(32000) BLOCKSIZE(0) RECORDFORMAT(VARIABLE) 
     BLOCKFORMAT(BLOCKED) DISPOSITION(SHR)                
ADD GROUP(group_name) LIST(list_name)

where:

STEPLIB: Identifies cics.index.SDFHLOAD as the CICS load library that contains the DFHCSDUP module.
DFHCSD: Identifies cics.dfhcsd as the CICS CSD file to be updated.
SYSIN: Shows the SYSIN input for import and export transient data queues.
group_name: Identifies the name of your group.
list_name: Identifies the name of a CSD list, which you include on the GRPLIST system initialization parameter for WUI server WUI A.

For information about TD queue definitions see Transient data queue definitions for the WUI.

A return code of 4 is expected from this run of DFHCSDUP because, before adding the designated group to the CSD, the job attempts to delete any group with the same name.

You can amend the supplied definitions for a CMAS and MAS in the same way. Run DFHCSDUP including the modified resource definition from the sample EYU$CDEF, for a CMAS, or EYU$MDEF, for a MAS, in a CSD list that you use when starting your system.