Professional Documents
Culture Documents
Training Guide
COBOL Version
Release 7.6
This document and the product referenced in it are subject to the following legends:
Copyright 1984 2007 Compuware Corporation. All rights reserved. Unpublished rights
reserved under the Copyright Laws of the United States.
U.S. GOVERNMENT RIGHTS-Use, duplication, or disclosure by the U.S. Government is
subject to restrictions as set forth in Compuware Corporation license agreement and as
provided in DFARS 227.7202-1(a) and 227.7202-3(a) (1995), DFARS 252.2277013(c)(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14 (ALT
III), as applicable. Compuware Corporation.
This product contains confidential information and trade secrets of Compuware Corporation.
Use, disclosure, or reproduction is prohibited without the prior express written permission of
Compuware Corporation. Access is limited to authorized users. Use of this product is subject
to the terms and conditions of the user's License Agreement with Compuware Corporation.
XPEDITER, XPEDITER/CICS, XPEDITER/Xchange, XPEDITER/Code Coverage, Abend-AID for
CICS, FrontLine, and Compuware are trademarks or registered trademarks of Compuware
Corporation.
CICS/ESA, CICSPlex, CICS Transaction Server, DB2, DFSMS, IBM, MQ Series, MVS,
MVS/ESA, OS/390, VTAM, WebSphere MQ, and z/OS are trademarks or registered
trademarks of International Business Machines Corporation.
Adobe Acrobat Reader copyright 1987-2004 Adobe Systems Incorporated. All rights
reserved. Adobe and Acrobat are trademarks of Adobe Systems Incorporated.
All other company and product names are trademarks or registered trademarks of their
respective owners.
Table of Contents
TABLE OF CONTENTS
Helpful Hints.......................................................................................................................... H-1
Xpediter/TSO Helpful Hints for COBOL.....................................................................................H-2
Xpediter/TSO Helpful Hints for Assembler .................................................................................H-4
Xpediter/TSO Helpful Hints for PL/I ......................................................................................... H-6
Xpediter/TSO Helpful Hints for C .............................................................................................. H-8
Chapter 1 Introduction to Xpediter/TSO ......................................................................... 1-1
Basic Features ................................................................................................................................1-2
Demo Program Description ...........................................................................................................1-3
Sample Scenario: Intercept a S0C7 Abend ...................................................................................1-4
Chapter 2 Compile Process ............................................................................................. 2-1
Xpediter/TSO Compile Processes..................................................................................................2-2
Compile Listing .............................................................................................................................2-3
DDIO File Utility...........................................................................................................................2-4
Convert Compile JCL ..................................................................................................................2-10
Compile Facility ..........................................................................................................................2-14
Chapter 3 Test Setup ........................................................................................................ 3-1
Primary Menu ................................................................................................................................3-2
Environments Menu.......................................................................................................................3-3
Test Standard Screen .....................................................................................................................3-4
Test Setup Menu ............................................................................................................................3-7
Chapter 4 Source Listing Screen .................................................................................... 4-1
Source Listing Screen ....................................................................................................................4-2
Reference Card ..............................................................................................................................4-3
Chapter 5 Gaining Control - Unconditional.................................................................... 5-1
Breakpoints ....................................................................................................................................5-2
Before Breakpoints ........................................................................................................................5-4
After Breakpoints...........................................................................................................................5-7
Delete Command ...........................................................................................................................5-9
Chapter 6 Controlling Program Execution ..................................................................... 6-1
Go Command.................................................................................................................................6-2
RUNTO Command ........................................................................................................................6-3
GO 1 Command .............................................................................................................................6-4
Go n Command..............................................................................................................................6-7
Go n Trace .....................................................................................................................................6-8
Set Delay Command ....................................................................................................................6-09
GO Half Command......................................................................................................................6-11
Chapter 7 Display / Modify Data ...................................................................................... 7-1
Peek Command .............................................................................................................................7-2
Dright Command ...........................................................................................................................7-3
Dleft Command..............................................................................................................................7-4
Elementary Command ...................................................................................................................7-5
Hexadecimal Command.................................................................................................................7-7
Move Command ............................................................................................................................7-9
Locate Command .........................................................................................................................7-10
Keep Command ..........................................................................................................................7-13
Delete Command ........................................................................................................................7-17
Retest Command..........................................................................................................................7-19
i-1
i-2
Table of Contents
i-3
i-4
Helpful Hints
Helpful Hints
This section contains helpful quick reference pages that offer a concise review of commands associated with
debugging operations. The section is positioned before chapter one to ensure your familiarity with it and to help
you more easily reference it once you have covered the material in the training guide.
Helpful Hints includes the following:
H-1
H-2
LOGIC DEBUGGING
Keep Data Names
Working Storage
Current Statement
LOCATE * or PF6
GOTO statement-number -or- GT (line command)
SKIP statement-number -or- S (line command)
View Execution
Detect Loop
SHOW PREV
COUNT PARA; GO n (n = number of statements)
SHOW COUNTS
Path Coverage
Restart Test
Exit Test
PF1=HELP
PF7=UP
PF2=PEEK CSR
PF8=DOWN
PF3=END
PF9=GO 1
PF4=EXIT
PF10=LEFT
PF5=RFIND
PF11=RIGHT
PF6=LOCATE *
PF12=GO
Reverse Execution
H-3
Browse a File
Get to a Record
Display Subprogram
Insert Logic
Bring in a Script
Enhanced Find
ISPF Session
Table Displays
PF13=HELP
PF19=UP
PF14=FIND CSR
PF20=DOWN
PF15=END
PF21=GO 1
PF16=EXIT
PF22=DLEFT
PF17=FIND IND
PF23=DRIGHT
PF18=LOCATE
PF24=GO
H-4
LOGIC DEBUGGING
Data Labels
Display Registers
GPREGS
WHEN data-label CHANGES
-orWHEN data-label = value
Current Statement
View Execution
Path Coverage
Restart Test
Exit Test
PF1=HELP
PF7=UP
PF2=PEEK CSR
PF8=DOWN
PF3=END
PF9=GO 1
PF4=EXIT
PF10=LEFT
PF5=RFIND
PF11=RIGHT
PF6=LOCATE *
PF12=GO
H-5
Alter an Instruction
Browse a File
Get to a Record
Display Subprogram
Detect Loop
Insert Logic
Bring in a Script
Line numbers
ISPF Session
PF13=HELP
PF19=UP
PF14=FIND CSR
PF20=DOWN
PF15=END
PF21=GO 1
PF16=EXIT
PF22=DLEFT
PF17=FIND IND
PF23=DRIGHT
PF18=LOCATE *
PF24=GO
H-6
LOGIC DEBUGGING
Keep Data Names
Working Storage
Current Statement
View Execution
Detect Loop
SHOW PREV
COUNT PARA; GO n (n = number of statements)
SHOW COUNTS
Path Coverage
Restart Test
Exit Test
PF1=HELP
PF7=UP
PF2=PEEK CSR
PF8=DOWN
PF3=END
PF9=GO 1
PF4=EXIT
PF10=LEFT
PF5=RFIND
PF11=RIGHT
PF6=LOCATE *
PF12=GO
Browse a File
H-7
Get to a Record
Display Subprogram
Insert Logic
Bring in a Script
ISPF Session
PF13=HELP
PF19=UP
PF14=FIND CSR
PF20=DOWN
PF15=END
PF21=GO 1
PF16=EXIT
PF22=DLEFT
PF17=FIND IND
PF23=DRIGHT
PF18=LOCATE
PF24=GO
LOGIC DEBUGGING
Keep Data Names
Working Storage
Current Statement
View Execution
Detect Loop
SHOW PREV
COUNT PARA; GO n (n = number of statements)
SHOW COUNTS
Path Coverage
Restart Test
Exit Test
PF1=HELP
PF7=UP
PF2=PEEK CSR
PF8=DOWN
PF3=END
PF9=GO 1
PF4=EXIT
PF10=LEFT
PF5=RFIND
PF11=RIGHT
PF6=LOCATE *
PF12=GO
Browse a File
H-9
Get to a Record
Display Subprogram
Insert Logic
Bring in a Script
ISPF Session
PF13=HELP
PF19=UP
PF14=FIND CSR
PF20=DOWN
PF15=END
PF21=GO 1
PF16=EXIT
PF22=DLEFT
PF17=FIND IND
PF23=DRIGHT
PF18=LOCATE
PF24=GO
Introduction to Xpediter/TSO
1-1
Intercept abends.
1-2
Basic Features
Xpediter/TSO is a testing, debugging, and analysis tool that enables you to do the following:
1. Control program execution
3. Intercept abends
Display the Abend-AID snapshot report at any point in an Xpediter/TSO test session.
Introduction to Xpediter/TSO
DEMO PROGRAM
Employee
File
Employee
Compensation
Report
CWXTCOB
at
month
end
Monthly Regional
Sales Report
CWXTSUBC
CWXTDATE
1-3
1-4
1. Enter the name of the program to be tested in the Program field and the execution JCL in the
File List/JCL Member field on the Test Standard screen.
Profile: CWXTCOB -----COMMAND ===> [ENTER]
----------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
Introduction to Xpediter/TSO
1-5
1-6
Introduction to Xpediter/TSO
1-7
1-8
Introduction to Xpediter/TSO
1-9
1-10
Compile Process
2-1
Discuss the Compuware Language Processor and the Source Listing File.
2-2
Your site will use either the Pre-Compile or the Post-Compile Process.
XREF
PMAP
DMAP
COMPILE
Language
Processor
Object
Sysprint
LINK
Source
Listing
File
Linked Module
(DD SYSLMOD )
(DD CWPDDIO)
COMPILE
Object
Sysprint
LINK
Language
Processor
Linked Module
(DD SYSLMOD)
Source
Listing
File
(DD CWPDDIO)
Compile Process
Compile Listing
------------------------------------------------------------------------------SDSF OUTPUT DISPLAY USERIDR JOB07579 DSID
111 LINE 7
COLUMNS 15- 94
COMMAND INPUT ===>
SCROLL ===> CSR
PCOPTN041-I PROCESSED ON 10/16/2007 AT 13:02:55
PCOPTN041-I
PCOPTN041-I COBOL Z/OS
PCOPTN041-I OUTPUT ( DDIO, PRINT )
PCOPTN041-I
PCOPTN041-I PROCESSOR
PCOPTN041-I OUTPUT ( NODDIO, NOPRINT )
PCOPTN041-I WARNINGS ( FRONT, EMBED )
PCOPTN041-I TEXT ( NOFILE, NOWORKING-STORAGE, NOLINKAGE, NOREPORT, NOPROCEDUR
PCOPTN041-I OPTIONS ( XREF, LIST )
PCOPTN041-I ERRORS ( UPPER-CASE )
PCOPTN041-I ( SCALELINE, NOBYPASS )
PCOPTN041-I
PCOPTN041-I DDIO
PCOPTN041-I OUTPUT ( NOLIST, NOPMAP, NOOFFSET, NOCLIST, NOXREF, NODMAP, NOMAP
PCOPTN041-I ( PROGRAM-NAME( ) )
PCOPTN041-I
PCOPTN041-I PRINT
PCOPTN041-I OUTPUT ( SOURCE, LIST, PMAP, OFFSET, CLIST, XREF, DMAP, MAP )
PCOPTN041-I
PCDRVR052-I LISTING CWXTCOB DATED 10/16/2007 AT 13:02:55 SUCCESSFULLY WRITTEN
PCDRVR316-I LISTING CWXTCOB PROCESSED ON 10/16/2007 AT 13:02:55
2-3
2-4
You only need to create a DDIO file if one does not already exist. Check with your
Xpediter/TSO installer to see if you need to create a DDIO file.
DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT
----------------------
Specify defaults
Prepare programs for debugging
Debug programs interactively under TSO
Debug programs interactively under batch
Debug DB2 Stored Procedures interactively
Perform utility functions
Invoke File-AID for DB2
Invoke File-AID for MVS
Invoke File-AID for IMS
Code Coverage Reports and Utilities
Connect to a CICS region
Display information about XPEDITER/TSO
Exit primary menu
- ** NO DESCRIPTION **
----------------------OPTION ===>
1
2
3
5
6
7
REGION SIZE
LIST ALLOCATES
DDIO FILE FACILITY
CONVERT PROFILE
CONVERT INCLUDE
MERGE
or
-----------------------
or
Compile Process
REGION SIZE
LIST ALLOCATES
DDIO FILE FACILITY
CONVERT PROFILE
CONVERT INCLUDE
MERGE
-----------------------
or
---------- CSS UTILITIES - Source Listing File Facility -------- CSS V8.4.0
COMMAND ===>
Commands: SEtup
DDIOCALC (DDIO calculator)
DD (DDIO tutorial)
SD (SD/DB tutorial)
LP (LP tutorial)
Processing Options
Confirm Delete
Show print setup
Language
SEL Options:
SEL
_
(1)
(2)
(3)
(4)
(5)
(6)
(7)
(8)
A (Adv Function)
2-5
2-6
3. Enter C in the select column followed by the dataset name of the DDIO file to be created.
---------- CSS UTILITIES - Source Listing File Facility -------- CSS V8.4.0
COMMAND ===> [ENTER]
Commands: SEtup
DDIOCALC (DDIO calculator)
DD (DDIO tutorial)
SD (SD/DB tutorial)
LP (LP tutorial)
Processing Options
Confirm Delete
Show print setup
Language
SEL Options:
SEL
C
(1)
(2)
(3)
(4)
(5)
(6)
(7)
(8)
A (Adv Function)
Shared Directory
Database File
DDIO File
Compile Process
4. Specify the TYPE of file you want to create (Shared Directory, Database File or DDIO).
----------------- XPEDITER/TSO - DDIO CREATE/FORMAT FACILITY ---------------COMMAND ===> 3
Commands: SEtup DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
File Name entered: 'USERID.DDIO'
1
Shared Directory
Database File
DDIO File
--- COMPUWARE CSS UTILITIES - CREATE/FORMAT Source Listing File ---- V8.4.0
COMMAND ===>
Commands: SEtup
A (Advanced Parms)
D (Delete file)
DD (DDIO tutorial)
SD (SD/DB tutorial)
LP (LP tutorial)
Dataset Name ===> 'USERID.DDIO'
Preparation ===> BATCH
DS Organization ===> VSAM
Reallocate ===> NO
Model DSN
Storage Class
Management Class
Data Class
Volume
Unit
===>
===>
===>
===>
===>
===>
(Batch/Editjcl/Foreground)
(Vsam/Sequential)
(Yes/No)
(optional)
(optional)
(optional)
(optional)
(optional)
(Blocks/Tracks/Cylinders)
(1 to 16000)
or
2-7
2-8
5. Enter the parameters to allocate and format a new source listing file and press Enter to submit
the batch job.
--- COMPUWARE CSS UTILITIES - CREATE/FORMAT Source Listing File ---- V8.4.0
COMMAND ===> [ENTER]
Commands: SEtup
A (Advanced Parms)
D (Delete file)
DD (DDIO tutorial)
SD (SD/DB tutorial)
LP (LP tutorial)
Dataset Name ===> 'USERID.DDIO'
Preparation ===> BATCH
DS Organization ===> VSAM
Reallocate ===> NO
Model DSN
Storage Class
Management Class
Data Class
Volume
Unit
===>
===>
===>
===>
===>
===>
(Batch/Editjcl/Foreground)
(Vsam/Sequential)
(Yes/No)
(optional)
(optional)
(optional)
(optional)
(optional)
(Blocks/Tracks/Cylinders)
(1 to 16000)
or
---------- CSS UTILITIES - Source Listing File Facility ------ JOB SUBMITTED
COMMAND ===>
Commands: SEtup
DDIOCALC (DDIO calculator)
DD (DDIO tutorial)
SD (SD/DB tutorial)
LP (LP tutorial)
Processing Options
Confirm Delete
Show print setup
Language
SEL Options:
SEL
_
_
_
_
_
_
_
_
_
(1)
(2)
(3)
(4)
(5)
(6)
(7)
(8)
A (Adv Function)
Compile Process
2-9
6. Browse the results of the submitted job using the method available at your site for viewing job
output.
SDSF OUTPUT DISPLAY USERIDB JOB01734
COMMAND INPUT ===>
DSID
104 LINE 2
COLUMNS 02- 81
SCROLL ===> CSR
COMPUWARE CORPORATION.
ENTER UTILITY COMMAND:
*
*
FORMAT DDIO FILE: USERID.DDIO
*
FORMAT INDD=CWUT0001,
TYPE=SOURCE,
AD=DUPS,
RC=00100,
GC=0003,
BLKSIZE=18425
FORMATTING SUCCESSFULLY COMPLETED.
2-10
DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT
----------------------
Specify defaults
Prepare programs for debugging
Debug programs interactively under TSO
Debug programs interactively under batch
Debug DB2 Stored Procedures interactively
Perform utility functions
Invoke File-AID for DB2
Invoke File-AID for MVS
Invoke File-AID for IMS
Code Coverage Reports and Utilities
Connect to a CICS region
Display information about XPEDITER/TSO
Exit primary menu
- ** NO DESCRIPTION **
or
------------------
>
<
or
Compile Process
2-11
9. Enter the compile JCL dataset name and the DDIO file where you want to place the source file
listing.
-------------------- XPEDITER/TSO - CONVERT COMPILE JCL ----------------------COMMAND ===> [ENTER]
Primary Commands:
ISPF Library:
Project ===>
Group
===>
Type
===>
Member ===>
===>
Browse
===>
Edit
SEtup
===>
or
2-12
Compile Process
2-13
2-14
Compile Facility
12. Select option 2 from the Program Preparation menu to use the Xpediter/TSO compile facility.
-----------------OPTION ===> 2
1
2
3
4
------------------
For the COMPILE FACILITY, you may use the Compile Profile field
below as a method of selecting a specific profile that contains
or will contain the desired compile parameters. If an existing
name is entered, the compile parameters previously saved under
that name will be used. If a new name is entered, a new profile
will be created to hold the newly entered compile parameters.
A '?' in the Compile Profile field will display a member list of
existing names permitting profiles to be selected, displayed or
maintained (i.e., COPY, RENAME, DELETE, etc.).
Compile Profile => DEFAULT
>
NOTE:
<
or
This option is only available if it was turned on when the product was installed.
13. Enter the source dataset name, the preparation to be used, and the program language type.
Display settings and process the job to compile and linkedit your program. You have a choice
of using a foreground or a batch job to compile your program. You can also select the edit
JCL option to edit and/or save the JCL before submitting.
---------------------- XPEDITER/TSO - COMPILE FACILITY -----------------------COMMAND ===>
Primary Commands: Listing (Display output) SEtup (Display general settings)
Compile Profile:
DEFAULT
>
<
D - Display settings
S - Process only
SEL
STEPS
--- ------------------_ 1. DB2 Precompile
_ 2. CICS Translation
D 3. Compile
D 4. Linkedit
Compile Process
or
or
2-15
2-16
DEFAULT
>
<
D - Display settings
S - Process only
SEL
STEPS
--- ------------------_ 1. DB2 Precompile
_ 2. CICS Translation
D 3. Compile
D 4. Linkedit
-----------------OPTION ===>
1
2
3
4
------------------
For the COMPILE FACILITY, you may use the Compile Profile field
below as a method of selecting a specific profile that contains
or will contain the desired compile parameters. If an existing
name is entered, the compile parameters previously saved under
that name will be used. If a new name is entered, a new profile
will be created to hold the newly entered compile parameters.
A '?' in the Compile Profile field will display a member list of
existing names permitting profiles to be selected, displayed or
maintained (i.e., COPY, RENAME, DELETE, etc.).
Compile Profile => DEFAULT
>
<
or
Compile Process
2-17
------------------
For the COMPILE FACILITY, you may use the Compile Profile field
below as a method of selecting a specific profile that contains
or will contain the desired compile parameters. If an existing
name is entered, the compile parameters previously saved under
that name will be used. If a new name is entered, a new profile
will be created to hold the newly entered compile parameters.
A '?' in the Compile Profile field will display a member list of
existing names permitting profiles to be selected, displayed or
maintained (i.e., COPY, RENAME, DELETE, etc.).
Compile Profile => DEFAULT
>
---------------------OPTION ===>
0
1
2
3
4
5
F
FA
FI
C
CS
T
X
or
DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT
<
----------------------
Specify defaults
Prepare programs for debugging
Debug programs interactively under TSO
Debug programs interactively under batch
Debug DB2 Stored Procedures interactively
Perform utility functions
Invoke File-AID for DB2
Invoke File-AID for MVS
Invoke File-AID for IMS
Code Coverage Reports and Utilities
Connect to a CICS region
Display information about XPEDITER/TSO
Exit primary menu
- ** NO DESCRIPTION **
or
2-18
18. View the completed compile message, which tells you the compile and link have executed
successfully.
CWXTCOB RC=00: COMPILE
CWXTCOB RC=00: LINKEDIT
***
A return code of 00
indicates that the
compile completed
without error.
USERID
USERID
Test Setup
3-1
3-2
Primary Menu
1. Invoke Xpediter/TSO to interactively debug the demo program.
---------------------OPTION ===> 2
0
1
2
3
4
5
F
FA
FI
C
CS
T
X
DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT
----------------------
Specify defaults
Prepare programs for debugging
Debug programs interactively under TSO
Debug programs interactively under batch
Debug DB2 Stored Procedures interactively
Perform utility functions
Invoke File-AID for DB2
Invoke File-AID for MVS
Invoke File-AID for IMS
Code Coverage Reports and Utilities
Connect to a CICS region
Display information about XPEDITER/TSO
Exit primary menu
Specify default values for your terminal, PF keys, profiles, and screen colors.
PREPARE
Convert compile JCL for Xpediter, compile programs under Xpediter, bind application plans
or packages, edit file allocation lists.
TSO
BATCH
Establish a batch connect test session to debug an application program running in batch mode.
STORED PROCEDURE
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT
PROFILE
Test Setup
Environments Menu
The Environments menu is displayed when you invoke Xpediter/TSO for the first time. Your menu will only show those
environments applicable to your site.
2. Select the standard environment.
Profile: CWXTCOB -----OPTION ===> 1
--------------------
XPEDITER/TSO
===> 1 STANDARD
2 DIALOG
3 IMS
4 BTS
5 BATCHPEM
6 DLIPEM
7 IMSPEM
Test
Test
Test
Test
Test
Test
Test
XPEDITER/IMS
8 MPP
9 BMP/IFP
10 IMSPEM
11 BMPPEM
Test
Test
Test
Test
or
Batch programs that process QSAM and VSAM files issue EXEC SQL statements or issue third-party database calls.
DIALOG
IMS
Batch programs that issue CBLTDLI calls and EXEC SQL statements or batch BMP programs.
BTS
BATCHPEM
DLIPEM
IMSPEM
MPP
BMP/IFP
Transaction driven BMP programs in the IMS BMP region or IMS fast path programs in the IMS fast path region.
IMSPEM
HOGAN IMSPEM applications or the IMSPEM driver module in the IMS MPP region.
BMPPEM
HOGAN BMPPEM applications or the BMPPEM driver module in the IMS BMP region.
DB2SP
3-3
3-4
----------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
Test Setup
ENTRY POINT
Alternate entry point if execution begins at a point other than the link-edited entry point.
LOAD MODULE
INITIAL SCRIPT
POST SCRIPT
PARM
FILE LIST/
JCL MEMBER
Dataset name that contains the file allocation list, CLIST, or JCL.
PREVIEW FILES?
'YES' if you want to invoke the File Allocation Utility to allow changes to allocations,
browsing or editing of the data in the files prior to entry to the debugging session.
CODE COVERAGE?
YES if you want to store the results of your test in the Code Coverage repository.
SYSTEM FLOW?
DB2?
'YES' if your program executes SQL statements. Answer 'NO' if the program to be
tested accesses DB2 through the TSO Call Attach Facility.
PLAN
SYSTEM
3-5
3-6
----------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
Test Setup
3-7
0
1
2
3
4
5
6
7
ENVIRONMENT
LOADLIBS
DDIO
INCLUDES
LOG
SCRIPT
DSNLOAD
PANEXEC
C
D
E
A
CODE COVERAGEDOCUMENT
EXTENDED
ALL
-
-----------------------------
or
Access the Environments menu to enter information about your program and other parameters
associated with your specific test session environment.
LOADLIBS
List all load modules libraries that may be accessed during an Xpediter/TSO test session.
DDIO
List all DDIO libraries that may be accessed during an Xpediter/TSO session. DDIO libraries
contain the source listings used for interactive testing. At least one DDIO dataset is required.
INCLUDES
List the names of test script libraries that contain sets of Xpediter/TSO commands used to set up,
run, or rerun a debugging session.
LOG
Display and modify the default values for the log dataset that contains a record of all Xpediter/TSO
commands entered during a debugging session and the responses to them.
SCRIPT
Display and modify the default values for the script dataset which contains each executable
command entered during the debugging session.
DSNLOAD
Define required or additional DB2 system IDs and DSNLOAD datasets for access to DB2.
PANEXEC
List PANEXEC (program product) load library DSNAMES and PANEXEC Control Card File
DSNAMES.
CODE COVERAGE
Specify the dataset where XPEDITER/TSO will write the results of the Code Coverage test and the
system name for the test (if available).
DOCUMENT
EXTENDED
Modify NEW and WORK dataset allocation values assigned by the installer of Xpediter/TSO.
3-8
6. Enter the load library names referenced in your execution JCL for the program you plan to test using
Xpediter/TSO and press Enter.
Profile: CWXTCOB ---- XPEDITER/TSO - LOAD MODULE LIBRARIES ------------------------COMMAND ===> [ENTER]
COMMANDS: DOWN (for additional User Libraries)
User Libraries:
--->>> Include ALL libraries your program requires <<<--(Even if the library is in LINKLST, ie. COBOL or LE runtime libraries)
(1) ===>
(2) ===>
If no dataset name is specified here, Xpediter/TSO will
(3) ===>
search the libraries referenced by the STEPLIB or JOBLIB
(4) ===>
DD statements in your execution JCL.
(5) ===>
(6) ===>
(7) ===>
(8) ===>
Installation Libraries: (Changes made to this list override installed default
(9) ===> 'SYS1.COB2LIB'
(10) ===>
(11) ===>
(12) ===>
(13) ===>
(14) ===>
(15) ===>
(16) ===>
Press ENTER to Process
or
Test Setup
7. Enter the DDIO library name referenced in your compile JCL for the program you plan to test using
Xpediter/TSO and press Enter.
Profile: CWXTCOB -------COMMAND ===> [ENTER]
--------------------------------
User Libraries:
(1)
(2)
(3)
(4)
(5)
(6)
===> 'USERID.DDIO'
===>
===>
===>
===>
===>
or
.
.
.
000011 //CWPDDIO DD DSN=USERID.DDIO,DISP=SHR
000012 //XOPTIONS DD DSN=SYS2.XPEDITER.XOPTIONS,DISP=SHR
000013 //CWPPRMO DD *
.
.
.
3-9
3-10
8. Enter the dataset name of the Xpediter/TSO test script library. The Xpediter/TSO script facility will be
covered in more detail in Chapter 10.
Profile: CWXTCOB --COMMAND ===> [ENTER]
--------------------------
User Libraries:
(1) ===>
(2) ===>
(3) ===>
Installation Libraries: (Changes made to this list override installed default
(4) ===> 'SYS2.XPEDITER.INCLUDE'
(5) ===>
(6) ===>
or
9. Enter a dataset name of your choosing or the name will be generated for you if the DSNAME field is
blank. Enter D in the process option field to automatically delete the log dataset after each test.
------------------------COMMAND ===> [ENTER]
-------------------------------
Allocation Parameters:
Data Class ===>
Space Units ===> TRK
Primary ===> 2
Secondary ===> 2
Storage Class ===>
Unit ===>
Volume ===>
Process Options:
(A, D, or ?
or
A
D
K
PD
PK
?
(Append)
(Delete)
(Keep)
(Print-Delete)
(Print-Keep)
(Prompt)
Test Setup
10. Enter a dataset name of your choosing or the script dataset name will be generated for you if the
DSNAME field is blank. Enter D in the process option field to automatically delete the script dataset
after each test.
----------------------COMMAND ===> [ENTER]
-----------------------------
Allocation Parameters:
Data Class ===>
Space Units ===> TRK
Primary ===> 2
Secondary ===> 2
Storage Class ===>
Unit ===>
Volume ===>
Process Options:
(A, D, or ?
or
A
D
K
PD
PK
?
(Append)
(Delete)
(Keep)
(Print-Delete)
(Print-Keep)
(Prompt)
11. Enter the DB2 DSNLOAD library names (leave blank if not using DB2 or to default to the libraries
specified in your execution JCL).
Profile: CWXTCOB ----COMMAND ===> [ENTER]
NAME
(1)
(2)
(3)
(4)
(5)
(6)
(7)
(8)
===>
===>
===>
===>
===>
===>
===>
===>
D801
D801
D701
D701
----------------------------
DSNLOAD DSNAME
===>
===>
===>
===>
===>
===>
===>
===>
'DSN810.D801.SDSNEXIT'
'DSN810.SDSNLOAD'
'DSN710.D701.SDSNEXIT'
'DSN710.SDSNLOAD'
or
3-11
3-12
----------------------------
===>
===>
===>
===>
===> PECNTL
===>
===>
===>
===>
or
13. Enter the Code Coverage repository dataset, system name and test id.
Profile: CWXTCOB ---COMMAND ===> [ENTER]
-------------------------------
===>
===> CYL
===> 5
===> 5
===>
===>
===>
Disposition Options:
A (Append)
D (Delete)
K (Keep)
? (Prompt)
===> K
or
(K or ?)
(A, D, or ?
Test Setup
3-13
-----------------------------
Allocation Parameters:
Data Class ===>
Space Units ===> TRK
Primary ===> 2
Secondary ===> 2
Storage Class ===>
Unit ===>
Volume ===>
Process Options:
(A, D, or ?
or
A
D
K
PD
PK
?
More:
(Append)
(Delete)
(Keep)
(Print-Delete)
(Print-Keep)
(Prompt)
15. If you wish to modify the NEW or WORK dataset allocations assigned at the time Xpediter/TSO was
installed, select the appropriate option otherwise press PF3 to return to the Xpediter/TSO Setup Menu.
Profile: DEFAULT ------OPTION ===> [PF3]
---------------------------------
NEW
WORK
Difference
Inquire
or
3-14
---------------------------------
0
1
2
3
4
5
6
7
ENVIRONMENT
LOADLIBS
DDIO
INCLUDES
LOG
SCRIPT
DSNLOAD
PANEXEC
C
D
E
A
or
-----------------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
4-1
4-2
4-3
Reference Card
The reference card lists the Xpediter/TSO PF key defaults and the commands available during your debugging
session. Many commands can be issued as primary or line commands. You may want to highlight your reference
card with these commands that will be used in this training guide:
AFTER
EXIT
GO 1
INTERCEPT
RESUME
SET
WHEN
BEFORE
FIND
GO n
KEEP
RETEST
SHOW
COUNT
GO
GO HALF
MONITOR
REVERSE
SKIP
DELETE
GOTO
INCLUDE
PEEK
RUNTO
TRACE
4-4
5-1
AFTER
SHOW BREAKS
DELETE
5-2
Breakpoints
BREAKPOINT A location in your program where you want to suspend normal program execution and gain
control.
Default breakpoints are set in the following places in the main program:
- before the Procedure Division
- after every STOP RUN, GOBACK, or EXIT PROGRAM
Breakpoint indicators are located between the statement number and the source code and are as follows:
- BEFORE breakpoints are designated by the letter B
- AFTER breakpoints are designated by the letter A
- BEFORE and AFTER breakpoints set on the same statement are designated by the '@'
2. Scroll up.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF7]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
000365
UNTIL REGION-SUB > 4.
000366
PERFORM 9900-CLOSE.
000367 A
GOBACK.
000368
***
000369
*** DIFFERENT PROCESSING OCCURS BASED ON EMPLOYEE TYPE. THERE
000370
*** ARE 3 VALID EMPLOYEE TYPES. IF A RECORD IS READ CONTAINING
000371
*** A RECORD TYPE OTHER THAN H, S OR M, AN ERROR MESSAGE IS
000372
*** WRITTEN AND PROCESSING CONTINUES.
000373
***
000374
1000-PROCESS-DATA.
000375
IF HOURLY
000376
PERFORM 2000-PROCESS-HOURLY
000377
ELSE
000378
IF SALES
000379
PERFORM 3000-PROCESS-SALES
5-3
5-4
BEFORE
Primary Command:
BEFORE, BEF, B
Examples:
B 338
BEFORE CWXTSUBC:
BEF 0000-MAINLINE
Line Command:
5-5
5-6
AFTER
Set a breakpoint to stop program execution after a line of code has executed.
Primary Command:
AFTER, AFT, A
Examples:
AFTER 359
A CWXTSUBC:
Line Command:
5-7
5-8
SHOW BREAKS
Primary Commands:
SHOW BREAKS, SH BR
DELETE
Primary Command:
DELETE, DEL, D
Examples:
DELETE AFTER
DEL BEF 338
Line Command:
9. Delete the before breakpoint on statement 351 and the after breakpoint on statement 361.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
SPECIFIED STATEMENTS ARE SHOWN - RESTORE SOURCE WITH 'END'
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
- - - - - - - - - - - - - - - - - - 349 LINES NOT DISPLAYED
=====> B PROCEDURE DIVISION USING PARMINFO.
d 351 B 0000-MAINLINE.
- - - - - - - - - - - - - - - - - 2 LINES NOT DISPLAYED
000354 A
IF GOOD-PARM
- - - - - - - - - - - - - - - - - 6 LINES NOT DISPLAYED
da 361 @
PERFORM 6000-PRINT-EMPLOYEE-REPORT
- - - - - - - - - - - - - - - - - 5 LINES NOT DISPLAYED
000367 A
GOBACK.
- - - - - - - - - - - - - - - - - 6 LINES NOT DISPLAYED
000374 B 1000-PROCESS-DATA.
- - - - - - - - - - - - - - - - - - 20 LINES NOT DISPLAYED
000395 B 2000-PROCESS-HOURLY.
- - - - - - - - - - - - - - - - - - 23 LINES NOT DISPLAYED
5-9
5-10
5-11
5-12
6-1
GO 1
GO n
GO n TRACE
SET DELAY
GO HALF
RUNTO
6-2
GO
Begin or resume execution of your program. GO can also be issued by pressing [PF12]
or [PF24].
Primary Command:
GO
6-3
RUNTO
Used to set a temporary BEFORE breakpoint and begin execution. Once the breakpoint
is encountered it is removed. It is similar to setting a BEFORE breakpoint, issuing the
GO command, and then issuing the DELETE BEFORE command.
Primary Command:
RUNTO
Examples:
RUNTO 362
Line Command:
2. Enter the command to resume program execution and pause before statement 359.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
NEXT LOGICAL INSTRUCTION IS CWXTCOB:355
000044
05 PARM-ERROR-SW
> N
** END **
-------------------------------------------- After CWXTCOB:354/AMODE 31 <>
000350 B PROCEDURE DIVISION USING PARMINFO.
000351
0000-MAINLINE.
000352
PERFORM 9000-OPEN.
000353
PERFORM 9100-CHECK-PARM.
====>> A
IF GOOD-PARM
000355
PERFORM 9200-INIT
000356
PERFORM 8000-READ-INPUT
000357
UNTIL RECORDS-READ = START-NUMBER
000358
OR END-OF-FILE
z 359
PERFORM 1000-PROCESS-DATA
000360
UNTIL END-OF-FILE
000361 B
PERFORM 6000-PRINT-EMPLOYEE-REPORT
000362
MOVE 1 TO REGION-SUB
000363
IF END-OF-MONTH
000364
PERFORM 7000-PRINT-REGION-REPORT
6-4
GO 1
Execute one statement and stop. GO 1 can also be issued by pressing [PF9] or [PF21].
Primary Command:
GO 1
3. Execute 1 statement.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go 1
SCROLL ===> CSR
RUNTO BREAKPOINT ENCOUNTERED
000039
05 EOF-SW
> N
** END **
------------------------------------------- Before CWXTCOB:359/AMODE 31 <>
000350 B PROCEDURE DIVISION USING PARMINFO.
000351
0000-MAINLINE.
000352
PERFORM 9000-OPEN.
000353
PERFORM 9100-CHECK-PARM.
000354 A
IF GOOD-PARM
000355
PERFORM 9200-INIT
000356
PERFORM 8000-READ-INPUT
000357
UNTIL RECORDS-READ = START-NUMBER
000358
OR END-OF-FILE
=====>
PERFORM 1000-PROCESS-DATA
000360
UNTIL END-OF-FILE
000361 B
PERFORM 6000-PRINT-EMPLOYEE-REPORT
000362
MOVE 1 TO REGION-SUB
000363
IF END-OF-MONTH
000364
PERFORM 7000-PRINT-REGION-REPORT
-----000373
=====>
000375
000376
000377
000378
000379
000380
000381
000382
000383
000384
000385
000386
000387
-----000373
=====>
000375
000376
000377
000378
000379
000380
000381
000382
000383
000384
000385
000386
000387
6-5
6-6
-----000373
000374
000375
=====>
000377
000378
000379
000380
000381
000382
000383
000384
000385
000386
000387
GO n
Primary Command:
GO n
Examples:
GO 5
GO 5 PARA
6. Execute 10 statements.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go 10
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
** END **
-----000373
000374
000375
=====>
000377
000378
000379
000380
000381
000382
000383
000384
000385
000386
000387
-----000453
=====>
000455
000456
000457
000458
000459
000460
000461
000462
000463
000464
000465
000466
000467
6-7
6-8
GO n TRACE
Primary Command:
GO n TRACE
Example:
GO 5 TRACE
-----000453
=====>
000455
000456
000457
000458
000459
000460
000461
000462
000463
000464
000465
000466
000467
SET DELAY
Primary Command:
Example:
6-9
6-10
GO HALF
Executes a half step (from before to after a statement, or from after one statement to
before the next).
Primary Command:
GO H
10. Execute the READ statement. GO Half issued at a before breakpoint steps to an after
breakpoint on the same statement. GO Half issued at an after breakpoint steps to a before
breakpoint on the next statement.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go h
SCROLL ===> CSR
12 STATEMENTS EXECUTED
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 02523H1JOHN SMITH
5456 ELM
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-WORK-AREA
> 02523H1JOHN SMITH
5456 ELM
** END **
------------------------------------------- Before CWXTCOB:623/AMODE 31 <>
000621
***
000622
8000-READ-INPUT.
=====>
READ EMPLOYEE-FILE INTO EMPLOYEE-WORK-AREA
000624
AT END
000625
MOVE 'Y' TO EOF-SW.
000626
ADD 1 TO RECORDS-READ.
000627
***
000628
***
000629
9000-OPEN.
000630
OPEN INPUT EMPLOYEE-FILE.
000631
OPEN OUTPUT REPORT-FILE.
000632
***
000633
*** VALID PARMS ARE BLANK OR 5 DIGIT NUMBER
000634
***
000635
9100-CHECK-PARM.
6-11
6-12
Display/Modify Data
DRIGHT
Scroll the data in a Keep or Peek window to the right by the specified scroll amount.
DLEFT
Scroll the data in a Keep or Peek window to the left by the specified scroll amount.
E (Line Command)
Display elementary items for a group level variable (on PEEK or KEEP).
H (Line Command)
MOVE
LOCATE
KEEP
RETEST
7-1
7-2
PEEK
Primary Commands:
PEEK, P
Example:
PEEK PARM-DATA
Line Commands:
P, Pn
Example:
P2
Display/Modify Data
DRIGHT
Scroll the data in a Keep or Peek window to the right by the specified scroll amount.
DRIGHT is a convenient way to scroll data instead of source while the cursor is
positioned on the Command line. The DRIGHT command can also be issued by
pressing PF23.
Primary Command:
DRIGHT
7-3
7-4
DLEFT
Scroll the data in a Keep or Peek window to the left by the specified scroll amount.
DLEFT is a convenient way to scroll data instead of source while the cursor is
positioned on the Command line. The DLEFT can also be issued by pressing PF22.
Primary Command:
DLEFT
4. Scroll left.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> dleft
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+----7----+----8
000029
01 EMPLOYEE-RECORD
> 5500000 921231
----+----7----+----8
000151
01 EMPLOYEE-WORK-AREA
> 5500000 921231
** END **
-------------------------------------------- After CWXTCOB:623/AMODE 31 <>
000150
**
----+----7----+----8
000151 P 01 EMPLOYEE-WORK-AREA.
> 5500000 921231
000152
05 WA-EMP-NUM
PIC 9(5).
000153
05 WA-EMP-TYPE
PIC X.
000154
88 HOURLY
VALUE 'H'.
000155
88 SALES
VALUE 'S'.
000156
88 MANAGEMENT
VALUE 'M'.
000157
05 WA-EMP-REGION
PIC 9.
000158
88 NORTH
VALUE 1.
000159
88 SOUTH
VALUE 2.
000160
88 EAST
VALUE 3.
000161
88 WEST
VALUE 4.
000162
05 WA-EMP-NAME
PIC X(15).
000163
05 WA-EMP-ADDRESS.
5. Scroll left.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF22]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+----4----+----5----+----6
MORE->
01 EMPLOYEE-RECORD
> STREET EDINA
MN23040
....
----+----4----+----5----+----6
MORE->
01 EMPLOYEE-WORK-AREA
> STREET EDINA
MN23040
....
** END **
-------------------------------------------- After CWXTCOB:623/AMODE 31 <>
000150
**
----+----4----+----5----+----6
MORE-> P 01 EMPLOYEE-WORK-AREA.
> STREET EDINA
MN23040
....
000152
05 WA-EMP-NUM
PIC 9(5).
000153
05 WA-EMP-TYPE
PIC X.
000154
88 HOURLY
VALUE 'H'.
000155
88 SALES
VALUE 'S'.
000156
88 MANAGEMENT
VALUE 'M'.
000157
05 WA-EMP-REGION
PIC 9.
000158
88 NORTH
VALUE 1.
000159
88 SOUTH
VALUE 2.
000160
88 EAST
VALUE 3.
000161
88 WEST
VALUE 4.
000162
05 WA-EMP-NAME
PIC X(15).
000163
05 WA-EMP-ADDRESS.
Display/Modify Data
Line Command:
7-5
7-6
7. Scroll down.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF8]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 02334S1ROY GARDNER
323 OAK
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-WORK-AREA
> 02334S1ROY GARDNER
323 OAK
** END **
-------------------------------------------- After CWXTCOB:623/AMODE 31 <>
000150
**
----+----1----+----2----+----3
MORE-> P 01 EMPLOYEE-WORK-AREA.
> 02334S1ROY GARDNER
323 OAK
000152 P
05 WA-EMP-NUM
PIC > 02334
DECIMAL
000153 P
05 WA-EMP-TYPE
PIC > S
000154
88 HOURLY
VALUE 'H'.
000155
88 SALES
VALUE 'S'.
000156
88 MANAGEMENT
VALUE 'M'.
000157 P
05 WA-EMP-REGION
PIC > 1
DECIMAL
000158
88 NORTH
VALUE 1.
000159
88 SOUTH
VALUE 2.
000160
88 EAST
VALUE 3.
000161
88 WEST
VALUE 4.
Display/Modify Data
Line Command:
7-7
7-8
Display/Modify Data
7-9
MOVE
Change the content of program variables. Typing over the displayed value is an implicit
MOVE command.
Primary Command:
MOVE, M
Examples:
7-10
LOCATE
Scrolls to a particular point in the current program. LOCATE scrolls to the current
execution point. LOCATE can also be issued by pressing [PF6].
Primary Command:
LOCATE, LOC, L
LOCATE
LOC PROCEDURE
L 316
11. Return to the current point of program execution.
Examples:
Display/Modify Data
7-11
7-12
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084
Display/Modify Data
KEEP
Primary Commands:
KEEP, K
Examples:
KEEP EMPLOYEE-FILE
K HOLD-LINE (REG-IX, HOLD-IX)
Line Commands:
K, Kn, K
Example:
K2
14. Retain HOLD-AREA in the keep window by using the KEEP command.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> k hold-area
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
** END **
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084
7-13
7-14
Display/Modify Data
7-15
7-16
17. Scroll to the next occurrence in the table. Since there are only 4 occurrences, pressing Enter
will return or wrap around to the first occurrence in the table.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
4+1
OCCURS
----+----1----+----2----+----3
MORE-> K 05 HOLD-AREA
> THOMAS LONG
WEST H178703310
** END **
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084
Display/Modify Data
DELETE KEEP:
Primary Command:
Examples:
DEL KEEP
D K HOLD-LINE
Line Command:
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
7-17
7-18
19. Add HOLD-AREA to the keep window, using the current value of REG-IX.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> keep hold-area (reg-ix)
SCROLL ===> CSR
DELETE COMMAND PROCESSED
** END **
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084
Display/Modify Data
RETEST
Primary Command:
RETEST, RET
7-19
7-20
SHOW WHEN
COUNT
PAUSE
A specific condition.
Inserted commands.
8-1
8-2
WHEN
Primary Command:
WHEN
Examples:
1. Use the WHEN command to stop execution when the value in EMPLOYEE-WORK-AREA
changes.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> when employee-work-area;go
SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
=====> B PROCEDURE DIVISION USING PARMINFO.
000351
0000-MAINLINE.
000352
PERFORM 9000-OPEN.
000353
PERFORM 9100-CHECK-PARM.
000354
IF GOOD-PARM
000355
PERFORM 9200-INIT
000356
PERFORM 8000-READ-INPUT
000357
UNTIL RECORDS-READ = START-NUMBER
000358
OR END-OF-FILE
000359
PERFORM 1000-PROCESS-DATA
000360
UNTIL END-OF-FILE
000361
PERFORM 6000-PRINT-EMPLOYEE-REPORT
000362
MOVE 1 TO REGION-SUB
000363
IF END-OF-MONTH
000364
PERFORM 7000-PRINT-REGION-REPORT
8-3
8-4
SHOW WHEN
Primary Command:
8-5
8-6
COUNT [MAX]
Primary Command:
COUNT, COU, C
Examples:
7. Read 5 additional employee records and stop before the 6th record is read.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> count 623 max 5
SCROLL ===> CSR
DELETE COMMAND PROCESSED
000153 K 05 WA-EMP-TYPE
> S
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 01431S5TED NESSMAN
ONE COPL
----+----1----+----2----+----3
-------------------------------------------- After CWXTCOB:623/AMODE 31 <>
000622
8000-READ-INPUT.
====>>
READ EMPLOYEE-FILE INTO EMPLOYEE-WORK-AREA
000624
AT END
000625
MOVE 'Y' TO EOF-SW.
000626
ADD 1 TO RECORDS-READ.
000627
***
000628
***
000629
9000-OPEN.
000630
OPEN INPUT EMPLOYEE-FILE.
000631
OPEN OUTPUT REPORT-FILE.
000632
***
000633
*** VALID PARMS ARE BLANK OR 5 DIGIT NUMBER
000634
***
000635
9100-CHECK-PARM.
8-7
8-8
8-9
8-10
PAUSE
12. Insert the commands to stop program execution if the value of WA-EMP-TYPE = 'S'.
--------------------------- XPEDITER/TSO - SOURCE ---------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
000153 K 05 WA-EMP-TYPE
> S
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 04147S3LAURA MARTIN
TWO ENDE
----+----1----+----2----+----3
------------------------------------------- Before CWXTCOB:623/AMODE 31 <>
000622
8000-READ-INPUT.
=====>
READ EMPLOYEE-FILE INTO EMPLOYEE-WORK-AREA
0000005
000624
AT END
000625
MOVE 'Y' TO EOF-SW.
000626
ADD 1 TO RECORDS-READ.
''''''
if wa-emp-type = 'S'
''''''
pause
''''''
end-if
000627
***
000628
***
000629
9000-OPEN.
000630
OPEN INPUT EMPLOYEE-FILE.
000631
OPEN OUTPUT REPORT-FILE.
000632
***
000631
*** VALID PARMS ARE BLANK OR 5 DIGIT NUMBER
8-11
8-12
Exiting a Session
9-1
LOG
9-2
EXIT
End a test session and return to the test panel. Exit can also be issued by pressing
[PF4].
Primary Command:
EXIT
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
Exiting a Session
LOG
Primary Command:
LOG
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
Menu
Utilities
Compilers
or
Help
BROWSE
USERID.XPLOG.OCT18.T120045
Line 00000000 Col 001 080
Command ===>
Scroll ===> PAGE
********************************* Top of Data **********************************
+-----------------------------------------------------------------------------+
:
JOB: USERID
:
: XPEDITER/TSO RELEASE 07.06.00
CUSTOMER # 000001
STEP: ATSOPROC
:
:
DATE: 10/18/2007 :
: COMPUWARE CORPORATION
TIME: 12.00.47
:
:
SYSTEM: CW01
:
+-----------------------------------------------------------------------------+
XPED TSO SPF
TEST CWXTCOB
PARM '00003'
*** CWXTCOB FROM USERID.LOAD
BEFORE CWXTCOB::CWXTCOB:
AFTER CWXTCOB::CWXTCOB:
PAUSE Before CWXTCOB
BEFORE BREAKPOINT ENCOUNTERED
------------------------------ CWXTCOB
LINK 10/16/07
9-3
9-4
Utilities
Compilers
Help
BROWSE
USERID.XPLOG.OCT18.T120045
Line 00000000 Col 001 080
Command ===> [PF3]
Scroll ===> PAGE
********************************* Top of Data **********************************
+-----------------------------------------------------------------------------+
:
JOB: USERID
:
: XPEDITER/TSO RELEASE 07.06.00
CUSTOMER # 000001
STEP: ATSOPROC
:
:
DATE: 10/18/2007 :
: COMPUWARE CORPORATION
TIME: 12.00.47
:
:
SYSTEM: CW01
:
+-----------------------------------------------------------------------------+
XPED TSO SPF
TEST CWXTCOB
PARM '00003'
*** CWXTCOB FROM USERID.LOAD
BEFORE CWXTCOB::CWXTCOB:
AFTER CWXTCOB::CWXTCOB:
PAUSE Before CWXTCOB
BEFORE BREAKPOINT ENCOUNTERED
------------------------------ CWXTCOB
LINK 10/16/07
------------------
DDNAME: XPOUT
DSNAME: 'USERID.XPLOG.OCT18.T120045'
DATA SET DISPOSITION:
Process Option ===> d
SYSOUT Class ===> X
(Browse) K (Keep)
(Copy)
M (Move)
(Delete) PD (Print-Delete)
(Edit)
PK (Print-Keep)
R (Rename)
Scripts
10-1
Chapter 10 Scripts
A test script is a predefined stream of Xpediter/TSO commands. In the interactive mode, Xpediter/TSO
automatically generates a script of all the commands entered during a debugging session. This script dataset can be
edited and copied into a test script library and used later to do the following:
INCLUDE
10-2
SCRIPT
Primary Commands:
SCRIPT, SC
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
Scripts
10-3
10-4
3. Insert the commands to set a keep on EMPLOYEE-WORK-AREA and set execution counters
on all statements.
File Edit Confirm Menu Utilities Compilers Test Help
-----------------------------------------------------------------------------EDIT ---- USERID.XPSCR.OCT18.T120045 ------------------------ COLUMNS 001 072
Command ===> [ENTER]
SCROLL ===> CSR
****** ***************************** TOP OF DATA ******************************
i2
1
BEFORE ALL PARA
****** **************************** BOTTOM OF DATA ****************************
Scripts
------------------
DDNAME: XPSCRIPT
DSNAME: 'USERID.XPSCR.OCT18.T120045'
DATA SET DISPOSITION:
Process Option ===> M
SYSOUT Class ===> X
(Browse) K (Keep)
(Copy)
M (Move)
(Delete) PD (Print-Delete)
(Edit)
PK (Print-Keep)
R (Rename)
Enter the name of the dataset and
member name into which you want
to store the script.
3 Lines Moved/Copied
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
10-5
10-6
3 Lines Moved/Copied
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
E
0
1
2
3
4
5
6
7
EXTENDED
ENVIRONMENT
LOADLIBS
DDIO
INCLUDES
LOG
SCRIPT
DSNLOAD
PANEXEC
C
D
E
A
CODE COVERAGEDOCUMENT
EXTENDED
ALL
-
--------------------------
or
Scripts
E
0
1
2
3
4
5
6
7
EXTENDED
ENVIRONMENT
LOADLIBS
DDIO
INCLUDES
LOG
SCRIPT
DSNLOAD
PANEXEC
C
D
E
A
CODE COVERAGEDOCUMENT
EXTENDED
ALL
-
--------------------------
or
-------------------
User Libraries:
(1) ===> 'USERID.XPED.INCLUDE'
(2) ===>
(3) ===>
Installation Libraries: (Changes made to this list override installed default
(4) ===>
(5) ===>
(6) ===>
or
10-7
10-8
E
0
1
2
3
4
5
6
7
EXTENDED
ENVIRONMENT
LOADLIBS
DDIO
INCLUDES
LOG
SCRIPT
DSNLOAD
PANEXEC
C
D
E
A
CODE COVERAGEDOCUMENT
EXTENDED
ALL
-
--------------------------
or
-----------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
Scripts
INCLUDE
Primary Command:
INCLUDE, INC
11. Execute the commands contained in the CWXTCOB test script member.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> include cwxtcob
SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
=====> B PROCEDURE DIVISION USING PARMINFO.
000351
0000-MAINLINE.
000352
PERFORM 9000-OPEN.
000353
PERFORM 9100-CHECK-PARM.
000354
IF GOOD-PARM
000355
PERFORM 9200-INIT
000356
PERFORM 8000-READ-INPUT
000357
UNTIL RECORDS-READ = START-NUMBER
000358
OR END-OF-FILE
000359
PERFORM 1000-PROCESS-DATA
000360
UNTIL END-OF-FILE
000361
PERFORM 6000-PRINT-EMPLOYEE-REPORT
000362
MOVE 1 TO REGION-SUB
000363
IF END-OF-MONTH
000364
PERFORM 7000-PRINT-REGION-REPORT
10-9
10-10
11-1
REVERSE
Activate review mode or change the current direction while in the review mode.
RESUME
In this chapter you will use review mode to determine the cause of a SOC7 abend.
11-2
----------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
MONITOR
Primary Command:
MONITOR, MON
Examples:
MONITOR CWXTSUBC:
MON ALL
11-3
11-4
11-5
11-6
REVERSE
Activate review mode or change the direction of your review of program execution.
Primary Command:
REVERSE, REV
11-7
6. Begin reverse execution and stop when the value of GRAND-TOTAL-EMP changes because
this is the variable that caused the abend.
---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> when grand-total-emp;go
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
000129 K 05 EMP-COMPENSATION
> 01000.00
PACKED
000137 K 05 GRAND-TOTAL-EMP
> ???????????
INVALID PACKED
000129
05 EMP-COMPENSATION
> 01000.00
PACKED
000137
05 GRAND-TOTAL-EMP
> ???????????
INVALID PACKED
** END **
--------------------------------- Reverse - Before CWXTCOB:432/AMODE 31 <>
000431
CALC-COMMISSION.
=====>
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
000433
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000434
YRS-OF-SERVICE
000435
TODAYS-DATE
000436
WA-EMP-HIRE-DATE.
000437
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
000438
SET HOLD-IX UP BY 1.
000439
***
000440
*** PROCESS TYPE M (MANAGEMENT) RECORDS. THE MANAGER NAME AND
000441
*** SALARY ARE STORED IN A TABLE FOR USE DURING PRINTING OF THE
000442
*** REGIONAL SALES REPORT.
000443
***
000444
4000-PROCESS-MANAGEMENT.
000445
MOVE WA-EMP-NAME
TO REGION-MANAGER (WA-EMP-REGION).
11-8
11-9
11-10
11-11
11-12
12. Continue reviewing the execution in reverse and stop when the value of WA-EMP-REGION
changes.
---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> when wa-emp-region;go
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
000129 K 05 EMP-COMPENSATION
> ?????????
INVALID PACKED
000137 K 05 GRAND-TOTAL-EMP
> 0000000.00
PACKED
000157 K 05 WA-EMP-REGION
> 5
DECIMAL
S=5
OCCURS
----+
----------------------------------- Reverse - Before CWXTCOB:429/AMODE 31 <>
000133
** OR MANAGEMENT. EACH SUM IS PRINTED AT THE END OF THEIR
000134
** RESPECTIVE REPORTS.
000135
**
000136
01 GRAND-TOTAL-FIELDS.
000137
05 GRAND-TOTAL-EMP
PIC 9(7)V99
COMP-3 VALUE 0.
000138
05 GRAND-TOTAL-MGMT
PIC 9(7)V99
COMP-3 VALUE 0.
000139
**
000140
** USED FOR CALCULATING OVERTIME FOR ANY HOURLY EMPLOYEE
000141
** WHOSE HOURS EXCEEDS 40
000142
**
000143
01 OVERTIME-FIELDS.
000144
05 OT-AMOUNT
PIC 9(5)V99
COMP-3.
000145
05 OT-HOURS
PIC 9(2).
000146
**
000147
** EMPLOYEE RECORD WORK-AREA. EMPLOYEE DATA IS REDEFINED
11-13
13. Toggle the direction of review mode from reverse to forward. NOTE: Entering REVERSE only
changes the direction of the review mode; it does not cause execution to occur.
---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> rev
SCROLL ===> CSR
WHEN WA-EMP-REGION CHANGES
000129 K 05 EMP-COMPENSATION
> ?????????
INVALID PACKED
000137 K 05 GRAND-TOTAL-EMP
> 0000000.00
PACKED
000157 K 05 WA-EMP-REGION
> 2
DECIMAL
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 03431H2GAIL LAWRENCE 123 NORT
----------------------------------- Reverse - Before CWXTCOB:621/AMODE 31 <>
000608
WRITE REPORT-RECORD FROM BLANK-LINE.
000609
WRITE REPORT-RECORD FROM BLANK-LINE.
000610
WRITE REPORT-RECORD FROM BLANK-LINE.
000611
WRITE REPORT-RECORD FROM REGION-HDR1.
000612
WRITE REPORT-RECORD FROM BLANK-LINE.
000613
WRITE REPORT-RECORD FROM BLANK-LINE.
000614
WRITE REPORT-RECORD FROM REGION-HDR2.
000615
WRITE REPORT-RECORD FROM BLANK-LINE.
000616
ADD 1 TO PAGE-COUNT.
000617
MOVE 4 TO REG-LINE-COUNT.
000618
***
000619
***
000620
8000-READ-INPUT.
=====>
READ EMPLOYEE-FILE INTO EMPLOYEE-WORK-AREA
000622
AT END
11-14
11-15
15. Display the elementary items of EMPLOYEE-WORK-AREA to determine the possible values for
WA-EMP-REGION.
---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
WHEN WA-EMP-REGION CHANGES
000129 K 05 EMP-COMPENSATION
> ?????????
INVALID PACKED
000137 K 05 GRAND-TOTAL-EMP
> 0000000.00
PACKED
000157 K 05 WA-EMP-REGION
> 5
DECIMAL
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 01431S5TED NESSMAN
ONE COPL
------------------------------------ Forward - After CWXTCOB:621/AMODE 31 <>
000608
WRITE REPORT-RECORD FROM BLANK-LINE.
000609
WRITE REPORT-RECORD FROM BLANK-LINE.
000610
WRITE REPORT-RECORD FROM BLANK-LINE.
000611
WRITE REPORT-RECORD FROM REGION-HDR1.
000612
WRITE REPORT-RECORD FROM BLANK-LINE.
000613
WRITE REPORT-RECORD FROM BLANK-LINE.
000614
WRITE REPORT-RECORD FROM REGION-HDR2.
000615
WRITE REPORT-RECORD FROM BLANK-LINE.
000616
ADD 1 TO PAGE-COUNT.
You want to view the variable
000617
MOVE 4 TO REG-LINE-COUNT.
in Working Storage at the time
of the problem.
000618
***
000619
***
000620
8000-READ-INPUT.
pe2 >
READ EMPLOYEE-FILE INTO EMPLOYEE-WORK-AREA
000622
AT END
11-16
RESUME
Primary Command:
RESUME
11-17
11-18
18. Remove the monitor and when breakpoints and continue program execution.
---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> d monitor;d when;go
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
000129 K 05 EMP-COMPENSATION
> 01000.00
PACKED
000137 K 05 GRAND-TOTAL-EMP
> 0000000.00
PACKED
000157 K 05 WA-EMP-REGION
> 5
DECIMAL
000129
05 EMP-COMPENSATION
> 01000.00
PACKED
000137
05 GRAND-TOTAL-EMP
> 0000000.00
PACKED
----------------------------------- S0C7 Abend at CWXTCOB:432/AMODE 31 <>
000431
CALC-COMMISSION.
=====>
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
000433
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000434
YRS-OF-SERVICE
000435
TODAYS-DATE
000436
WA-EMP-HIRE-DATE.
000437
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
000438
SET HOLD-IX UP BY 1.
000439
***
000440
*** PROCESS TYPE M (MANAGEMENT) RECORDS. THE MANAGER NAME AND
000441
*** SALARY ARE STORED IN A TABLE FOR USE DURING PRINTING OF THE
000442
*** REGIONAL SALES REPORT.
000443
***
000444
4000-PROCESS-MANAGEMENT.
000445
MOVE WA-EMP-NAME
TO REGION-MANAGER (WA-EMP-REGION).
11-19
11-20
Counting Execution
12-1
SHOW COUNTS
Display the statements and their associated execution counters, as well as record the
counts in the Xpediter/TSO log.
SHOW MODULES
Display a list of all application modules loaded and the number of times each module
was executed.
12-2
-----------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
Counting Execution
COUNT
Primary Command:
COUNT, COU, C
Examples:
C ALL STATE
COU 8000-READ-INPUT
Line Command:
12-3
12-4
3. Scroll down.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF8]
SCROLL ===> CSR
1 COMMAND(S) COMPLETED
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
=====> B PROCEDURE DIVISION USING PARMINFO.
000351
0000-MAINLINE.
0000000
000352
PERFORM 9000-OPEN.
000353
PERFORM 9100-CHECK-PARM.
000354
IF GOOD-PARM
000355
PERFORM 9200-INIT
000356
PERFORM 8000-READ-INPUT
000357
UNTIL RECORDS-READ = START-NUMBER
000358
OR END-OF-FILE
000359
PERFORM 1000-PROCESS-DATA
000360
UNTIL END-OF-FILE
000361
PERFORM 6000-PRINT-EMPLOYEE-REPORT
000362
MOVE 1 TO REGION-SUB
000363
IF END-OF-MONTH
000364
PERFORM 7000-PRINT-REGION-REPORT
4. Place your cursor on 1000-PROCESS-DATA paragraph heading and scroll down. You must
have the scroll amount set to CSR.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF8]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
000365
UNTIL REGION-SUB > 4.
000366
PERFORM 9900-CLOSE.
000367 A
GOBACK.
000368
***
000369
*** DIFFERENT PROCESSING OCCURS BASED ON EMPLOYEE TYPE. THERE
000370
*** ARE 3 VALID EMPLOYEE TYPES. IF A RECORD IS READ CONTAINING
000371
*** A RECORD TYPE OTHER THAN H, S OR M, AN ERROR MESSAGE IS
000372
*** WRITTEN AND PROCESSING CONTINUES.
000373
***
000374
1000-PROCESS-DATA.
0000000
000375
IF HOURLY
000376
PERFORM 2000-PROCESS-HOURLY
000377
ELSE
000378
IF SALES
000379
PERFORM 3000-PROCESS-SALES
Counting Execution
12-5
12-6
Counting Execution
SHOW COUNTS
Primary Command:
12-7
12-8
Counting Execution
12-9
SHOW MODULES
Display a list of application modules loaded and the number of times each module was
executed.
Primary Command:
CSECT CWXTCOB
NO SOURCE CALL
NO SOURCE CALL
12-10
CSECT CWXTCOB
NO SOURCE CALL
NO SOURCE CALL
Subroutine Testing
13-1
Display the source for a program and set the before and after module
breakpoints.
KEEP LINKAGE
In this chapter you will discuss the following three scenarios for testing a called program:
Both the calling and called program are compiled for Xpediter.
13-2
DEMO PROGRAM
CWXTCOB
CWXTSUBC
CWXTDATE
BOTH THE CALLING AND CALLED PROGRAM ARE COMPILED FOR XPEDITER
Compile CWXTCOB and CWXTSUBC.
From the Test Standard screen, specify PROGRAM = CWXTCOB.
Enter INTERCEPT CWXTSUBC from the initial source display.
Subroutine Testing
13-3
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
13-4
INTERCEPT
Display the source for a program and set the before and after module
breakpoints.
Primary Commands:
INTERCEPT, INT
Example:
INT CWXTSUBC
Subroutine Testing
13-5
13-6
Subroutine Testing
13-7
13-8
This scenario assumes a DDIO source listing member exists for CWXTSUBC but not
for CWXTCOB.
6. Begin a new test of program CWXTCOB using a parm string of 00003. If the PARM field is left
blank, the parameter string from your execution JCL will be passed to your program.
Profile: CWXTCOB -----COMMAND ===> [ENTER]
----------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
Subroutine Testing
13-9
13-10
Subroutine Testing
13-11
13-12
10. Resume program execution. Control is returned to the driver program and execution will
pause upon entry into the subroutine.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB
COMP DATE: 10/16/2007 COMP TIME: 13:02:50
** END **
Subroutine Testing
13-13
13-14
COMMANDS:
===>
===> NO
===> NO
===> NO
or
Subroutine Testing
13-15
13. Since no driver program exists to populate the linkage section, change EMP-TYPE to 'S' and
SALES-AMOUNT to 2000.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
Overtype the data here.
000060
01 EMP-TYPE
> s
000061
01 SALES-AMOUNT
> 002000.00
DECIMAL
000062
01 COMM-TOTAL
> 00000.00
PACKED
** END **
---------------------------------------------- Before CWXTSUBC/AMODE 31 <>
=====> B PROCEDURE DIVISION USING EMP-TYPE, SALES-AMOUNT, COMM-TOTAL.
000067
0000-MAINLINE.
000068
IF EMP-TYPE EQUAL 'S'
000069
PERFORM 1000-PROCESS-SALES
000070
ELSE
000071
IF EMP-TYPE EQUAL 'M'
000072
PERFORM 2000-PROCESS-MANAGEMENT.
000073 A
GOBACK.
000074
***
000075
***
000076
***
000077
1000-PROCESS-SALES.
000078
MOVE SALES-AMOUNT TO SALES-RANGE.
000079
IF S-RANGE1
000080
SET SALES-IX TO 1
13-16
Subroutine Testing
KEEP LINKAGE
Primary Commands:
13-17
13-18
Enhanced Find
14-1
Exclude from view all lines that were not found. EXCLUDE is a parameter of the FIND
command.
NOLINES
Eliminate the message line that appears with the EXCLUDE keyword.
ALIAS
Find other references to the same storage location. ALIAS is a parameter of the FIND command.
INDIRECT
Find all direct and indirect references to the data name and all places a data value is
passed to or from the data name. INDIRECT is a parameter of the FIND command.
MODIFY
Identify where the value of the data name has changed or could be changed. MODIFY is a
parameter of the FIND command.
14-2
1.
----------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
NOTE:
If you would like a record of your FIND commands, you must first enter the SET LOG
FIND ON command, which will record the results of the FIND commands you issue to
the log file. See Chapter 9 for information on the log file.
Enhanced Find
FIND
Primary Commands:
FIND, F
Examples:
F 'OPEN'
F PARA X
F HOLD-LINE
F HOLD-LINE ALIAS
F HOLD-LINE ALIAS IND X NOL
F EMP-TYPE IN CALL
2. Find REGION-SALES.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> f region-sales
SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
=====> B PROCEDURE DIVISION USING PARMINFO.
000351
0000-MAINLINE.
000352
PERFORM 9000-OPEN.
000353
PERFORM 9100-CHECK-PARM.
000354
IF GOOD-PARM
000355
PERFORM 9200-INIT
000356
PERFORM 8000-READ-INPUT
000357
UNTIL RECORDS-READ = START-NUMBER
000358
OR END-OF-FILE
000359
PERFORM 1000-PROCESS-DATA
000360
UNTIL END-OF-FILE
000361
PERFORM 6000-PRINT-EMPLOYEE-REPORT
000362
MOVE 1 TO REGION-SUB
000363
IF END-OF-MONTH
000364
PERFORM 7000-PRINT-REGION-REPORT
14-3
14-4
3. Repeat find.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF5]
SCROLL ===> CSR
5 DATA REFS: 1 DEF, 2 USES, 2 MODS FOUND FOR REGION-SALES
----+-000347
01 PARMINFO
> ..00003
** END **
-----000109
000110
000111
000112
000113
000114
000115
000116
000117
000118
000119
000120
000121
000122
000123
Enhanced Find
EXCLUDE
Keywords:
EXCLUDE, EX, X
14-5
14-6
Enhanced Find
14-7
ALIAS
Find references to the data name and any other field referencing the same storage location. This
includes group levels, elementary items, redefinitions and 88 levels.
Keyword:
ALIAS, ALI
6. Find REGION-SALES, all of its aliases, and exclude all other statements.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> f region-sales alias x
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+-000347
01 PARMINFO
> ..00003
** END **
-----000420
000421
000422
000423
000424
000425
000426
000427
000428
000429
000430
000431
000432
000433
000434
14-8
Enhanced Find
INDIRECT
Find all statements in the program that directly or indirectly affect the data name.
Keywords:
INDIRECT, IND
14-9
8. Find REGION-SALES, all indirect references, exclude other statements, and suppress dashed
separator lines.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> f region-sales ind x nol
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+-000347
01 PARMINFO
> ..00003
** END **
-----000420
000421
000422
000423
000424
000425
000426
000427
000428
000429
000430
000431
000432
000433
000434
14-10
Enhanced Find
14-11
14-12
<>
USE
USE
MOD
MOD
Enhanced Find
MODIFY
Keywords:
MODIFY, MOD
12. Find all statements where REGION-SALES is modified, excluding all other statements.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> f region-sales mod x
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+-000347
01 PARMINFO
> ..00003
** END **
-----000420
000421
000422
000423
000424
000425
000426
000427
000428
000429
000430
000431
000432
000433
000434
<>
USE
USE
MOD
MOD
14-13
14-14
Enhanced Find
14-15
14-16
NOTE:
If you entered the SET LOG FIND ON command, you can now view your results by
entering the LOG command. See Chapter 9 about the details of printing the log file.
15-1
GOTO
15-2
SKIP
Primary Command:
SKIP, S
Examples:
Line Command:
15-3
15-4
GOTO
Primary Command:
GOTO
Examples:
GOTO 365
GOTO 6000-PRINT-EMPLOYEE-REPORT
Line Command:
GT
15-5
15-6
-----000373
000374
''''''
=====>
''''''
''''''
000375
000376
000377
000378
000379
000380
000381
000382
000383
-----000373
000374
''''''
=====>
''''''
''''''
000375
000376
000377
000378
000379
000380
000381
000382
000383
-----000385
=====>
000387
000388
000389
000390
000391
000392
000393
000394
000395
000396
000397
000398
000399
15-7
15-8
-----000385
=====>
000387
000388
000389
000390
000391
000392
000393
000394
000395
000396
000397
000398
000399
Abend-AID Link
16-1
NOTE:
The Abend-AID link requires Abend-AID for Batch Release 8.0.4 or higher.
16-2
----------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
Abend-AID Link
T0812817
USERID
ATSOPROC
13.44.06
OPSYS
DFSMS/MVS
JES2
LE
frontline.compuware.com
z/OS
1.8.0
V1R8M0
z/OS 1.8
z/OS
V1R8
Model
- 2086
CP FMID - HBB7730
System - CW01
16-3
16-4
T0812817
USERID
ATSOPROC
13.44.06
OPSYS
DFSMS/MVS
JES2
LE
frontline.compuware.com
z/OS
1.8.0
V1R8M0
z/OS 1.8
z/OS
V1R8
Model
- 2086
CP FMID - HBB7730
System - CW01
Abend-AID Link
16-5
16-6
Sourceless Debugging
17-1
AT
Set a breakpoint in a program that has not been compiled for Xpediter.
GPREGS
SHOW AT
Gain control of a program that does not have a Compuware source listing.
NOTE:
In order to execute the example in this module, CWXTSUBC must not be present in the
DDIO file.
17-2
COMMANDS:
( Caps = YES)
===>
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
Sourceless Debugging
MEMORY
Primary Commands:
MEMORY, MEM
Examples:
MEM CWXTSUBC:
MEMORY C75C8
MEMORY +D0
MEMORY R3%+F0
Line Command:
17-3
17-4
Sourceless Debugging
AT
Set a breakpoint in a program that has not been compiled with Xpediter.
Primary Command:
AT
Examples:
AT CWXTSUBC: +C0
AT +C4
17-5
17-6
Sourceless Debugging
GPREGS
Display and optionally modify the contents of the general purpose registers.
Primary Command:
GPREGS
Example:
GPREGS OFF
17-7
17-8
SHOW AT
Primary Command:
SHOW AT, SH AT
CSECT
ADDRESS
OFFSET
INSTR
FORMAT
OPCODE
CWXTCOB
CWXTSUBC
065276E8
BC
RX
47
******************************** BOTTOM OF DATA ********************************
GPREGS R0
R4
R8
R12
==>
==>
==>
==>
367CC248
367CC2C0
367D1110
0014AA58
R1
R5
R9
R13
==>
==>
==>
==>
001501C8
B65257F0
367CC100
00150018
R2
R6
R10
R14
==>
==>
==>
==>
367D13D9
367D0039
36523D58
800D4BCC
R3
R7
R11
R15
==>
==>
==>
==>
367D0110
367D0110
365242F8
365276E8
Sourceless Debugging
CSECT
ADDRESS
OFFSET
INSTR
FORMAT
OPCODE
CWXTCOB
CWXTSUBC
065276E8
BC
RX
47
******************************** BOTTOM OF DATA ********************************
GPREGS R0
R4
R8
R12
==>
==>
==>
==>
367CC248
367CC2C0
367D1110
0014AA58
R1
R5
R9
R13
==>
==>
==>
==>
001501C8
B65257F0
367CC100
00150018
R2
R6
R10
R14
==>
==>
==>
==>
367D13D9
367D0039
36523D58
800D4BCC
R3
R7
R11
R15
==>
==>
==>
==>
367D0110
367D0110
365242F8
365276E8
17-9
17-10
Sourceless Debugging
17-11
Enhanced sourceless debugging is now available. The Pseudosource command generates an assembler view of a
program providing more flexibility when debugging. Knowledge of the Assembler language is required. For
additional information on sourceless debugging, please refer to the Xpediter/TSO and IMS Reference Manual.
When working with pseudo-source, the following commands are available.
AFTER
DELETE
GO
GO (n) TRACE
INSERT
LOCATE
TRACE
BEFORE
EXIT
GO HALF
GOTO
KEEP
PEEK
VERIFY
COUNT
FIND
GO (n)
GPREGS
LINE
SKIP
WHEN
GO
GO 1
GO n
GO n TRACE
GO HALF
KEEP
SHOW WHEN
WHEN
17-12
PSEUDOSOURCE
Creates a temporary source image for a module or CSECT that does not have a matching
Compuware source listing file. The source image created is an interpreted pseudoassembler view of the loaded object code.
Primary Commands:
PSEUDOSOURCE, PSEUDO, PS
Examples:
PSEUDOSOURCE CWXTCOB::CWXTSUBC:
PSEUDO CWXTSUBC:
PS CWXTSUBC 2C
Sourceless Debugging
17-13
17-14
Sourceless Debugging
BEFORE
Primary Command:
BEFORE, BEF, B
Examples:
B 338
BEFORE CWXTSUBC:
Line Command:
17-15
17-16
Sourceless Debugging
GO
Begin or resume execution of your program. GO can also be issued by pressing [PF12] or [PF24].
Primary Command:
GO
17-17
17-18
KEEP
Primary Commands:
KEEP, K
Examples:
KEEP Rn
K address
R6
** END **
> 00000000
Sourceless Debugging
17-19
GO HALF
Executes half a statement (from before to after a statement, or from after one statement to
before the next).
Primary Command:
GO H
15. Enter the command to execute the Load Register instruction without advancing the position
of the execution pointer.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> GO H
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
SYSTEM K
R6
** END **
> 00000000
R6
** END **
> 367D13D0
17-20
16. Enter the command to permanently display the data located at the address contained in
register 6.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> k 367d13d0
SCROLL ===> CSR
NEXT LOGICAL INSTRUCTION IS CWXTSUBC:133
SYSTEM K
R6
** END **
> 367D13D0
R6
> 367D13D0
----+----1----+----2----+----3
> S05500000.....................
367D13D0
** END **
------------------------------------------- After CWXTSUBC:132/AMODE 31 ->
000131
5020 9134
ST
R2,308(,R9)
*&.j.*
====>> B 1862
LR
R6,R2
*..*
000133
5820 1004
L
R2,4(,R1)
*....*
000134
4120 2000
LA
R2,0(,R2)
*....*
000135
5020 9138
ST
R2,312(,R9)
*&.j.*
000136
1872
LR
R7,R2
*..*
000137
5820 1008
L
R2,8(,R1)
*....*
000138
4120 2000
LA
R2,0(,R2)
*....*
000139
5020 913C
ST
R2,316(,R9)
*&.j.*
000140
D203 D088 A034
MVC
136(4,R13),52(R10)
*K.}h..*
000141
BF2F 9158
ICM
R2,15,344(R9)
*..j.*
GPREGS R0 ==> 00150310 R1 ==> 001501C8 R2 ==> 367D13D0 R3 ==> 365276E8
R4 ==> 36527720 R5 ==> 00170038 R6 ==> 367D13D0 R7 ==> 00000000
R8 ==> 367D1950 R9 ==> 367CCC38 R10 ==> 36527810 R11 ==> 36526B90
R12 ==> 365277E4 R13 ==> 00150200 R14 ==> 36527A10 R15 ==> B6527A1C
Sourceless Debugging
WHEN
Primary Command:
WHEN
Examples:
17-21
WHEN R2 CHANGES
WHEN address L(length) > Xvalue
17. Enter the command to pause execution when the value of EMP-TYPE equals S and the value
of SALES-AMT is greater than $70,000.00. Delete the before breakpoint and resume program
execution.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> when 367d13d0 l(9) > S07000000;go
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
SYSTEM K
R6
MEMORY K
> 367D13D0
----+----1----+----2----+----3
> S05500000.....................
367D13D0
** END **
------------------------------------------- After CWXTSUBC:132/AMODE 31 ->
000131
5020 9134
ST
R2,308(,R9)
*&.j.*
d =>> B 1862
LR
R6,R2
*..*
000133
5820 1004
L
R2,4(,R1)
*....*
000134
4120 2000
LA
R2,0(,R2)
*....*
000135
5020 9138
ST
R2,312(,R9)
*&.j.*
000136
1872
LR
R7,R2
*..*
000137
5820 1008
L
R2,8(,R1)
*....*
000138
4120 2000
LA
R2,0(,R2)
*....*
000139
5020 913C
ST
R2,316(,R9)
*&.j.*
000140
D203 D088 A034
MVC
136(4,R13),52(R10)
*K.}h..*
000141
BF2F 9158
ICM
R2,15,344(R9)
*..j.*
GPREGS R0 ==> 00150310 R1 ==> 001501C8 R2 ==> 367D13D0 R3 ==> 365276E8
R4 ==> 36527720 R5 ==> 00170038 R6 ==> 367D13D0 R7 ==> 00000000
R8 ==> 367D1950 R9 ==> 367CCC38 R10 ==> 36527810 R11 ==> 36526B90
R12 ==> 365277E4 R13 ==> 00150200 R14 ==> 36527A10 R15 ==> B6527A1C
R6
> 367D0039
----+----1----+----2----+----3
> S07500000.....................
367D13D0
** END **
---------------------------------------------- Before CWXTSUBC/AMODE 31 ->
******************************** TOP OF MODULE ********************************
=====>
CWXTSUBC CSECT
000003
47F0 F028
B
40(,R15)
*.00.*
000004
DC
XL8'00C3C5C500000110'
*.CEE....*
000005
DC
XL8'0000001447F0F001'
*.....00.*
000006
DC
XL4'98CEAC00'
*q...*
000007
3652779E
DC
A(CWXTSUBC+X'B6')
000008
DC
12X'00'
000009
90EC D00C
STM
R14,R12,12(R13)
*..}.*
000010
4110 F038
LA
R1,56(,R15)
*..0.*
000011
98EF F04C
LM
R14,R15,76(R15)
*q.0<*
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0182
R4 ==> 367CC2C0 R5 ==> B65257F0 R6 ==> 367D0039 R7 ==> 367D0110
R8 ==> 367D1110 R9 ==> 367CC100 R10 ==> 36523D58 R11 ==> 365242F8
R12 ==> 0014AA58 R13 ==> 00150018 R14 ==> 800D4BCC R15 ==> 365276E8
17-22
18. Enter the command to display all WHEN conditions currently in effect.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> show when
SCROLL ===> CSR
WHEN 367d13d0 l (9) > 'S07000000'
SYSTEM K
R6
> 367D0039
----+----1----+----2----+----3
> S07500000.....................
MEMORY K
367D13D0
** END **
---------------------------------------------- Before CWXTSUBC/AMODE 31 ->
******************************** TOP OF MODULE ********************************
=====>
CWXTSUBC CSECT
000003
47F0 F028
B
40(,R15)
*.00.*
000004
DC
XL8'00C3C5C500000110'
*.CEE....*
000005
DC
XL8'0000001447F0F001'
*.....00.*
000006
DC
XL4'98CEAC00'
*q...*
000007
3652779E
DC
A(CWXTSUBC+X'B6')
000008
DC
12X'00'
000009
90EC D00C
STM
R14,R12,12(R13)
*..}.*
000010
4110 F038
LA
R1,56(,R15)
*..0.*
000011
98EF F04C
LM
R14,R15,76(R15)
*q.0<*
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0182
R4 ==> 367CC2C0 R5 ==> B65257F0 R6 ==> 367D0039 R7 ==> 367D0110
R8 ==> 367D1110 R9 ==> 367CC100 R10 ==> 36523D58 R11 ==> 365242F8
R12 ==> 0014AA58 R13 ==> 00150018 R14 ==> 800D4BCC R15 ==> 365276E8
GPREGS R0
R4
R8
R12
==>
==>
==>
==>
367CC248
367CC2C0
367D1110
0014AA58
R1
R5
R9
R13
==>
==>
==>
==>
001501C8
B65257F0
367CC100
00150018
R2
R6
R10
R14
==>
==>
==>
==>
367D13D9
367D0039
36523D58
800D4BCC
R3
R7
R11
R15
==>
==>
==>
==>
367D0182
367D0110
365242F8
365276E8
Sourceless Debugging
GPREGS R0
R4
R8
R12
==>
==>
==>
==>
367CC248
367CC2C0
367D1110
0014AA58
R1
R5
R9
R13
==>
==>
==>
==>
001501C8
B65257F0
367CC100
00150018
R2
R6
R10
R14
==>
==>
==>
==>
367D13D9
367D0039
36523D58
800D4BCC
R3
R7
R11
R15
==>
==>
==>
==>
367D0182
367D0110
365242F8
365276E8
GPREGS R0
R4
R8
R12
==>
==>
==>
==>
367CC248
367CC2C0
367D1110
0014AA58
R1
R5
R9
R13
==>
==>
==>
==>
001501C8
B65257F0
367CC100
00150018
R2
R6
R10
R14
==>
==>
==>
==>
367D13D9
367D0039
36523D58
800D4BCC
R3
R7
R11
R15
==>
==>
==>
==>
367D0182
367D0110
365242F8
365276E8
17-23
17-24
GPREGS R0
R4
R8
R12
==>
==>
==>
==>
367CC248
367CC2C0
367D1110
0014AA58
R1
R5
R9
R13
==>
==>
==>
==>
001501C8
B65257F0
367CC100
00150018
R2
R6
R10
R14
==>
==>
==>
==>
367D13D9
367D0039
36523D58
800D4BCC
R3
R7
R11
R15
==>
==>
==>
==>
367D0182
367D0110
365242F8
365276E8
R6
> 367D0039
----+----1----+----2----+----3
> S07500000.....................
367D13D0
** END **
---------------------------------------------- Before CWXTSUBC/AMODE 31 ->
******************************** TOP OF MODULE ********************************
=====>
CWXTSUBC CSECT
000003
47F0 F028
B
40(,R15)
*.00.*
000004
DC
XL8'00C3C5C500000110'
*.CEE....*
000005
DC
XL8'0000001447F0F001'
*.....00.*
000006
DC
XL4'98CEAC00'
*q...*
000007
3652779E
DC
A(CWXTSUBC+X'B6')
000008
DC
12X'00'
000009
90EC D00C
STM
R14,R12,12(R13)
*..}.*
000010
4110 F038
LA
R1,56(,R15)
*..0.*
000011
98EF F04C
LM
R14,R15,76(R15)
*q.0<*
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0182
R4 ==> 367CC2C0 R5 ==> B65257F0 R6 ==> 367D0039 R7 ==> 367D0110
R8 ==> 367D1110 R9 ==> 367CC100 R10 ==> 36523D58 R11 ==> 365242F8
R12 ==> 0014AA58 R13 ==> 00150018 R14 ==> 800D4BCC R15 ==> 365276E8
Sourceless Debugging
GO n
Primary Command:
GO n
R6
MEMORY K
> 367D0039
----+----1----+----2----+----3
> S07500000.....................
367D13D0
** END **
---------------------------------------------- Before CWXTSUBC/AMODE 31 ->
******************************** TOP OF MODULE ********************************
=====>
CWXTSUBC CSECT
000003
47F0 F028
B
40(,R15)
*.00.*
000004
DC
XL8'00C3C5C500000110'
*.CEE....*
000005
DC
XL8'0000001447F0F001'
*.....00.*
000006
DC
XL4'98CEAC00'
*q...*
000007
3652779E
DC
A(CWXTSUBC+X'B6')
000008
DC
12X'00'
000009
90EC D00C
STM
R14,R12,12(R13)
*..}.*
000010
4110 F038
LA
R1,56(,R15)
*..0.*
000011
98EF F04C
LM
R14,R15,76(R15)
*q.0<*
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0182
R4 ==> 367CC2C0 R5 ==> B65257F0 R6 ==> 367D0039 R7 ==> 367D0110
R8 ==> 367D1110 R9 ==> 367CC100 R10 ==> 36523D58 R11 ==> 365242F8
R12 ==> 0014AA58 R13 ==> 00150018 R14 ==> 800D4BCC R15 ==> 365276E8
R6
> 367D13D0
----+----1----+----2----+----3
> S07500000.....................
367D13D0
** END **
------------------------------------------ Before CWXTSUBC:168/AMODE 31 ->
000167
58B0 C028
L
R11,40(,R12)
*..{.*
=====>
4710 B196
BO
406(,R11)
*...o*
000169
9120 9054
TM
84(R9),X'20'
*j...*
000170
47E0 B18E
BNO
398(,R11)
*.\..*
000171
9620 D084
OI
132(R13),X'20'
*o.}d*
000172
9640 9057
OI
87(R9),X'40'
*o ..*
000173
47F0 B196
B
406(,R11)
*.0.o*
000174
9640 9148
OI
328(R9),X'40'
*o j.*
000175
9601 D084
OI
132(R13),X'01'
*o.}d*
000176
95E2 6000
CLI
0(R6),X'E2'
*nS-.*
000177
4770 B1C6
BNE/BNZ 454(,R11)
*...F*
GPREGS R0 ==> 00150310 R1 ==> 001501C8 R2 ==> 00000001 R3 ==> 365276E8
R4 ==> 36527720 R5 ==> 0013B7FC R6 ==> 367D13D0 R7 ==> 367D13D1
R8 ==> 367D1950 R9 ==> 367CCC38 R10 ==> 36527810 R11 ==> 36527980
R12 ==> 365277E4 R13 ==> 00150200 R14 ==> B6527A10 R15 ==> B6527A1C
17-25
17-26
GO n TRACE
Primary Command:
GO n TRACE
Example:
GO 5 TRACE
22. Enter the command to execute the next 10 statements, highlighting each statement as it
executes.
------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go 10 trace
SCROLL ===> CSR
50 STATEMENTS EXECUTED
SYSTEM K
MEMORY K
R6
> 367D13D0
----+----1----+----2----+----3
> S07500000.....................
367D13D0
** END **
------------------------------------------ Before CWXTSUBC:168/AMODE 31 ->
000167
58B0 C028
L
R11,40(,R12)
*..{.*
=====>
4710 B196
BO
406(,R11)
*...o*
000169
9120 9054
TM
84(R9),X'20'
*j...*
000170
47E0 B18E
BNO
398(,R11)
*.\..*
000171
9620 D084
OI
132(R13),X'20'
*o.}d*
000172
9640 9057
OI
87(R9),X'40'
*o ..*
000173
47F0 B196
B
406(,R11)
*.0.o*
000174
9640 9148
OI
328(R9),X'40'
*o j.*
000175
9601 D084
OI
132(R13),X'01'
*o.}d*
000176
95E2 6000
CLI
0(R6),X'E2'
*nS-.*
000177
4770 B1C6
BNE/BNZ 454(,R11)
*...F*
GPREGS R0 ==> 00150310 R1 ==> 001501C8 R2 ==> 00000001 R3 ==> 365276E8
R4 ==> 36527720 R5 ==> 0013B7FC R6 ==> 367D13D0 R7 ==> 367D13D1
R8 ==> 367D1950 R9 ==> 367CCC38 R10 ==> 36527810 R11 ==> 36527980
R12 ==> 365277E4 R13 ==> 00150200 R14 ==> B6527A10 R15 ==> B6527A1C
Sourceless Debugging
17-27
17-28
18-1
18-2
DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT
----------------------
Specify defaults
Prepare programs for debugging
Debug programs interactively under TSO
Debug programs interactively under batch
Debug DB2 Stored Procedures interactively
Perform utility functions
Invoke File-AID for DB2
Invoke File-AID for MVS
Invoke File-AID for IMS
Code Coverage Reports and Utilities
Connect to a CICS region
Display information about XPEDITER/TSO
Exit primary menu
- ** NO DESCRIPTION **
or
------------------
For the COMPILE FACILITY, you may use the Compile Profile field
below as a method of selecting a specific profile that contains
or will contain the desired compile parameters. If an existing
name is entered, the compile parameters previously saved under
that name will be used. If a new name is entered, a new profile
will be created to hold the newly entered compile parameters.
A '?' in the Compile Profile field will display a member list of
existing names permitting profiles to be selected, displayed or
maintained (i.e., COPY, RENAME, DELETE, etc.).
Compile Profile => DEFAULT
>
<
or
3. Enter the dataset name to copy the file allocation list to, the dataset name to copy the JCL
from, and the program name for step selection.
----------------------COMMAND ===> [ENTER]
-----------------------
===>
===>
===>
===>
USERID
XPEDITER
ALLOC
CWXTCOB
---------------------COMMAND ===>
Line
D
I
R
Commands:
(Delete)
(Insert)
(Repeat)
or
Primary Commands:
...MORE ===>
S (Select detail)
CANcel
(Quit without saving)
BR (Browse dataset)
COPY
(Copy JCL or File List)
ED (Edit dataset)
ALLOCate (Allocate and continue)
FB (File-AID Browse)
END
(Save and End)
FE (File-AID Edit)
File Allocation List: 'USERID.XPEDITER.ALLOC(CWXTCOB)'
----------------------- DSNAME ----------------------- DISP
DDNAME
DUMMY, TEMP, TERM, SYSOUT, *, OR A DATASET NAME
STAT
------------------------------------------------------------------------------'''''
EMPFILE 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'
SHR
'''''
RPTFILE SYSOUT=X
'''''
SYSOUT
SYSOUT=X
'''''
'''''
'''''
'''''
'''''
'''''
'''''
'''''
18-3
18-4
Commands:
(Delete)
(Insert)
(Repeat)
Primary Commands:
...MORE ===>
S (Select detail)
CANcel
(Quit without saving)
BR (Browse dataset)
COPY
(Copy JCL or File List)
ED (Edit dataset)
ALLOCate (Allocate and continue)
FB (File-AID Browse)
END
(Save and End)
FE (File-AID Edit)
File Allocation List: 'USERID.XPEDITER.ALLOC(CWXTCOB)'
----------------------- DSNAME ----------------------- DISP
DDNAME
DUMMY, TEMP, TERM, SYSOUT, *, OR A DATASET NAME
STAT
------------------------------------------------------------------------------'''''
EMPFILE 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'
SHR
'''''
RPTFILE term
'''''
SYSOUT
SYSOUT=X
'''''
'''''
'''''
'''''
'''''
'''''
'''''
'''''
---------------------COMMAND ===>
Line
D
I
R
Commands:
(Delete)
(Insert)
(Repeat)
---------- Row 1 Of 3
SCROLL ===> CSR
Primary Commands:
...MORE ===>
S (Select detail)
CANcel
(Quit without saving)
BR (Browse dataset)
COPY
(Copy JCL or File List)
ED (Edit dataset)
ALLOCate (Allocate and continue)
FB (File-AID Browse)
END
(Save and End)
FE (File-AID Edit)
File Allocation List: 'USERID.XPEDITER.ALLOC(CWXTCOB)'
----------------------- DSNAME ----------------------- DISP
DDNAME
DUMMY, TEMP, TERM, SYSOUT, *, OR A DATASET NAME
STAT
------------------------------------------------------------------------------'''''
EMPFILE 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'
SHR
'''''
RPTFILE TERM
'''''
SYSOUT
SYSOUT=X
'''''
'''''
'''''
'''''
'''''
'''''
'''''
'''''
18-5
---------- Row 1 Of 3
SCROLL ===> CSR
Commands:
(Delete)
(Insert)
(Repeat)
Primary Commands:
...MORE ===>
S (Select detail)
CANcel
(Quit without saving)
BR (Browse dataset)
COPY
(Copy JCL or File List)
ED (Edit dataset)
ALLOCate (Allocate and continue)
FB (File-AID Browse)
END
(Save and End)
FE (File-AID Edit)
File Allocation List: 'USERID.XPEDITER.ALLOC(CWXTCOB)'
----------------------- DSNAME ----------------------- DISP
DDNAME
DUMMY, TEMP, TERM, SYSOUT, *, OR A DATASET NAME
STAT
------------------------------------------------------------------------------'''''
EMPFILE 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'
SHR
'''''
RPTFILE TERM
'''''
SYSOUT
SYSOUT=X
'''''
'''''
'''''
------------------COMMAND ===>
Line
D
I
R
------- Row 1 Of 3
SCROLL ===> CSR
Commands:
(Delete)
(Insert)
(Repeat)
Primary Commands:
...<=== MORE
S (Select detail)
CANcel
(Quit without saving)
BR (Browse dataset)
COPY
(Copy JCL or File List)
ED (Edit dataset)
ALLOCate (Allocate and continue)
FB (File-AID Browse)
END
(Save and End)
FE (File-AID Edit)
File Allocation List: 'USERID.XPEDITER.ALLOC(CWXTCOB)'
------------ SMS ------------DDNAME
DATACLAS
STORCLAS
MGMTCLAS
DEL?
------------------------------------------------------------------------------'''''
EMPFILE
'''''
RPTFILE
'''''
SYSOUT
'''''
'''''
'''''
'''''
NOTE:
If your site uses SMS to manage DASD datasets, the screens shown in this chapter will
be displayed:
- DSNAME
- SMS Parameters
If your site does not use SMS to manage datasets, the following screens will be
displayed:
- DSNAME
- Space and Catalog Parameters
- DCB Parameters
No space/DCB information is shown for files already created.
18-6
------- Row 1 Of 3
SCROLL ===> CSR
Commands:
(Delete)
(Insert)
(Repeat)
Primary Commands:
...<=== MORE
S (Select detail)
CANcel
(Quit without saving)
BR (Browse dataset)
COPY
(Copy JCL or File List)
ED (Edit dataset)
ALLOCate (Allocate and continue)
FB (File-AID Browse)
END
(Save and End)
FE (File-AID Edit)
File Allocation List: 'USERID.XPEDITER.ALLOC(CWXTCOB)'
------------ SMS ------------DDNAME
DATACLAS
STORCLAS
MGMTCLAS
DEL?
------------------------------------------------------------------------------s
EMPFILE
'''''
RPTFILE
'''''
SYSOUT
'''''
'''''
'''''
'''''
'''''
'''''
'''''
'''''
----------------------OPTION ===>
DDNAME: EMPFILE
1
2
3
4
5
----------------------
DSN: 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'
ALLOCATION
DCB
SYSOUT
PROTECTION
HFS
Specify
Specify
Specify
Specify
Specify
or
----------------------
DSN: 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'
ALLOCATION
DCB
SYSOUT
PROTECTION
HFS
Specify
Specify
Specify
Specify
Specify
or
----------------------
SA
SD (Select DCB)
SO (SYSOUT)
SP (Protection)
DSN: 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'
DISP ===> SHR (Status) _______ (Normal Disp) _______ (Conditional Disp)
FAU DEL? ===> ______ (Yes, No, Use, Prompt)
FREE ===> _____ (End/Close)
SPACE ===> _____ (Units) _____ (Primary) _____ (Secondary) ___ (Dir)
AVGREC _ RLSE ___ (Yes/No) CONTIG ______ ROUND ___ (Yes/No)
UNIT ===> ________ (Device) __ (Unit Count) DEFER ___ (Yes/No)
VOL SER ===> ______ ______ ______ ______ ______ (Serial Numbers)
VOL SEQ ___ VOL COUNT ___ PRIVATE ___ (Yes/No) MSVGP ________
REF DSN ______________________________________________
LABEL ===> ____ (Dataset Seq) ___ (Label Type)
RETPD ____ EXPDT ________
18-7
18-8
----------------------
DSN: 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'
ALLOCATION
DCB
SYSOUT
PROTECTION
HFS
Specify
Specify
Specify
Specify
Specify
or
-------------------------
SA (Select Allocation)
SD
SO (SYSOUT)
DSN: 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'
SP (Protection)
----------------------
DSN: 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'
ALLOCATION
DCB
SYSOUT
PROTECTION
HFS
Specify
Specify
Specify
Specify
Specify
or
Commands:
(Delete)
(Insert)
(Repeat)
---------- Row 1 Of 3
SCROLL ===> CSR
Primary Commands:
...MORE ===>
S (Select detail)
CANcel
(Quit without saving)
BR (Browse dataset)
COPY
(Copy JCL or File List)
ED (Edit dataset)
ALLOCate (Allocate and continue)
FB (File-AID Browse)
END
(Save and End)
FE (File-AID Edit)
File Allocation List: 'USERID.XPEDITER.ALLOC(CWXTCOB)'
----------------------- DSNAME ----------------------- DISP
DDNAME
DUMMY, TEMP, TERM, SYSOUT, *, OR A DATASET NAME
STAT
------------------------------------------------------------------------------'''''
EMPFILE 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'
SHR
'''''
RPTFILE SYSOUT=X
'''''
SYSOUT
SYSOUT=X
'''''
'''''
'''''
'''''
'''''
'''''
'''''
18-9
18-10
===>
===>
===>
===>
USERID
XPEDITER
ALLOC
CWXTCOB
or
------------------
For the COMPILE FACILITY, you may use the Compile Profile field
below as a method of selecting a specific profile that contains
or will contain the desired compile parameters. If an existing
name is entered, the compile parameters previously saved under
that name will be used. If a new name is entered, a new profile
will be created to hold the newly entered compile parameters.
A '?' in the Compile Profile field will display a member list of
existing names permitting profiles to be selected, displayed or
maintained (i.e., COPY, RENAME, DELETE, etc.).
Compile Profile => DEFAULT
>
<
or
Batch Connect
19-1
Interactive - enables you to connect through VTAM to a job submitted in batch mode and to start an
interactive debugging session.
Unattended - enables you to submit a test of your program with a predefined set of Xpediter/TSO commands
(script) and review the output.
Batch jobs with multiple steps, enabling you to test one or more of the steps.
In this chapter you will submit a job for interactive batch testing using Xpediter's batch connect facility.
INTERACTIVE
TSO
XPEDITER
TSO
BATCH
XPEDITER
XPEDITER
VTAM
PROGRAM
PROGRAM
FILES
FILES
NOTE: To use the demo program JCL, you must copy the JCL into your own PDS and edit the jobname by
adding one character to your TSO user ID.
19-2
DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT
----------------------
Specify defaults
Prepare programs for debugging
Debug programs interactively under TSO
Debug programs interactively under batch
Debug DB2 Stored Procedures interactively
Perform utility functions
Invoke File-AID for DB2
Invoke File-AID for MVS
Invoke File-AID for IMS
Code Coverage Reports and Utilities
Connect to a CICS region
Display information about XPEDITER/TSO
Exit primary menu
- ** NO DESCRIPTION **
or
--------
Batch
Multi-Batch
NOTE:
-------------------------
or
Batch Connect enables you to connect to a submitted batch job, view the source, and manipulate
data as it executes in its native environment. You can debug a single step, multiple steps, or
several programs under a step. Multi-batch differs from batch in the following ways:
1) Multiple jobnames, stepnames, and programs can be selected for debugging by Xpediter with a single
Multi-Batch request.
2) The Multi-Batch requests are persistent until the owner of the request, or an administrator deletes them.
3) Users submit their current test or production JCL. If the jobname, stepname, and program matches an
active Multi-batch request, Xpediter automatically intercepts the program and begins the debugging session
(unattended test) or provides the user with an opportunity to connect to the job and interactively debug it.
Batch Connect
19-3
===>
Browse
===>
Edit
SEtup
STatus
===>
or
-------------
The JOB CARD below is used by the SUBMIT PROC expansion process.
Its purpose is to extract information from PROCs such as DD names and
to resolve symbolic substitution. MSGCLASS, MSGLEVEL, TYPRUN, and NOTIFY
are reserved for XPEDITER use and will be ignored if specified below.
The
-
===>
===>
===>
===>
or
19-4
Line Commands:
I - Interactive testing
U - Unattended testing
Followed optionally by:
C - Code Coverage
T - Code Coverage, plus TDO
F - System Flow (F, CF or TF)
Primary
Edit
END
RUN
SEtup
SUBmit
STatus
---------- Row 1 of 4
SCROLL ===> CSR
Commands:
- Display converted selected steps
- Exit without processing
- Submit and connect
- Setup work datasets
- Convert selected steps and submit
- Display status of submitted job(s)
Dataset: 'USERID.XPEDITER.SAMPLIB(CWXTPROC)'
PROGRAM
INITSCR
POSTSCR
STEPNAME PROCNAME
PROCSTEP
EXEC PGM
--------------------------------- -------------------------------------------i
CWXTCOB
________ ________ RUN01
CWXTPROC
STEP01
_
IEBGENER
________ ________ RUN01
CWXTPROC
STEP02
u
CWXTCOB
cwxtcob_ showc
RUN02
CWXTPROC
STEP01
_
IEBGENER
________ ________ RUN02
CWXTPROC
STEP02
******************************* Bottom of data ********************************
----------------------COMMAND ===>
Line Commands:
I - Interactive testing
U - Unattended testing
Followed optionally by:
C - Code Coverage
T - Code Coverage, plus TDO
F - System Flow (F, CF or TF)
Primary
Edit
END
RUN
SEtup
SUBmit
STatus
---------- Row 1 of 4
SCROLL ===> CSR
Commands:
- Display converted selected steps
- Exit without processing
- Submit and connect
- Setup work datasets
- Convert selected steps and submit
- Display status of submitted job(s)
Dataset: 'USERID.XPEDITER.SAMPLIB(CWXTPROC)'
PROGRAM
INITSCR
POSTSCR
STEPNAME PROCNAME
PROCSTEP
EXEC PGM
--------------------------------- -------------------------------------------I
CWXTCOB
________ ________ RUN01
CWXTPROC
STEP01
XPTSO
__
IEBGENER
________ ________ RUN01
CWXTPROC
STEP02
U
CWXTCOB
CWXTCOB
SHOWC
RUN02
CWXTPROC
STEP01
XPBATCH
__
IEBGENER
________ ________ RUN02
CWXTPROC
STEP02
******************************* Bottom of data ********************************
NOTE:
The DDIO and INCLUDE files have already been defined to the setup. The initial script you are
pointing to in the unattended batch job (CWXTCOB) is the same as the one you created in
Chapter 10. An additional script member called SHOWC is defined under the POSTSCR
column and will be executed at the end of your test session. This script contains the command
SHOW COUNTS.
Batch Connect
Line Commands:
I - Interactive testing
U - Unattended testing
Followed optionally by:
C - Code Coverage
T - Code Coverage, plus TDO
F - System Flow (F, CF or TF)
Primary
Edit
END
RUN
SEtup
SUBmit
STatus
---------- Row 1 of 4
SCROLL ===> CSR
Commands:
- Display converted selected steps
- Exit without processing
- Submit and connect
- Setup work datasets
- Convert selected steps and submit
- Display status of submitted job(s)
Dataset: 'USERID.XPEDITER.SAMPLIB(CWXTPROC)'
PROGRAM
INITSCR
POSTSCR
STEPNAME PROCNAME
PROCSTEP
EXEC PGM
--------------------------------- -------------------------------------------I
CWXTCOB
________ ________ RUN01
CWXTPROC
STEP01
XPTSO
__
IEBGENER
________ ________ RUN01
CWXTPROC
STEP02
U
CWXTCOB
CWXTCOB
SHOWC
RUN02
CWXTPROC
STEP01
XPBATCH
__
IEBGENER
________ ________ RUN02
CWXTPROC
STEP02
******************************* Bottom of data ********************************
Line Commands:
I - Interactive testing
U - Unattended testing
Followed optionally by:
C - Code Coverage
T - Code Coverage, plus TDO
F - System Flow (F, CF or TF)
Primary
Edit
END
RUN
SEtup
SUBmit
STatus
---------- Row 1 of 4
SCROLL ===> CSR
Commands:
- Display converted selected steps
- Exit without processing
- Submit and connect
- Setup work datasets
- Convert selected steps and submit
- Display status of submitted job(s)
Dataset: 'USERID.XPEDITER.SAMPLIB(CWXTPROC)'
PROGRAM
INITSCR
POSTSCR
STEPNAME PROCNAME
PROCSTEP
EXEC PGM
--------------------------------- -------------------------------------------I
CWXTCOB
________ ________ RUN01
CWXTPROC
STEP01
XPTSO
__
IEBGENER
________ ________ RUN01
CWXTPROC
STEP02
U
CWXTCOB
CWXTCOB
SHOWC
RUN02
CWXTPROC
STEP01
XPBATCH
__
IEBGENER
________ ________ RUN02
CWXTPROC
STEP02
******************************* Bottom of data *******************************
JOB USERIDX(JOB06095) SUBMITTED
***
19-5
19-6
Line Commands:
I - Interactive testing
U - Unattended testing
Followed optionally by:
C - Code Coverage
T - Code Coverage, plus TDO
F - System Flow (F, CF or TF)
Primary
Edit
END
RUN
SEtup
SUBmit
STatus
Commands:
- Display converted selected steps
- Exit without processing
- Submit and connect
- Setup work datasets
- Convert selected steps and submit
- Display status of submitted job(s)
Dataset: 'USERID.XPEDITER.SAMPLIB(CWXTPROC)'
PROGRAM
INITSCR
POSTSCR
STEPNAME PROCNAME
PROCSTEP
EXEC PGM
--------------------------------- -------------------------------------------I
CWXTCOB
________ ________ RUN01
CWXTPROC
STEP01
XPTSO
__
IEBGENER
________ ________ RUN01
CWXTPROC
STEP02
U
CWXTCOB
CWXTCOB
SHOWC
RUN02
CWXTPROC
STEP01
XPBATCH
__
IEBGENER
________ ________ RUN02
CWXTPROC
STEP02
******************************* Bottom of data *******************************
Batch Connect
XPEDITER/TSO - STATUS
B (Browse)
P (Purge)
C (Cancel)
R (Requeue)
--------------- Row 1 of 1
SCROLL ===> CSR
USERID => USERID
NOTE:
When the source is displayed, all Xpediter/TSO debugging commands are available.
19-7
19-8
Batch Connect
XPEDITER/TSO - STATUS
B (Browse)
P (Purge)
C (Cancel)
R (Requeue)
--------------- Row 1 of 1
SCROLL ===> CSR
USERID => USERID
19-9
19-10
13. You will be notified when the next step has run.
10.49.04 JOB06095 $HASP165 USERIDX ENDED AT CW01
0 CN(INTERNAL)
***
--------------------------COMMAND ===>
Line Commands: A (Attach)
I (Info)
Jobname ===>
Sort Sequence ===> JOBID
XPEDITER/TSO - STATUS
B (Browse)
P (Purge)
C (Cancel)
R (Requeue)
--------------- Row 1 of 1
SCROLL ===> CSR
USERID => USERID
Batch Connect
XPEDITER/TSO - STATUS
B (Browse)
P (Purge)
C (Cancel)
R (Requeue)
--------------- Row 1 of 1
SCROLL ===> CSR
USERID => USERID
19-11
19-12
EMPLOYEE NAME
REGION TYPE
JOHN SMITH
ROY GARDNER
DAN PEARSON
MICHAEL DAYTON
DENNIS WHITE
VALERIE OLSEN
LAURA MARTIN
MARCIA SULLIVAN
JAMES MORRISON
THOMAS LONG
DONNA BROWN
SAMUEL ADDAMS
MARK JOHNSON
NORTH
NORTH
NORTH
SOUTH
SOUTH
EAST
EAST
EAST
EAST
WEST
WEST
WEST
WEST
H
S
S
S
S
S
S
H
H
H
S
H
S
HIRE
DATE
YRS OF
SERVICE
10/15/81
12/31/92
07/20/89
08/30/82
02/29/88
05/01/94
06/14/83
04/05/93
09/13/91
03/31/87
11/11/81
01/02/86
09/30/82
22
11
14
21
16
10
20
11
12
17
22
18
21
SALARY
1083.00
750.00
850.00
825.00
1050.00
900.00
1225.00
1200.00
1017.50
1000.00
1000.00
1100.00
750.00
O/T
COMMISSION
0.00
0.00
0.00
0.00
0.00
0.00
0.00
180.00
0.00
0.00
0.00
82.50
0.00
0.00
3300.00
1000.00
6000.00
1120.00
5600.00
6000.00
0.00
0.00
0.00
3333.00
0.00
6000.00
TOTAL
1083.00
4050.00
1850.00
6825.00
2170.00
6500.00
7225.00
1380.00
1017.50
1000.00
4333.00
1182.50
6750.00
Batch Connect
EMPLOYEE NAME
REGION TYPE
JOHN SMITH
ROY GARDNER
DAN PEARSON
MICHAEL DAYTON
DENNIS WHITE
VALERIE OLSEN
LAURA MARTIN
MARCIA SULLIVAN
JAMES MORRISON
THOMAS LONG
DONNA BROWN
SAMUEL ADDAMS
MARK JOHNSON
NORTH
NORTH
NORTH
SOUTH
SOUTH
EAST
EAST
EAST
EAST
WEST
WEST
WEST
WEST
H
S
S
S
S
S
S
H
H
H
S
H
S
HIRE
DATE
YRS OF
SERVICE
10/15/81
12/31/92
07/20/89
08/30/82
02/29/88
05/01/94
06/14/83
04/05/93
09/13/91
03/31/87
11/11/81
01/02/86
09/30/82
22
11
14
21
16
10
20
11
12
17
22
18
16
SALARY
1083.00
750.00
850.00
825.00
1050.00
900.00
1225.00
1200.00
1017.50
1000.00
1000.00
1100.00
750.00
O/T
COMMISSION
0.00
0.00
0.00
0.00
0.00
0.00
0.00
180.00
0.00
0.00
0.00
82.50
0.00
0.00
3300.00
1000.00
6000.00
1120.00
5600.00
6000.00
0.00
0.00
0.00
3333.00
0.00
6000.00
TOTAL
1083.00
4050.00
1850.00
6825.00
2170.00
6500.00
7225.00
1380.00
1017.50
1000.00
4333.00
1182.50
6750.00
19-13
19-14
--------------------------COMMAND ===>
Line Commands: A (Attach)
I (Info)
Jobname ===>
Sort Sequence ===> JOBID
XPEDITER/TSO - STATUS
B (Browse)
P (Purge)
C (Cancel)
R (Requeue)
--------------- Row 1 of 1
SCROLL ===> CSR
USERID => USERID
Batch Connect
XPEDITER/TSO - STATUS
B (Browse)
P (Purge)
Jobname ===>
Sort Sequence ===> JOBID
--------------- Row 1 of 1
SCROLL ===> CSR
C (Cancel)
R (Requeue)
----------------------COMMAND ===>
Line Commands:
I - Interactive testing
U - Unattended testing
Followed optionally by:
C - Code Coverage
T - Code Coverage, plus TDO
F - System Flow (F, CF or TF)
Primary
Edit
END
RUN
SEtup
SUBmit
STatus
---------- Row 1 of 4
SCROLL ===> CSR
Commands:
- Display converted selected steps
- Exit without processing
- Submit and connect
- Setup work datasets
- Convert selected steps and submit
- Display status of submitted job(s)
Dataset: 'USERID.XPEDITER.SAMPLIB(CWXTPROC)'
PROGRAM
INITSCR POSTSCR
STEPNAME PROCNAME
PROCSTEP
EXEC PGM
---------------------------------- ------------------------------------------I
CWXTCOB
________ ________
RUN01
CWXTPROC
STEP01
XPTSO
__
IEBGENER
________ ________
RUN01
CWXTPROC
STEP02
U
CWXTCOB
CWXTCOB
SHOWC___
RUN02
CWXTPROC
STEP01
XPBATCH
__
IEBGENER
________ ________
RUN02
CWXTPROC
STEP02
******************************* Bottom of data ********************************
19-15
19-16
Line Commands:
I - Interactive testing
U - Unattended testing
Followed optionally by:
C - Code Coverage
T - Code Coverage, plus TDO
F - System Flow (F, CF or TF)
Primary
Edit
END
RUN
SEtup
SUBmit
STatus
---------- Row 1 of 4
SCROLL ===> CSR
Commands:
- Display converted selected steps
- Exit without processing
- Submit and connect
- Setup work datasets
- Convert selected steps and submit
- Display status of submitted job(s)
Dataset: 'USERID.XPEDITER.SAMPLIB(CWXTPROC)'
PROGRAM
INITSCR
POSTSCR
STEPNAME PROCNAME
PROCSTEP
EXEC PGM
---------------------------------- ------------------------------------------I
CWXTCOB
________ ________
RUN01
CWXTPROC
STEP01
XPTSO
__
IEBGENER
________ ________
RUN01
CWXTPROC
STEP02
U
CWXTCOB
CWXTCOB
SHOWC___
RUN02
CWXTPROC
STEP01
XPBATCH
__
IEBGENER
________ ________
RUN02
CWXTPROC
STEP02
******************************* Bottom of data ********************************
===>
Browse
===>
Edit
SEtup
STatus
===>
or
Batch Connect
ISPF Library:
Project ===>
Group
===>
Type
===>
Member ===>
===>
Browse
===>
Edit
SEtup
STatus
===>
---------------------OPTION ===>
0
1
2
3
4
5
F
FA
FI
C
CS
T
X
DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT
or
----------------------
Specify defaults
Prepare programs for debugging
Debug programs interactively under TSO
Debug programs interactively under batch
Debug DB2 Stored Procedures interactively
Perform utility functions
Invoke File-AID for DB2
Invoke File-AID for MVS
Invoke File-AID for IMS
Code Coverage Reports and Utilities
Connect to a CICS region
Display information about XPEDITER/TSO
Exit primary menu
- ** NO DESCRIPTION **
or
19-17
19-18
Profiles
20-1
Chapter 20 Profiles
The user profile contains the environment parameters and SETUP options needed for a particular debugging
session. Using profiles will allow you to retain characteristics of specific test environments (IMS, DB2) so that
they will not have to be set up each time the test is run. Each Xpediter/TSO user can create unlimited separate
profiles.
The following command is covered:
PROFILE
20-2
DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT
----------------------
Specify defaults
Prepare programs for debugging
Debug programs interactively under TSO
Debug programs interactively under batch
Debug DB2 Stored Procedures interactively
Perform utility functions
Invoke File-AID for DB2
Invoke File-AID for MVS
Invoke File-AID for IMS
Code Coverage Reports and Utilities
Connect to a CICS region
Display information about XPEDITER/TSO
Exit primary menu
- ** NO DESCRIPTION **
-----------------------OPTION ===>
1
2
3
4
TEST PF KEYS
COLORS
OTHERS
PROFILE
or
Specify
Specify
Specify
Specify
-----------------------
or
Profiles
20-3
2. Access the Profile screen. The user's profiles retain information about specific Xpediter test
environments. The profile includes but is not limited to, load libraries and DDIO libraries.
Each profile has a name and a description. The name can be a maximum of eight positions
and can consist of alphabetic, numeric, and special characters. The description is used to
explain the purpose of the profile and can be a maximum of 50 characters.
-----------------------OPTION ===> 4
1
2
3
4
TEST PF KEYS
COLORS
OTHERS
PROFILE
Specify
Specify
Specify
Specify
-----------------------COMMAND ===>
-----------------------
or
20-4
3. Use the default profile to create a new profile with a name of VENDOR and a description of
TEST VENDOR PACKAGE X.
-----------------------COMMAND ===> [ENTER]
-----------------------COMMAND ===>
Profiles
-----------------------OPTION ===>
1
2
3
4
TEST PF KEYS
COLORS
OTHERS
PROFILE
Specify
Specify
Specify
Specify
-----------------------
or
20-5
20-6
TEST PF KEYS
COLORS
OTHERS
PROFILE
Specify
Specify
Specify
Specify
---------------------OPTION ===>
0
1
2
3
4
5
F
FA
FI
C
CS
T
X
or
DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT
-----------------------
----------------------
Specify defaults
Prepare programs for debugging
Debug programs interactively under TSO
Debug programs interactively under batch
Debug DB2 Stored Procedures interactively
Perform utility functions
Invoke File-AID for DB2
Invoke File-AID for MVS
Invoke File-AID for IMS
Code Coverage Reports and Utilities
Connect to a CICS region
Display information about XPEDITER/TSO
Exit primary menu
or
Profiles
20-7
6. Overtype the profile name to begin an interactive test using the new profile.
---------------------OPTION ===> 2
0
1
2
3
4
5
F
FA
FI
C
CS
T
X
DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT
----------------------
Specify defaults
Prepare programs for debugging
Debug programs interactively under TSO
Debug programs interactively under batch
Debug DB2 Stored Procedures interactively
Perform utility functions
Invoke File-AID for DB2
Invoke File-AID for MVS
Invoke File-AID for IMS
Code Coverage Reports and Utilities
Connect to a CICS region
Display information about XPEDITER/TSO
Exit primary menu
or
7. Enter the information required by Xpediter/TSO to test the program Vendorx and display the
setup menu to make additional changes to the profile.
Profile: VENDOR
COMMAND ===> se
------
-----------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(VENDORX)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
20-8
8. Select the option to view the load libraries currently declared to this test session.
Profile: VENDOR -------OPTION ===> 1
0
1
2
3
4
5
6
7
ENVIRONMENT
LOADLIBS
DDIO
INCLUDES
LOG
SCRIPT
DSNLOAD
PANEXEC
C
D
E
A
CODE COVERAGEDOCUMENT
EXTENDED
ALL
-
--------------------------
or
9. Enter the name of the load libraries to be used during this test session.
Profile: VENDOR ----- XPEDITER/TSO - LOAD MODULE LIBRARIES -----------------COMMAND ===> [ENTER]
COMMANDS: DOWN (for additional User Libraries)
User Libraries:
--->>> Include ALL libraries your program requires <<<--(Even if the library is in LINKLST, ie. COBOL or LE runtime libraries)
(1) ===> 'userid.loadlib2
(2) ===>
(3) ===>
(4) ===>
(5) ===>
(6) ===>
(7) ===>
(8) ===>
Installation Libraries: (Changes made to this list override installed default
(9) ===>
(10) ===>
(11) ===>
(12) ===>
(13) ===>
(14) ===>
(15) ===>
(16) ===>
Press ENTER to Process or Enter END Command to Terminate
Profiles
0
1
2
3
4
5
6
7
ENVIRONMENT
LOADLIBS
DDIO
INCLUDES
LOG
SCRIPT
DSNLOAD
PANEXEC
C
D
E
A
CODE COVERAGEDOCUMENT
EXTENDED
ALL
-
NOTE:
--------------------------
or
You may continue to make changes to your setup by selecting the other options
available. All the changes you make will be saved to the current profile.
Profile: VENDOR
COMMAND ===>
------
-----------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(VENDORX)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
20-9
20-10
-----------------------
COMMANDS:
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(VENDORX)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
-----------------------
===>
===>
===>
===>
'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>
or
Index
i-1
Index
A
Abend-AID for Batch Integration ..........................................................................................................................16-1
AA SNAP Command ..........................................................................................................................................16-3
Abend-AID for Batch Snapshot Report ..............................................................................................................16-3
AT Command .........................................................................................................................................................17-5
B
Basic Features...........................................................................................................................................................1-2
Batch Connect Facility ...........................................................................................................................................19-1
Breakpoints...............................................................................................................................................................5-2
AFTER Command................................................................................................................................................5-7
BEFORE Command ................................................................................................................................. 5-4, 17-15
C
Compile Process ......................................................................................................................................................2-1
Pre-Compile Process.............................................................................................................................................2-2
Post-Compile Process ...........................................................................................................................................2-2
Compile Listing Output ........................................................................................................................................2-3
Convert Compile JCL ............................................................................................................................................2-10
Compile Facility .....................................................................................................................................................2-14
COUNT Command.................................................................................................................................................12-3
COUNT MAX Command ........................................................................................................................................8-7
Resetting the MAX parameter ............................................................................................................................8-10
D
DDIO File Utility .....................................................................................................................................................2-4
Source Listing Create/Format Facility Menu .......................................................................................................2-7
Source Listing File Facility menu.........................................................................................................................2-6
DELETE Command .................................................................................................................................................5-9
DELETE AT primary command ......................................................................................................................17-10
DELETE BEFORE.............................................................................................................................................5-10
DELETE Hex ............................................................................................................................................... 1-7, 7-8
DELETE KEEP ..................................................................................................................................................7-17
DELETE MONITOR ......................................................................................................................................11-18
Demo Program Description ......................................................................................................................................1-3
DLEFT Command ....................................................................................................................................................7-4
DRIGHT Command .................................................................................................................................................7-3
E
EXIT Command .......................................................................................................................................................9-2
i-2
F
File Allocation Utility.............................................................................................................................................18-1
FIND Command .................................................................................................................................................... 14-3
ALIAS Keyword ................................................................................................................................................14-7
EXCLUDE Keyword..........................................................................................................................................14-5
COBOL Structures
Call Statements .............................................................................................................................................14-16
Paragraphs ....................................................................................................................................................14-14
INDIRECT Keyword..........................................................................................................................................14-9
MODIFY Keyword ..........................................................................................................................................14-13
G
GO Command............................................................................................................................................... 6-2, 17-17
GO HALF Command ................................................................................................................................. 6-11, 17-19
GO 1 Command........................................................................................................................................................6-4
GO n Command............................................................................................................................................ 6-7, 17-25
GO n TRACE Command.............................................................................................................................. 6-8, 17-26
SET DELAY n.n Command.................................................................................................................................6-9
GOTO Command ...................................................................................................................................................15-5
GPREGS Command ...............................................................................................................................................17-7
H
HELP BEFORE Command ......................................................................................................................................5-5
I
INCLUDE Command .............................................................................................................................................10-9
INSERT Command.................................................................................................................................................8-11
INTERCEPT Command .........................................................................................................................................13-4
K
KEEP Command ......................................................................................................................................... 7-13 17-18
KEEP LINKAGE .............................................................................................................................................13-17
L
LOCATE Command...............................................................................................................................................7-10
LOG Command ........................................................................................................................................................9-3
M
MEMORY Command.............................................................................................................................................17-3
MONITOR Command............................................................................................................................................11-3
MOVE Command.....................................................................................................................................................7-9
P
PAUSE Command..................................................................................................................................................8-11
PEEK Command ......................................................................................................................................................7-2
E(lementary) Line Command .................................................................................................................... 7-5 11-15
H(ex) Line Command.......................................................................................................................................... 7-7
Profile
Change the Profile You are Using......................................................................................................................20-7
Create a New Profile ..........................................................................................................................................20-4
PROFILE Command ............................................................................................................................................20-10
PSEUDOSOURCE Command .............................................................................................................................17-12
R
Reference Card .........................................................................................................................................................4-3
RESUME Command ............................................................................................................................................11-16
RETEST Command................................................................................................................................................7-19
REVERSE Command.............................................................................................................................................11-6
Index
i-3
RUNTO Command...................................................................................................................................................6-3
S
Scripting Facility ....................................................................................................................................................10-1
SCRIPT Command .................................................................................................................................................10-2
SET LOG FIND ON Command .............................................................................................................................14-4
SHOW Command
SHOW AT..........................................................................................................................................................17-8
SHOW BREAKS..................................................................................................................................................5-8
SHOW COUNTS ...............................................................................................................................................12-7
SHOW MODULES ............................................................................................................................................12-9
SHOW WHEN .....................................................................................................................................................8-5
SKIP Command......................................................................................................................................................15-2
Source Listing Screen...............................................................................................................................................4-1
Subroutine Testing.................................................................................................................................................. 13.1
Both the Calling and Called Program Compiled for Xpediter............................................................................13-3
No Calling Program Available (Stand-Alone Program)...................................................................................13-14
Only the Called Program Compiled for Xpediter...............................................................................................13-8
T
Test Setup .................................................................................................................................................................3-1
Xpediter/TSO Primary Menu ...............................................................................................................................3-2
Environments Menu .............................................................................................................................................3-3
Test Standard Screen ............................................................................................................................................3-4
Test Setup Menu...................................................................................................................................................3-7
Load Libraries ................................................................................................................................................3-8
DDIO Files ......................................................................................................................................................3-9
Test Script Libraries ......................................................................................................................................3-10
Log Dataset ....................................................................................................................................................3-10
Script Dataset .................................................................................................................................................3-11
DSNLOAD Libraries .....................................................................................................................................3-11
PANEXEC Libraries .....................................................................................................................................3-12
Code Coverage ..............................................................................................................................................3-12
Document Dataset ..........................................................................................................................................3-13
Extended Setup Menu ....................................................................................................................................3-13
W
WHEN Command ....................................................................................................................................... 8-2, 17-21
i-4