AA SNAP

Displays the Abend-AID Snapshot report.

ACCEPT

For COBOL, assigns a value to a data item.

AFTER

Sets a breakpoint after the execution of an instruction.

Valid locations could be: statement-number, paragraph-name, program-name, label-name, procedure-name, module-name, address, address-expression, CSECT name, +/- offset, ALL STATE, ALL PARA, ALL PROG, ALL PROC, ALL LABELS, ALL FUNC, ALL SQL [subtype], ALL DLI [subtype], ALL MQ [subtype], ALL variable, a list separated by spaces or commas, or a range using the keyword THRU.

ALLOCATE

Dynamically accesses the file allocation utility (FAU) from the debugging session, or allocates an existing file allocation list contained in the named data set.

AT

Sets a breakpoint in a program without source.

BEFORE

Sets a breakpoint before the execution of an instruction.

Valid locations could be: statement-number, paragraph-name, program-name, label-name, procedure-name, module-name, address, address-expression, CSECT name, +/- offset, ALL STATE, ALL PARA, ALL PROG, ALL PROC, ALL LABELS, ALL FUNC, ALL SQL [subtype], ALL DLI [subtype], ALL MQ [subtype], ALL variable, a list separated by spaces or commas, or a range using the keyword THRU.

BOTTOM

Scrolls to the bottom of the currently displayed data.

BROWSE

Displays files or data sets.

CCHILITE

CCHILITE provides visual cues with annotation and a high-intensity background to indicate which lines have or have not been executed.

CONNECT

Connects the terminal to a Code Debug TSO Batch Connect job.

COUNT

Sets execution counters to gather test coverage statistics.

Valid locations could be: statement-number, paragraph-name, program-name, label-name, procedure-name, module-name, address, address-expression, CSECT name, +/- offset, ALL STATE, ALL PARA, ALL PROG, ALL PROC, ALL LABELS, ALL FUNC, ALL SQL [subtype], ALL DLI [subtype], ALL MQ [subtype], ALL variable, a list separated by spaces or commas, or a range using the keyword THRU.

COVER

Used in the input command stream (XPIN DD) to activate Code Coverage functionality for the current test. Use the OptionsBlock positional parameter to specify the System-Name in positions 1-15 (followed by a blank), the Test-ID in positions 17-31 (followed by a blank), the optional User-ID in positions 33-40 (followed by a blank), and the Function-ID in position 42.

DELETE

Turns off or negates the effect of other Code Debug commands. Will also remove any unused inserted lines created with the I (Insert) line command.

See to the specific primary command for a list of valid location choices.

Disconnects the terminal from a Code Debug TSO Batch Connect job.

DLEFT

Scrolls the data in a Keep or Peek window to the left by the specified scroll amount.

DLI

Issues calls to IMS using the standard IBM CBLTDLI (COBOL), ASMTDLI (Assembler), DL/I (PL/I or C), or AIBTDLI interface.

DOWN

Scrolls toward the bottom of the data.

DRIGHT

Scrolls the data in a Keep or Peek window to the right by the specified scroll amount.

DROP

Valid only for Assembler, DROP releases addressability from a DSECT established with the USING command.

END

Terminates the current function and returns to the previous screen.

EXCLUDE

Excludes data lines from displaying in the source.

Terminates the current test session. The LAST parameter causes the step completion code to reflect the last abend condition intercepted during the session. The ABEND parameter causes the step to terminate with the specified abend code.

FADB2

Accesses File-AID for DB2. Valid only with Code Debug Db2 Extension.

Searches for character strings, data names, and COBOL structures. String delimiters can be '', "", == ==, or nothing. Any number of optional parameters can be specified with a required parameter. FIND without a keyword repeats the last find.

Find Syntax (Assembler, PL/I, and C)

COBOL FIND Syntax (Format 1)

COBOL FIND Syntax (Format 2)

COBOL FIND Syntax (Format 3)

COBOL FIND Syntax (Format 4)

The following keywords can be used with the COBOL-structure parameter:

Valid only for COBOL and Assembler, GEN expands macros or compressed EXEC code.

GETMAIN

Valid only for Assembler, GETMAIN allocates virtual storage. Any number of optional parameters can be specified with a required parameter.

GO

Begins execution or resumes execution following a pause.

GOBACK

Valid only for COBOL, GOBACK changes the program logic and returns to the next higher level module.

GOTO

Repositions the current execution pointer.

CAUTION:

Be careful using the GOTO command. When you GOTO a source statement, you can also be inadvertently bypassing execution of several underlying machine instructions. This can affect subsequent statements and cause unpredictable results including, but not limited to, abends (especially S0C4 and S0C7), loops, storage overlays, and logic and display errors.

GPREGS

Displays the contents of the general-purpose registers.

HELP

Displays additional information about an error message or provides tutorial information. HELP * redisplays the most recently browsed help file.

IF

Establishes a conditional expression within a block of inserted lines.

INCLUDE

Executes a predefined test script during the session.

INSERT

Temporarily inserts Code Debug TSO commands. The following primary command syntax outlined can be used only in unattended batch or in an INCLUDE test script. INSERT is only valid as a line command in interactive mode. You can remove all unused inserted lines by entering a DELETE or RESET primary command with no keywords.

INTERCEPT

In an interactive test, the INTERCEPT command loads a module, sets before and after breakpoints, and displays the source. In an interactive test in BTS or Dialog box Manager, Code Debug TSO automatically generates the command.

In an unattended batch test, INTERCEPT is used in the command stream to identify programs to be intercepted. In a BTS batch test, the only commands allowed in the command stream are INTERCEPT command parameters and the XPED command.

