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

Document ID : KB000017965
Last Modified Date : 07/02/2019
Show Technical Document Details
Introduction:

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
Instructions:
Please Update This Required Field