Previous Topic: Overview of StepsNext Topic: Code Indirect Commands


Set a Breakpoint to Execute an Indirect Command

Before accessing the indirect commands facility, first set an unconditional, conditional, or request breakpoint that includes an option to execute an Indirect Command statement number.

Follow the steps listed next when setting an unconditional or conditional breakpoint from the Source Listing Breakpoint:

  1. From the Source Listing Breakpoint, set an unconditional or conditional breakpoint that will invoke the indirect commands.

    The following table summarizes how to set the breakpoints from the Source Listing Facility:

Breakpoint

Source Listing Entries

Unconditional

Specify:

Option # 12 (Bkpt Opts)

U to the left of one or more statements

Press Enter

Conditional

Specify:

Option # 12 (Bkpt Opts)

C to the left of one or more statements

Press Enter

Request

Use Monitoring Menus

Note: To jump to the Program Monitoring Menu from a breakpoint display, enter =1.2.1 on the command line.

The following screen shows how to set an unconditional breakpoint for indirect commands from the Source Listing facility. Notice the required Option # 12 entry at the top of the screen.

CA InterTest for CICS V9.1 - PROTDEM FILE PROTDEM FILE SOURCE LISTING BREAKPOINT  COMMAND ==>         í  Program= COBDEMO  Option # 12    Stmt #                            Margin= 01                     Label/Search Arg=   OPTS 1 Proc div  2 Work-stor 3 Link sect 4 D-map      5 Clst/Pmap More:   +       6 Data xref 7 Proc xref 8 Err msgs  9 Srch fwd  10 Srch bwd              PFKS 1 Help     2            3 Det BKPT   4 Profile    5 Resume      6 Menu        7 Backward 8 Forward    9           10 Do 1 Verb 11 Backtrace 12 Status -----------------------------------------------------------------------------       00788     03  OPTSPROTHLF        PIC X(8).                                       00789                                                                             00790 PROCEDURE DIVISION USING DFHEIBLK DFHCOMMAREA.                            U 00791     CALL 'DFHEI1'.                                                      ì

  1. Enter Option # 12 and U on Source Listing for Indirect Commands.
  2. After pressing Enter, CA InterTest for CICS displays the Breakpoint Locations menu with the location you selected on the Source Listing already indicated.
  3. On the Breakpoint Locations menu, specify the (still to be written) one‑ to five‑digit statement number of the first indirect command that you want to be executed at the breakpoint you are setting. For example, enter 10 or 50.

    CA InterTest MONITORING COMMAND BUILDER - COBOL BREAKPOINT LOCATIONS      11      SET breakpoint options for   PROG=COB2DEMO for location:              000791     CALL 'DFHEI1'.                                                                                  After:                Enter 'n' to stop only every n'th time:                         ____             Term ID (or .ANY or .NO) where breakpoints will take effect:                 Term ID (or .ANY) that will receive the breakpoints:                         Statement no. of indirect command(s) to be executed:           50___             User ID (or .ANY) who will execute the program:             .ANY        PF1 Help       2            3 End        4 Return     5            6  PF7            8            9           10           11           12

  4. Press Enter. CA InterTest for CICS processes the breakpoint as usual, and displays a message to that effect.
  5. CA InterTest for CICS displays the Indirect Commands screen containing the following fields:
    Term ID

    Indicates the terminal where the specified indirect commands execute. This value must match the terminal ID specified at the breakpoint that invokes these indirect commands. Enter one of the following values:

    xxxx—indicates a specific terminal.

    .ANY—indicates that these commands will execute at all terminals.

    Note: If indirect commands are specified for both .ANY and your specific terminal, the indirect commands specified for your terminal take precedence.

    .NO—indicates that these commands execute with no terminal.

    Delete ALL

    Deletes all previously specified indirect commands for the program you are testing. Enter one of the following options:

    NO—indicates that the indirect commands at the specified terminal will not be deleted (default).

    YES—indicates that the indirect commands at the specified terminal will be deleted.

    Line

    Indicates the one‑ to five‑digit sequence number, from 1 to 99999, of the indirect command, which must be followed by at least one blank space. This number must be the first item entered except for continued commands, and must begin in the first position of the input line.

    Command

    Displays the actual command text to be performed during Indirect Command execution from a breakpoint. For a complete listing of indirect commands, see Indirect Command Syntax.