Configuring BPE for an external trace of IMS Connect

Before you can start a BPE external trace for IMS Connect, you must first configure BPE and the external trace data set.

1. Define the generation data group (GDG) base.

   	//STEP1 EXEC PGM=IDCAMS 
   	//SYSPRINT DD SYSOUT=A 
   	//SYSIN DD * 
   	  DEFINE GENERATIONDATAGROUP - 
   	    (NAME(IMSTESTL.RCTR.GDG01) - 
   	     NOEMPTY - 	
   	     SCRATCH - 
   	     LIMIT(255))
   	//

2. In the BPECFGxx member of the IMS.PROCLIB data set, specify the following parameters for IMS Connect:
   • EXTTRACE
   • TRCLEV

   In the EXTTRACE statement, specify the data set name of the generation data set group that you created in Step 1 and specify HWS in the COMP() parameter to identify IMS Connect as the BPE component to which this EXTTRACE statement applies.

    EXTTRACE(GDGDEF( DSN(IMSTESTL.RCTR.GDG01)       
                     UNIT(SYSDA) VOLSER(000000)     
               	     SPACE(1) SPACEUNIT(CYL)        
                     BLKSIZE(32760) ) COMP(HWS) )   

   When the Recorder Trace (TRCLEV type parameter RCTR) trace level is set to MEDIUM, message data is recorded before a message is sent to a user message exit and after the exit returns a message.

   You can set the trace level to HIGH to enable additional trace points. When these trace points are enabled, a trace record is also written when IMS Connect sends a message to or receives a message from a TCP/IP endpoint, a DRDA client, an SCI client, or OTMA via XCF. These records are not collected when the trace level is set to any value other than HIGH or when IMS Connect uses internal tracing.

   Recommendation: Use the BPE External Trace with the TRCLEV parameter HIGH only when troubleshooting IMS Connect client or OTMA-related problems. A large amount of trace data is recorded when the trace level is set to HIGH.

   In the TRCLEV parameter, you must specify EXTERNAL=YES to enable the External Trace facility:

   TRCLEV=(RCTR,MEDIUM,HWS,EXTERNAL=YES)

   Tip: If TRCLEV=(RCTR,MEDIUM,HWS,EXTERNAL=YES) is specified in the BPECFG member, the Recorder trace resumes every time IMS Connect restarts. If you do not want the Recorder trace to resume when IMS Connect restarts, issue the BPE command F hwsjobname,UPD TRTAB NAME(RCTR) LEVEL(MEDIUM) EXTERNAL(YES)