Sample definition job

Sample Fault Analyzer CICS program and transaction definition job shows a sample batch job that can be used to define all of the above mentioned programs and transaction to CICS®. Replace data set names shown with xxx prefix with the correct names for your installation and list-name with the appropriate CICS® startup SIT GRPLIST name. The group name FA has been chosen for this example, but can be changed if you desire.

Figure 1. Sample Fault Analyzer CICS program and transaction definition job

//IDICICS JOB  ...
//IDICICS EXEC PGM=DFHCSDUP,REGION=1024K,
//             PARM='CSD(READWRITE),PAGESIZE(60),NOCOMPAT'
//STEPLIB  DD DISP=SHR,DSN=xxx.SDFHLOAD
//DFHCSD   DD DISP=SHR,DSN=xxx.DFHCSD
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
  DEF PROGRAM(IDIPLT) GROUP(FA) EXECKEY(CICS)
      CEDF(NO) DATALOCATION(ANY)
      CONCURRENCY(QUASIRENT)
  DEF PROGRAM(IDIPLTD) GROUP(FA) EXECKEY(CICS)
      CEDF(NO) DATALOCATION(ANY)
      CONCURRENCY(QUASIRENT)
  DEF PROGRAM(IDIPLTS) GROUP(FA) EXECKEY(CICS)
      CEDF(NO) DATALOCATION(ANY)
      CONCURRENCY(QUASIRENT)
  DEF PROGRAM(IDIXCX53) GROUP(FA)
      CEDF(NO) DATALOCATION(ANY)
      CONCURRENCY(QUASIRENT)
  DEF PROGRAM(IDIXCCEE) GROUP(FA)
      CEDF(NO) DATALOCATION(ANY)
      CONCURRENCY(QUASIRENT)
  DEF PROGRAM(IDIXFA) GROUP(FA) EXECKEY(CICS)
      CEDF(NO) DATALOCATION(ANY)
      CONCURRENCY(QUASIRENT)
  DEF PROGRAM(IDIVPCLE) GROUP(FA)
      CONCURRENCY(QUASIRENT)
  DEF TRANSACTION(CFA) GROUP(FA)
      PROGRAM(IDIXFA) TASKDATALOC(ANY)
      SHUTDOWN(ENABLED)
  DEF MAPSET(IDIXMAP) GROUP(FA)
  ADD G(FA) L(list-name)
/*

The above sample job is provided as member IDISCICS in data set IDI.SIDISAM1.

In order for Fault Analyzer to be invoked under CICS®, it is necessary to add IDI.SIDIAUTH to the DFHRPL concatenation.

CICS® tracing must be active for Fault Analyzer to display CICS® trace information.

The ABCODE keyword must be used on an EXEC CICS® ABEND statement in order for Fault Analyzer to be invoked. For example:

EXEC CICS ABEND ABCODE('abcd') END-EXEC

If the NODUMP keyword is used on an EXEC CICS® ABEND statement, then Fault Analyzer only performs analysis if invoked via the IDIXCCEE exit.