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

Document ID : KB000017965
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

This document will tell you how to enable the Endevor ESI Security trace in foreground and route it to a sequential dataset.

Solution:

There are many time 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=FBA,LRECL=133,BLKSIZE-3118)
     RECFM=FB,LRECL=133,BLKSIZE=0, SPACE(11) CYLINDERS
     
     or
     
     TSO ALLOC DD(EN$TRESI) DA(USERID.ESITRACE) NEW CAT SPACE(11) CYLINDERS LRECL(13) 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