Setting a SLIP trap

Figure 1 shows an example SLIP trap that captures a dump of the CICS address space, the MVS logger address space, and the coupling facility structure associated with the failing logstream.

SLIP SET,IF,LPAMOD=(IGC0003E,0),DATA=(1R?+
4,EQ,C4C6C8D3,+8,EQ,C7F0F7F7,+C,EQ,F2),A=S    <change the message
VCD,JOBLIST=(cicsjob,IXGLOGR,XCFAS),          <change CICS Job
 
-->response xx
 
xx,DSPNAME=('XCFAS'.*,'IXGLOGR'.*),STRLIST
=(STRNAME=structname,LOCKENTRIES,ACC=NOLIM    <change STRNAME
,(LISTNUM=ALL,
 
-->response yy
 
yy,ENTRYDATA=SERIALIZE,ADJUNCT=CAPTURE)),S
DATA=(RGN,XESDATA,ALLNUC,CSA,LSQA,PSA,SQA,
SWA,TRT,COUPLE,WLM,GRSQ,LPA),
 
-->response zz
 
zz,ID=LOGR,REMOTE=(JOBLIST,DSPNAME,SDATA),
END

In this example, the SLIP triggers when a specific CICS log manager message DFHLG0772 is written to the console. This is specified in the EQ parameter of the SLIP:

+4,EQ,C4C6C8D3,+8,EQ,C7F0F7F7,+C,EQ,F2)
       D F H L        G 0 7 7        2     <equates to

You can also set a more “generic” trap, that is triggered by the occurrence of any one of a range of messages. For example, to cause the SLIP to be triggered by any log manager message in the DFHLG07xx range, alter the value of the EQ parameter to:

+4,EQ,C4C6C8D3,+8,EQ,C7F0F7),
       D F H L        G 0 7      <equates to

To use the example SLIP, you must:

1. Replace the cicsjob value with the name of the CICS job (or jobs) to be dumped.
2. Replace the xx, yy, and zz values with the appropriate operator reply numbers, as each segment is entered.
3. Replace the structname value with the name of the coupling facility structure that contains the failing log stream.

   For system log failures only, you can get the name of the coupling facility structure (or structures) from the two DFHLG0104 messages that were issued when CICS connected to DFHLOG and DFHSHUNT during the run in which the failure occurred.

   For all other log streams, to get the name of the coupling facility structure use the LIST LOGSTREAM NAME command already described. For example:

   //LOGRRPT  EXEC PGM=IXCMIAPU
   //SYSPRINT DD SYSOUT=*
   //SYSIN    DD *
    DATA
      TYPE(LOGR)
      REPORT(YES)
      LIST LOGSTREAM NAME(logstream_name) DETAIL(YES)

   Figure 1 shows example output produced by the LIST LOGSTREAM NAME command. Search for the log stream name; the structure name follows it.

   Step 3 assumes two things:

   • That the failing log stream is a coupling facility log stream. If it is a DASD-only log stream, the STRLIST parameter in the example SLIP is not appropriate.
   • That the logging problem is repeatable. It is assumed that the log stream has failed at least once before the SLIP is set (the initial failure allowing you to deduce the name of the coupling facility structure to be dumped).