4.

After setting monitoring or breakpoints, exit to CICS and execute your program. See topics Breakpoint Primary Option Menu and Source Listing: Command Line and PF Key Summary for breakpoint activities and execution options. For more information, please see the CA-InterTest for CICS User Guide and the Assembler Primer, COBOL Primer, or PL/I Primer.

ITST Primary Option Menu (Main Menu)

Access: Fastpath: ITST PF6 ITST x.y =x.y.z =1.x.y from CICS or Source Command line displays main menu from Source Listing displays main menu from CICS displays menu option from ITST menu or Source Command line jumps to option from Breakpoint Command line jumps to ITST option Description Select program for Source Listing display Selection list by program name Selection list by symbolic file, then by program name Monitoring Submenu Program Monitoring Options menu: gives status; sets and removes monitoring, breakpoints, options; performs NEWCOPY Transaction Monitoring Options menu Terminal Monitoring Options menu Monitoring Status display (system-wide), can remove entries Display/reconnect/purge active monitored tasks Display/modify global system-wide options ABP - Automatic breakpointing; GLOG - Global logging CKPT - Option checkpointing; ITTRACE - CA-InterTest tracing DUMP - Dumping all abends; PURGE - Breakpoint task purging Main Storage Areas Menu Display and modify selected areas of main storage Auxiliary Storage Menu Display and modify files, databases, and queues

Source Listing Facility

Access: Usage: ITST Option 1.1 or 1.2, then select program from Selection List Also: LIST=progname from CICS 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.

Monitoring Status Display

Monitoring Status lets you view and remove any monitoring option! Access: PF12 from Source or Breakpoint; ITST 2.1 (one program) or 2.4 (system-wide). Usage: Navigate branches using EXPAND [PF6] or COLLAPSE [PF5]. Scroll using PF7 and PF8. Type R to left of an entry to remove it. Exit: PF3 returns to previous panel.
------------------- CA-InterTest for CICS r8 COMMAND ===> MONITORING STATUS -------

Option 1 Source 1.1 Program Selection 1.2 File Selection 2 Monitoring 2.1 Program 2.2 Transaction 2.3 Terminal 2.4 Status 2.5 Active Tasks 2.6 System-wide

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. For a complete list of the Source Listing commands available to all users, see the Quick Reference for Assembler, COBOL and PL/I Users. 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 [PF Key] ABEND or =3 BTRACE [PF11] BWD [PF7] CNTL CNTL=cmd CORE CORE=cmd END [PF3 Det Bkpt] FILE FILE FWD [PF8] HELP [PF1] ITST MENU [PF6] MENU [PF6] MONITOR NEXT [PF10] MONITOR [PF5] FWD [PF8] HELP [PF1] ITST BWD [PF7] CNTL CNTL=cmd CORE CORE=cmd END [PF3] Display Command [PF key] Description Abends the task (Breakpoint Option 3) Displays Backtrace Summary Scrolls listing backward amount set on Profile Displays CNTL Command Builder menu Executes CNTL command entered Displays CORE Main Storage Menu Executes CORE command entered END returns to previous panel PF3 at breakpoint toggles displays Displays the FILE facility Scrolls listing forward amount set on Profile, or to cursor location Displays online Help for current panel Displays ITST Primary Option Menu Displays ITST Primary Menu Displays Breakpoint Primary Menu Sets monitoring for current program Continue processing from the given statement until a specified number of verbs have been executed PROFILE [PF4] Displays Source Listing Profile panel Scrolls to current breakpoint location Resumes execution of program STATUS [PF12] STATUS ALL 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 on any entry Fastpath selection of Option X.Y.Z of current Primary Option Menu; At breakpoint, ITST options are =1.x.y

Type + to expand or - collapse option levels displayed below, or R to remove option(s). More: Option Description Attributes _ - COBDEMO Program monitor entry COBOL _ - |-.ANY User monitoring options Active | Symbolic listing file PROTSYM R |-VBP Variable change breakpoint Location=.ANY | Option ID 0DCC875E _ -RBP Request breakpoint(s) All Temp Storage commands Option ID 490A179C From, to terminals X505, X505

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 1 Main menu 2 Status 3 Abend 4 Resume 4.1 Next instruction 4.2 Label 4.3 Statement 4.4 Offset 4.5 Indirect command 4.6 Next EXEC/CALL 4.7 nnn steps 4.8 nnn instructions 5 Override 6 Dump 7 Disconnect 8 Hogan SMART X Exit Description ITST Primary Option Menu Display/remove current monitoring options (STATUS command) Abend current program with or without a dump Resume Execution Menu Resume from the next sequential instruction Resume from a label Resume from a statement number Resume from an offset 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 Override automatic breakpoint default processing Caution: Override is immediate. Task may abend. Cause dump, resume from next sequential instruction Disconnect the breakpoint from this terminal Tip: Reconnect is ITST Option 2.5 or CNTL=RECON Invoke Hogan System's debugging facility Exit ITST menu processing

3 Main Storage (CORE) 3.1 System areas 3.2 Task areas 3.3 Breakpoint areas 4 Auxiliary Storage (FILE) 4.1 Files 4.2 DB2 databases 4.3 DL/I databases 4.4 TD queues 4.5 TS queues 5 Dump Analysis 5.1 Analysis 5.2 Tracing 5.3 Configuration 5.4 Start 5.5 Stop 6 Product Help 7 Status/Maintenance 7.1 Product Status 7.1.1 CA-InterTest status 7.1.2 Global Options 7.1.3 Symbolic File names 7.1.4 CA-SymDump status 7.1.5 CA-InterTest PTFs 7.1.6 CA-SymDump PTFs 7.2 Abend descriptions 7.2.1 Add 7.2.2 Update 7.2.3 Inquire 7.2.4 Delete 8 Whats New X Exit TERM, TIME, USER

