Customizing IMS BTS Debugging

The IMS BTS Debugging utility of IBM® z/OS® Debugger Utilities helps your users prepare a BTS JCL and start a debug session in the foreground or in batch. You can supply your users with default values for the TEST runtime option and data set names for the z/OS Debugger load module, user exit module, debug information files, IMS subsystem IDs and base JCLs.

To set the defaults, do the following steps:
  1. Review the parameters described in Table 1. Verify that you have all the information you need to specify values for each parameter. You can also view a complete list of parameters and the syntax convention for these parameters in the EQAZDSYS member of the hlq.SEQATLIB data set.
  2. Edit the EQAZDSYS1 member of the hlq.SEQATLIB data set. Modify the parameters required by your site. You can add parameters by doing one of the following alternatives:
    • Use the INCLUDE 'any.data.set.name'; statement to include statements from a data set that you created.
    • Use the INCLUDE membername; statement to include parameters from other members in the data set hlq.SEQATLIB.

    If your application programmers use terminals that cannot display text in mixed-case English, enter all parameters and their values in uppercase English.

Table 1. Parameters you can define for the IMS BTS Debugging option of IBM z/OS Debugger Utilities.
Name of parameter Description
yb2dtmod The name of the data set that contains the z/OS Debugger load modules, SEQAMOD.
yb2dtce1 The name of the data set that contains Language Environment® runtime library, SCEERUN1.
yb2dtce2 The name of the data set that contains Language Environment runtime library, SCEERUN2.
yb2dtbin The name of the data set that contains the CEEBINIT load module.
yb2dtnmp The naming pattern you stored in EQAD3CXT when you completed the instructions in Modifying the naming pattern. If you modify the naming pattern stored in EQAD3CXT, you must modify this parameter to match.
yb2dtdev The interface type that application programmers should use to debug IMS BTS programs. You can specify one of the following values:
MFI
Interact with z/OS Debugger in full-screen mode or full-screen mode using a dedicated terminal without Terminal Interface Manager (TIM). If application programmers are using full-screen mode using a dedicated terminal without Terminal Interface Manager, they identify the terminal by network and LU names, as described in Enabling debugging in full-screen mode using a dedicated terminal.
TIM
Interact with z/OS Debugger in full-screen mode or full-screen mode using the Terminal Interface Manager (TIM). The application programmer identifies the terminal by user ID, as described in How users start a full-screen mode debug session with the Terminal Interface Manager. Make sure you complete the instructions in Enabling full-screen mode using the Terminal Interface Manager.
GUI
Interact with z/OS Debugger in remote debug mode, where the application programmer identifies the remote debugger by IP address.
yb2dtmtd The method that application programmers should use to start z/OS Debugger. You can specify one of the following values:
C
The application programmer specifies the CEEOPTS DD statement. You must run z/OS, Version 1.7, or later to use this option.
E
The application programmer specifies the EQAD3CXT user exit.
yb2dtprf The name of the data set that contains the preferences file. If your site does not use a preferences files, you can leave this field blank.
yb2dtcmd The name of the data set that contains the commands file. If your site does not use a commands files, you can leave this field blank.
yb2dtufl The name of a data set containing a list of data set names to be allocated by EQADEBUG DD statements.
yb2dtued The name of a data set containing the EQAUEDAT load module.
yb2imsnm The number of IMS subsystems that the application programmers can use to run or debug IMS applications. The maximum value is 12.
yb2iidn For each IMS subsystem, create a copy of this parameter and assign n a unique number between 1 and 12. For example, if your site has two IMS subsystems, you create yb2iid1 and yb2iid2 and assign each parameter a unique IMS system name.
yb2bmpn For each IMS subsystem, create a copy of this parameter and assign n a unique number between 1 and 12 and specify the member name of a JCL that your site uses as a base or template JCL for batch message processing (BMP) programs. Edit the EQABMPSM2 member of hlq.SEQATLIB, then copy it to a new name (for example, BMPJCL1). For example, if your site has two IMS subsystems, you create yb2bmp1 and yb2bmp2 and assign each parameter the member name.
yb2dbbn For each IMS subsystem, create a copy of this parameter and assign n a unique number between 1 and 12 and the member name of a JCL that your site uses as a base or template JCL for Data Language/I (DL/I) programs. Edit the EQADBBSM3 member of hlq.SEQATLIB, then copy it to a new name (for example, DBBJCL1). For example, if your site has two IMS subsystems, you create yb2dbb1 and yb2dbb2 and assign each parameter the member name.
yb2dlin For each IMS subsystem, create a copy of this parameter and assign n a unique number between 1 and 12 and the member name of a JCL that your site uses as a base or template JCL for Data Language/I (DL/I) programs. Edit the EQADLISM4 member of hlq.SEQATLIB, then copy it to a new name (for example, DLIJCL1). For example, if your site has two IMS subsystems, you create yb2dli1 and yb2dli2 and assign each parameter the member name.
1 USERMOD EQAUMOD6 is provided for updating EQAZDSYS. See SMP/E USERMODs for an SMP/E USERMOD for this customization.
2 USERMOD EQAUMODG is provided for updating EQABMPSM. See SMP/E USERMODs for an SMP/E USERMOD for this customization.
3 USERMOD EQAUMODH is provided for updating EQADBBSM. See SMP/E USERMODs for an SMP/E USERMOD for this customization.
4 USERMOD EQAUMODI is provided for updating EQADLISM. See SMP/E USERMODs for an SMP/E USERMOD for this customization.