Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Application and system primary commands

Related topics

Quick-Reference

Code Debug CICS Primary Commands

Primary Commands for Code Debug CICS

This section summarizes the application and system primary commands for Code Debug CICS.

ABEND

Transfers to the Exit Session screen (X).

qabend.png

ACCESS

Links to third-party programs to display data pertinent to the system. ACCESS MAP displays BMS maps online. LINK is an alias of ACCESS.

qaccess.png

AFTER

Sets a breakpoint after the execution of a statement.

qafter.png

operator

The following are valid operator values with synonyms in parentheses.

EQ (=)

GT (>)

LT (<)

NE (< >) or (¬ =)

GE (> =)

LE (< =)

literal

Literal value that can be a number, alphanumeric string, hexadecimal string, or asterisk (*) as follows:


    • Numbers can be optionally preceded or followed by a sign.
    • An alphanumeric string must be enclosed in single or double quotes.
    • A hexadecimal string must be enclosed in single or double quotes and preceded by an X.
    • An asterisk (*) indicates the current variable value.

ALLOW

Allows a currently trapped storage violation to take place if this command is enabled in the global table.

qallow.png

BEFORE

Sets a breakpoint before the execution of a statement.

qbefore.png

operator

The following are valid operator values with synonyms in parentheses.

EQ (=)

GT (>)

LT (<)

NE (< >) or (¬ =)

GE (> =)

LE (< =)

literal

Literal value that can be a number, alphanumeric string, hexadecimal string, or asterisk (*) as follows:


    • Numbers can be optionally preceded or followed by a sign.
    • An alphanumeric string must be enclosed in single or double quotes.
    • A hexadecimal string must be enclosed in single or double quotes and preceded by an X.
    • An asterisk (*) indicates the current variable value.

BOTTOM

Scrolls to the bottom of data.

qbottom.png

CALC

Performs the mathematical operations specified in the expression and displays the result in the message area of the screen. Expressions can include parentheses, operators, registers, variables, literals, labels, etc. For more details, consult the Code Debug CICS Reference Manual or use the HELP CALC command.

qcalc.png

CAPTURE

Starts the capture of a script. Also ends the capture and saves the script to a user or system script data set. To execute a script, use the INCLUDE command.

qcapture.png

CHAIN

Follows a CICS storage chain on the Memory Display screens (2.2, 9.2).

qchain.png

COLS

Displays or removes columns as the first line in the source area on the Source Listing screen (2.L).

qcols.png

COUNT

Sets execution counts and gathers test coverage statistics.

qcount.png

DBOTTOM

The DBOTTOM command scrolls to the end of the displayed data. On the 2.L screen, where multiple windows can exist (one each for Keep displays and Source displays), the DBOTTOM command scrolls the Keep window exclusively, regardless of cursor position.

qdbottom.png

DDOWN

The DDOWN command scrolls forward through the data currently displayed on the screen. On the 2.L screen, where multiple windows can exist (one each for Keep displays and Source displays), the DDOWN command scrolls the Keep window exclusively, regardless of cursor position.

qddown.png

DELETE

Deletes breakpoints, counts, keeps, skips, verifies, and whens activated in a program. DELETE MONITOR deactivates review mode.

QDELETE.png


operator

The following are valid operator values with synonyms in parentheses.

EQ (=)

GT (>)

LT (<)

NE (< >) or (¬=)

GE (> =)

LE (< =)

literal

Literal value that can be a number, alphanumeric string, hexadecimal string, or asterisk (*) as follows:


    • Numbers can be optionally preceded or followed by a sign.
    • An alphanumeric string must be enclosed in single or double quotes.
    • A hexadecimal string must be enclosed in single or double quotes and preceded by an X.
    • An asterisk (*) indicates the current variable value.

DISPLAYP

Transfers to the Memory Display screen (2.2).

qdisplay.png

DLEFT

The DLEFT command scrolls the current window to the left. On the 2.L screen, where multiple windows can exist (one each for Keep displays and Source displays), the DLEFT command scrolls the Keep window exclusively, regardless of cursor position.

qdleft.png

DOWN

