Installing and customizing z/OS Debugger JCL Wizard

The z/OS® Debugger JCL Wizard is an ISPF edit macro, EQAJCL, that can be used by a user to modify a JCL or procedure member to create statements that will invoke z/OS Debugger in various environments.

Prerequisites

The z/OS Debugger library hlq.SEQAMOD is assumed to be in the z/OS link list where the batch job will run. If it is not in the link list, do one of the following actions:
  • Add the library hlq.SEQAMOD to the link list of z/OS LPARs where the modified JCL or procedure will be run.
  • Add the library hlq.SEQAMOD to the //STEPLIB or //JOBLIB statement of the step or job that will be debugged.

Installation of the EQAJCL ISPF macro and its ISPF panels

The z/OS Debugger JCL Wizard contains an ISPF edit macro and a set of ISPF panels.

Use one of the following methods to install the z/OS Debugger JCL Wizard :
  • Installation to libraries allocated to the TSO Logon procedure.

    Use one of these two methods:
  • Installation by using a local REXX exec to point to the z/OS Debugger libraries.

    Select a command name that you do not currently use (for example, DEBUG), and install a REXX exec by that name into an existing data set in your TSO Logon procedure's SYSEXEC or SYSPROC DDs. The REXX exec should look like this (with hlq being changed to the high level qualifier that you use for the z/OS Debugger libraries):
    /* This REXX exec will invoke the z/OS Debugger EQAJCL ISPF macro */
    "EXEC 'hlq.SEQAEXEC(EQAJCL)'"
    EXIT
    

Customizing the data set names and other values in EQAJCL

You must modify member EQAJCL of the hlq.SEQAEXEC data set to specify the data set names that you chose at installation time. Edit the EQAJCL1 member and follow the directions in the member's prologue for site customization of data set names.

1 USERMOD EQAUMODL is provided for updating EQAJCL. See SMP/E USERMODs in the IBM® z/OS Debugger Customization Guide for an SMP/E USERMOD for this customization.