Source Listing: Command Line and PF Key Summary

[Pages:2]Source Listing: Command Line and PF Key Summary Perform any function listed below using the top Command line of Source displays. Many commands are also assigned to PF keys.

Breakpoint Commands apply when an executing program is stopped at a breakpoint. Display Commands apply when you are viewing a non-executing program.

Breakpoint Command

ABEND or =3 ABI AUTOSTEP ADVANCE

BOTTOM BPO BTRACE [PF11] BWD [PF7] CALLTRACE CNTL CNTL=cmd

CORE CORE=cmd COUNTS CS DATAMON DISPLAY DOWN END [PF3 Det Bkpt] FILE FIND FO FP

FS FWD [PF8]

GO HELP [PF1] IC ITST KEEP LEFT LOCATE

Display Command (PF Key)

ABI

BOTTOM BPO

BWD [PF7]

CNTL CNTL=cmd COMPOSITE CORE CORE=cmd

DATAMON

DOWN END [PF3]

FILE FIND FO FP

FS FWD [PF8]

HELP [PF1] IC ITST KEEP LEFT LOCATE

Description

Abends the task (Breakpoint Option 3) Turn ON/OFF interception of CICS ABENDS Step through program using a specified interval Position listing at the next executed statement in the statement trace table Position listing at the bottom of the source code Jump to the Breakpoint Options build screen Displays Backtrace Summary Scrolls listing backward amount set on Profile Displays Active Program Call Trace Menu Displays CNTL Command Builder menu Executes CNTL command entered Set composite monitoring for sub-programs/modules Displays CORE Main Storage Menu Executes CORE command entered Display the Code Coverage counters Reset breakpointed task at the breakpoint Set/Remove Data Monitoring Display the storage of a data-item Shift listing down a specified number of lines END returns to previous panel PF3 at breakpoint toggles displays Displays the FILE facility Find a string within a program online listing Position listing to a specific hex offset Position listing to a specific paragraph, procedure, or label Position listing to a specific line number Scrolls listing forward amount set on Profile, or to cursor location Continue processing at specific line number or label Displays online Help for current panel Jump to Indirect Commands build screen Displays ITST Primary Option Menu Add a data-item to the Keep Window Shift listing left a specific number of characters Locate a label, line number, offset, or special area within the program online source listing:

Breakpoint Command

MARGIN

Display Command (PF Key) Label

MARGIN MENU [PF6]

Description

Any valid label within an ASSEMBLER, COBOL, or PL/I program, including datanames, CSECT, procedure, and paragraph names (up to 31 characters)

Linenumber

Any line number within an ASSEMBLER, COBOL, or PL/I program

Hex-offset (ex. + 100)

.xx for PL/I The special indicator depends upon the language. For PL/I, use:

.AG Aggregate List

.DX Data Name Cross Reference

.EM Error Messages

.GC Generated Code

.LX Label Cross Reference

.OF Offsets

.PX Procedure Cross Reference

.SR Storage Registers

.SS Static Storage

.VS Variable Storage

.XR Cross Reference

.xx for COBOL

Special indicator dependent on language. For COBOL, use:

.CL COBOL/VS CLIST

.DM DMAP

.DX Data Name Cross Reference

.EM Error Messages

.LC Local-Storage Section

.LI

COBOL II LIST

.LS Linkage Section

.OF COBOL II OFFSET

.PD Procedure Division

.PM COBOL/VS PMAP

.WS Working-Storage Section

.PX Procedure Cross Reference

.XR Cross Reference

.xx for

Special indicator dependent on

Assembler language. For Assembler, use:

.C1

1st CSECT

.1C

1st CSECT

.EM Error Messages

.LI

Literals

.MC Macro Catalog

.XR Cross Reference

Shift listing to a specific margin position

Displays ITST Primary Menu

-2-

Breakpoint Command MENU [PF6] MLOG MONITOR NEXT [PF10]

OFFALL PREV

PO PROFILE [PF4] RBP RESETBKP [CLEAR] RESUME [PF5] RIGHT RO RUN

SET SO STATUS [PF12]

STATUS ALL

TOP TRACE UP =X.Y.Z

=1.X.Y.Z

Display Command (PF Key)

MLOG MONITOR [PF5]

OFFALL

PO PROFILE [PF4] RBP

Description