Scrolls down by the specified amount. The default scrolling value is displayed in the SCROLL field.

qdown.png

DRIGHT

The DRIGHT command scrolls the current window to the right. On the 2.L screen, where multiple windows can exist (one each for Keep displays and Source displays), the DRIGHT command scrolls the Keep window exclusively, regardless of cursor position.

qdright.png

DS

Transfers to the Display Storage screen (2.3).

qds.png

DTOP

The DTOP command scrolls to the start of the data currently displayed on the screen. On the 2.L screen, where multiple windows can exist (one each for Keep displays and Source displays), the DTOP command scrolls the Keep window exclusively, regardless of cursor position.

qdtop.png

DUP

The DUP command scrolls backward through the data currently displayed on the screen. On the 2.L screen, where multiple windows can exist (one each for Keep displays and Source displays), the DUP command scrolls the Keep window exclusively, regardless of cursor position.

qdup.png

ELEMENT

Breaks 01 group-level items into elementary items when the Program Storage screen (2.3) is in vertical hex mode (HEX ON).

qelement.png

END

Terminates the current function and returns to the next higher level menu.

qend.png

EXCLUDE

Excludes data that is normally displayed on the Source Listing screen (2.L). The RESET command resets the screen display.

qexclude.png

EXIT

If AUTOXIT in the global table is set to YES (default), EXIT clears the screen and returns to CICS. If AUTOXIT is set to NO, EXIT transfers to the Exit Session screen (X).

qexit.png

FILE

Transfers to the File Utility Menu (5).

qfile.png

FIND

Positions the cursor on a specified string or data item.

CSECT Selections Screen (2.6.2)

Searches for the specified module or CSECT. The string must be a complete module or CSECT name.

qfind2.png


Memory Display Screen (2.2, 9.2) and Browse Container Data Screen (2.C.3)

Searches for a specified string.

qfind2_1.png


Source Listing Screen (2.L)

Searches for the specified program line, location, or string.

qfind3.png


Program Storage Screens (2.3)

Locates a specified occurrence of a string.

qfind4.png


Task Storage Display Screen (2.S)

Locates the first occurrence of a string on the currently selected chains.

qfind6.png

GO

Resumes execution and follows specified parameters, if any. The number parameter is the number of statements to be executed and delay is the delay interval in seconds between successive statements. The OVER operand allows you to step a COBOL PERFORM paragraph statement and stop at the next executable statement following the PERFORM.

qgoover.png

Parameter Group 1

qgooverparm1.png


Parameter Group 2

qgooverparm2.png

operator

The following are valid operator values with synonyms in parentheses.

EQ (=)

GT (>)

LT (<)

NE (< >) or (Ø =)

GE (> =)

LE (< =)

literal

Literal value that can be a number, alphanumeric string, hexadecimal string, or asterisk (*) as follows:


    • Numbers can be optionally preceded or followed by a sign.
    • An alphanumeric string must be enclosed in single or double quotes.
    • A hexadecimal string must be enclosed in single or double quotes and preceded by an X.
    • An asterisk (*) indicates the current variable value.

GOTO

Repositions the current execution pointer.

qgoto.png

GPREGS

Displays general purpose registers in the footer area of the screen.

qgpregs.png

GROUP

Displays only 01 and 77 group data items when the Program Storage screen (2.3) is in vertical hex mode (HEX ON).

qgroup.png

HELP

Displays online help. The default is to display help for the current screen.

qhelp.png

HEX

Selects a display mode on the Break/Abend (2.1), Program Storage (2.3), Browse Container Data (2.C.3), and Source Listing (2.L) screens. The available formats are symbolic (HEX OFF), dump format (HEX DUMP), and vertical hexadecimal (HEX ON or HEX VERT). HEX DUMP is not available on the 2.1 and 2.L screens.

qhex.png

INCLUDE

Starts execution of a previously created script.

qinclude.png

INTERCEPT

The INTERCEPT command is used to load the program or a statically-linked subroutine within the program, then set a before breakpoint.

qintercept.png

KEEP

Displays the contents of a data item in the scrollable and sizeable keep window. To change displayed data, overtype it with a new value.

qkeep.png

KEYS

