ABEND

None

Display the Abend Breakpointed Task screen

ABI ON

None

Turn abend intercept on (default). This intercepts all CICS abends and produces an automatic breakpoint screen providing a CICS HANDLE ABEND LABEL/PROGRAM is not active.

If you want to intercept CICS abends for programs having an active CICS HANDLE LABEL/PROGRAM, see the ABI FORCE command.

ABI OFF

None

Turn abend intercept off. This causes CA InterTest for CICS to stop intercepting CICS abends. No automatic breakpoint screen appears and the program abends.

ABI FORCE

None

Turn Abend Intercept on for all CICS ABENDS, even if a program has an outstanding HANDLE ABEND active or issues a CICS HANDLE ABEND command.

Use this option when you want an automatic breakpoint screen for programs that also have active HANDLE ABENDS to process their own errors.

ADVANCE n

ADV n

A n

None

Advances n entries in the statement trace table and displays the resulting statement. (If n is not specified, it defaults to 1.) If data monitoring is active, past data values for the statement are also displayed. Use this command to redisplay the execution sequence of a program. Statement tracing must be active for the ADVANCE command to function (see the TRACE option).

Note: This command is only valid for COBOL programs.

AUTOSTEP x y

AS x y

None

Resume execution x verb(s) at a time displaying the current source statement for a y interval of time. This command is available only at a breakpoint. Default: One verb at at time until next CALL/COMMAND.

BOTTOM

BOT

None

GO to bottom of source.

BPO

None

Jump to Breakpoint Option screen.

BTRACE

PF11

Backtrace. Displays the backtrace summary. This command is available only at a breakpoint.

BWD

PF7

Scroll backward. Set the scroll amount on the Source Listing Profile. Does not apply within the Keep window.

CALLTRACE

None

Shows the program call flow leading up to the currently breakpointed program. Select programs having symbolic support from the list and display their data areas. Select channels at a specific program level from the CALLTRACE program list.

CHANNEL

None

Displays the currently allocated channel and the containers in the channel. Display the data within a container from the selection list .This feature is only valid in CICS releases that support CHANNELs and Containers.

CNTL

None

Displays the CNTL Command Menu.

Note: The Monitoring Menu (=1.2) is an alternative to using the CNTL menu.

COMPOSITE

None

Set composite monitoring options for monitoring of sub‑programs.

CORE

None

Displays the Main Storage menu. Select an option to view a main storage (CORE) display.

COUNTS SHOW

None

Turns on the code coverage COUNTER display. To activate code coverage, see Customizing the Source Listing Profile or issue PROFILE command.

COUNTS NOSHOW

None

Turns off the code coverage COUNTER display. To deactivate code coverage, see Customizing the Source Listing Profile or issue the PROFILE command.

COUNTS RESET

None

Resets the program code coverage statement counters to zero.

COUNTS op value

None

Turns on the code coverage COUNTER display and highlights program statements that match the criteria. The source listing is repositioned to the first statement matching the criteria.

Op values: EQ or =, NE or <>, LT or <, GT or >, LE or <= or =<, GE or >= or =>

Values: 0 to 9999

COUNTS NEXT

None

Repositions the source listing to the next statement that matches the previously specified COUNT op value criteria.

COUNTS ALL

None

Removes previously specified COUNT op value criteria and redisplays source listing without special COUNTER highlighting.

CS

None

Go to current breakpoint source statement. This command is available only at a breakpoint.

DATAMON

DM

None

Displays the Monitoring Command Builder menu to set and remove statement tracing and data monitoring.

Note: This command is only valid for COBOL programs.

DATAMON ON

DM ON

None

Turns data monitoring on. This causes CA InterTest for CICS to capture data values for each executed statement in the program. You are then able to redisplay these values at a breakpoint, by tracing backward and forward through the entries in the statement trace table using the PREV and ADVANCE commands. DATAMON ON forces TRACE ON.

Note: This command is only valid for COBOL programs.

DATAMON OFF

DM OFF

None

Turns data monitoring off. This causes CA InterTest for CICS to stop capturing data values for each executed statement in the program. In addition, you can no longer display captured data values when tracing backward and forward through the entries in the statement trace table using the PREV and ADVANCE commands.

Note: This command is only valid for COBOL programs.

DISPLAY data‑item

D data‑item

None

Displays the storage of a data name.

DOWN

None

Shift listing down.

END

PF3

Returns to the prior display or menu.

FILE

None

Displays the Auxiliary Storage menu. Select an option to view a file or queue.

