ABEND

None

Display the Abend Breakpointed Task screen (this command is available only at a breakpoint)

ABI ON

None

Default. Turn Abend Intercept on—intercepts all CICS abends and produce an automatic breakpoint screen providing there a CICS HANDLE ABEND LABEL/PROGRAM is not active. If you want to intercept CICS abends for programs that have an active CICS HANDLE LABEL/PROGRAM then see the ABI FORCE command.

ABI OFF

None

Turn Abend Intercept off—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 can also be 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 verbs at a time displaying the current source statement for a y interval of time. This command is only available at a breakpoint. One verb at a time until next CALL/COMMAND is the default.

Note: This command is available only at a breakpoint.

BOTTOM

BOT

None

GO to bottom of source

BPO

None

Jump to Breakpoint Option screen

BWD

PF7

Scrolls backward. The scroll amount is set on the Source Listing Profile.

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.

CHANNEL

None

Displays the currently allocated channel and the containers in the channel. From the selection list you can also display the data within a container. This feature is only valid in CICS releases that support CHANNELs and Containers.

CNTL

None

Displays the CNTL Command Menu.

Note: The Monitoring Menu (2) is an alternative to using the CNTL menu; for details, see the chapter "Monitoring Menu Options."

COMPOSITE

None

Sets composite monitoring options for monitoring of subprograms. This command is used to establish the current load module name when setting/removing breakpoint options on subprograms that are monitored under the same name in more than one composite load module. For more details, see Composite Support for Duplicate Subprograms at the end of this chapter.

CORE

None

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

COUNTS SHOW

None

Turns the Code Coverage COUNTER display on. To activate Code Coverage see Customizing the Source Listing Profile or issue PROFILE command.

COUNTS NOSHOW

None

Turns the Code Coverage COUNTER display off. 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 the Code Coverage COUNTER display on and highlights program statements that match the criteria. The source listing is repositioned to the first statement matching the criteria.

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

Valid 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.

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 will then be 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 are no longer able to 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. (this command is available only at a breakpoint)

DOWN

None

Shifts 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.

FP

None

Find paragraph.

FS

None

Find statement number.

FWD

PF8

Scrolls forward the amount indicated on the Source Listing Profile.

HELP

PF1

Displays help for the Source Listing Facility.

IC

None

Jump to Indirect Command screen.

ITST

See MENU

Displays the ITST 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, a label, or part of the listing.

MARGIN

MAR

None

Shift listing to specific margin.

MENU

PF6

Displays the high‑level menu. When not at a breakpoint, it is the ITST Primary Option Menu; when at a breakpoint, it is the Breakpoint Primary Option Menu.

MONITOR

PF5

Sets monitoring for the current program using the CICS user ID displayed on the Profile.

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/ will be 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

Sets or removes 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, you can also display 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 Source Listing Profile, where you can change settings for the current session.

RBP

None

Sets or removes request breakpoints

RIGHT

Shifts listing right

RO

None

Sets or removes replacement options

RUN

None

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

SET

None

Initializes a data‑item's value. This command is available only at a breakpoint.

SO

None

Sets or removes special options

SDFDATA

None

Set to display data in structure display format for the current program.

SDFHEX

None

Set to display 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. You can 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 validate the crumple zones for each piece of storage. See The STORAGE Facility in the chapter "Breakpoint Activities."

TOP

None

Go to top of source.

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 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.

UP

None

Shift listing up.

=x.y.z

None

Fast-path to Primary Menu Option x.y.z.