Accesses the Primary PF Key Settings screen (0.2), which you can use to change PF key assignments. Use the END command or a PF key to return to the previous screen.

qkeys.png

LEFT

Scrolls to the left by the specified amount. The default scrolling value is displayed in the SCROLL field.

qleft.png

LIBRARY

Displays information about the program and a corresponding program listing.

qlibrary.png

LOAD

Loads a program into Code Debug. Can also load a program and select a specified CSECT. When capturing a script, entering a program or module name on a screen creates an equivalent LOAD command in the script.

qload.png

LOCATE

Locates an abend, breakpoint, line number, listing area, offset, paragraph, variable (e.g., data name), or a storage area encompassing an address.

Global Command

Transfers to the Source Listing screen (2.L) or Assembler Break/Abend screen (2.20) and scrolls to the first executable statement or current execution pointer.

qlocate.png


Source Listing Screen (2.L) — Source Window

Positions to a specified area in the displayed source listing.

qlocate2.png


List of CSECTs Screen (2.6.1)

Locates a CSECT within a list.

qlocate3.png


List of DLL Functions Screen (2.6.F)

Locates a function within a list.

qlocate2.6.F.png


Program Storage Screens (2.3)

Locates a cell, COMMAREA, EIB, TWA, or working storage.

qlocate4.png


2.L and 2.1 Screens — Keep Window

Positions to the variable-name in the keep window if the cursor is in that window.

qlocate5.png


Task Storage Screen (2.S)

Locates an area containing an address within its boundaries.

qlocate8.png

LOCK

Ensures that an address is not deleted from the select address table on the Select Address screen and Memory Display screens (2.2, 9.2).

qlock.png

MEMORY

Transfers to the Memory Display screen (2.2).

qmemory.png

MENU

Returns immediately to highest level system menu.

qmenu.png

MONITOR

Starts review mode. Used with REVERSE and GO n commands to review program execution.

qmonitor.png

MOVE

Modifies contents of program variables. The MOVE command has the same rules and behaviors as the COBOL MOVE verb.

qmove.png

NEXT

Displays the next address from the select address table for the Memory Display screens (2.2, 9.2).

qnext.png

ONETIME

Sets a temporary breakpoint that pauses execution before the statement and is then automatically deleted. ONETIME CSR is only valid on the Source Listing screen (2.L) when the cursor is in the listing window.

qonetime.png

PEEK

If the variable parameter is used, PEEK transfers to the Working Storage screen (2.3) and positions to the variable. If PSW or register parameter is used, the contents of the PSW or register are displayed in the message area of the current screen in the same way as with the CALC command. Valid only in a break/abend state.

qpeek.png

PFSHOW

Displays or hides Code Debug’s PF key settings.

qpfshow.png

PREV

Displays the previous address from the select address table for the Memory Display screens (2.2, 9.2).

qprev.png

PRINT

Spools a hard copy printout of the current program trace to the JES2/JES3 HOLD queue. Only valid on the Program Trace screen (2.4).

qprint.png

PSEUDOSOURCE

Creates a temporary Assembler source image of a CSECT that does not have a matching BMC source listing.

qpseudosource.png

REDISP

Redisplays the contents of the current screen.

qredisp.png

RELEASE

Removes breakpoints and keeps from a specified program. Must be used prior to performing a CICS newcopy.

qrelease.png

REPEAT

Re-executes the most recently entered command. Unlike the RETRIEVE command, REPEAT does not redisplay the previous command in the COMMAND field.

qrepeat.png

RESAVE

Overlays the saved excluded data with the current excluded data on the Source Listing screen (2.L).

qresave.png

RESET

Restores excluded lines on the Source Listing screen (2.L). Can also remove all special lines in the listing.

qreset.png

RESTORE

Redisplays the previous source display captured by a SAVE command on the Source Listing screen (2.L).

qrestore.png

RESUME

Resumes program execution from a breakpoint, abend, or storage violation. The default resumes execution at the current execution pointer. Also used to end review mode.

qresume.png

RETRIEVE

Retrieves the last command entered in the COMMAND field from the stack of commands. Repetitive entry of RETRIEVE cycles back through the last 20 entered commands.

