Specifying setup options
Setup is a user initialization procedure that lets you assign values to installed options such as: (1) application load library names, (2) DDIO file names, (3) test script library names, and so on. These options automatically default to the installed options the first time you access Code Debug TSO; however, you can override the installed options by using the setup procedure. The options you specify are retained across debugging sessions until you change them.
The setup procedure is accessed by typing SETUP or SE on the command line of any environment test screen or any screen on which the command appears. The options displayed on a Setup Menu depend on the environment in which you run your program and may vary for different environments.
For example, if you selected option 7 (IMSPEM) on the Code Debug TSO Environments Menu shown in following figure, the Hogan IMSPEM Environment Test screen is displayed.
Code Debug TSI Environments Menu
OPTION ===>
CODE DEBUG TSO
1 STANDARD - Test a program with no special environment services
2 DIALOG - Test programs that make ISPF dialog manager calls
3 IMS - Test a program that makes IMS/DB calls
4 BTS - Test programs using BTS
5 BATCHPEM - Test a program in a Hogan BATCHPEM environment
6 DLIPEM - Test a program in a Hogan DLIPEM/BMPPEM environment
7 IMSPEM - Test a program in a Hogan BTS IMSPEM environment
CODE DEBUG IMS
8 MPP - Test programs in an IMS message region
9 BMP/IFP - Test a program in a BMP or Fast Path region
10 IMSPEM - Test Hogan IMSPEM in an IMS message region
11 BMPPEM - Test Hogan BMPPEM in a BMP region
DB2 STORED PROCEDURES
12 DB2SP - Test DB2 Stored Procedure interactively
Note: The environment highlighted is currently selected.
Press ENTER to process or enter END command to terminate
Hogan IMSPEM Test Screen
COMMAND ===>
COMMANDS: SEtup (Display Setup Menu)
BTsin (Display BTSIN Menu)
PROFile (Display Profile List) DOwn (Scroll Down)
INTERCEPTS
PROGRAM TRANCODE INITSCR POSTSCR START MAX
===> PQ4CODEL ===> TQ4COCNG ===> ===> ===> ===>
===> ===> ===> ===> ===> ===>
===> ===> ===> ===> ===> ===>
BTSIN ===> 'ASJUSR1.INCLUDE(BTSIN)'
Program Type ===> DLI (DLI, BMP, DBB)
HOGAN PEM Driver ===> IMSPEM ("IMSPEM" is Default for DLI Program)
File List/JCL Member ===>
Unattended? ===> NO
Code Coverage Test? ===> NO (YES, NO, TDO) System Flow? ===> NO
Is This a DB2 Test? ===> NO System ===>
Press ENTER to process or enter END command to terminate
If you enter SETUP on the environment test screen, the IMSPEM Setup Menu shown in following figure is displayed.
Code Debug TSO IMSPEM Setup Menu
OPTION ===>
0 ENVIRONMENT - Execution environments menu
1 LOADLIBS - Application load module libraries
2 DDIO - DDIO files
3 INCLUDES - Test script libraries
4 LOG - Session log dataset disposition
5 SCRIPT - Test script dataset disposition
6 DSNLOAD - DB2 system names and DSNLOAD libraries
7 PANEXEC - PANEXEC load libraries
I IMS - IMS setup options menu
B BTS - BTS setup options menu
H HOGAN - HOGAN setup options menu
C CODE COVERAGE- Code Coverage setup options
D DOCUMENT - Document dataset disposition
E EXTENDED - Extended Setup Menu
A ALL - Display all of the above in succession (except 0)
Press ENTER to process or enter END command to terminate
Option 0 on all Setup Menus displays the Environments Menu. Options 1 through 7 on the Setup menus are available for all environments and are referred to as the common setup options. The screens for each of these seven options are described in Common Setup Screens.
Setup options available under Code Debug TSO environments
The following table shows the setup options that are available for each Code Debug TSO environment.
Setup Options Available for Code Debug TSO Environments
Setup options | Code Debug TSO Environments | ||||||
|---|---|---|---|---|---|---|---|
Standard | Dialog Box | IMS | BTS | BATCHPEM | DLIPEM | IMSPEM | |
LOADLIBS | X | X | X | X | X | X | X |
DDIO | X | X | X | X | X | X | X |
INCLUDES | X | X | X | X | X | X | X |
LOG | X | X | X | X | X | X | X |
SCRIPT | X | X | X | X | X | X | X |
DNSLOAD | X | X | X | X | X | X | X |
PANEXEC | X | X | X | X | X | X | X |
IMS | X | X | X | X | |||
BTS | X | X | |||||
HOGAN | X | X | X | ||||
CODE COVERAGE | X | X | X | X | X | X | X |
DOCUMENT | X | X | X | X | X | X | X |
Setup options available under Code Debug IMS environments
The following table shows the setup options that are available for each Code Debug IMS environment. The Setup Menu shown in following figure is displayed when you select option 11 (BMPPEM) under Code Debug IMS on the Environments Menu and type SETUP in the command line of the displayed environment test screen.
See the Common Setup Screens for a description of the first seven options (options 1 through 7) on the Setup Menu. See the IMS Setup Menu for descriptions of options 8 through 11 and see also Hogan Setup Menu for option H.
Code Debug IMS BMPPEM Setup Menu
OPTION ===>
0 ENVIRONMENT - Execution environments menu
1 LOADLIBS - Application load module libraries
2 DDIO - DDIO files
3 INCLUDES - Test script libraries
4 LOG - Session log dataset disposition
5 SCRIPT - Test script dataset disposition
6 DSNLOAD - DB2 system names and DSNLOAD libraries
7 PANEXEC - PANEXEC load libraries
8 IMS - PSB and DBD libraries
9 PROCLIB - IMS preload list
10 DFSRESLB - IMS authorized load libraries
11 PARMS - IMS region ID and parameter strings
H HOGAN - Hogan setup options menu
C CODE COVERAGE- Code Coverage setup options
D DOCUMENT - Document dataset disposition
E EXTENDED - Extended Setup Menu
A ALL - Display all of the above in succession (except 0)
Press ENTER to process or enter END command to terminate
The following notes list the differences between above figure and the Setup Menu for the different Code Debug IMS environments:
Setup Options Available for Code Debug IMS Enviroments
Setup option | Code Debug IMS Enviroments | |||
|---|---|---|---|---|
MPP | BMP/IFP | IMSPEM | BMPPEM | |
LOADIBS | X | X | X | X |
DDIO | X | X | X | X |
INCLUDES | X | X | X | X |
LOG | X | X | X | X |
SCRIPT | X | X | X | X |
dSNLOAD | X | X | X | X |
IMS | X | X | X | X |
PROCLIB | X | X | X | X |
DFSRESLB | X | X | X | X |
PARMS | X | X | X | X |
HOGAN | X | X | ||
CODE COVERAGE | X | X | X | X |
DOCUMENT | X | X | X | X |
This section shows the following examples of the Setup Menus, and the screens and submenus that can be accessed from them. Since many of the Setup Menus are the same, all of the menus are not shown.