How to Enable the Endevor ESI Security Trace in Foreground and send it to a dataset

Products

• Endevor

Issue/Introduction

How to enable the Endevor ESI Security trace in foreground and route it to a sequential dataset.

Environment

Release: All

Resolution

There are many times when support will ask you to enable a trace in foreground and send us the output. The easiest way to gather that trace is to route the output to a sequential dataset. Below are examples of how to enable the ESI trace in foreground and route it to a sequential dataset.

Option 1

1. Login into Endevor
    
2. On the command line of the Environments Option list type:
   

   TSO %ESITRACE DATASET DSN('IPRFX.ESITRC') NEW CAT

3. Walk thru the actions that you need to recreate for the ESI Security problem
    
4. Stop the trace by issuing command: 
   

   TSO %ESITRACE STOP

 

Option 2

1. Pre-allocate the sequential file using either 3.2, IEFBR14 or the TSO ALLOCATE command. An example of the IEFBR14 and TSO ALLOCATE commands are below:
   
   
   //BR14 EXEC PGM=IEFBR14,COND=EVEN
   //TRACE DD DSN=USERID.ESITRACE,
   // DISP=(NEW,CATLG),
   // UNIT=SYSDA,
   // SPACE=(CYL,(1,1)),
   // DCB=(RECFM=F B,LRECL=133,BLKSIZE=0)
   
   or
   
   TSO ALLOC DD(EN$TRESI) DA('USERID.ESITRACE') NEW CAT SPACE(11) CYLINDERS LRECL(133) BLKSIZE(0) RECFM(FB) UNIT(SYSDA)
   
    
2. Login to Endevor
    
3. On the command line of the Environment Selection List panel type: 
   

   TSO ALLOC DD(EN$TRESI) DA('USERID.ESITRACE') MOD

4. Perform the action(s) that you need to recreate for the ESI Security Problem
    
5. Stop the trace by typing the following commands:
   

   TSO %ESITRACE STOP

 

Option 3:

Have the Endevor Administrator add the following DD statements to your Endevor CLIST prior to the invoking Endevor (C1SM1000) - Below is an example: 

/* ADD TRACES FOR DEBUGGING */                                
/* "ALLOC DD (EN$TROPT) DA(*) SHR" */                         
"ALLOC DD (EN$TRESI) DA(*) SHR"                               
                                                              
/* INVOKE ENDEVOR */                                          
"ISPEXEC SELECT PGM(C1SM1000) NOCHECK NEWAPPL(CTLS) PASSLIB"