Accessing the EXEC testing facility

Figure 1 shows an example.

After the EXEC Management panel is displayed, test an EXEC by following these steps:

To test an EXEC

1. Locate the EXEC name in the member list.
2. In the LC column, place a T (for Test EXEC).In Figure 1, an EXEC named PARSE is selected to be tested.

3. Press the Enter key.The EXEC is loaded and the EXEC Test panel is displayed automatically (Figure 2).

   Figure 2. EXEC test Control panel

   BMC Software --------------------- EXEC Test ---------------------------------
   COMMAND ===>
   EXEC === PARSE     ID === 3                                  DATE --- 01/01/01/29
   Options: B - Browse EXEC output        V - Variable access   TIME --- 07:59:48
            C - Conditional Breakpoints   O - OSPI session display
   Primary Commands:
       STEP - Single step execution       CONTinue - Execute, stop at breakpoints
       RUN  - Execute without stopping    CANcel   - Terminate execution
       L    - Locate by line number       Find     - Find string
       OFF  - Remove all breakpoints      CMDSHOW ON/OFF -Show/remove this display
       SKIP - Skip current statement      FORCE    - Force terminate EXEC
       VARON/VAROFF | EXPAND - Variable substitution on current line
   Line Commands --- Break (A)fter, Break (B)efore, (O)ff
            ***************************************************************
          B->PROC 2 P1 DSNAME                                               00001
             /************************************************************* 00002
             /*                                                             00003
             /* DOC GROUP(SYSTEMS) AUTHOR(ERNST) FUNC(UTIL)                 00004
             /* DOC DESC(ENQ CHECKER FOR MULTISYSTEM)                       00005
             /*                                                             00006
             /************************************************************* 00007
             GLOBAL NROFTARGETS                                             00008
             SET EOF=FALSE                                                  00009
             SET NROFTARGETS=0                                              00010

   The EXEC Test Control panel shows a scrollable listing of the EXEC at the bottom of the panel. The upper portion of the panel contains information about the available commands. Whenever an EXEC is tested, the debugger suspends execution before the first statement.

   The current position of the EXEC during testing is indicated by three factors:

   • The line is highlighted.
   • An arrow to the left of it points at it.
   • The character B (for before) or A (for after) prefixes it.

   The field near the top of the panel, labeled EXEC, contains the name of the currently tested member. When working with nested EXECs (EXECs that call other EXECs as subroutines by using the IMFEXEC SELECT WAIT(YES) command), the debugger always reflects the name of the EXEC currently executing. Therefore, the value of the EXEC field can change during the debugging session and may be used to establish a point of reference for the level of processing.

   If you are debugging an EXEC (EXECA) that calls another EXEC (EXECB) with IMFEXEC SELECT WAIT(NO), EXECB will execute and the debugging application has no control over EXECB and EXECB cannot be debugged.

   The ID field shows the identification assigned to the current thread, so it remains constant throughout the debugging session. This field also reflects the number of EXECs executed since the last MainView AutoOPERATOR SS restart (this number does not include nested EXECs).

   Because a large portion of the panel is taken up by command information that is not required by the more advanced user, the bottom portion of the panel can be expanded to cover the upper portion of the panel.

4. To expand the view, issue the CMDSHOW OFF primary command.The panel will look like Figure 3:

   Figure 3. EXEC test Control panel--advanced format

   BMC Software ---------------------- EXEC Test -------------------- AutoOPERATOR
   COMMAND ===>
   EXEC === PARSE     ID === 3
            ***************************************************************
          B->PROC 2 P1 DSNAME                                               00001
             /************************************************************* 00002
             /*                                                             00003
             /* DOC GROUP(SYSTEMS) AUTHOR(ERNST) FUNC(UTIL)                 00004
             /* DOC DESC(ENQ CHECKER FOR MULTISYSTEM)                       00005
             /*                                                             00006
             /************************************************************* 00007
             GLOBAL NROFTARGETS                                             00008
             SET EOF=FALSE                                                  00009
             SET NROFTARGETS=0                                              00010
             ERROR DO                                                       00011
               IF &LASTCC=400 THEN DO                                       00012
                 SET EOF=TRUE                                               00013
                 CLOSFILE MYJNT                                             00014
                 RETURN                                                     00015
               END                                                          00016
               ELSE DO                                                      00017
                 EXIT                                                       00018
               END                                                          00019
             END                                                            00020