Displays Breakpoint Primary Menu Start, stop, cancel, or load MLOG sessions Sets monitoring for current program Continue processing from the given statement until a specified number of verbs have been executed Turn off ALL breakpoints set by Userid/Terminal Position listing at the previously executed statement in the statement trace table Set/Remove protection options Displays Source Listing Profile panel Set/Remove Request Breakpoints Scrolls to current breakpoint location

RIGHT RO

SO STATUS [PF12] STATUS ALL TOP TRACE UP =X.Y.Z

Resumes execution of program Shift listing right a specific number of characters Set/Remove Replacement Options Continue processing from current statement ignoring all preset breakpoints and indirect commands until task either abends or runs to normal completion Initialize storage of a data-item Set/Remove Special Options Displays Monitoring Status for current program where you can view and remove any option Displays System-Wide Monitoring Status where you can view and remove any option Position listing at the top of the source code Set/Remove Statement Tracing Shift listing up a specific number of lines Fastpath selection of Option X.Y.Z of current Primary Option Menu; At breakpoint, ITST options are =1.x.y

Breakpoint Primary Option Menu

Access: When you are stopped at a breakpoint, PF6 or MENU command displays this menu.

Notice ITST Main Menu is Option 1.

Fastpath: Enter =x.y from Breakpoint Command line to bypass menu and select an option.

Enter =1.x.y to select an ITST menu option x.y from a breakpoint.

Option

Description

1 Main menu

ITST Primary Option Menu

2 Status

Display/remove current monitoring options (STATUS command)

3 Abend

Abend current program with or without a dump

4 Resume

Resume Execution Menu

4.1 Next instruction 4.2 Label 4.3 Statement 4.4 Offset

Resume from the next sequential instruction Resume from a label Resume from a statement number Resume from an offset

-3-

Option

Description

4.5 Indirect command 4.6 Next EXEC/CALL 4.7 nnn steps 4.8 nnn instructions

Execute an indirect command sequence Resume until the next EXEC command or external call Resume for specified number of statements or verbs Resume for specified number of machine instructions

5 Override

Override automatic breakpoint default processing Caution: Override is immediate. Task may abend.

6 Dump

Cause dump, resume from next sequential instruction

7 Disconnect

Disconnect the breakpoint from this terminal Tip: Reconnect is ITST Option 2.5 or CNTL=RECON

8 Hogan SMART Invoke Hogan System's debugging facility

X Exit

Exit ITST menu processing

Source Listing: View and Customize Profile

Use PROFILE command or PF4 to view and customize Source Profile settings.

Setting

Options

Display Window

Choose header format for Source screens: N-- Disables the info area

(more code); T - Displays Option & PF Key titles; R - Displays registers;

K -- Displays programdata items; P - Enables you to specify the load

module name, and view the symbolic file information.

PF7/8 Amount

Change scroll amount for PF7/8: PAGE; HALF; STOP; nnn

Stepping Amount Auto-Stepping

Set single-step amount for PF10 at breakpoint: nnn COBOL verbs, PL/I statements, or Assembler instructions Set automatic single-stepping ON or OFF, and optionally change wait interval (1 - 59 seconds) and stop value (nnn steps or CALL)

Source List BKPT Request source listing breakpoint (ON) or detailed breakpoint (OFF).

BKPT Term ID

Identify terminal to receive breakpoint displays: * - this terminal; termid; .ANY (use if User ID=specific); .NO (produces abend)

From Term ID

Identify terminal where program will run: * - this terminal; termid - runs from this terminal; .ANY - runs from any or without a terminal (use if User ID=specific); .NO - runs without terminal

User ID

CICS User ID executing the program: .ANY - monitoring occurs when executed by any user; specific User ID - monitoring occurs when User ID executes program, and breakpoints sent to wherever user is signed on (personal debugging session)

AutoKeep

Request that the contents of all program variables or data-names referenced in the active statement of a program be automatically displayed when debugging a program. Default controlled by product installation parameter SLBAKEEP or use the Profile screen to turn off or on again at any time.

Code Coverage SDF

Allows you to view which program statements have been executed and how many times they have been executed. Structure/Keep Window display format. HEX or DATA

Backtrace Facility PF Keys Access: When stopped at a breakpoint, PF11 or BTRACE command displays a high-level