AllFusion CA-SymDump Primary Option Menu Select captured dump or trace for online viewing/analysis Capture current CICS internal trace Configure CA-SymDump capture/retention options Start dump capture facility Stop dump capture facility HELP facility master menu Product status maintenance functions Product Status Menu (VRPT), displays GENLEVEL Program, transaction, file status CA-InterTest IN25OPTS Installation Options Symbolic File DD and data set names CA-SymDump program, transaction, file status PTFs applied to each module PTFs applied to each module Abend code maintenance menu for optional USERHELP file Create and maintain user-defined abend codes and descriptions; these entries take precedence over CA-InterTest Help file descriptions for same code Online summary of new features for this release Exit ITST menu processing Enter command to display terminal ID, time, or CICS user ID

PROFILE [PF4] RESETBKP [CLEAR] RESUME [PF5] STATUS [PF12] STATUS ALL

=X.Y.Z =1.X.Y.Z

=X.Y.Z

-2-

-3-

-4-

Backtrace Facility PF Keys

Access: Usage: When stopped at a breakpoint, PF11 or BTRACE command displays a high-level Backtrace Summary (block level) of your programs execution. Select a starting location from the Backtrace Summary and press PF2 to go to Source Listing Backtrace, where you can trace your programs logic flow (forward or backward) at the statement level using PF Keys. Traced statements are highlighted. Description Displays online Help Returns to Backtrace Summary Terminates Backtrace session, returns to Breakpoint display Accesses Source Listing Profile, where you can set Stepping Amount for PF9 and PF10, scroll amount for PF7 and PF8 Repositions screen at first (oldest) entry in backtrace 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) Traces forward one statement or the Stepping Amount set on Profile (PF4) Displays the previous statement block Displays the next statement block

Setting AutoKeep

Code Coverage SDF

Source Listing Backtrace PF Keys 1 Help 2 Summary 3 End 4 Profile 5 Ist Statement 6 Last Statement 7 Backward 8 Forward 9 Prev Stmt Prev nnn 10 Next Stmt 10 Prev nnn 11 Prev Block 12 Next Block

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

Quick Reference For All Users

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 B C D D G K Description Bypass monitoring of instruction at automatic bkpt, press PF5. Set conditional breakpoint (CBP) at current location. A menu prompts you to enter the condition, such as IF TASKNUM > 2. Under Display Main Storage structured display for specified variable. variable Overtype storage value to change it. Display Object Code for instruction. Go [resume execution] at this instruction instead of breakpoint. 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. 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. Set unconditional breakpoint (UBP) at selected statement. From Procedure Names label, sets UBP at all labels. From Cross-Reference section, sets UBP at all occurrences. Under [COBOL, Assembler only] Set variable-change breakpoint Variable (VBP) for this variable; VBP occurs when variables value changes. Remove breakpoint, or remove data item from keep window. Scroll keep window data left the width of the display area. To scroll a specific number of bytes, specify a value after the '<'. For example, '<5' scrolls the data left 5 bytes. Scroll keep window data right the width of the display area. To scroll a specific number of bytes, specify a value after the '>'. For example, '>5' scrolls the data right 5 bytes.

AllFusion CA-InterTest for CICS r8

Getting Started
1. 2. 3. Compile program with CA-InterTest for CICS preprocessor to obtain symbolic support. Sign onto CICS and enter ITST to display the Primary Option Menu. Set monitoring before running a program you are testing. Optionally, set one or more breakpoints to gain control over your program during execution. You can do these tasks from the ITST menus, or while viewing your Source Listing. Option 2.1, Program Monitoring Menu, displays a menu from which you can set and remove monitoring, breakpoints, and any option for a program. See the Program Monitoring Menu column in the following table for details. Option 1.1, Source Program Selection, displays a list of compiled programs. Select a program for Source Listing display. See the Source Listing column below for basic functions. See back side of card for details. Function Set Monitoring for Program Set Unconditional Breakpoint (UBP) Display Monitoring Status Remove Monitoring Exit Program Monitoring Menu Entries (ITST Option 2.1) Program name, select Monitor Option Program name, select UBP Option, enter location on next panel Program name, select Status Option Program name, enter R next to Monitor Option =X exits menus PF3 returns one panel PF4 returns to top-level menu Source Listing (ITST Option 1.1) PF5 or MONITOR command U in column 1 of line in listing PF12 or STATUS command PF12, tab to entry, enter R to remove PF3 or CLEAR exits Source, then =X exits menus

Source Listing: View and Customize Profile

Use PROFILE command or PF4 to view and customize Source Profile settings. Setting Display Titles Options Choose header format for Source screens: N - No display of Option & PF Key titles (more code); R - Display Registers instead of Option & PF Key titles); Y - Display Option & PF Key titles Change scroll amount for PF7/8: PAGE; HALF; STOP; nnn 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) Request source listing breakpoint (ON) or detailed breakpoint (OFF). Identify terminal to receive breakpoint displays: * - this terminal; termid; .ANY (use if User ID=specific); .NO (produces abend) 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 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)

PF7/8 Amount Stepping Amount Auto-Stepping Source List BKPT BKPT Term ID From Term ID

V X <

>

User ID

Note: You can use ITST menu options from a Source Listing. PF6 Menu displays the Main Menu, or =x.y in Command line jumps directly to a menu option.
All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies. Copyright 2006 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. -5-6-