Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Modifying the CICS startup JCL


Note

The TDCAS and CICS region requires 64-bit storage during CICS transaction dump capture. You can do this using the MEMLIMIT=nnnnM parameter on the JOB or EXEC statements in your CICS JCL and TDCAS JCL. Alternatively, your MVS systems programmer may have set an installation default MEMLIMIT through SMFPRMxx in PARMLIB or by using SMF exit IEFUSI. Check with your MVS systems programmer.

Add the following DD statements to your CICS region startup JCL:

//DFHRPL DD Statement

Append a DD card for the Abend-AID for CICS CICSLIB load library to the library concatenation for the //DFHRPL DD statement. For example:

//          DD  DSN=SYS1.CMPW.MKFX171.SKFXCLIB,DISP=SHR

//FDBDCUST DD Statement

If you did not add an RDO file entry for the Abend-AID for CICS customization file, you must include a DD statement for the file in the CICS region JCL. For example:

//FDBDCUST  DD  DSN=SYS1.CPWR.MKAZ170.CUST.FILE,DISP=SHR

Important

The FDBDCUST DD used in the CICS region must be the same as that associated with the TDCAS dump capture region, that you want to process the reports.

//SLSF00n DD Statement

If you are installing source support, and you want to define your source listing files in the CICS JCL, add a DD statement for each file anywhere in the CICS region’s job step.

Note

You can use other available methods for defining your source listing files. See Source Listing Files for more information.

The DDname must match the value specified for the SLSDDN transaction dump global option. SLSF001 is the default. See SLSDDN for more information.

The first DD statement must end in 001. Increment the value for each additional file. For example,

//SLSF001   DD  DSN=SYS1.CPWR.MKFX171.LISTING1,DISP=SHR
//SLSF002   DD  DSN=SYS1.CPWR.MKFX171.LISTING2,DISP=SHR 

//SYSMDUMP DD Statement

We recommend adding the following DD statement to your CICS region JCL:

//SYSMDUMP  DD  DSN=SYS1.CPWR.MKFX171.SYSMDUMP.FILE,DISP=SHR

If the CICS region abends early in initialization processing or late in termination processing and a dump is requested, the dump is routed to the SYSMDUMP data set. When necessary, the SYSMDUMP data set can be imported into Abend-AID for CICS.

//ABNLIGNR DD Statement

We recommend that if batch Abend-AID is installed, to prevent a batch Abend-AID dump being taken if your CICS region fails, add the following DD statement to your CICS region JCL:

//ABNLIGNR  DD  DUMMY

//FDBDLOG DD Statement (optional)

Abend-AID for CICS writes its diagnostic messages to the data set or SYSOUT class specified by this DD statement. If you do not specify an //FDBDLOG DD, Abend-AID for CICS dynamically writes its messages to SYSOUT=*. If you want to write these messages to a data set, add the following DD to your CICS region JCL:

//FDBDLOG DD DSN=dataset.name,DISP=SHR



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*