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 is an example of how to enable the ESI trace in foreground and route it to a sequential dataset. There are few ways you can do this:

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 type commands 
   

   TSO %ESITRACE STOP

 

Option 2

1. Pre-allocate the sequential file using the following using either 3.2, IEFBR140 or the TSO ALLOCATE commands. 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=FB,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 Option List 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
   TSO FREE DD(EN$TRESI)

 

Option 3:

Have the Endevor Administrator add the following DD Statements to your Endevor CLIST:

ALLOC DD (BSTERR) SYSOUT REUSE
ALLOC DD (EN$TRESI) DA(*) SHR