Backtrace Summary (block level) of your program's execution. Usage: Select a starting location from Backtrace Summary and press PF2 to go to Source

Listing Backtrace, where you can trace your program's logic flow (forward or backward) at the statement level using PF Keys. Traced statements are highlighted.

-4-

Source Listing Backtrace

PF Keys

Description

1 Help

Displays online Help

2 Summary

Returns to Backtrace Summary

3 End

Terminates Backtrace session, returns to Breakpoint display

4 Profile

Accesses Source Listing Profile, where you can set Stepping Amount for PF9 and PF10, scroll amount for PF7 and PF8

5 Ist Statement

Repositions screen at first (oldest) entry in backtrace

6 Last Statement 7 Backward

8 Forward

9 Prev Stmt Prev nnn

Repositions screen at last (newest) entry in backtrace

Scrolls list up one page, or PF7/8 amount set on Profile; suspends highlighting until PF5, 6, 9, 10, 11, or 12 is used

Scroll list down one page, or PF7/8 amount set on Profile; suspends highlighting until PF5, 6, 9, 10, 11, or 12 is used

Traces backward one statement or the Stepping Amount set on Profile (PF4)

10 Next Stmt Next nnn

Traces forward one statement or the Stepping Amount set on Profile (PF4)

11 Prev Block

Displays the previous statement block

12 Next Block

Displays the next statement block

Source Listing: Column 1 Commands Enter a letter in column 1 of your Source Listing and press Enter to process the testing functions listed below. For variable functions (D, K, M, and V), also move Cursor under variable before pressing Enter if line is where variable is used. Omit cursor if line defines variable.

Col.1 Entry Cursor Description

B

Bypass monitoring of instruction at automatic bkpt, press PF5.

C

Set conditional breakpoint (CBP) at current location. A menu

prompts you to enter the condition, such as IF TASKNUM > 2.

D Under Display Main Storage structured display for specified variable. variable Overtype storage value to change it.

D

Display Object Code for instruction.

G

Go [resume execution] at this instruction instead of breakpoint.

K Under Keep data item in keep window at top of source listing. Variable Window shows current value (in Character and Hex) at breakpoint. Overtype keep window value to change it.

M Under [COBOL, PL/I only] Display formatted MOVE command to Variable modify value of data item. Valid entries for FROM field are: 1. ZEROS, SPACES, LOW-VALUES, HIGH-VALUES, QUOTES; 2. Variable name; 3. Numeric Literal, optionally preceded by + or - ; 4. Alphanumeric literal in single quotes, optionally preceded by ALL.

U

Set unconditional breakpoint (UBP) at selected statement.

This breakpoint stops before the selected statement.

From Procedure Names label, sets UBP at all labels.

From Cross-Reference section, sets UBP at all occurrences.

V Under [COBOL, Assembler only] Set variable-change breakpoint Variable (VBP) for this variable; VBP occurs when variable's value changes.

X

Remove breakpoint, or remove data item from keep window.

)

Set unconditional breakpoint (UBP) at selected statement.

This breakpoint stops after the selected statement.

From Procedure Names label, sets UBP at all labels.

From Cross-Reference section, sets UBP at all occurrences.

-5-

Quick Reference For Assembler, COBOL and PL/I Users

CA InterTestfor CICS

This Quick Reference provides a complete list of the Source Listing commands available to all users. For information on getting started with CA InterTest for CICS, the Monitoring Status display, or the ITST Primary Option menu, see the Quick Reference for ALL Users. For additional information, refer to the CA InterTest for CICS User Guide and the Assembler Primer, COBOL Primer or PL/I Primer.

Source Listing Facility

Access: ITST Option 1.1 or 1.2, then select program from Selection List Also: LIST=progname from CICS

Usage:

There are many ways to use the Source Listing Facility. See Getting Started on other side for basic functions. Also see Command Line and PF Key Summary, and Column 1 Commands. Modify session settings using PF4 Profile. In addition, any menu option can be accessed using the fastpath entry =x.y.z in the Command line.

All product names referenced herein are either trademarks or registered trademarks of their respective companies. Copyright? 2017 CA. All rights reserved.

Printing Instructions: Set the laser printer Print Properties to Legal (8.5x14), 2-sided/Duplex, 'Flip' or 'Rotate' on Short Edge. After printing, fold the paper between the three columns accordion style to create an easy-to-read quick reference.

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download