Continuously displays the values of program variables in a Keep window. KeepE keeps the contents of the elementary items of a group level variable. KeepH keeps the contents in hexadecimal format. Displayed values are updated as each breakpoint is encountered.

Scrolls the source listing to the left by the specified scroll amount.

LINE

Determines whether the line command area will display statements, offsets, or addresses.

LOAD

Dynamically loads a module.

LOCATE

Scrolls to a particular line number in the current program. LOCATE * scrolls to the current execution point.

LOG

Browses the session log.

MEMORY

Displays memory from a specified location.

Pointer qualification (->) is valid for PL/I.

MONITOR

Valid COBOL, MONITOR records the program’s execution in a buffer. REVERSE can be used to execute in review mode at a later time.

MOVE

Changes the contents of program variables. In an interactive test, typing over the displayed value is an implicit MOVE command.

COBOL, PL/I, and C Syntax

Assembler Syntax

NOLINES

Suppresses the message XXX LINES NOT DISPLAYED that appears after an EXCLUDE command or keyword is issued.

ONETIME

Sets a temporary before breakpoint to pause once before execution of an instruction.

PAUSE

Sets a pause breakpoint within a block of inserted lines (interactive mode) or commands (batch mode).

PEEK

Displays the values of program variables. PeekE displays the contents of the elementary items of a group level variable. PeekH displays the contents in hexadecimal format.

Creates a temporary pseudo-assembler view for a module or CSECT that has no matching BMC source listing.

RESET

Restores excluded lines on the source screen, removes any pending line commands, and removes any unused inserted lines created with the I (Insert) line command.

RESUME

Valid only for COBOL, RESUME exits review mode and returns to the current execution position.

RETEST

Begins a new test of the same program, even if the current test has not completed. Valid only in the TSO standard environment.

RETURN

Valid only for PL/I and Assembler, RETURN changes the program logic and goes to the return linkage of a program.

REVERSE

Valid only for COBOL, REVERSE reviews the execution path that led to the current breakpoint. Requires previous entry of the MONITOR command.

RIGHT

Scrolls the source listing to the right by the specified scroll amount.

RUN

Submits an execution JCL file and connects to the specified job.

RUNTO

Sets a onetime breakpoint and starts execution.

SCRNSAVE

Copies the current Code Debug TSO screen to the Code Debug session log.

SET

Overrides Code Debug TSO defaults. Some values are set only for the duration of the test session, while others are maintained across sessions. For more information, see the and Command-and-syntax-reference.

Parameter Group 1

Parameter Group 2

Parameter Group 3

The following restrictions apply to certain SET command parameters:

Displays breakpoints, diagnostic information, or the SET command options.

Temporarily bypasses the execution of a statement.

Valid locations could be: statement-number, paragraph-name, program-name, procedure-name, label-name, address, +/- offset, address-expression, module-name, ALL STATE, ALL PARA, ALL PROC, ALL LABELS, ALL PROG, ALL FUNC, ALL SQL [subtype], ALL DLI [subtype], ALL MQ [subtype], ALL variable, a list separated by spaces or commas, or a range using the keyword THRU.

Changes the module shown on the source display when testing interactively. In unattended batch (or in an INCLUDE file), use the SOURCE command to qualify a module to be associated with subsequent Code Debug commands.

The parameter descriptions for the SOURCE command are:

module-name

The name of the module, external procedure, entry point, or CSECT to be displayed on the Source screen. You can also see to a program or module by the name of the load module.

load-module

The name of the composite load module. If the module name and the load module name are the same, a value is not required for this field.

STATUS

Displays the Status screen which contains a list of the jobs in the system.

TEST

Specifies the name of the program to be tested and the parameters necessary to establish the test. This command is used in the input command stream (XPIN DD).

Allows you to switch back and forth between the Listing screen and the Storage screen for all languages.

TOP

Scrolls to the top of the data.

TRACE

Monitors the program’s logic flow. If MAX n is not used, the default is 25 in interactive mode and 2500 in unattended batch mode.

Valid locations could be: statement-number, paragraph-name, program-name, procedure-name, label-name, address, +/- offset, address-expression, module-name, ALL STATE, ALL PARA, ALL PROC, ALL LABELS, ALL PROG, ALL FUNC, ALL SQL [subtype], ALL DLI [subtype], ALL MQ [subtype], ALL variable, a list separated by spaces or commas, or a range using the keyword THRU.

UP

Scrolls toward the top of the data.

USE

Valid only for COBOL in IMS subprogram testing. Establishes addressability for database PCBs in the linkage section.

Valid with Code Debug TSO only when the value of SUB is specified as a test session parameter for the IMS environment.

USING

Valid only for Assembler, USING temporarily establishes addressability to a DSECT. USING is effective only if the program has established a base register for the DSECT and loaded the base register with the appropriate value.

VERIFY

Valid only for Assembler, VERIFY displays the contents of an instruction or data area.

WHEN

Indicates when a specified condition is true or when a program variable changes value. In an interactive test, execution is paused. In an unattended batch test, execution does not pause. A message is written to the session log indicating that the specified condition has been met.

Displays the location of a specific address or CSECT.

WS

Valid only for COBOL, WS displays working storage.

XCHANGE

Accesses Xchange to simulate date and time changes for your applications.

XPED

Specifies the environment in the input command stream (XPIN DD). Valid environments are BATCH (default), BATCH PEM, BTS, BTS PEM, IMS, IMS PEM, TSO, and TSO PEM.