FIND

F

None

Find a string

FO

None

Find hexadecimal offset. This command is available only at a breakpoint.

FP

None

Find paragraph.

FS

None

Find statement number.

FWD

PF8

Scrolls forward the amount indicated on the source listing Profile. Does not apply within the Keep window.

GO

None

Continue until the next intercept occurs. This command is available only at a breakpoint.

HELP

PF1

Displays help for the source listing facility.

IC

None

Jump to Indirect Command screen.

ITST

None

Displays the Primary Option menu.

KEEP data‑item

K data‑item

None

Add a data‑item to the static keep window

LEFT

None

Shift listing left.

LOCATE

LOC

L

None

Locate line number or part of the listing.

MARGIN

MAR

None

Shift listing to specific margin.

MENU

PF6

Displays the Breakpoint Primary Option menu.

MONITOR

None

Sets monitoring for the listed program.

NEXT

N

PF10

Execute the next verb in a program. This command is available only at a breakpoint.

NEXT OVER

None

Continue the test session when stopped on a PERFORM or CALL until the statement following the PERFORM or CALL is encountered, where a break point occurs.

NEXT RETURN

None

Continue the test session when stopped within a paragraph or subroutine until the session encounters the statement following the PERFORM or CALL that invoked the current paragraph or subroutine, where a break point occurs. TRACE ON must be enabled.

OFFALL

None

Removes all breakpoints set by active USER or TERMINAL. Active USERID is used if a valid USERID is signed on. Otherwise, the active TERMINAL is used.

ALL breakpoints for ALL programs/transactions/ are removed that were set by the active USERID or active TERMINAL.

OFFALL TERM

None

Removes all breakpoints set by active TERMINAL.

OFFALL USER

None

Removes all breakpoints set by active USER.

PO

None

Set or remove storage protection options

PREV n

P n

None

Backs up n entries in the statement trace table and displays the resulting statement. (If n is not specified, it defaults to 1.) If data monitoring is active, display also past data values for the statement. Use this command to step backward through the execution of a program. Statement tracing must be active for the PREV command to function (see the TRACE option).

Note: This command is only valid for COBOL programs.

PROFILE

PF4

Displays the source listing Profile, where you change settings for the current session.

RBP

None

Set or remove Request Breakpoints

RESETBKP

Clear

Repositions breakpointed task at current breakpoint.

RESUME

PF5

Resumes breakpointed task at next sequential instruction. This command is available only at a breakpoint.

RIGHT

None

Shift listing right.

RO

None

Set or remove replacement options

RUN

None

Resume execution ignoring all breakpoints. This command is available only at a breakpoint.

SET

None

Initialize a data‑item's value

SO

None

Set or remove special options

SDFDATA

None

Displays data in Structure Display Format for the current program.

SDFHEX

None

Displays data in hexadecimal/character format for the current program.

STATUS

PF12

Displays the Monitoring Status report (Option 2.4 on the Primary Option Menu) for the current program. Remove monitoring, breakpoints, and options directly from the Status display.

STATUS
ALL

None

Displays the Monitoring Status report for all programs, transactions, and terminals CA InterTest for CICS is monitoring in the region.

Storage

None

Displays a listing off all USER and CICS class storage associated with the currently breakpointed task (most storage acquired by CA InterTest for CICS is not displayed), this command also checks the crumple zones of each piece of storage for validity.

TRACE

TR

None

Displays the Monitoring Command Builder menu to set and remove statement tracing and data monitoring.

Note: This command is only valid for COBOL programs and is unrelated to the Backtrace facility.

TRACE ON

TR ON

None

Turns statement tracing on. The number of entries to be saved in the statement trace table is determined by the STMTTRCE option in IN25OPTS. The default is 1000.

Note: This command is only valid for COBOL programs and is unrelated to the Backtrace facility.

TRACE OFF

TR OFF

None

Turns statement tracing off. TRACE OFF forces DATAMON OFF.

Note: This command is only valid for COBOL programs and is unrelated to the Backtrace facility.

TOP

None

Go to top of source.

UP

None

Shift listing up.

=x.y.z


=1.x.y.z

None

Fast-path to Breakpoint Primary Menu Option x.y.z, discussed in the "Breakpoint Activities" chapter. Equivalent ITST Primary Option Menu fast-path entries are =1.x.y.z.

<{nnnn}

None

Used in the Keep window to scroll data item storage left nnnn bytes.

>{nnnn}

None

Used in the Keep window to scroll data item storage right nnnn bytes.