Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Specifying setup options for C


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.

Important

At least one DDIO library is required for Code Debug TSO.

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 4 (BTS) on the Code Debug TSO Environments Menu shown in the following figure, the BTS environment test screen shown in the figure  is displayed.

Environments Menu

Profile: C64 --------------------- 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






          Press ENTER to process  or  enter END command to terminate

BTS Test Screen

 Profile: C64 --------------------------  BTS (2.4)  ---------------------------
COMMAND ===>

COMMANDS:  SEtup (Display Setup Menu)
           BTsin (Display BTSIN Menu)
           PROFile (Display Profile List)                   DOwn  (Scroll Down)
                                  INTERCEPTS

     PROGRAM       TRANCODE      INITSCR       POSTSCR       START     MAX
===> XPEDTRNC ===>          ===>          ===>          ===>      ===>
===>          ===>          ===>          ===>          ===>      ===>
===>          ===>          ===>          ===>          ===>      ===>

                 BTSIN ===>
          Program Type ===> DLI     (DLI, BMP, DBB)

   PARM Passing Option ===> STD     (STD)     Retain Breakpoints? ===> NO

  File List/JCL Member ===> XPEDITER.FLIST(TRIMPP)
           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 Command line of the Code Debug TSO BTS Environment test screen, the Setup Menu screen shown in the following figure is displayed.

Code Debug TSO BTS Setup Menu

Profile: C64 ------------------  SETUP MENU  --------------------------
OPTION  ===>

         E  EXTENDED     - Extended Setup Menu
         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

         C  CODE COVERAGE- Code Coverage setup options
         D  DOCUMENT     - Document dataset disposition
         A  ALL          - Display all of the above in succession (except 0)

          Press ENTER to process  or  enter END command to terminate

Option E on all Setup Menus displays the Extended Setup Menu. Extended Setup allows the user to modify NEW and WORK data set allocation values that were previously assigned by the installer of the Code Debug product. Option 0 on all Setup Menus displays the Execution 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.

Important

As a convenience, you can bypass the Setup Menus by using the SETUP command and specifying the setup option you want. For example, SETUP 1 takes you directly to the Load Module Libraries screen, SE A automatically cycles you through all the setup screens, and SETUP 0.4 changes your test type to BTS.

This section shows 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 displayed in this space.

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

LOADLIBS

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

PANEXEC

X

X

X

X

IMS



X

X

BTS




X

CODE COVERAGE

X

X

X

X

DOCUMENT

X

X

X

X


Code Coverage does not currently support VisualAge PL/I or C programs. However, statistics will be collected on any non-VA PL/I and non-C programs involved in the Code Coverage test.

Setup options available under Code Debug IMS environments

The Setup Menu shown in the following figure is displayed when you select option 8 (MPP) 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.

Code Debug IMS MPP Setup Menu

Profile: C64 -------------------  SETUP MENU  -----------------------
OPTION  ===>

         E  EXTENDED     - Extended Setup Menu
         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


         C  CODE COVERAGE- Code Coverage setup options
         D  DOCUMENT     - Document dataset disposition
         A  ALL          - Display all of the above in succession (except 0)

          Press ENTER to process  or  enter END command to terminate

This section provides information about the following topics:

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*