qretrieve.png

REVERSE

Toggles the direction of review mode.

qreverse.png

RFIND

Repeats the last FIND command entered.

qrfind.png

RIGHT

Scrolls to the right by the specified amount. The default scrolling value is displayed in the SCROLL field.

qright.png

RUNTO

Sets a onetime breakpoint that pauses execution before the statement and is then automatically deleted. RUNTO issued from a trapped transaction will also issue a GO command after setting the onetime breakpoint. RUNTO CSR is only valid on the Source Listing screen (2.L) when the cursor is in the listing window.

qrunto.png

SAVE

Saves the current excluded data on the Source Listing screen (2.L).

qsave.png

SELECT

Typing the SELECT command, moving the cursor to the desired item, then pressing Enter selects the item. If the item is an address in the data portion of the Memory Display screen (2.2 or 9.2), the item becomes the new base address. Otherwise, SELECT transfers from the Memory Display screen to the Select Address screen.

qselect.png

SET

Allows you to change selected debugging session parameters and save them in a profile.

qset.png


Parameter Group 1

qsetparm1.png


Parameter Group 2

qsetparm2.png

SHOW

Modifies the format of selected screens to display data in different forms. For C, COBOL, and PL/I, SHOW WHEN transfers to the Show When screen (2.7).

Source Listing Screen (2.L)

Excludes all source statements except those specified in the command parameter. The RESET command resets the screen display.

qshow.png


Program Trace Screen (2.4)

Changes display to a list of executed paragraphs, procedures, or labels.

qshow2.png


Keep Display Areas

Modifies the format of the keep window on the Source Listing (2.L) and Break/Abend (2.1) screens and variables on the Program Storage (2.3) screen.

qshow3.png

SKIP

Temporarily bypasses the execution of a statement. The +offset parameter is only valid for Assembler programs.

qskip.png


operator

The following are valid operator values with synonyms in parentheses.

EQ (=)

GT (>)

LT (<)

NE (< >) or (¬ =)

GE (> =)

LE (< =)

literal

Literal value that can be a number, alphanumeric string, hexadecimal string, or asterisk (*) as follows:


    • Numbers can be optionally preceded or followed by a sign.
    • An alphanumeric string must be enclosed in single or double quotes.
    • A hexadecimal string must be enclosed in single or double quotes and preceded by an X.
    • An asterisk (*) indicates the current variable value.

SOURCE

Transfers to the Source Listing screen (2.L). TOGGLE is an alias of SOURCE.

qsource.png

SVCDUMP

Produces an MVS SVC dump. Only available to XPSP users.

qsvcdump.png

TOP

Positions display to the beginning of data on screens which permit scrolling.

qtop.png

UNLOCK

Unlocks the current address in the select address table on the Select Address screen and Memory Display screens (2.2, 9.2).

qunlock.png

UP

Scrolls up by the specified amount. The default scrolling value is displayed in the SCROLL field.

qup.png

VERIFY

Displays underlying object code for Assembler source. The Assembler instructions and data can be modified by overtyping the verify fields, but only if the program is not in protected storage. Note that when you delete a VERIFY that you have overtyped, the data is not restored. You must restore it to return to its initial value.

qverify.png

VS

Transfers to the Variable Storage screen (2.3) for PL/I.

qvs.png

WHEN

Sets conditional breakpoints for C, COBOL, and PL/I.

qwhenNEWCOMP2lines.png

operator

The following are valid operator values with synonyms in parentheses.

EQ (=)

GT (>)

LT (<)

NE (< >) or (¬ =)

GE (> =)

LE (< =)

literal

Literal value that can be a number, alphanumeric string, hexadecimal string, or asterisk (*) as follows:


    • Numbers can be optionally preceded or followed by a sign.
    • An alphanumeric string must be enclosed in single or double quotes.
    • A hexadecimal string must be enclosed in single or double quotes and preceded by an X.
    • An asterisk (*) indicates the current variable value.

WS

Transfers to the Working Storage screen (2.3) for COBOL.

qws.png

=

Transfers to the Primary Menu, or any screen ID entered.

qequal.png


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*