You are on page 1of 280

Xpediter/TSO

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.

Please direct questions about XPEDITER/TSO


or comments on this document to:
XPEDITER/TSO Technical Support
Compuware Corporation
One Campus Martius
Detroit, MI 48226-5099
1-800-538-7822
Outside the USA and Canada, please contact
your local Compuware office or agent.
2007 Compuware Corporation

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

Xpediter/TSO COBOL Training Guide

Chapter 8 Gaining Control - Conditional ........................................................................ 8-1


When Command ............................................................................................................................8-2
Show When Command ..................................................................................................................8-5
Count Max Command....................................................................................................................8-7
Pause Command ..........................................................................................................................8-11
Chapter 9 Exiting a Session............................................................................................. 9-1
Exit Command ...............................................................................................................................9-2
Log Command ...............................................................................................................................9-3
Chapter 10 Scripts .......................................................................................................... 10-1
Script Command ..........................................................................................................................10-2
Chapter 11 - Review Program Execution ......................................................................... 11-1
Monitor Command.......................................................................................................................11-3
Reverse Command .......................................................................................................................11-6
Resume Command .....................................................................................................................11-16
Chapter 12 Counting Execution .................................................................................... 12-1
Count Command ..........................................................................................................................12-3
Show Count Command................................................................................................................12-7
Show Modules Command............................................................................................................12-9
Chapter 13 Subroutine Testing...................................................................................... 13-1
I. Both the Calling and Called Program Compiled with Xpediter ..............................................13-3
Intercept Command.................................................................................................................13-4
II. Only the Called Program Compiled with Xpediter ................................................................13-8
III. No Calling Program Available ............................................................................................13-14
Keep Linkage Command .....................................................................................................13-17
Chapter 14 Enhanced Find ............................................................................................ 14-1
Find Command ............................................................................................................................14-3
Exclude Command.......................................................................................................................14-6
Alias Keyword .............................................................................................................................14-8
Indirect Keyword .......................................................................................................................14-10
Modify Keyword .......................................................................................................................14-14
Chapter 15 Altering Program Flow................................................................................ 15-1
Skip Command ............................................................................................................................15-2
Chapter 16 Abend-AID Link ........................................................................................... 16-1
Chapter 17 Sourceless Debugging ............................................................................... 17-1
Memory Command ......................................................................................................................17-3
At Command................................................................................................................................17-5
GPREGS Command ....................................................................................................................17-7
Show At Command......................................................................................................................17-8
Pseudosource Command ...........................................................................................................17-12
Before Command ......................................................................................................................17-15
Go Command ............................................................................................................................17-17
Keep Command ........................................................................................................................17-18
Go Half Command ....................................................................................................................17-19
When Command .......................................................................................................................17-21
Go 'n' Command .......................................................................................................................17-25
Go 'n' Trace Command .............................................................................................................17-26
Chapter 18 File Allocation Utility................................................................................... 18-1

Table of Contents

Chapter 19 Batch Connect ............................................................................................. 19-1


Chapter 20 Profiles ......................................................................................................... 20-1

i-3

i-4

Xpediter/TSO COBOL Training Guide

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:

Xpediter/TSO Helpful Hints for COBOL

Xpediter/TSO Helpful Hints for Assembler

Xpediter/TSO Helpful Hints for PL/1

Xpediter/TSO Helpful Hints for C

H-1

H-2

Xpediter/TSO Cobol Training Guide

Xpediter/TSO Helpful Hints for COBOL


ABEND DEBUGGING

Trap program abends:


GO (to start test)

When abend occurs:


LOG -orAA SNAP (if Abend-AID installed) -orHELP abend-code

LOGIC DEBUGGING
Keep Data Names

Watch data values as program executes:


KEEP data-name -orK, Kn (line command, n =position of variable in statement) -orK* (all variables for statement)
Try GO HALF to see data after statement execution

Stop on Data Change

Execute program until data changes:


WHEN data-name CHANGES -or- WHEN data-name = value

Working Storage

Change/view contents of working-storage:


PEEK data-name -orP, Pn (line command, n =position of variable in statement) -orWS (to see the entire Working-Storage)
Try E, En (to display elementary items)
Try H, Hn (to display in hex)

Current Statement

Position source at the execution pointer:

Change Logic Flow

Change the statements to be executed:

LOCATE * or PF6
GOTO statement-number -or- GT (line command)
SKIP statement-number -or- S (line command)

View Execution

View program execution:


GO TR
PA1 (to stop)
-orTRACE STATE or TRACE PARA
SET DELAY 1 (for a 1 second delay)
GO or PF12 -orGO 1 or PF9 (to execute 1 statement)

Trace Logic Flow

Show every statement on which execution was paused:

Detect Loop

Find a loop in the program:

SHOW PREV
COUNT PARA; GO n (n = number of statements)
SHOW COUNTS

Path Coverage

Gather statement execution statistics:


COUNT ALL PARA
GO
SHOW COUNTS
Try LOG to see record of counts

Restart Test

Start the test over from the beginning:


RETEST
EXIT or PF4

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

Xpediter/TSO Helpful Hints for COBOL

Reverse Execution

H-3

Review program logic and data values:


MONITOR;GO
REVERSE (to reverse execution)
Try WHEN data-name to identify the statement where a data
Value changed
GO or GO 1
RESUME (to resume execution from reversal point)
DELETE MONITOR (to stop monitoring)

Browse a File

Look at the records in a sequential file:

Get to a Record

Execute until a certain record is read:

BROWSE DDNAME -or- DATASET.NAME


COUNT read-statement-number MAX n (n = record number to stop on -1)
Example: To gain control of the 10th record, set the MAX to 9. You will
stop after the 9th record is processed and before the 10th
record is processed.
WHEN data-name = value (execution pauses when condition true)

Display Subprogram

View the source code of a called program:


SOURCE subprogram-name -orOvertype program-name with subprogram-name in message-area -orINTERCEPT subprogram-name (to set Before and After breakpoints)

Insert Logic

Add temporary debugging code during test:


In (INSERT line command, n is number of lines to insert)
Try HELP INSERT to see list of valid commands

Bring in a Script

Automatically execute a list of commands:


INCLUDE member-name
(The script must be a member of a PDS identified in the setup)

Enhanced Find

Find data names or COBOL structures:


Try SET LOG FIND ON to add Find results to the Log for printing
FIND IO X (to find input and output statements)
FIND string IN PARA (to find string in paragraph heading only)
FIND data-name ALIAS X
(to find any other name for that memory location)
FIND data-name ALIAS IND
(to find all statements that indirectly or directly affect the data-name)
(FIND IND or PF17 will follow indirect chain)
Try adding X after the statement to show only lines found -orX NOL to remove # of lines message line

ISPF Session

Get to an ISPF session:


ISPF
=X (to return to Xpediter)

Table Displays

View the data values within a table:


KEEP table-name
Overtype occurrence field with number -orType +1 next to occurrence value and press ENTER repeatedly

View subscripted entry in table:


KEEP table-name (subscript/index-name)

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

Xpediter/TSO COBOL Training Guide

Xpediter/TSO Helpful Hints for Assembler


ABEND DEBUGGING

Trap program abends:


GO (to start test)

When abend occurs:


LOG -orAA SNAP (if Abend-AID installed) -orHELP abend-code

LOGIC DEBUGGING
Data Labels

Change/view contents of Data Labels:


KEEP data-label -orK, Kn (line command, n =position of variable in statement) -orK* (all variables for statement)
-or for a temporary view of a label PEEK data-label -orP, Pn (line command, n =position of variable in statement)
Try H, Hn (to display in hex) and
GO HALF to see data after statement execution

Display Registers

Display Register contents:

Stop on Data Change

Execute program until data changes:

GPREGS
WHEN data-label CHANGES
-orWHEN data-label = value

Current Statement

Position source at the execution pointer:


LOCATE * or PF6

Change Logic Flow

Change the flow of execution:


GOTO statement-number/offset -or- GT (line command)
SKIP statement-number/offset -or- S (line command)

View Execution

View program execution:


GO TR
PA1 (to stop)
-orTRACE STATE or TRACE LABELS
SET DELAY n (n - delay in seconds)
GO or PF12 -orGO 1 or PF9 (to execute 1 statement)

Path Coverage

Gather statement execution statistics:


COUNT ALL LABELS
GO
SHOW COUNTS
Try LOG to see record of counts

Restart Test

Start the test over from the beginning:


RETEST
EXIT or PF4

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

Xpediter/TSO Helpful Hints for Assembler

View Macro Code

H-5

To view the macro code:


GEN statement-number/offset
-orG (line command)

Alter an Instruction

Display and change object code:


VERIFY statement-number/offset
-orV (line command)
Overtype the instruction to change object code

Browse a File

Look at the records in a sequential file:

Get to a Record

Execute until a certain record is read:

BROWSE DDNAME -or- DATASET.NAME


COUNT x MAX n (x = GET instruction statement number)
(n = record number to stop on -1)
Example: To gain control of the 10th record, set the MAX to 9.
You will stop after the 9th record is processed
and before the 10th record is processed.

Display Subprogram

View the source code of a called program:


SOURCE subprogram-name
-orOvertype program-name with subprogram-name
in message-area
-orINTERCEPT subprogram-name
(to set Before and After breakpoints)

Detect Loop

Find a loop in the program:


COUNT ALL LABELS; GO n (n = number of statements)
SHOW COUNTS

Insert Logic

Add temporary debugging code during test:


In (INSERT line command, n is number of lines to insert)
Try HELP INSERT to see list of valid commands

Bring in a Script

Automatically execute a list of commands:


INCLUDE member-name
(The script must be a member of a PDS identified in the setup)

Line numbers

Change the way the line numbers are displayed:


LINE STATE
- to see the programs statement numbers
LINE OFFSET - to see the programs offsets
LINE 24
- to see the address in 24 bit mode
LINE 31
- to see the address in 31 bit mode

ISPF Session

Get to an ISPF session:


ISPF
=X (to return to Xpediter)

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

Xpediter/TSO COBOL Training Guide

Xpediter/TSO Helpful Hints for PL/I


ABEND DEBUGGING

Trap program abends:


GO (to start test)

When abend occurs:


LOG -orAA SNAP (if Abend-AID installed) -orHELP abend-code

LOGIC DEBUGGING
Keep Data Names

Watch data values as program executes:


KEEP data-name -orK, Kn (line command, n =position of variable in statement) -orK* (all variables for statement)
Try GO HALF to see data after statement execution

Stop on Data Change

Execute program until data changes:

Working Storage

Change/view contents of working-storage:

WHEN data-name CHANGES -or- WHEN data-name = value


PEEK data-name -orP, Pn (line command, n =position of variable in statement) -orWS (to see the entire Working-Storage)
Try E, En (to display elementary items)
Try H, Hn (to display in hex)

Current Statement

Position source at the execution pointer:


LOCATE * or PF6

Change Logic Flow

Change the statements to be executed:


GOTO statement-number -or- GT (line command)
SKIP statement-number -or- S (line command)

View Execution

View program execution:


GO TR
PA1 (to stop)
-orTRACE STATE or TRACE PARA
SET DELAY 1 (for a 1 second delay)
GO or PF12 -orGO 1 or PF9 (to execute 1 statement)

Trace Logic Flow

Show every statement on which execution was paused:

Detect Loop

Find a loop in the program:

SHOW PREV
COUNT PARA; GO n (n = number of statements)
SHOW COUNTS

Path Coverage

Gather statement execution statistics:


COUNT ALL PARA
GO
SHOW COUNTS
Try LOG to see record of counts

Restart Test

Start the test over from the beginning:


RETEST
EXIT or PF4

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

Xpediter/TSO Helpful Hints for PL/I

Browse a File

H-7

Look at the records in a sequential file:


BROWSE DDNAME
-orBROWSE DATASET.NAME

Get to a Record

Execute until a certain record is read:


COUNT read-statement-number MAX n
(n = record number to stop on -1)
Example: To gain control of the 10th record, set the MAX to 9.
You will stop after the 9th record is processed and
before the 10th record is processed.
WHEN data_name = value (execution pauses when condition true)

Display Subprogram

View the source code of a called program:


SOURCE subprogram-name
-orOvertype program-name with subprogram-name in message-area
-orINTERCEPT subprogram-name (to set Before and After breakpoints)

Insert Logic

Add temporary debugging code during test:


In (INSERT line command, n is number of lines to insert)
Try HELP INSERT to see list of valid commands

Bring in a Script

Automatically execute a list of commands:


INCLUDE member-name
(The script must be a member of a PDS identified in the Setup)

ISPF Session

Get to an ISPF session:


ISPF
=X (to return to Xpediter)

View Data in an Array

View the data within an array:


KEEP array_name
KEEP subscript_name to change the occurrence shown

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-8 Xpediter/TSO COBOL Training Guide

Xpediter/TSO Helpful Hints for C


ABEND DEBUGGING

Trap program abends:


GO (to start test)

When abend occurs:


LOG -orAA SNAP (if Abend-AID installed) -orHELP abend-code

LOGIC DEBUGGING
Keep Data Names

Watch data values as program executes:


KEEP data-name -orK, Kn (line command, n =position of variable in statement) -orK* (all variables for statement)
Try GO HALF to see data after statement execution
Note: Case sensitive, must SET CAPS OFF.

Stop on Data Change

Execute program until data changes:

Working Storage

Change/view contents of working-storage:

WHEN data-name CHANGES -or- WHEN data-name = value


PEEK data-name -orP, Pn (line command, n =position of variable in statement)
Try E, En (to display elementary items)
Try H, Hn (to display in hex)

Current Statement

Position source at the execution pointer:


LOCATE * or PF6

Change Logic Flow

Change the statements to be executed:


GOTO statement-number -or- GT (line command)
SKIP statement-number -or- S (line command)

View Execution

View program execution:


GO TR
PA1 (to stop)
-orTRACE STATE or TRACE PARA
SET DELAY 1 (for a 1 second delay)
GO or PF12 -orGO 1 or PF9 (to execute 1 statement)

Trace Logic Flow

Show every statement on which execution was paused:

Detect Loop

Find a loop in the program:

SHOW PREV
COUNT PARA; GO n (n = number of statements)
SHOW COUNTS

Path Coverage

Gather statement execution statistics:


COUNT ALL PARA
GO
SHOW COUNTS
Try LOG to see record of counts

Restart Test

Start the test over from the beginning:


RETEST
EXIT or PF4

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

Xpediter/TSO Helpful Hints for C

Browse a File

H-9

Look at the records in a sequential file:


BROWSE DDNAME
-orBROWSE DATASET.NAME

Get to a Record

Execute until a certain record is read:


COUNT read-statement-number MAX n
(n = record number to stop on -1)
Example: To gain control of the 10th record, set the MAX to 9.
You will stop after the 9th record is processed and
before the 10th record is processed.
WHEN data_name = value (execution pauses when condition true)

Display Subprogram

View the source code of a called program:


SOURCE subprogram-name
-orOvertype program-name with subprogram-name in message-area
-orINTERCEPT subprogram-name (to set Before and After breakpoints)

Insert Logic

Add temporary debugging code during test:


In (INSERT line command, n is number of lines to insert)
Try HELP INSERT to see list of valid commands

Bring in a Script

Automatically execute a list of commands:


INCLUDE member-name
(The script must be a member of a PDS identified in the Setup)

ISPF Session

Get to an ISPF session:


ISPF
=X (to return to Xpediter)

View Data in an Array

View the data within an array:


KEEP array_name
KEEP subscript_name to change the occurrence shown

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-10 Xpediter/TSO COBOL Training Guide

Introduction to Xpediter/TSO

1-1

Chapter 1 Introduction to Xpediter/TSO


Xpediter/TSO is a testing, debugging, and analysis tool that allows the programmer to view source code as it
executes in order to identify incorrect logic, test hard-to-validate routines, and analyze both program structure and
data flow. This chapter discusses the basic features of Xpediter/TSO and introduces a sample program to illustrate
these features.
Xpediter/TSO allows you to do the following:

Control program execution.

Display/modify program variable values.

Intercept abends.

Analyze program logic and data relationships.

Review program execution.

Monitor program execution coverage.

Alter program execution.

Link to Abend-AID for Batch.

Link to File-AID for DB2

Test your program in a TSO or batch region.

In this chapter you will do the following:

Discuss the basic features of Xpediter/TSO.

Introduce the Xpediter/TSO demo program.

Intercept a S0C7 abend.

1-2

Xpediter/TSO COBOL Training Guide

Basic Features
Xpediter/TSO is a testing, debugging, and analysis tool that enables you to do the following:
1. Control program execution

Start and stop execution at any point in the program.


Stop conditionally or unconditionally.

2. Display/modify program variable values

Display or modify values at any point.

3. Intercept abends

Intercept program abends.


Display pertinent abend information.

4. Analyze program logic and data relationships

Trace logic path.


Follow data flow.

5. Review program execution

Record and review program execution and corresponding data values.

6. Monitor program execution coverage

Count the number of executions for a statement or paragraph.


Record execution counts.

7. Alter program execution

Bypass statement execution.


Branch to another location in the program.

8. Link to Abend-AID for Batch

Display the Abend-AID snapshot report at any point in an Xpediter/TSO test session.

9. Link to File-AID for DB2

Access File-AID for DB2 at any point in an Xpediter/TSO test session.

10. Test your program in a TSO or batch address space

Interactive under TSO/ISPF.


Interactive in a batch address space.
Unattended in a batch address space.

Introduction to Xpediter/TSO

Demo Program Description


The demo program calculates employee compensation based on employee type. The input file contains hourly,
sales, and management records. The output consists of an employee compensation and regional sales report.

DEMO PROGRAM

Employee
File

Employee
Compensation
Report

CWXTCOB

at
month
end

Monthly Regional
Sales Report

CWXTSUBC

CWXTDATE

1-3

1-4

Xpediter/TSO COBOL Training Guide

Sample Scenario: Intercept a S0C7 Abend


In this scenario, the demo program CWXTCOB will be tested interactively under TSO. Xpediter/TSO will extract
the file information it needs from the JCL member named in the File List/JCL Member field. More detail on this
process and the commands covered in this chapter will be discussed in subsequent chapters.

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]

XPEDITER/TSO - STANDARD (2.1)

----------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFile (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

To override the parameter string in


the execution JCL, enter a beginning
and ending quote in the PARM field.

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

EDIT ---- USERID.XPEDITER.SAMPLIB(CWXTJCLC) - 01.08 -- COLUMNS 001 072


COMMAND ===>
SCROLL ===> CSR
****** ***************************** TOP OF DATA ****************************
000001 //USERIDX JOB (ACCT#),'NAME',CLASS=A,
000002 // MSGCLASS=X,NOTIFY=USERID
000003 //*
000004 //*
EXECUTE CWXTCOB IN BATCH
000005 //*
000006 //CWXTCOB EXEC PGM=CWXTCOB,PARM=00003
000007 //STEPLIB DD
DSN=USERID.LOAD,DISP=SHR
000008 //
DD
DSN=SYS1.COB2LIB,DISP=SHR
000009 //EMPFILE DD
DSN=USERID.XPEDITER.SAMPLIB(CWXTDATA),DISP=SHR
000010 //RPTFILE DD
SYSOUT=X
000011 //SYSOUT
DD
SYSOUT=X
000012 //
****** **************************** BOTTOM OF DATA **************************

Introduction to Xpediter/TSO

2. Begin program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
----+-000347
01 PARMINFO
> ..
** 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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
S0C7 ABEND ENCOUNTERED, USE "AA SNAP" COMMAND FOR ADDITIONAL INFORMATION
000128
05 EMP-WAGES
> ?????????
INVALID PACKED
000169
10 WA-EMP-HOURS
> 40
DECIMAL
000170
10 WA-EMP-RATE
> ???????
INVALID PACKED
** END **
-----000401
=====>
000403
000404
000405
000406
000407
000408
000409
000410
000411
000412
000413
000414
000415

------------------------------ S0C7 Abend at CWXTCOB:402/AMODE 31 <>


ELSE
COMPUTE EMP-WAGES = WA-EMP-HOURS * WA-EMP-RATE.
COMPUTE EMP-COMPENSATION = EMP-WAGES + OT-AMOUNT.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE
TODAYS-DATE
WA-EMP-HIRE-DATE.
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
SET HOLD-IX UP BY 1.
***
*** CALCULATE TYPE S (SALES) EMPLOYEE COMPENSATION. THE TOTAL
*** SALES FOR THE EMPLOYEE IS PASSED TO THE CALLED PROGRAM WHICH
*** CALCULATES COMMISSION. ONCE EMPLOYEE COMPENSATION IS
*** RETURNED FROM CWXTSUBC, IT IS STORED IN A HOLD-TABLE. THE

1-5

1-6

Xpediter/TSO COBOL Training Guide

3. Display the contents of WA-EMP-RATE in hex.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
S0C7 ABEND ENCOUNTERED, USE "AA SNAP" COMMAND FOR ADDITIONAL INFORMATION
000128
05 EMP-WAGES
> ?????????
INVALID PACKED
000169
10 WA-EMP-HOURS
> 40
DECIMAL
h 0170
10 WA-EMP-RATE
> ???????
INVALID PACKED
** END **
-----000401
=====>
000403
000404
000405
000406
000407
000408
000409
000410
000411
000412
000413
000414
000415

------------------------------ S0C7 Abend at CWXTCOB:402/AMODE 31 <>


ELSE
COMPUTE EMP-WAGES = WA-EMP-HOURS * WA-EMP-RATE.
COMPUTE EMP-COMPENSATION = EMP-WAGES + OT-AMOUNT.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE
TODAYS-DATE
WA-EMP-HIRE-DATE.
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
SET HOLD-IX UP BY 1.
***
*** CALCULATE TYPE S (SALES) EMPLOYEE COMPENSATION. THE TOTAL
*** SALES FOR THE EMPLOYEE IS PASSED TO THE CALLED PROGRAM WHICH
*** CALCULATES COMMISSION. ONCE EMPLOYEE COMPENSATION IS
*** RETURNED FROM CWXTSUBC, IT IS STORED IN A HOLD-TABLE. THE

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
000128
05 EMP-WAGES
> ?????????
INVALID PACKED
000169
10 WA-EMP-HOURS
> 40
DECIMAL
000170
10 WA-EMP-RATE
> ???????
INVALID PACKED
055
2CB
----------------------------------- S0C7 Abend at CWXTCOB:402/AMODE 31 <>
000401
ELSE
=====>
COMPUTE EMP-WAGES = WA-EMP-HOURS * WA-EMP-RATE.
000403
COMPUTE EMP-COMPENSATION = EMP-WAGES + OT-AMOUNT.
000404
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
000405
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000406
YRS-OF-SERVICE
000407
TODAYS-DATE
000408
WA-EMP-HIRE-DATE.
000409
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
000410
SET HOLD-IX UP BY 1.
000411
***
000412
*** CALCULATE TYPE S (SALES) EMPLOYEE COMPENSATION. THE TOTAL
000413
*** SALES FOR THE EMPLOYEE IS PASSED TO THE CALLED PROGRAM WHICH
000414
*** CALCULATES COMMISSION. ONCE EMPLOYEE COMPENSATION IS
000415
*** RETURNED FROM CWXTSUBC, IT IS STORED IN A HOLD-TABLE. THE

Introduction to Xpediter/TSO

4. Delete the hex display of WA-EMP-RATE.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
000128
05 EMP-WAGES
> ?????????
INVALID PACKED
000169
10 WA-EMP-HOURS
> 40
DECIMAL
dh 170
10 WA-EMP-RATE
> ???????
INVALID PACKED
055
2CB
----------------------------------- S0C7 Abend at CWXTCOB:402/AMODE 31 <>
000401
ELSE
=====>
COMPUTE EMP-WAGES = WA-EMP-HOURS * WA-EMP-RATE.
000403
COMPUTE EMP-COMPENSATION = EMP-WAGES + OT-AMOUNT.
000404
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
000405
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000406
YRS-OF-SERVICE
000407
TODAYS-DATE
000408
WA-EMP-HIRE-DATE.
000409
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
000410
SET HOLD-IX UP BY 1.
000411
***
000412
*** CALCULATE TYPE S (SALES) EMPLOYEE COMPENSATION. THE TOTAL
000413
*** SALES FOR THE EMPLOYEE IS PASSED TO THE CALLED PROGRAM WHICH
000414
*** CALCULATES COMMISSION. ONCE EMPLOYEE COMPENSATION IS
000415
*** RETURNED FROM CWXTSUBC, IT IS STORED IN A HOLD-TABLE. THE

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
DELETE COMMAND PROCESSED
000128
05 EMP-WAGES
> ?????????
INVALID PACKED
000169
10 WA-EMP-HOURS
> 40
DECIMAL
000170
10 WA-EMP-RATE
> ???????
INVALID PACKED
** END **
-----000401
=====>
000403
000404
000405
000406
000407
000408
000409
000410
000411
000412
000413
000414
000415

------------------------------ S0C7 Abend at CWXTCOB:402/AMODE 31 <>


ELSE
COMPUTE EMP-WAGES = WA-EMP-HOURS * WA-EMP-RATE.
COMPUTE EMP-COMPENSATION = EMP-WAGES + OT-AMOUNT.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE
TODAYS-DATE
WA-EMP-HIRE-DATE.
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
SET HOLD-IX UP BY 1.
***
*** CALCULATE TYPE S (SALES) EMPLOYEE COMPENSATION. THE TOTAL
*** SALES FOR THE EMPLOYEE IS PASSED TO THE CALLED PROGRAM WHICH
*** CALCULATES COMMISSION. ONCE EMPLOYEE COMPENSATION IS
*** RETURNED FROM CWXTSUBC, IT IS STORED IN A HOLD-TABLE. THE

1-7

1-8

Xpediter/TSO COBOL Training Guide

5. Overtype the value of WA-EMP-RATE with valid data.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
DELETE COMMAND PROCESSED
000128
05 EMP-WAGES
> ?????????
INVALID PACKED
000169
10 WA-EMP-HOURS
> 40
DECIMAL
000170
10 WA-EMP-RATE
> 10.5
INVALID PACKED
** END **
-----000401
=====>
000403
000404
000405
000406
000407
000408
000409
000410
000411
000412
000413
000414
000415

------------------------------ S0C7 Abend at CWXTCOB:402/AMODE 31 <>


ELSE
COMPUTE EMP-WAGES = WA-EMP-HOURS * WA-EMP-RATE.
COMPUTE EMP-COMPENSATION = EMP-WAGES + OT-AMOUNT.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE
TODAYS-DATE
WA-EMP-HIRE-DATE.
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
SET HOLD-IX UP BY 1.
***
*** CALCULATE TYPE S (SALES) EMPLOYEE COMPENSATION. THE TOTAL
*** SALES FOR THE EMPLOYEE IS PASSED TO THE CALLED PROGRAM WHICH
*** CALCULATES COMMISSION. ONCE EMPLOYEE COMPENSATION IS
*** RETURNED FROM CWXTSUBC, IT IS STORED IN A HOLD-TABLE. THE

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
000128
05 EMP-WAGES
> ?????????
INVALID PACKED
000169
10 WA-EMP-HOURS
> 40
DECIMAL
000170
10 WA-EMP-RATE
> 010.50
PACKED
** END **
-----<>000401
=====>
000403
000404
000405
000406
000407
000408
000409
000410
000411
000412
000413
000414
000415

------------------------------ S0C7 Abend at CWXTCOB:402/AMODE 31


ELSE
COMPUTE EMP-WAGES = WA-EMP-HOURS * WA-EMP-RATE.
COMPUTE EMP-COMPENSATION = EMP-WAGES + OT-AMOUNT.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE
TODAYS-DATE
WA-EMP-HIRE-DATE.
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
SET HOLD-IX UP BY 1.
***
*** CALCULATE TYPE S (SALES) EMPLOYEE COMPENSATION. THE TOTAL
*** SALES FOR THE EMPLOYEE IS PASSED TO THE CALLED PROGRAM WHICH
*** CALCULATES COMMISSION. ONCE EMPLOYEE COMPENSATION IS
*** RETURNED FROM CWXTSUBC, IT IS STORED IN A HOLD-TABLE. THE

Introduction to Xpediter/TSO

6. Re-execute the statement that abended.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go 1
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
000128
05 EMP-WAGES
> ?????????
INVALID PACKED
000169
10 WA-EMP-HOURS
> 40
DECIMAL
000170
10 WA-EMP-RATE
> 010.50
PACKED
** END **
-----000401
=====>
000403
000404
000405
000406
000407
000408
000409
000410
000411
000412
000413
000414
000415

------------------------------ S0C7 Abend at CWXTCOB:402/AMODE 31 <>


ELSE
COMPUTE EMP-WAGES = WA-EMP-HOURS * WA-EMP-RATE.
COMPUTE EMP-COMPENSATION = EMP-WAGES + OT-AMOUNT.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE
TODAYS-DATE
WA-EMP-HIRE-DATE.
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
SET HOLD-IX UP BY 1.
***
*** CALCULATE TYPE S (SALES) EMPLOYEE COMPENSATION. THE TOTAL
*** SALES FOR THE EMPLOYEE IS PASSED TO THE CALLED PROGRAM WHICH
*** CALCULATES COMMISSION. ONCE EMPLOYEE COMPENSATION IS
*** RETURNED FROM CWXTSUBC, IT IS STORED IN A HOLD-TABLE. THE

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
000129
05 EMP-COMPENSATION
> ?????????
INVALID PACKED
000128
05 EMP-WAGES
> 00420.00
PACKED
000144
05 OT-AMOUNT
> 00000.00
PACKED
** END **
-----000401
000402
=====>
000404
000405
000406
000407
000408
000409
000410
000411
000412
000413
000414
000415

-------------------------------------- Before CWXTCOB:403/AMODE 31 <>


ELSE
COMPUTE EMP-WAGES = WA-EMP-HOURS * WA-EMP-RATE.
COMPUTE EMP-COMPENSATION = EMP-WAGES + OT-AMOUNT.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE
TODAYS-DATE
WA-EMP-HIRE-DATE.
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
SET HOLD-IX UP BY 1.
***
*** CALCULATE TYPE S (SALES) EMPLOYEE COMPENSATION. THE TOTAL
*** SALES FOR THE EMPLOYEE IS PASSED TO THE CALLED PROGRAM WHICH
*** CALCULATES COMMISSION. ONCE EMPLOYEE COMPENSATION IS
*** RETURNED FROM CWXTSUBC, IT IS STORED IN A HOLD-TABLE. THE

1-9

1-10

Xpediter/TSO COBOL Training Guide

7. Exit the session.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> exit
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
000129
05 EMP-COMPENSATION
> ?????????
INVALID PACKED
000128
05 EMP-WAGES
> 00420.00
PACKED
000144
05 OT-AMOUNT
> 00000.00
PACKED
** END **
-----000401
000402
=====>
000404
000405
000406
000407
000408
000409
000410
000411
000412
000413
000414
000415

-------------------------------------- Before CWXTCOB:403/AMODE 31 <>


ELSE
COMPUTE EMP-WAGES = WA-EMP-HOURS * WA-EMP-RATE.
COMPUTE EMP-COMPENSATION = EMP-WAGES + OT-AMOUNT.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE
TODAYS-DATE
WA-EMP-HIRE-DATE.
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
SET HOLD-IX UP BY 1.
***
*** CALCULATE TYPE S (SALES) EMPLOYEE COMPENSATION. THE TOTAL
*** SALES FOR THE EMPLOYEE IS PASSED TO THE CALLED PROGRAM WHICH
*** CALCULATES COMMISSION. ONCE EMPLOYEE COMPENSATION IS
*** RETURNED FROM CWXTSUBC, IT IS STORED IN A HOLD-TABLE. THE

Compile Process

2-1

Chapter 2 Compile Process


In order to debug your program symbolically at the source level, you must compile your source programs using the
Compuware Language Processor.
To compile your programs using the Compuware Language Processor you can do the following:

Modify and use your site-specific proc or compile panel.

Convert your own compile JCL to compile for Xpediter.

Use the Xpediter/TSO Compile facility to compile for Xpediter.

In this chapter you will do the following:

Discuss the Compuware Language Processor and the Source Listing File.

Discuss how to create your DDIO file.

Discuss how to convert your compile JCL to compile for Xpediter.

Discuss how to use the Xpediter/TSO Compile facility.

2-2

Xpediter/TSO COBOL Training Guide

Xpediter/TSO Compile Processes


NOTE:

Your site will use either the Pre-Compile or the Post-Compile Process.

The Pre-Compile Process


Source

XREF
PMAP
DMAP

COMPILE

Language
Processor

Object

Sysprint

LINK
Source
Listing
File

Linked Module
(DD SYSLMOD )

(DD CWPDDIO)

The Post-Compile Process


Source

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

Your compile procedures are the following:

2-3

2-4

Xpediter/TSO COBOL Training Guide

DDIO File Utility


NOTE:

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.

1. Enter 5 to perform utility functions.


---------------------OPTION ===> 5
0
1
2
3
4
5
F
FA
FI
C
CS
T
X

XPEDITER/TSO 7.6 - PRIMARY MENU

DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT

Profile ===> CWXTCOB

----------------------

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 **

For Online Technical Support Reference: http://frontline.compuware.com


Copyright (c) 2007, Compuware Corporation. All rights reserved.
(800) 538-7822
Press ENTER to process

----------------------OPTION ===>
1
2
3
5
6
7

REGION SIZE
LIST ALLOCATES
DDIO FILE FACILITY
CONVERT PROFILE
CONVERT INCLUDE
MERGE

or

enter END command to terminate

XPEDITER/TSO - UTILITIES MENU


-

-----------------------

Display memory available for testing


Display files allocated to your test session
Create/Format/Copy/Export and list DDIO file(s)
Convert XPEDITER/TSO release 5.1 user profiles
Convert include scripts to new qualification rules
Merge profiles from alternate users

Press ENTER to process

or

enter END command to terminate

Compile Process

2. Enter 3 to create the DDIO file.


----------------------OPTION ===> 3
1
2
3
5
6
7

REGION SIZE
LIST ALLOCATES
DDIO FILE FACILITY
CONVERT PROFILE
CONVERT INCLUDE
MERGE

XPEDITER/TSO - UTILITIES MENU


-

-----------------------

Display memory available for testing


Display files allocated to your test session
Create/Format/Copy/Export and list DDIO file(s)
Convert XPEDITER/TSO release 5.1 user profiles
Convert include scripts to new qualification rules
Merge profiles from alternate users

Press ENTER to process

or

enter END command to terminate

---------- 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)

for S/Member List:


===> YES (Yes or No)
===> YES (Yes or No)
===> ENGLISH

Source Browsing Options:


Unit ===> VIO
Blocking ===> 10
(ENGLISH/JAPANESE/USAMIX/USAUC)

C (Create) I (Info) S (Member List)


M (Move/Copy/Export/Import)

A (Adv Function)

---- Source Listing Shared Directories/Databases/DDIO files ---_______________________________________________________________

2-5

2-6

Xpediter/TSO COBOL Training Guide

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)

for S/Member List:


===> YES (Yes or No)
===> YES (Yes or No)
===> ENGLISH

Source Browsing Options:


Unit ===> VIO
Blocking ===> 10
(ENGLISH/JAPANESE/USAMIX/USAUC)

C (Create) I (Info) S (Member List)


M (Move/Copy/Export/Import)

A (Adv Function)

---- Source Listing Shared Directories/Databases/DDIO files ---'USERID.DDIO'__________________________________________________

-------------CSS UTILITIES - Select Desired File Type -------------CSS V8.4.0


COMMAND ===>
Commands: SEtup DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
File Name entered: 'USERID.DDIO'
1

Shared Directory

- Create a shared directory


NOTE: At least one database file must be
attached to this shared directory for it
to be functional.

Database File

- Create a Database that will be attached


to an EXISTING shared directory.

DDIO File

- Create a non-database DDIO file.

Enter END command to terminate

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

- Create a shared directory


NOTE: At least one database file must be
attached to this shared directory for it
to be functional.

Database File

- Create a Database that will be attached


to an EXISTING shared directory.

DDIO File

- Create a non-database DDIO file.

Enter END command to terminate

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

===>
===>
===>
===>
===>
===>

Space Units ===> CYLINDERS


Primary Quantity ===> 200
Number of Members ===> 100
Press ENTER to process

(Batch/Editjcl/Foreground)
(Vsam/Sequential)
(Yes/No)
(optional)
(optional)
(optional)
(optional)
(optional)
(Blocks/Tracks/Cylinders)
(1 to 16000)
or

enter END command to terminate

2-7

2-8

Xpediter/TSO COBOL Training Guide

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

===>
===>
===>
===>
===>
===>

Space Units ===> CYLINDERS


Primary Quantity ===> 200
Number of Members ===> 100
Press ENTER to process

(Batch/Editjcl/Foreground)
(Vsam/Sequential)
(Yes/No)
(optional)
(optional)
(optional)
(optional)
(optional)
(Blocks/Tracks/Cylinders)
(1 to 16000)
or

enter END command to terminate

---------- 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)

for S/Member List:


===> YES (Yes or No)
===> YES (Yes or No)
===> ENGLISH

Source Browsing Options:


Unit ===> VIO
Blocking ===> 10
(ENGLISH/JAPANESE/USAMIX/USAUC)

C (Create) I (Info) S (Member List)


M (Move/Copy/Export/Import)

A (Adv Function)

---- Source Listing Shared Directories/Databases/DDIO files ---_______________________________________________________________

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.

MAXIMUM NUMBER OF ENTRIES


ALLOCATION GROUP SIZE
BLOCK SIZE

ENTER UTILITY COMMAND:


*** ALL FUNCTIONS SUCCESSFULLY COMPLETED
******************************** BOTTOM OF DATA ********************************

2-10

Xpediter/TSO COBOL Training Guide

Convert Compile JCL


7. Prepare programs for debugging.
---------------------OPTION ===> 1
0
1
2
3
4
5
F
FA
FI
C
CS
T
X

XPEDITER/TSO 7.6 - PRIMARY MENU

DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT

Profile ===> CWXTCOB

----------------------

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 **

For Online Technical Support Reference: http://frontline.compuware.com


Copyright (c) 2007, Compuware Corporation. All rights reserved.
(800) 538-7822
Press ENTER to process

or

enter END command to terminate

8. Convert your existing site-specific JCL to compile for Xpediter.


-----------------OPTION ===> 1
1
2
3
4

XPEDITER/TSO - PROGRAM PREPARATION MENU

CONVERT COMPILE JCL


COMPILE FACILITY
BIND FACILITY
EDIT ALLOCATION LIST

------------------

Convert compile JCL for XPEDITER


Compile programs for XPEDITER
Bind application plans or packages
Edit or Create file allocation lists

For the COMPILE FACILITY, you may enter a separate Profile ID


below. This will allow you to save the compile parameters
separatly for different compiles. A '?' in the profile field will
display a list of profiles to select from. From that list the
profiles can be maintained (ie, COPY, RENAME, DELETE, etc.).
Compile Profile => DEFAULT

>

Press ENTER to process

<
or

enter END command to terminate

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 ===>

blank (Process JCL)

===>

Browse

===>

Edit

SEtup

===>

(Blank for member selection list)

Other Partitioned or Sequential Dataset:


Dataset Name ===> 'USERID.JCL(COMPILE)'
Volume Serial ===>
(If not cataloged)
Language Processor Related Items:
DDIO File ===> 'USERID.DDIO'
Options Dataset ===>

Press ENTER to process

or

enter END command to terminate

EDIT ---- SYS99301.T135053.RA000.USERID.R0165779 ------------ COLUMNS 001 072


COMMAND ===>
SCROLL ===> CSR
JCL HAS BEEN MODIFIED TO COMPILE WITH XPEDITER.
==MSG> *======================================================================*
==MSG> * COMMANDS:
*
==MSG> *
SUB
- SUBMIT THIS JOB
*
==MSG> *
RUN
- SUBMIT THIS JOB AND CHECK STATUS
*
==MSG> *
END
- RETURN TO PREVIOUS PANEL
*
==MSG> *======================================================================*
000001 //USERIDB JOB (ACCT#,DEPT),'NAME',
000002 //
CLASS=A,MSGCLASS=R,NOTIFY=USERID
000003 //*
000004 //*
000005 //#
PROC CMP='SYS1.COB2COMP',
000006 //
LIB='SYS1.COB2LIB'
==MSG> *** THE FOLLOWING STEP IS MODIFIED TO COMPILE WITH XPEDITER ***
000007 //COB2
EXEC PGM=CWPCMAIN,
000008 //
PARM='APOST,RES,RENT,OFFSET,OPTIMIZE,XREF,MAP',
000009 //
REGION=1024K
000010 //STEPLIB DD DISP=SHR,DSN=CX.PROD.LOADLIB
000011 //
DD DSNAME=&CMP,DISP=SHR
000012 //SYSPRINT DD SYSOUT=*,COPIES=1
000013 //SYSLIN
DD DSNAME=&&LOADSET,UNIT=SYSDA,DISP=(MOD,PASS),
000014 //
SPACE=(TRK,(3,3))

2-12

Xpediter/TSO COBOL Training Guide

10. Scroll down.


EDIT ---- SYS99301.T135053.RA000.USERID.R0165779 ------------ COLUMNS 001 072
COMMAND ===> [PF8]
SCROLL ===> CSR
JCL HAS BEEN MODIFIED TO COMPILE WITH XPEDITER.
==MSG> *======================================================================*
==MSG> * COMMANDS:
*
==MSG> *
SUB
- SUBMIT THIS JOB
*
==MSG> *
RUN
- SUBMIT THIS JOB AND CHECK STATUS
*
==MSG> *
END
- RETURN TO PREVIOUS PANEL
*
==MSG> *======================================================================*
000001 //USERIDB JOB (ACCT#,DEPT),'NAME',
000002 //
CLASS=A,MSGCLASS=R,NOTIFY=USERID
000003 //*
000004 //*
000005 //#
PROC CMP='SYS1.COB2COMP',
000006 //
LIB='SYS1.COB2LIB'
==MSG> *** THE FOLLOWING STEP IS MODIFIED TO COMPILE WITH XPEDITER ***
000007 //COB2
EXEC PGM=CWPCMAIN,
000008 //
PARM='APOST,RES,RENT,OFFSET,OPTIMIZE,XREF,MAP',
000009 //
REGION=1024K
000010 //STEPLIB DD DISP=SHR,DSN=CX.PROD.LOADLIB
000011 //
DD DSNAME=&CMP,DISP=SHR
000012 //SYSPRINT DD SYSOUT=*,COPIES=1
000013 //SYSLIN
DD DSNAME=&&LOADSET,UNIT=SYSDA,DISP=(MOD,PASS),
000014 //
SPACE=(TRK,(3,3))

EDIT ---- SYS99301.T135053.RA000.USERID.R0165779 ------------ COLUMNS 001 072


COMMAND ===>
SCROLL ===> CSR
000015 //SYSUT1
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000016 //SYSUT2
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000017 //SYSUT3
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000018 //SYSUT4
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000019 //SYSUT5
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000020 //SYSUT6
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000021 //SYSUT7
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000022 //XOPTIONS DD DISP=SHR,DSN=USERID.XPEDITER.XOPTIONS
000023 //CWPDDIO DD DISP=SHR,DSN=USERID.DDIO
000024 //LKED
EXEC PGM=IEWL,PARM='LIST,XREF,LET,MAP',COND=(5,LT,COB2),
000025 //
REGION=512K
000026 //SYSLIN
DD DSNAME=&&LOADSET,DISP=(OLD,DELETE)
000027 //
DD DDNAME=SYSIN
000028 //SYSLMOD DD DSNAME=USERID.LOAD,DISP=SHR
000029 //SYSLIB
DD DSNAME=&LIB,DISP=SHR
000030 //SYSUT1
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000031 //SYSPRINT DD SYSOUT=*
000032 //#
PEND
000033 //STEP1 EXEC #
000034 //COB2.SYSIN DD DSN=USERID.XPEDITER.SAMPLIB(CWXTCOB),DISP=SHR
000035 //COB2.CWPPRMO DD *
000036 COBOL(OUTPUT(PRINT,DDIO))

Compile Process

11. Submit your compile job to run.


EDIT ---- SYS99301.T135053.RA000.USERID.R0165779 ------------ COLUMNS 001 072
COMMAND ===> sub
SCROLL ===> CSR
000015 //SYSUT1
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000016 //SYSUT2
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000017 //SYSUT3
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000018 //SYSUT4
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000019 //SYSUT5
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000020 //SYSUT6
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000021 //SYSUT7
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000022 //XOPTIONS DD DISP=SHR,DSN=USERID.XPEDITER.XOPTIONS
000023 //CWPDDIO DD DISP=SHR,DSN=USERID.DDIO
000024 //LKED
EXEC PGM=IEWL,PARM='LIST,XREF,LET,MAP',COND=(5,LT,COB2),
000025 //
REGION=512K
000026 //SYSLIN
DD DSNAME=&&LOADSET,DISP=(OLD,DELETE)
000027 //
DD DDNAME=SYSIN
000028 //SYSLMOD DD DSNAME=USERID.LOAD,DISP=SHR
000029 //SYSLIB
DD DSNAME=&LIB,DISP=SHR
000030 //SYSUT1
DD UNIT=SYSDA,SPACE=(CYL,(1,1))
000031 //SYSPRINT DD SYSOUT=*
000032 //#
PEND
000033 //STEP1 EXEC #
000034 //COB2.SYSIN DD DSN=USERID.XPEDITER.SAMPLIB(CWXTCOB),DISP=SHR
000035 //COB2.CWPPRMO DD *
000036 COBOL(OUTPUT(PRINT,DDIO))

2-13

2-14

Xpediter/TSO COBOL Training Guide

Compile Facility
12. Select option 2 from the Program Preparation menu to use the Xpediter/TSO compile facility.
-----------------OPTION ===> 2
1
2
3
4

XPEDITER/TSO - PROGRAM PREPARATION MENU

CONVERT COMPILE JCL


COMPILE FACILITY
BIND FACILITY
EDIT ALLOCATION LIST

------------------

Convert compile JCL for XPEDITER


Compile programs for XPEDITER
Bind application plans or packages
Edit file allocation lists

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

>

Press ENTER to process

NOTE:

<
or

enter END command to terminate

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

>

<

Source Dsname ===> 'USERID.XPEDITER.SAMPLIB(CWXTCOB)'


Preparation ===> BATCH
(Batch/Editjcl/Foreground)
Language ===> COB390
Select From The List Below
(COB/COB2/COB370/COBMVS/COB390/E-COBOL/CAOPT/HASM/HLASM/PLI/PLI370)
(VAPLI/E-PLI/CMVS/C390/CZOS)
SEL Options:

D - Display settings
S - Process only

SEL
STEPS
--- ------------------_ 1. DB2 Precompile
_ 2. CICS Translation
D 3. Compile
D 4. Linkedit

S - Select DB2 Precompile libraries


----------------------------------_ D801
_ D701
_ D610

Compile Process

14. Enter the DDIO file dataset name.


------------------------ COMPILE STEP - COBOL/390 ----------------------------COMMAND ===> [ENTER]
Options ===> SOURCE,MAP,LIST,NOTEST,NONUM,XREF(FULL)
===> PGMNAME(COMPAT)
SYSLIB Datasets:
(1) ===>
(2) ===>
(3) ===>
(4) ===>
(5) ===>
(6) ===>
(7) ===>
(8) ===>
Object Library ===>
DDIO File ===> 'USERID.DDIO'
LP Options DSN ===>
Press ENTER to update

or

enter END command to terminate

15. Enter the load library dataset name.


----------------------------- LINKEDIT STEP ----------------------------------COMMAND ===> [ENTER]
Options ===> LIST,LET
===>
Load Library ===> 'USERID.LOAD'
SYSLIB Datasets:
(1) ===>
(2) ===>
(3) ===>
(4) ===>
(5) ===>
(6) ===>
(7) ===>
(8) ===>
SYSLIN Control Statements:
===>
===>
Press ENTER to update

or

enter END command to terminate

2-15

2-16

Xpediter/TSO COBOL Training Guide

16. Press PF3 to return to the Program Preparation menu.


---------------------- XPEDITER/TSO - COMPILE FACILITY -----------------------COMMAND ===> [PF3]
JOB USERIDB(JOB04562) SUBMITTED
Primary Commands: Listing (Display output) SEtup (Display general settings)
Compile Profile:

DEFAULT

>

<

Source Dsname ===> 'USERID.XPEDITER.SAMPLIB(CWXTCOB)'


Preparation ===> BATCH
(Batch/Editjcl/Foreground)
Language ===> COB390
Select From The List Below
(COB/COB2/COB370/COB390/E-COBOL/HLASM/PLI/VAPLI/E-PLI/CMVS/C390)
(CZOS)
SEL Options:

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

S - Select DB2 Precompile libraries


----------------------------------_ D801
_ D701
_ D610

XPEDITER/TSO - PROGRAM PREPARATION MENU

CONVERT COMPILE JCL


COMPILE FACILITY
BIND FACILITY
EDIT ALLOCATION LIST

------------------

Convert compile JCL for XPEDITER


Compile programs for XPEDITER
Bind application plans or packages
Edit or Create file allocation lists

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

>

Press ENTER to process

<
or

enter END command to terminate

Compile Process

2-17

17. Press PF3 to return to the Primary menu.


-----------------OPTION ===> [PF3]
1
2
3
4

XPEDITER/TSO - PROGRAM PREPARATION MENU

CONVERT COMPILE JCL


COMPILE FACILITY
BIND FACILITY
EDIT ALLOCATION LIST

------------------

Convert compile JCL for XPEDITER


Compile programs for XPEDITER
Bind application plans or packages
Edit or Create file allocation lists

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

>

Press ENTER to process

---------------------OPTION ===>
0
1
2
3
4
5
F
FA
FI
C
CS
T
X

or

enter END command to terminate

XPEDITER/TSO 7.6 - PRIMARY MENU

DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT

Profile ===> CWXTCOB

<

----------------------

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 **

For Online Technical Support Reference: http://frontline.compuware.com


Copyright (c) 2007, Compuware Corporation. All rights reserved.
(800) 538-7822
Press ENTER to process

or

enter END command to terminate

2-18

Xpediter/TSO COBOL Training Guide

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

Chapter 3 Test Setup


To prepare for an Xpediter/TSO debugging session, you must allocate your program files and databases and establish your
session defaults.
In this chapter you will prepare for an Xpediter/TSO debugging session.

3-1

3-2

Xpediter/TSO COBOL Training Guide

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

XPEDITER/TSO 7.6 - PRIMARY MENU

DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT

Profile ===> DEFAULT

----------------------

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 ***

For Online Technical Support Reference: http://frontline.compuware.com


Copyright (c) 2007, Compuware Corporation. All rights reserved.
(800) 538-7822
Press ENTER to process or enter END command to terminate

Primary Menu Options


DEFAULTS

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

Invoke Xpediter/TSO to interactively debug an application program.

BATCH

Establish a batch connect test session to debug an application program running in batch mode.

STORED PROCEDURE

Test and debug DB2 stored procedures

UTILITIES

Access general utility functions.

FADB2

Invoke File-AID for DB2 (if available).

FILE-AID

Invoke File-AID for MVS (if available).

FILE-AID/IMS

Invoke File-AID for IMS (if available)

CODE COVERAGE

Invoke Xpediter/Code Coverage (if available).

CICS

Establish a connection to a CICS region (if available).

TUTORIAL

Access the help system.

EXIT

Exit from the primary menu.

PROFILE

Specify the current 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 - ENVIRONMENTS MENU

--------------------

XPEDITER/TSO
===> 1 STANDARD
2 DIALOG
3 IMS
4 BTS
5 BATCHPEM
6 DLIPEM
7 IMSPEM

Test
Test
Test
Test
Test
Test
Test

a program with no special environment services


programs that make ISPF dialog manager calls
a program that makes IMS/DB calls
programs using BTS
a program in a Hogan BATCHPEM environment
a program in a Hogan DLIPEM/BMPPEM environment
a program in a Hogan BTS IMSPEM environment

XPEDITER/IMS
8 MPP
9 BMP/IFP
10 IMSPEM
11 BMPPEM

Test
Test
Test
Test

programs in an IMS message region


a program in a BMP or Fast Path region
Hogan IMSPEM in an IMS Message Region
Hogan BMPPEM in a BMP region

DB2 STORED PROCEDURES


12 DB2SP
- Test DB2 Stored Procedure interactively
Note:

The environment highlighted is currently selected.

Press ENTER to process

or

enter END command to terminate

Guidelines for Selecting an Environment


STANDARD

Batch programs that process QSAM and VSAM files issue EXEC SQL statements or issue third-party database calls.

DIALOG

Programs that call ISPF Dialog Management Services.

IMS

Batch programs that issue CBLTDLI calls and EXEC SQL statements or batch BMP programs.

BTS

IMS/DC programs with BTS.

BATCHPEM

HOGAN BATCHPEM applications or the BATCHPEM driver module.

DLIPEM

HOGAN DLIPEM applications or the DLIPEM driver module itself.

IMSPEM

HOGAN IMSPEM applications or the IMSPEM driver module with BTS.

MPP

IMS/DC MPP programs in the IMS message region.

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

Programs that invoke a DB2 stored procedure.

3-3

3-4

Xpediter/TSO COBOL Training Guide

Test Standard Screen


The setup information is saved as part of the profile.
3. Enter the information required to test the demo program based on the JCL represented in Figure 3.4.
Profile: CWXTCOB -----COMMAND ===> [ENTER]

XPEDITER/TSO - STANDARD (2.1)

----------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>

The program on the Test Standard screen


should match what is specified in your
execution JCL. If the PARM field is left blank,
the parameter string from your execution JCL
will be passed to your program.

Initial Script ===>


Post Script ===>
PARM

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate


This is the JCL member you will point
to for the File List/JCL Member field on
the Test Standard screen.

EDIT ---- USERID.XPEDITER.SAMPLIB(CWXTJCLC) - 01.08 -- COLUMNS 001 072


COMMAND ===>
SCROLL ===> CSR
****** ***************************** TOP OF DATA ****************************
000001 //USERIDX JOB (ACCT#),'NAME',CLASS=A,
000002 // MSGCLASS=X,NOTIFY=USERID
000003 //*
000004 //*
EXECUTE CWXTCOB IN BATCH
000005 //*
000006 //CWXTCOB EXEC PGM=CWXTCOB,PARM=00003
000007 //STEPLIB DD
DSN=USERID.LOAD,DISP=SHR
000008 //
DD
DSN=SYS1.COB2LIB,DISP=SHR
000009 //EMPFILE DD
DSN=USERID.XPEDITER.SAMPLIB(CWXTDATA),DISP=SHR
000010 //RPTFILE DD
SYSOUT=X
000011 //SYSOUT
DD
SYSOUT=X
000012 //
****** **************************** BOTTOM OF DATA **************************

Test Setup

Test Standard Screen Fields


PROGRAM

Load module name of your program.

ENTRY POINT

Alternate entry point if execution begins at a point other than the link-edited entry point.

LOAD MODULE

Required only if unit testing CSECTS within a load module.

INITIAL SCRIPT

Member name of a test script to execute at the beginning of a debugging session.

POST SCRIPT

Member name of a test script to execute at the end of a debugging session.

PARM

Parameter string if the program expects a run time parameter.

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?

YES if the program is to collect System Flow statistics.

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

DB2 plan generated during the bind process.

SYSTEM

DB2 subsystem name.

3-5

3-6

Xpediter/TSO COBOL Training Guide

4. Select the setup option to establish your session defaults.


Profile: CWXTCOB -----COMMAND ===> SE

XPEDITER/TSO - STANDARD (2.1)

----------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

Test Setup

3-7

Test Setup Menu


The Test Setup menu enables you to establish defaults for your test session. If you need to change your test
environment, select option 0.
5. Display all Test Setup screens.
Profile: CWXTCOB ------OPTION ===> A

XPEDITER/TSO - SETUP MENU

0
1
2
3
4
5
6
7

ENVIRONMENT
LOADLIBS
DDIO
INCLUDES
LOG
SCRIPT
DSNLOAD
PANEXEC

C
D
E
A

CODE COVERAGEDOCUMENT
EXTENDED
ALL
-

-----------------------------

Execution environments menu


Application load module libraries
DDIO files
Test script libraries
Session log dataset disposition
Test script dataset disposition
DB2 system names and DSNLOAD libraries
PANEXEC load libraries

Code Coverage setup options


Document dataset disposition
Extended Setup Menu
Display all of the above in succession (except 0)

Press ENTER to process

or

enter END command to terminate

Test Setup Menu Options


ENVIRONMENT

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

Display and modify default values for the document dataset.

EXTENDED

Modify NEW and WORK dataset allocation values assigned by the installer of Xpediter/TSO.

3-8

Xpediter/TSO COBOL Training Guide

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

Enter END Command to Terminate

EDIT ---- USERID.XPEDITER.SAMPLIB(CWXTJCLC) - 01.08 -- COLUMNS 001 072


COMMAND ===>
SCROLL ===> CSR
****** ***************************** TOP OF DATA ****************************
000001 //USERIDX JOB (ACCT#),'NAME',CLASS=A,
000002 // MSGCLASS=X,NOTIFY=USERID
000003 //*
000004 //*
EXECUTE CWXTCOB IN BATCH
000005 //*
000006 //CWXTCOB EXEC PGM=CWXTCOB,PARM=00003
000007 //STEPLIB DD
DSN=USERID.LOAD,DISP=SHR
000008 //
DD
DSN=SYS1.COB2LIB,DISP=SHR
000009 //EMPFILE DD
DSN=USERID.XPEDITER.SAMPLIB(CWXTDATA),DISP=SHR
000010 //RPTFILE DD
SYSOUT=X
000011 //SYSOUT
DD
SYSOUT=X
000012 //
****** **************************** BOTTOM OF DATA **************************

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]

XPEDITER/TSO - DDIO FILES

--------------------------------

User Libraries:
(1)
(2)
(3)
(4)
(5)
(6)

===> 'USERID.DDIO'
===>
===>
===>
===>
===>

Installation Libraries: (Changes made to this list override installed default


(7) ===> 'SYS2.XPEDITER.DDIO'
(8) ===>
(9) ===>

Press ENTER to process

or

enter END command to terminate

.
.
.
000011 //CWPDDIO DD DSN=USERID.DDIO,DISP=SHR
000012 //XOPTIONS DD DSN=SYS2.XPEDITER.XOPTIONS,DISP=SHR
000013 //CWPPRMO DD *
.
.
.

3-9

3-10

Xpediter/TSO COBOL Training Guide

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]

XPEDITER/TSO - TEST SCRIPT LIBRARIES

--------------------------

User Libraries:
(1) ===>
(2) ===>
(3) ===>
Installation Libraries: (Changes made to this list override installed default
(4) ===> 'SYS2.XPEDITER.INCLUDE'
(5) ===>
(6) ===>

Press ENTER to Process

or

Enter END Command to Terminate

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]

XPEDITER/TSO - LOG DATASET

Log Dataset Name:


DSNAME ===>

-------------------------------

(DSNAME will be generated if blank)

Allocation Parameters:
Data Class ===>
Space Units ===> TRK
Primary ===> 2
Secondary ===> 2
Storage Class ===>
Unit ===>
Volume ===>

Process Options:

Disposition After the Test:


Process Option ===> D

(D, K, PD, PK, or ?)

Disposition Before the Test:


Process Option ===> D

(A, D, or ?

Press ENTER to process

or

A
D
K
PD
PK
?

(Append)
(Delete)
(Keep)
(Print-Delete)
(Print-Keep)
(Prompt)

Used only if DSNAME is specified)

enter END command to terminate

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]

XPEDITER/TSO - SCRIPT DATASET

Script Dataset Name:


DSNAME ===>

-----------------------------

(DSNAME will be generated if blank)

Allocation Parameters:
Data Class ===>
Space Units ===> TRK
Primary ===> 2
Secondary ===> 2
Storage Class ===>
Unit ===>
Volume ===>

Process Options:

Disposition After the Test:


Process Option ===> D

(D, K, PD, PK, or ?)

Disposition Before the Test:


Process Option ===> D

(A, D, or ?

Press ENTER to process

or

A
D
K
PD
PK
?

(Append)
(Delete)
(Keep)
(Print-Delete)
(Print-Keep)
(Prompt)

Used only if DSNAME is specified)

enter END command to terminate

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

XPEDITER/TSO - DSNLOAD LIBRARIES

----------------------------

DSNLOAD DSNAME
===>
===>
===>
===>
===>
===>
===>
===>

'DSN810.D801.SDSNEXIT'
'DSN810.SDSNLOAD'
'DSN710.D701.SDSNEXIT'
'DSN710.SDSNLOAD'

Note: Changes made to this screen override installed defaults


Press ENTER to Process

or

Enter END Command to Terminate

3-11

3-12

Xpediter/TSO COBOL Training Guide

12. Enter the PANEXEC load library DSNAMES.


Profile: CWXTCOB ----COMMAND ===> [ENTER]

XPEDITER/TSO - PANEXEC LIBRARIES

----------------------------

PANEXEC (Program Product) Load Library DSNAMEs (DDNAME PANESRL):


(1)
(2)
(3)
(4)

===>
===>
===>
===>

PANEXEC Control Card File DSNAMEs:


DDNAME
(1)
(2)
(3)
(4)

===> PECNTL
===>
===>
===>
===>

Note: Changes made to this screen override installed defaults


Press ENTER to Process

or

Enter END Command to Terminate

13. Enter the Code Coverage repository dataset, system name and test id.
Profile: CWXTCOB ---COMMAND ===> [ENTER]

XPEDITER/TSO - CODE COVERAGE

-------------------------------

Repository DSNAME ===> USERID.REPOSTRY


System Name ===> TRAINING

Test ID ===> MYTESTID

Test Data Optimization Dataset:


DSNAME ===>
Data Class
Space Units
Primary
Secondary
Storage Class
Unit
Volume

(DSNAME will be generated if blank)

===>
===> CYL
===> 5
===> 5
===>
===>
===>

Disposition After the Test

Disposition Options:
A (Append)
D (Delete)
K (Keep)
? (Prompt)
===> K

Disposition Before the Test ===> A


Press ENTER to Process

or

(K or ?)
(A, D, or ?

Only if DSN specified)

Enter END Command to Terminate

Test Setup

3-13

14. Enter the disposition of the document dataset.


---------------------COMMAND ===> [ENTER]

XPEDITER/TSO - DOCUMENT DATASET

Document Dataset Name:


DSNAME ===>

-----------------------------

(DSNAME will be generated if blank)

Allocation Parameters:
Data Class ===>
Space Units ===> TRK
Primary ===> 2
Secondary ===> 2
Storage Class ===>
Unit ===>
Volume ===>

Process Options:

Disposition After the Test:


Process Option ===> D

(D, K, PD, PK, or ?)

Disposition Before the Test:


Process Option ===> D

(A, D, or ?

Press ENTER to process

or

A
D
K
PD
PK
?

More:

(Append)
(Delete)
(Keep)
(Print-Delete)
(Print-Keep)
(Prompt)

Used only if DSNAME is specified)

enter END command to terminate

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]

XPEDITER/TSO - SETUP MENU

---------------------------------

Extended Setup Menu


N
W

NEW
WORK

- NEW dataset Allocations for this TEST Profile


- WORK dataset Allocations for this TEST Profile

Difference

- Display Difference from Installation Defaults

Inquire

- Display Test Settings for this TEST PROFILE

Press ENTER to process

or

enter END command to terminate

3-14

Xpediter/TSO COBOL Training Guide

16. Return to the Test Standard screen.


Profile: CWXTCOB ------OPTION ===> [PF3]

XPEDITER/TSO - SETUP MENU


-

---------------------------------

0
1
2
3
4
5
6
7

ENVIRONMENT
LOADLIBS
DDIO
INCLUDES
LOG
SCRIPT
DSNLOAD
PANEXEC

Execution environments menu


Application load module libraries
DDIO files
Test script libraries
Session log dataset disposition
Test script dataset disposition
DB2 system names and DSNLOAD libraries
PANEXEC load libraries

C
D
E
A

CODE COVERAGE - Code Coverage setup options


DOCUMENT
- Document dataset disposition
EXTENDED
- Extended Setup Menu
ALL
- Display all of the above in succession (except 0)

Press ENTER to process

Profile: CWXTCOB -----COMMAND ===> [ENTER]

or

enter END command to terminate

XPEDITER/TSO - STANDARD (2.1)

-----------------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

Source Listing Screen

Chapter 4 Source Listing Screen


When you run your program under Xpediter/TSO, the source code is displayed in a fully scrollable window. All
debugging and testing functions are accessible from this screen.
In this chapter you will do the following:

Introduce the source listing screen.

Review the reference card.

4-1

4-2

Xpediter/TSO COBOL Training Guide

Source Listing Screen


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>
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

Source Listing Screen

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

Xpediter/TSO COBOL Training Guide

Gaining Control - Unconditional

5-1

Chapter 5 Gaining Control - Unconditional


Xpediter/TSO allows you to gain control of a program at any statement or paragraph. The following examples will
show you how to set and remove unconditional breakpoints.
The following commands are covered:
BEFORE

Stop execution before a line of code is executed.

AFTER

Stop execution after a line of code has executed.

SHOW BREAKS

Display all breakpoints in the current module.

DELETE

Remove the current Xpediter/TSO command.

In this chapter you will do the following:

Set breakpoints using primary and line commands.

Set and delete breakpoints globally.

Display all lines with breakpoints.

5-2

Xpediter/TSO COBOL Training Guide

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

Breakpoints can be set on the following:


- statement number
- paragraph name
- module name

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 '@'

Gaining Control - Unconditional

1. Scroll down to view the default after breakpoint.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF8]
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

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

Xpediter/TSO COBOL Training Guide

BEFORE

Set a breakpoint to stop program execution before a line of code is executed.

Primary Command:

BEFORE, BEF, B

Examples:

B 338
BEFORE CWXTSUBC:
BEF 0000-MAINLINE

Line Command:

3. Stop program execution before each paragraph.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> before all para
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 <>
=====> 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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
1 COMMAND(S) COMPLETED
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
=====> B PROCEDURE DIVISION USING PARMINFO.
000351 B 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

Gaining Control - Unconditional

4. Access additional information about the BEFORE command.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> help before
SCROLL ===> CSR
1 COMMAND(S) COMPLETED
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
=====> B PROCEDURE DIVISION USING PARMINFO.
000351 B 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

5. Exit the help screen.


------------------------- XPEDITER/TSO - HELP -------------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
--------------------------------------------------- Before CWXTCOB/AMODE 31 -********************************* TOP OF DATA **********************************
BEFORE
The BEFORE command sets a breakpoint to pause before execution of
an instruction. The breakpoint is indicated by a "B" in column 9
on the Source screen. If the line command area is expanded for
31-bit mode addressing, the breakpoint indicator is displayed in
column 11 on the Source screen.
"Before breakpoints" are automatically set at PROCEDURE DIVISION
(COBOL) or PROCEDURE (PL/I) and at one or more ENTRY statements in
the main module before a debugging session starts. These automatic
"before breakpoints" are interpreted as "before module" breakpoints.
All other "before breakpoints" are interpreted as "before
statement" breakpoints.
When the "before breakpoint" is encountered, XPEDITER/TSO temporarily
suspends execution of your program, issues a message, and returns
control to you at the terminal. Use the GO command when you are ready

5-5

5-6

Xpediter/TSO COBOL Training Guide

6. Stop program execution before statement 361.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> b 361
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 <>
=====> B PROCEDURE DIVISION USING PARMINFO.
000351 B 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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
1 COMMAND(S) COMPLETED
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
=====> B PROCEDURE DIVISION USING PARMINFO.
000351 B 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 B
PERFORM 6000-PRINT-EMPLOYEE-REPORT
000362
MOVE 1 TO REGION-SUB
000363
IF END-OF-MONTH
000364
PERFORM 7000-PRINT-REGION-REPORT

Gaining Control - Unconditional

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:

7. Stop execution after statements 354 and 361.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
1 COMMAND(S) COMPLETED
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
=====> B PROCEDURE DIVISION USING PARMINFO.
000351 B 0000-MAINLINE.
000352
PERFORM 9000-OPEN.
000353
PERFORM 9100-CHECK-PARM.
a 354
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
a 361 B
PERFORM 6000-PRINT-EMPLOYEE-REPORT
000362
MOVE 1 TO REGION-SUB
000363
IF END-OF-MONTH
000364
PERFORM 7000-PRINT-REGION-REPORT

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
2 COMMAND(S) COMPLETED
----+-000347
01 PARMINFO
> ..00003
** END **
-----=====>
000351
000352
000353
000354
000355
000356
000357
000358
000359
000360
000361
000362
000363
000364

------------------------------------------ Before CWXTCOB/AMODE 31 <>


PROCEDURE DIVISION USING PARMINFO.
0000-MAINLINE.
PERFORM 9000-OPEN.
PERFORM 9100-CHECK-PARM.
A
IF GOOD-PARM
PERFORM 9200-INIT
PERFORM 8000-READ-INPUT
UNTIL RECORDS-READ = START-NUMBER
OR END-OF-FILE
PERFORM 1000-PROCESS-DATA
UNTIL END-OF-FILE
@
PERFORM 6000-PRINT-EMPLOYEE-REPORT
MOVE 1 TO REGION-SUB
IF END-OF-MONTH
PERFORM 7000-PRINT-REGION-REPORT
B
B

5-7

5-8

Xpediter/TSO COBOL Training Guide

SHOW BREAKS

Display all breakpoints in the current module.

Primary Commands:

SHOW BREAKS, SH BR

8. Display all breakpoints set.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> show breaks
SCROLL ===> CSR
2 COMMAND(S) COMPLETED
----+-000347
01 PARMINFO
> ..00003
** END **
-----=====>
000351
000352
000353
000354
000355
000356
000357
000358
000359
000360
000361
000362
000363
000364

------------------------------------------ Before CWXTCOB/AMODE 31 <>


PROCEDURE DIVISION USING PARMINFO.
0000-MAINLINE.
PERFORM 9000-OPEN.
PERFORM 9100-CHECK-PARM.
A
IF GOOD-PARM
PERFORM 9200-INIT
PERFORM 8000-READ-INPUT
UNTIL RECORDS-READ = START-NUMBER
OR END-OF-FILE
PERFORM 1000-PROCESS-DATA
UNTIL END-OF-FILE
@
PERFORM 6000-PRINT-EMPLOYEE-REPORT
MOVE 1 TO REGION-SUB
IF END-OF-MONTH
PERFORM 7000-PRINT-REGION-REPORT
B
B

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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.
000351 B 0000-MAINLINE.
- - - - - - - - - - - - - - - - - 2 LINES NOT DISPLAYED
000354 A
IF GOOD-PARM
- - - - - - - - - - - - - - - - - 6 LINES NOT DISPLAYED
000361 @
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

Gaining Control - Unconditional

DELETE

Remove the current Xpediter/TSO command.

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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
DELETE COMMAND PROCESSED
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
- - - - - - - - - - - - - - - - - - 349 LINES NOT DISPLAYED
=====> B PROCEDURE DIVISION USING PARMINFO.
000351
0000-MAINLINE.
- - - - - - - - - - - - - - - - - 2 LINES NOT DISPLAYED
000354 A
IF GOOD-PARM
- - - - - - - - - - - - - - - - - 6 LINES NOT DISPLAYED
000361 B
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

Xpediter/TSO COBOL Training Guide

10. Delete the before breakpoints on all paragraphs.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> delete before all para
SCROLL ===> CSR
DELETE COMMAND PROCESSED
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
- - - - - - - - - - - - - - - - - - 349 LINES NOT DISPLAYED
=====> B PROCEDURE DIVISION USING PARMINFO.
000351
0000-MAINLINE.
- - - - - - - - - - - - - - - - - 2 LINES NOT DISPLAYED
000354 A
IF GOOD-PARM
- - - - - - - - - - - - - - - - - 6 LINES NOT DISPLAYED
000361 B
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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
DELETE COMMAND PROCESSED
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
- - - - - - - - - - - - - - - - - - 349 LINES NOT DISPLAYED
=====> B PROCEDURE DIVISION USING PARMINFO.
000351
0000-MAINLINE.
- - - - - - - - - - - - - - - - - 2 LINES NOT DISPLAYED
000354 A
IF GOOD-PARM
- - - - - - - - - - - - - - - - - 6 LINES NOT DISPLAYED
000361 B
PERFORM 6000-PRINT-EMPLOYEE-REPORT
- - - - - - - - - - - - - - - - - 5 LINES NOT DISPLAYED
000367 A
GOBACK.
- - - - - - - - - - - - - - - - - 6 LINES NOT DISPLAYED
000374
1000-PROCESS-DATA.
- - - - - - - - - - - - - - - - - - 20 LINES NOT DISPLAYED
000395
2000-PROCESS-HOURLY.
- - - - - - - - - - - - - - - - - - 23 LINES NOT DISPLAYED

Gaining Control - Unconditional

11. Reset the excluded lines.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
DELETE COMMAND PROCESSED
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
- - - - - - - - - - - - - - - - - - 349 LINES NOT DISPLAYED
=====> B PROCEDURE DIVISION USING PARMINFO.
000351
0000-MAINLINE.
- - - - - - - - - - - - - - - - - 2 LINES NOT DISPLAYED
000354 A
IF GOOD-PARM
- - - - - - - - - - - - - - - - - 6 LINES NOT DISPLAYED
000361 B
PERFORM 6000-PRINT-EMPLOYEE-REPORT
- - - - - - - - - - - - - - - - - 5 LINES NOT DISPLAYED
000367 A
GOBACK.
- - - - - - - - - - - - - - - - - 6 LINES NOT DISPLAYED
000374
1000-PROCESS-DATA.
- - - - - - - - - - - - - - - - - - 20 LINES NOT DISPLAYED
000395
2000-PROCESS-HOURLY.
- - - - - - - - - - - - - - - - - - 23 LINES NOT DISPLAYED

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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 <>
=====> 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
000359
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

5-11

5-12

Xpediter/TSO COBOL Training Guide

Controlling Program Execution

6-1

Chapter 6 Controlling Program Execution


Xpediter/TSO enables you to step through source code by paragraph, line-by-line, or by executing a predetermined
number of statements.
The following commands are covered:
GO

Initiate execution of the program until a breakpoint is reached, an abend is detected, or


the program ends.

GO 1

Execute one statement and stop.

GO n

Execute n statements and stop.

GO n TRACE

Highlight each statement as it is executed.

SET DELAY

Control the speed of the TRACE process.

GO HALF

Execute a half step and stop.

RUNTO

Set a temporary BEFORE breakpoint and begin execution.

In this chapter you will do the following:

Begin and resume program execution.

Execute one or more statements.

6-2

Xpediter/TSO COBOL Training Guide

GO

Begin or resume execution of your program. GO can also be issued by pressing [PF12]
or [PF24].

Primary Command:

GO

1. Begin program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
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 -=====> 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
000359
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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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
000359
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

Controlling Program Execution

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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

6-4

Xpediter/TSO COBOL Training Guide

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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
** END **

-----000373
=====>
000375
000376
000377
000378
000379
000380
000381
000382
000383
000384
000385
000386
000387

-------------------------------------- Before CWXTCOB:374/AMODE 31 <>


***
1000-PROCESS-DATA.
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
ELSE
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE
WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.
***

Controlling Program Execution

4. Execute 1 more statement.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go 1
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
** END **

-----000373
=====>
000375
000376
000377
000378
000379
000380
000381
000382
000383
000384
000385
000386
000387

-------------------------------------- Before CWXTCOB:374/AMODE 31 <>


***
1000-PROCESS-DATA.
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
ELSE
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE
WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.
***

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
000153
05 WA-EMP-TYPE
> H
** END **
-----000373
000374
=====>
000376
000377
000378
000379
000380
000381
000382
000383
000384
000385
000386
000387

-------------------------------------- Before CWXTCOB:375/AMODE 31 <>


***
1000-PROCESS-DATA.
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
ELSE
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE
WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.
***

6-5

6-6

Xpediter/TSO COBOL Training Guide

5. Execute 1 more statement.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go 1
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
000153
05 WA-EMP-TYPE
> H
** END **
-----000373
000374
=====>
000376
000377
000378
000379
000380
000381
000382
000383
000384
000385
000386
000387

-------------------------------------- Before CWXTCOB:375/AMODE 31 <>


***
1000-PROCESS-DATA.
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
ELSE
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE
WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.
***

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

-------------------------------------- Before CWXTCOB:376/AMODE 31 <>


***
1000-PROCESS-DATA.
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
ELSE
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE
WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.
***

Controlling Program Execution

GO n

Execute a specified number of statements or paragraphs and stop.

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

-------------------------------------- Before CWXTCOB:376/AMODE 31 <>


***
1000-PROCESS-DATA.
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
ELSE
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE
WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.
***

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
10 STATEMENTS EXECUTED
** END **

-----000453
=====>
000455
000456
000457
000458
000459
000460
000461
000462
000463
000464
000465
000466
000467

-------------------------------------- Before CWXTCOB:454/AMODE 31 <>


5000-STORE-EMPLOYEE-DETAIL.
PERFORM 5100-SET-INDEX.
IF VALID-REGION
MOVE WA-EMP-NAME TO HOLD-NAME (REG-IX, HOLD-IX)
MOVE REGION-ID (WA-EMP-REGION)
TO HOLD-REGION (REG-IX, HOLD-IX)
MOVE WA-EMP-TYPE TO HOLD-TYPE (REG-IX, HOLD-IX)
MOVE WA-EMP-HIRE-DATE TO HOLD-HIRE-DATE (REG-IX, HOLD-IX)
MOVE YRS-OF-SERVICE TO HOLD-YEARS (REG-IX, HOLD-IX)
MOVE EMP-COMPENSATION
TO HOLD-TOTAL (REG-IX, HOLD-IX)
IF HOURLY
MOVE EMP-WAGES TO HOLD-WAGES (REG-IX, HOLD-IX)
MOVE OT-AMOUNT TO HOLD-OT (REG-IX, HOLD-IX)
MOVE ZEROS
TO HOLD-COMM (REG-IX, HOLD-IX)

6-7

6-8

Xpediter/TSO COBOL Training Guide

GO n TRACE

Highlight the execution flow of statements or paragraphs in your program.

Primary Command:

GO n TRACE

Example:

GO 5 TRACE

7. Trace 10 statements and resume program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go 10 trace
SCROLL ===> CSR
10 STATEMENTS EXECUTED
** END **

-----000453
=====>
000455
000456
000457
000458
000459
000460
000461
000462
000463
000464
000465
000466
000467

-------------------------------------- Before CWXTCOB:454/AMODE 31 <>


5000-STORE-EMPLOYEE-DETAIL.
PERFORM 5100-SET-INDEX.
IF VALID-REGION
MOVE WA-EMP-NAME TO HOLD-NAME (REG-IX, HOLD-IX)
MOVE REGION-ID (WA-EMP-REGION)
TO HOLD-REGION (REG-IX, HOLD-IX)
MOVE WA-EMP-TYPE TO HOLD-TYPE (REG-IX, HOLD-IX)
MOVE WA-EMP-HIRE-DATE TO HOLD-HIRE-DATE (REG-IX, HOLD-IX)
MOVE YRS-OF-SERVICE TO HOLD-YEARS (REG-IX, HOLD-IX)
MOVE EMP-COMPENSATION
TO HOLD-TOTAL (REG-IX, HOLD-IX)
IF HOURLY
MOVE EMP-WAGES TO HOLD-WAGES (REG-IX, HOLD-IX)
MOVE OT-AMOUNT TO HOLD-OT (REG-IX, HOLD-IX)
MOVE ZEROS
TO HOLD-COMM (REG-IX, HOLD-IX)

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
10 STATEMENTS EXECUTED
S=1
OCCURS
----+
000097
05 REGION-ID
> NORTH
000157
05 WA-EMP-REGION
> 1
DECIMAL
I=1,I=1
OCCURS
------------------------------------------- Before CWXTCOB:457/AMODE 31 <>
000454
PERFORM 5100-SET-INDEX.
000455
IF VALID-REGION
000456
MOVE WA-EMP-NAME TO HOLD-NAME (REG-IX, HOLD-IX)
=====>
MOVE REGION-ID (WA-EMP-REGION)
000458
TO HOLD-REGION (REG-IX, HOLD-IX)
000459
MOVE WA-EMP-TYPE TO HOLD-TYPE (REG-IX, HOLD-IX)
000460
MOVE WA-EMP-HIRE-DATE TO HOLD-HIRE-DATE (REG-IX, HOLD-IX)
000461
MOVE YRS-OF-SERVICE TO HOLD-YEARS (REG-IX, HOLD-IX)
000462
MOVE EMP-COMPENSATION
000463
TO HOLD-TOTAL (REG-IX, HOLD-IX)
000464
IF HOURLY
000465
MOVE EMP-WAGES TO HOLD-WAGES (REG-IX, HOLD-IX)
000466
MOVE OT-AMOUNT TO HOLD-OT (REG-IX, HOLD-IX)
000467
MOVE ZEROS
TO HOLD-COMM (REG-IX, HOLD-IX)
000468
ELSE

Controlling Program Execution

SET DELAY

Control the speed of the TRACE process.

Primary Command:

SET DELAY n.n

Example:

SET DELAY 2.0

8. Add 1.5 seconds to the delay time between statements.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> set delay 1.5
SCROLL ===> CSR
10 STATEMENTS EXECUTED
S=1
OCCURS
----+
000097
05 REGION-ID
> NORTH
000157
05 WA-EMP-REGION
> 1
DECIMAL
I=1,I=1
OCCURS
------------------------------------------- Before CWXTCOB:457/AMODE 31 <>
000454
PERFORM 5100-SET-INDEX.
000455
IF VALID-REGION
000456
MOVE WA-EMP-NAME TO HOLD-NAME (REG-IX, HOLD-IX)
=====>
MOVE REGION-ID (WA-EMP-REGION)
000458
TO HOLD-REGION (REG-IX, HOLD-IX)
000459
MOVE WA-EMP-TYPE TO HOLD-TYPE (REG-IX, HOLD-IX)
000460
MOVE WA-EMP-HIRE-DATE TO HOLD-HIRE-DATE (REG-IX, HOLD-IX)
000461
MOVE YRS-OF-SERVICE TO HOLD-YEARS (REG-IX, HOLD-IX)
000462
MOVE EMP-COMPENSATION
000463
TO HOLD-TOTAL (REG-IX, HOLD-IX)
000464
IF HOURLY
000465
MOVE EMP-WAGES TO HOLD-WAGES (REG-IX, HOLD-IX)
000466
MOVE OT-AMOUNT TO HOLD-OT (REG-IX, HOLD-IX)
000467
MOVE ZEROS
TO HOLD-COMM (REG-IX, HOLD-IX)
000468
ELSE

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
S=1
OCCURS
----+
000097
05 REGION-ID
> NORTH
000157
05 WA-EMP-REGION
> 1
DECIMAL
I=1,I=1
OCCURS
------------------------------------------- Before CWXTCOB:457/AMODE 31 <>
000454
PERFORM 5100-SET-INDEX.
000455
IF VALID-REGION
000456
MOVE WA-EMP-NAME TO HOLD-NAME (REG-IX, HOLD-IX)
=====>
MOVE REGION-ID (WA-EMP-REGION)
000458
TO HOLD-REGION (REG-IX, HOLD-IX)
000459
MOVE WA-EMP-TYPE TO HOLD-TYPE (REG-IX, HOLD-IX)
000460
MOVE WA-EMP-HIRE-DATE TO HOLD-HIRE-DATE (REG-IX, HOLD-IX)
000461
MOVE YRS-OF-SERVICE TO HOLD-YEARS (REG-IX, HOLD-IX)
000462
MOVE EMP-COMPENSATION
000463
TO HOLD-TOTAL (REG-IX, HOLD-IX)
000464
IF HOURLY
000465
MOVE EMP-WAGES TO HOLD-WAGES (REG-IX, HOLD-IX)
000466
MOVE OT-AMOUNT TO HOLD-OT (REG-IX, HOLD-IX)
000467
MOVE ZEROS
TO HOLD-COMM (REG-IX, HOLD-IX)
000468
ELSE

6-9

6-10

Xpediter/TSO COBOL Training Guide

9. Trace 12 more statements.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go 12 trace
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
S=1
OCCURS
----+
000097
05 REGION-ID
> NORTH
000157
05 WA-EMP-REGION
> 1
DECIMAL
I=1,I=1
OCCURS
------------------------------------------- Before CWXTCOB:457/AMODE 31 <>
000454
PERFORM 5100-SET-INDEX.
000455
IF VALID-REGION
000456
MOVE WA-EMP-NAME TO HOLD-NAME (REG-IX, HOLD-IX)
=====>
MOVE REGION-ID (WA-EMP-REGION)
000458
TO HOLD-REGION (REG-IX, HOLD-IX)
000459
MOVE WA-EMP-TYPE TO HOLD-TYPE (REG-IX, HOLD-IX)
000460
MOVE WA-EMP-HIRE-DATE TO HOLD-HIRE-DATE (REG-IX, HOLD-IX)
000461
MOVE YRS-OF-SERVICE TO HOLD-YEARS (REG-IX, HOLD-IX)
000462
MOVE EMP-COMPENSATION
000463
TO HOLD-TOTAL (REG-IX, HOLD-IX)
000464
IF HOURLY
000465
MOVE EMP-WAGES TO HOLD-WAGES (REG-IX, HOLD-IX)
000466
MOVE OT-AMOUNT TO HOLD-OT (REG-IX, HOLD-IX)
000467
MOVE ZEROS
TO HOLD-COMM (REG-IX, HOLD-IX)
000468
ELSE

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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.

Controlling Program Execution

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.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
NEXT LOGICAL INSTRUCTION IS CWXTCOB:626
----+----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 <>
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.
The execution pointer remains on the READ statement but
000627
***
changes from a single-head arrow (indicating execution is
000628
***
paused before) to a double-head arrow (indicating execution
000629
9000-OPEN.
is paused after).
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

Xpediter/TSO COBOL Training Guide

Display/Modify Data

Chapter 7 Display/Modify Data


Xpediter/TSO enables you to view and modify the data in the working storage or the linkage section.
The following commands are covered:
PEEK

Display contents of variables.

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)

Display contents of a variable in hexadecimal format (on PEEK or KEEP).

MOVE

Change the content of variables.

LOCATE

Scrolls to a particular point in the program.

KEEP

Continuously display variable contents in a KEEP window.

RETEST

Begin a new test of the same program.

In this chapter you will do the following:

View data in working-storage.

Modify data in working-storage.

View COBOL tables and indexes.

7-1

7-2

Xpediter/TSO COBOL Training Guide

PEEK

Display the value of a program variable.

Primary Commands:

PEEK, P

Example:

PEEK PARM-DATA

Line Commands:

P, Pn

Example:

P2

1. View the contents of EMPLOYEE-WORK-AREA.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> peek employee-work-area
SCROLL ===> CSR
NEXT LOGICAL INSTRUCTION IS CWXTCOB:626
----+----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 <>
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.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

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

2. Scroll right to view bytes 31-60.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> dright
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
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.

3. Scroll right to view bytes 61-80.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF23]
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.

7-3

7-4

Xpediter/TSO COBOL Training Guide

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

Display the elementary items of a group level data item.

Line Command:

6. Display the elementary items of EMPLOYEE-WORK-AREA.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
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
e
> P 01 EMPLOYEE-WORK-AREA.
> 02334S1ROY GARDNER
323 OAK
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.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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.

7-5

7-6

Xpediter/TSO COBOL Training Guide

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.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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 <>
----+----1----+
000162 P
05 WA-EMP-NAME
PIC > ROY GARDNER
000163
05 WA-EMP-ADDRESS.
----+----1----+
000164 P
10 WA-EMP-STREET
PIC > 323 OAK STREET
----+--000165 P
10 WA-EMP-CITY
PIC > EDINA
-000166 P
10 WA-EMP-STATE
PIC > MN
----+---000167 P
10 WA-EMP-ZIP
PIC > 23040
000168
05 WA-HOURLY-EMPLOYEE-DATA.
000169 P
10 WA-EMP-HOURS
PIC > ???
INVALID DECIMAL
000170 P
10 WA-EMP-RATE
PIC > ???????
INVALID PACKED
----+---

Display/Modify Data

Display the value of the data item in hexadecimal format.

Line Command:

8. Display WA-EMP-RATE in hex.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
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 <>
----+----1----+
000162 P
05 WA-EMP-NAME
PIC > ROY GARDNER
000163
05 WA-EMP-ADDRESS.
----+----1----+
000164 P
10 WA-EMP-STREET
PIC > 323 OAK STREET
----+--000165 P
10 WA-EMP-CITY
PIC > EDINA
-000166 P
10 WA-EMP-STATE
PIC > MN
----+---000167 P
10 WA-EMP-ZIP
PIC > 23040
000168
05 WA-HOURLY-EMPLOYEE-DATA.
000169 P
10 WA-EMP-HOURS
PIC > ???
INVALID DECIMAL
h 170 P
10 WA-EMP-RATE
PIC > ???????
INVALID PACKED
----+---

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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 <>
000169 P
10 WA-EMP-HOURS
PIC > ???
INVALID DECIMAL
000170 P
10 WA-EMP-RATE
PIC > ???????
INVALID PACKED
00F
0F5
----+--000171 P
10 FILLER
PIC > 500000
000172
05 WA-SALES-EMPLOYEE-DATA
REDEFINES
000173
WA-HOURLY-EMPLOYEE-DATA.
000174 P
10 WA-SALES-SALARY
PIC > 00750.00
PACKED
000175 P
10 WA-SALES-AMOUNT
PIC > 55000.00
DECIMAL
-000176 P
10 FILLER
PIC >
000177
05 WA-MGMT-EMPLOYEE-DATA
REDEFINES
000178
WA-SALES-EMPLOYEE-DATA.
000179 P
10 WA-MGMT-SALARY
PIC > 00750.00
PACKED

7-7

7-8

Xpediter/TSO COBOL Training Guide

9. Delete the hex display of WA-EMP-RATE.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
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 <>
000169 P
10 WA-EMP-HOURS
PIC > ???
INVALID DECIMAL
dh 70 P
10 WA-EMP-RATE
PIC > ???????
INVALID PACKED
00F
0F5
----+--000171 P
10 FILLER
PIC > 500000
000172
05 WA-SALES-EMPLOYEE-DATA
REDEFINES
000173
WA-HOURLY-EMPLOYEE-DATA.
000174 P
10 WA-SALES-SALARY
PIC > 00750.00
PACKED
000175 P
10 WA-SALES-AMOUNT
PIC > 55000.00
DECIMAL
-000176 P
10 FILLER
PIC >
000177
05 WA-MGMT-EMPLOYEE-DATA
REDEFINES
000178
WA-SALES-EMPLOYEE-DATA.
000179 P
10 WA-MGMT-SALARY
PIC > 00750.00
PACKED

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
DELETE COMMAND PROCESSED
----+----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 <>
000169 P
10 WA-EMP-HOURS
PIC > ???
INVALID DECIMAL
000170 P
10 WA-EMP-RATE
PIC > ???????
INVALID PACKED
----+--000171 P
10 FILLER
PIC > 500000
000172
05 WA-SALES-EMPLOYEE-DATA
REDEFINES
000173
WA-HOURLY-EMPLOYEE-DATA.
000174 P
10 WA-SALES-SALARY
PIC > 00750.00
PACKED
000175 P
10 WA-SALES-AMOUNT
PIC > 55000.00
DECIMAL
-000176 P
10 FILLER
PIC >
000177
05 WA-MGMT-EMPLOYEE-DATA
REDEFINES
000178
WA-SALES-EMPLOYEE-DATA.
000179 P
10 WA-MGMT-SALARY
PIC > 00750.00
PACKED
----+---000180 P
10 FILLER
PIC > 5500000

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:

MOVE SPACES TO WA-EMP-CITY


MOVE 50 TO WA-EMP-HOURS
MOVE WA-SALES-AMOUNT TO CALC-SALES

10. Change the value of WA-SALES-SALARY to 1000.00 and press Enter.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
DELETE COMMAND PROCESSED
----+----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 <>
000169 P
10 WA-EMP-HOURS
PIC > ???
INVALID DECIMAL
000170 P
10 WA-EMP-RATE
PIC > ???????
INVALID PACKED
----+--000171 P
10 FILLER
PIC > 500000
000172
05 WA-SALES-EMPLOYEE-DATA
REDEFINES
000173
WA-HOURLY-EMPLOYEE-DATA.
000174 P
10 WA-SALES-SALARY
PIC > 01000.00
PACKED
000175 P
10 WA-SALES-AMOUNT
PIC > 55000.00
DECIMAL
-Overtype the amount in
000176 P
10 FILLER
PIC >
WA-SALES-SALARY.
000177
05 WA-MGMT-EMPLOYEE-DATA
REDEFINES
000178
WA-SALES-EMPLOYEE-DATA.
000179 P
10 WA-MGMT-SALARY
PIC > 00750.00
PACKED
----+---000180 P
10 FILLER
PIC > 5500000

7-10

Xpediter/TSO COBOL Training Guide

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:

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF6]


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 <>
000169 P
10 WA-EMP-HOURS
PIC > ???
INVALID DECIMAL
000170 P
10 WA-EMP-RATE
PIC > ???????
INVALID PACKED
----+--000171 P
10 FILLER
PIC > 500000
000172
05 WA-SALES-EMPLOYEE-DATA
REDEFINES
000173
WA-HOURLY-EMPLOYEE-DATA.
000174 P
10 WA-SALES-SALARY
PIC > 01000.00
PACKED
000175 P
10 WA-SALES-AMOUNT
PIC > 55000.00
DECIMAL
-000176 P
10 FILLER
PIC >
000177
05 WA-MGMT-EMPLOYEE-DATA
REDEFINES
000178
WA-SALES-EMPLOYEE-DATA.
000179 P
10 WA-MGMT-SALARY
PIC > 01000.00
PACKED
----+---000180 P
10 FILLER
PIC > 5500000

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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 <>
====>>
READ EMPLOYEE-FILE INTO EMPLOYEE-WORK-AREA
000622
AT END
000623
MOVE 'Y' TO EOF-SW.
000624
ADD 1 TO RECORDS-READ.
000625
***
000626
***
000627
9000-OPEN.
000628
OPEN INPUT EMPLOYEE-FILE.
000629
OPEN OUTPUT REPORT-FILE.
000630
***
000631
*** VALID PARMS ARE BLANK OR 5 DIGIT NUMBER
000632
***
000633
9100-CHECK-PARM.
000634
IF PARM-LTH = 5
000635
IF PARM-DATA IS NUMERIC

Display/Modify Data

12. Resume program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
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 <>
====>>
READ EMPLOYEE-FILE INTO EMPLOYEE-WORK-AREA
000622
AT END
000623
MOVE 'Y' TO EOF-SW.
000624
ADD 1 TO RECORDS-READ.
000625
***
000626
***
000627
9000-OPEN.
000628
OPEN INPUT EMPLOYEE-FILE.
000629
OPEN OUTPUT REPORT-FILE.
000630
***
000631
*** VALID PARMS ARE BLANK OR 5 DIGIT NUMBER
000632
***
000633
9100-CHECK-PARM.
000634
IF PARM-LTH = 5
000635
IF PARM-DATA IS NUMERIC

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
** END **

------------------------------------------- Before CWXTCOB:361/AMODE 31 <>


000360
UNTIL END-OF-FILE
=====> B
PERFORM 6000-PRINT-EMPLOYEE-REPORT
000362
MOVE 1 TO REGION-SUB
000363
IF END-OF-MONTH
000364
PERFORM 7000-PRINT-REGION-REPORT
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.

7-11

7-12

Xpediter/TSO COBOL Training Guide

13. Find the definition of HOLD-TABLE in the data division.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> f hold-table first
SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
** END **

------------------------------------------- Before CWXTCOB:361/AMODE 31 <>


000360
UNTIL END-OF-FILE
=====> B
PERFORM 6000-PRINT-EMPLOYEE-REPORT
000362
MOVE 1 TO REGION-SUB
000363
IF END-OF-MONTH
000364
PERFORM 7000-PRINT-REGION-REPORT
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.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

Display/Modify Data

KEEP

Continuously display the contents of program variables in a KEEP window.

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

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
1
OCCURS
----+----1----+----2----+----3
MORE-> K 05 HOLD-AREA
> JOHN SMITH
NORTHH798110150
** END **
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

7-13

7-14

Xpediter/TSO COBOL Training Guide

15. View occurrence 3 of HOLD-AREA.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
3
OCCURS
----+----1----+----2----+----3
MORE-> K 05 HOLD-AREA
> JOHN SMITH
NORTHH798110150
Overtype the number of
** END **
the occurrence you want.
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
3
OCCURS
----+----1----+----2----+----3
MORE-> K 05 HOLD-AREA
> VALERIE OLSEN EAST S929405010
** END **
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

Display/Modify Data

16. Change the occurrence field to increment by 1 through the table.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
3+1
OCCURS
----+----1----+----2----+----3
MORE-> K 05 HOLD-AREA
> VALERIE OLSEN EAST S929405010
** END **
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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 H858703310
** END **
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

7-15

7-16

Xpediter/TSO COBOL Training Guide

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

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
1+1
OCCURS
----+----1----+----2----+----3
MORE-> K 05 HOLD-AREA
> JOHN SMITH
NORTHH228110150
** END **
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

Display/Modify Data

DELETE KEEP:

Remove the current KEEP window or a variable in the KEEP window.

Primary Command:

DELETE KEEP, DEL KEEP, D K

Examples:

DEL KEEP
D K HOLD-LINE

Line Command:

18. Delete HOLD-AREA from the keep window.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
1+1
OCCURS
----+----1----+----2----+----3
d
-> K 05 HOLD-AREA
> JOHN SMITH
NORTHH228110150
** END **
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
DELETE COMMAND PROCESSED
** END **

-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).

7-17

7-18

Xpediter/TSO COBOL Training Guide

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

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
I=4
OCCURS
----+----1----+----2----+----3
MORE-> K 05 HOLD-AREA
> THOMAS LONG
WEST H858703310
** END **
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

Display/Modify Data

RETEST

Begin a new test of the same program.

Primary Command:

RETEST, RET

20. Begin a new test of CWXTCOB.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> ret
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
I=4
OCCURS
----+----1----+----2----+----3
MORE-> K 05 HOLD-AREA
> THOMAS LONG
WEST H858703310
** END **
-----000070
000071
000072
000073
000074
000075
000076
000077
000078
000079
000080
000081
000082
000083
000084

-------------------------------------- Before CWXTCOB:361/AMODE 31 <>


**
01 HOLD-TABLE.
DEF
05 HOLD-AREA
OCCURS 4 TIMES
INDEXED BY REG-IX.
10 HOLD-LINE
OCCURS 20 TIMES
INDEXED BY HOLD-IX.
15 HOLD-NAME
PIC X(15).
15 HOLD-REGION
PIC X(5).
15 HOLD-TYPE
PIC X.
15 HOLD-YEARS
PIC 9(2).
15 HOLD-HIRE-DATE.
20 HOLD-HIRE-YY
PIC 9(2).
20 HOLD-HIRE-MM
PIC 9(2).
20 HOLD-HIRE-DD
PIC 9(2).
15 HOLD-WAGES
PIC 9(5)V99.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

7-19

7-20

Xpediter/TSO COBOL Training Guide

Gaining Control - Conditional

Chapter 8 Gaining Control - Conditional


Xpediter/TSO enables you to set conditional breakpoints. For example, you can stop program execution when a
data area is modified, when a particular record is reached, or when a specific condition is met.
The following commands are covered:
WHEN

Suspend execution when the value of a variable changes or when a


condition is met.

SHOW WHEN

Display all WHEN commands currently in effect.

COUNT

Suspend execution if the program attempts to exceed a specified count value.

PAUSE

Suspend execution when used within a block of inserted commands.

In this chapter you will establish breakpoints based on the following:

The value of a program variable changing.

A specific condition.

A specified count value.

Inserted commands.

8-1

8-2

Xpediter/TSO COBOL Training Guide

WHEN

Stop execution when a program variable changes value or when a specified


condition is true.

Primary Command:

WHEN

Examples:

WHEN WA-EMP-TYPE CHANGES


WHEN CALC-SALES NOT NUMERIC
WHEN REGION-ID (WA-EMP-REGION) = 'EAST '

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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
WHEN EMPLOYEE-WORK-AREA CHANGES
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 03431H2GAIL LAWRENCE 123 NORT
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-WORK-AREA
> 03431H2GAIL LAWRENCE 123 NORT
** END **
-------------------------------------------- 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.

Gaining Control - Conditional

2. Set a breakpoint to stop when WA-EMP-TYPE = 'S' .


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> when wa-emp-type = 'S'
SCROLL ===> CSR
WHEN EMPLOYEE-WORK-AREA CHANGES
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 03431H2GAIL LAWRENCE 123 NORT
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-WORK-AREA
> 03431H2GAIL LAWRENCE 123 NORT
** END **
-------------------------------------------- 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.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 03431H2GAIL LAWRENCE 123 NORT
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-WORK-AREA
> 03431H2GAIL LAWRENCE 123 NORT
** END **
-------------------------------------------- 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-3

8-4

Xpediter/TSO COBOL Training Guide

3. Open a keep window to view WA-EMP-TYPE and resume program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> keep wa-emp-type;go
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 03431H2GAIL LAWRENCE 123 NORT
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-WORK-AREA
> 03431H2GAIL LAWRENCE 123 NORT
** END **
-------------------------------------------- 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.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
WHEN WA-EMP-TYPE = 'S'
000153 K 05 WA-EMP-TYPE
> S
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 01431S5TED NESSMAN
ONE COPL
----+----1----+----2----+----3
----------------------------------------------------- After CWXTCOB:623 <>
000622
8000-READ-INPUT.
WA-EMP-TYPE
====>>
READ EMPLOYEE-FILE INTO EMPLOYEE-WORK-AREA
is equal to S.
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.

Gaining Control - Conditional

SHOW WHEN

Display all WHEN commands currently in effect.

Primary Command:

SHOW WHEN, SH WHEN

4. Display all when commands.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> show when
SCROLL ===> CSR
WHEN WA-EMP-TYPE = 'S'
000153 K 05 WA-EMP-TYPE
> S
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 01431S5TED NESSMAN
ONE COPL
----+----1----+----2----+----3
----------------------------------------------------- After CWXTCOB:623 <>
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.

5. Delete all when breakpoints.


------------------------- XPEDITER/TSO - SHOW -------------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
------------------------------------------------ After CWXTCOB:623/AMODE 31 -DEL
ACTIVE WHEN CONDITIONS
PROGRAM
--- --------------------------------------------------------------- -------d
WA-EMP-TYPE = 'S'
CWXTCOB
d
EMPLOYEE-WORK-AREA CHANGES
CWXTCOB
******************************* BOTTOM OF DATA *******************************

8-5

8-6

Xpediter/TSO COBOL Training Guide

6. Return to the source listing screen.


------------------------- XPEDITER/TSO - SHOW WHEN --------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
DELETE COMMAND PROCESSED
------------------------------------------------ After CWXTCOB:623/AMODE 31 -DEL
ACTIVE WHEN CONDITIONS
PROGRAM
--- --------------------------------------------------------------- -------*** NO WHEN REQUESTS IN EFFECT ***
******************************* BOTTOM OF DATA ********************************

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

Gaining Control - Conditional

COUNT [MAX]

Set a limit on the number of times a statement or paragraph is executed.

Primary Command:

COUNT, COU, C

Examples:

COUNT STATE MAX 10


C PARA MAX 5

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.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
1 COMMAND(S) COMPLETED
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
0000000
000624
AT END
000625
MOVE 'Y' TO EOF-SW.
000626
ADD 1 TO RECORDS-READ.
000627
***
A 7 digit counter
000628
***
is now displayed.
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

Xpediter/TSO COBOL Training Guide

8. Resume program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
SCROLL ===> CSR
1 COMMAND(S) COMPLETED
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
0000000
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.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
SPECIFIED EXECUTION MAX HAS BEEN REACHED
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.
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.

Gaining Control - Conditional

9. Resume program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
SCROLL ===> CSR
SPECIFIED EXECUTION MAX HAS BEEN REACHED
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.
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.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
CANNOT EXCEED SPECIFIED EXECUTION MAX
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.
The program will not continue to execute
000626
ADD 1 TO RECORDS-READ.
because doing so will cause the statement
000627
***
count to exceed the maximum set. To
000628
***
continue, reset the max by overtyping it with a
000629
9000-OPEN.
higher value or delete the max by overtyping it
000630
OPEN INPUT EMPLOYEE-FILE.
with zeros.
000631
OPEN OUTPUT REPORT-FILE.
000632
***
000633
*** VALID PARMS ARE BLANK OR 5 DIGIT NUMBER
000634
***
000635
9100-CHECK-PARM.

8-9

8-10

Xpediter/TSO COBOL Training Guide

10. Reset the count max by overtyping the counter.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
CANNOT EXCEED SPECIFIED EXECUTION MAX
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
0000000
000624
AT END
000625
MOVE 'Y' TO EOF-SW.
000626
ADD 1 TO RECORDS-READ.
Overtype the counter.
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.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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.
000627
***
The max was reset but the
000628
***
counter is maintained.
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.

Gaining Control - Conditional

PAUSE

Suspend execution when used within a block of inserted commands.

11. Insert 3 blank lines after the add statement.


------------------------- 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.
i3 26
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.

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

Xpediter/TSO COBOL Training Guide

13. Resume program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
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
MORE->
01 EMPLOYEE-WORK-AREA
> 04147S3LAURA MARTIN
TWO ENDE
------------------------------------------- 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
***
000633
*** VALID PARMS ARE BLANK OR 5 DIGIT NUMBER

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PAUSE REQUESTED BY INSERTED COMMAND
000153 K 05 WA-EMP-TYPE
> S
** END **
-----000622
000623
000624
000625
000626
''''''
=====>
''''''
000627
000628
000629
000630
000631
000632
000633

--------------------------------------- After CWXTCOB:626/AMODE 31 <>


8000-READ-INPUT.
READ EMPLOYEE-FILE INTO EMPLOYEE-WORK-AREA
0000007
AT END
MOVE 'Y' TO EOF-SW.
ADD 1 TO RECORDS-READ.
IF WA-EMP-TYPE = 'S'
PAUSE
END-IF
***
***
9000-OPEN.
OPEN INPUT EMPLOYEE-FILE.
OPEN OUTPUT REPORT-FILE.
***
*** VALID PARMS ARE BLANK OR 5 DIGIT NUMBER

Exiting a Session

9-1

Chapter 9 Exiting a Session


Xpediter/TSO enables you to terminate the test session at any point. Xpediter/TSO automatically creates a log file,
which is an audit trail of your test session. This file can be viewed during the test or at session termination.
The following commands are covered:
EXIT

Terminate the test session.

LOG

Browse the log file to view a record of the test session.

In this chapter you will do the following:

End the test.

Access the log file.

9-2

Xpediter/TSO COBOL Training Guide

EXIT

End a test session and return to the test panel. Exit can also be issued by pressing
[PF4].

Primary Command:

EXIT

1. End the test session.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> exit
SCROLL ===> CSR
PAUSE REQUESTED BY INSERTED COMMAND
000153 K 05 WA-EMP-TYPE
> S
** END **
-----000622
000623
000624
000625
000626
''''''
=====>
''''''
000627
000628
000629
000630
000631
000632
000633

------------------------------------------------ After CWXTCOB:624 <>


8000-READ-INPUT.
READ EMPLOYEE-FILE INTO EMPLOYEE-WORK-AREA
0000007
AT END
MOVE 'Y' TO EOF-SW.
ADD 1 TO RECORDS-READ.
IF WA-EMP-TYPE = 'S'
PAUSE
END-IF
***
***
9000-OPEN.
OPEN INPUT EMPLOYEE-FILE.
OPEN OUTPUT REPORT-FILE.
***
*** VALID PARMS ARE BLANK OR 5 DIGIT NUMBER

Profile: CWXTCOB -----COMMAND ===>

XPEDITER/TSO - STANDARD (2.1

COMMANDS:

SEtup (Display Setup Menu) Log (Browse LOG)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:

Log & Script Created


SCript (Edit Script)

Program ===> CWXTCOB


Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

Exiting a Session

LOG

Display the contents of the log file.

Primary Command:

LOG

2. Browse the log file.


Profile: CWXTCOB -----COMMAND ===> log

XPEDITER/TSO - STANDARD (2.1

COMMANDS:

SEtup (Display Setup Menu) Log (Browse LOG)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:

Log & Script Created


SCript (Edit Script)

Program ===> CWXTCOB


Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

Menu

Utilities

Compilers

or

enter END command to terminate

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

KEPT ITEMS --------------------------------+--

9-3

9-4

Xpediter/TSO COBOL Training Guide

3. End the browse of the log file.


Menu

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

KEPT ITEMS --------------------------------+--

4. Delete the log file.


Profile: CWXTCOB --COMMAND ===> [ENTER]

DATA SET DISPOSITION FOR THIS SESSION

------------------

DDNAME: XPOUT
DSNAME: 'USERID.XPLOG.OCT18.T120045'
DATA SET DISPOSITION:
Process Option ===> d
SYSOUT Class ===> X

VALID PROCESS OPTIONS: B


C
D
E

For Process Options C, M, or R:


DSNAME ===>
Member Name ===>

(Browse) K (Keep)
(Copy)
M (Move)
(Delete) PD (Print-Delete)
(Edit)
PK (Print-Keep)
R (Rename)

Enter your process option here.

JOB CARD INFORMATION:


(Required for system printer)
----*----1----*----2----*----3----*----4----*----5----*----6----*----7-//USERIDX JOB (ACCOUNT),'NAME',CLASS=A,MSGCLASS=X
//*
//*
//*
Press ENTER to Process or Enter END Command to Terminate

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:

Initialize a debugging session.

Execute a set of commands at the end of a session.

Facilitate redundant keystrokes.

The following commands are covered:


SCRIPT

Edit the script dataset created during a debugging session.

INCLUDE

Execute the commands in a test script.

In this chapter you will do the following:

Create a test script member.

Include the test script member into a debugging session.

10-2

Xpediter/TSO COBOL Training Guide

SCRIPT

Edit the test script created during a debugging session.

Primary Commands:

SCRIPT, SC

1. Edit the script file.


Profile: CWXTCOB -----COMMAND ===> sc

XPEDITER/TSO - STANDARD (2.1)

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:

SCript (Edit Script)

Program ===> CWXTCOB


Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

File Edit Confirm Menu Utilities Compilers Test Help


--------------------------------------------------------------------------------EDIT ---- USERID.XPSCR.OCT18.T120045 -------------------------- Columns 001 072
Command ===>
Scroll ===> CSR
****** *************************** TOP OF DATA ***********************************
000001 *START OF THE TEST SESSION SCRIPT FILE
000002
BEFORE CWXTCOB::CWXTCOB:
000003
AFTER CWXTCOB::CWXTCOB:
000004
BEFORE ALL PARA
000005
B 359
000006
AFTER
CWXTCOB:354
000007
AFTER
CWXTCOB:359
000008
BEFORE
CWXTCOB:361
000009
SHOW BREAKS
000010
DELETE BEFORE
CWXTCOB:351
000011
DELETE AFTER
CWXTCOB:359
000012
DELETE BEFORE ALL PARA
000013
SET DELAY 1.5
000014
PEEK EMPLOYEE-WORK-AREA
000015
PEEKE
CWXTCOB:EMPLOYEE-WORK-AREA
000016
PEEKH
CWXTCOB:WA-EMP-RATE
000017
DELETE PEEKH
CWXTCOB:WA-EMP-RATE
000018
MOVE 01000.00 TO WA-SALES-SALARY OF WA-SALES-EMPLOYEE-DATA OF
000019
DELETE PEEKH
CWXTCOB:WA-EMP-RATE

Scripts

2. Delete all lines except the before breakpoint on all paragraphs.


File Edit Confirm Menu Utilities Compilers Test Help
-----------------------------------------------------------------------------EDIT ---- USERID.XPSCR.OCT18.T120045
Columns 001 072
Command ===> [ENTER]
Scroll ===> CSR
****** ***************************** Top of Data ******************************
dd 01 *START OF THE TEST SESSION SCRIPT FILE
000002
BEFORE CWXTCOB::CWXTCOB:
dd 03
AFTER CWXTCOB::CWXTCOB:
000004
BEFORE ALL PARA
d99 05
B 359
000006
AFTER
CWXTCOB:354
000007
AFTER
CWXTCOB:359
000008
BEFORE
CWXTCOB:361
000009
SHOW BREAKS
000010
DELETE BEFORE
CWXTCOB:351
000011
DELETE AFTER
CWXTCOB:359
000012
DELETE BEFORE ALL PARA
000013
SET DELAY 1.5
000014
PEEK EMPLOYEE-WORK-AREA
000015
PEEKE
CWXTCOB:EMPLOYEE-WORK-AREA
000016
PEEKH
CWXTCOB:WA-EMP-RATE
000017
DELETE PEEKH
CWXTCOB:WA-EMP-RATE
000018
MOVE 01000.00 TO WA-SALES-SALARY OF WA-SALES-EMPLOYEE-DATA OF
000019
DELETE PEEKH
CWXTCOB:WA-EMP-RATE

File Edit Confirm Menu Utilities Compilers Test Help


------------------------------------------------------------------------------EDIT ---- USERID.XPSCR.OCT18.T120045 ------------------------ COLUMNS 001 072
COMMAND ===>
SCROLL ===> CSR
****** ***************************** TOP OF DATA ******************************
000001
BEFORE ALL PARA
****** **************************** Bottom of Data ****************************

10-3

10-4

Xpediter/TSO COBOL Training Guide

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 ****************************

File Edit Confirm Menu Utilities Compilers Test Help


------------------------------------------------------------------------------EDIT ---- USERID.XPSCR.OCT18.T120045 ------------------------ COLUMNS 001 072
Command ===> [ENTER]
SCROLL ===> CSR
****** ***************************** TOP OF DATA ******************************
000001
BEFORE ALL PARA
''''''
keep employee-work-area
''''''
count all state
****** **************************** BOTTOM OF DATA ****************************

4. End the edit session.


File Edit Confirm Menu Utilities Compilers Test Help
------------------------------------------------------------------------------EDIT ---- USERID.XPSCR.OCT18.T120045 ------------------------ COLUMNS 001 072
Command ===> [PF3]
SCROLL ===> CSR
****** ***************************** TOP OF DATA ******************************
000001
BEFORE ALL PARA
000002
KEEP EMPLOYEE-WORK-AREA
000003
COUNT ALL STATE
****** **************************** BOTTOM OF DATA ****************************

Scripts

5. Move the script dataset to a member of the test script library.


Profile: CWXTCOB --COMMAND ===> [ENTER]

DATA SET DISPOSITION FOR THIS SESSION

------------------

DDNAME: XPSCRIPT
DSNAME: 'USERID.XPSCR.OCT18.T120045'
DATA SET DISPOSITION:
Process Option ===> M
SYSOUT Class ===> X

VALID PROCESS OPTIONS: B


C
D
E
Move the script.

For Process Options C, M, or R:


DSNAME ===> 'USERID.XPED.INCLUDE'
Member Name ===> CWXTCOB

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

JOB CARD INFORMATION:


(Required for system printer)
----*----1----*----2----*----3----*----4----*----5----*----6----*----7-//USERIDX JOB (ACCOUNT),'NAME',CLASS=A,MSGCLASS=X
//*
//*
//*
Press ENTER to Process or Enter END Command to Terminate

Profile: CWXTCOB -----COMMAND ===>

XPEDITER/TSO - STANDARD (2.1

3 Lines Moved/Copied

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

10-5

10-6

Xpediter/TSO COBOL Training Guide

6. Define the test script library to your Xpediter/TSO setup.


Profile: CWXTCOB -----COMMAND ===> se

XPEDITER/TSO - STANDARD (2.1

3 Lines Moved/Copied

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

Profile: CWXTCOB ------OPTION ===>

or

enter END command to terminate

XPEDITER/TSO - SETUP MENU

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
-

--------------------------

Extended Setup Menu


Execution environments menu
Application load module libraries
DDIO files
Test script libraries
Session log dataset disposition
Test script dataset disposition
DB2 system names and DSNLOAD libraries
PANEXEC load libraries

Code Coverage setup options


Document dataset disposition
Extended Setup Menu
Display all of the above in succession (except 0)

Press ENTER to process

or

enter END command to terminate

Scripts

7. Select the includes option.


Profile: CWXTCOB ------OPTION ===> 3

XPEDITER/TSO - SETUP MENU

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
-

--------------------------

Extended Setup Menu


Execution environments menu
Application load module libraries
DDIO files
Test script libraries
Session log dataset disposition
Test script dataset disposition
DB2 system names and DSNLOAD libraries
PANEXEC load libraries

Code Coverage setup options


Document dataset disposition
Extended Setup Menu
Display all of the above in succession (except 0)

Press ENTER to process

or

enter END command to terminate

8. Enter the test script library name.


Profile: CWXTCOB --COMMAND ===> [ENTER]

XPEDITER/TSO - TEST SCRIPT LIBRARIES

-------------------

User Libraries:
(1) ===> 'USERID.XPED.INCLUDE'
(2) ===>
(3) ===>
Installation Libraries: (Changes made to this list override installed default
(4) ===>
(5) ===>
(6) ===>

Press ENTER to Process

or

Enter END Command to Terminate

10-7

10-8

Xpediter/TSO COBOL Training Guide

9. Return to the Test Standard screen.


Profile: CWXTCOB ------OPTION ===> [PF3]

XPEDITER/TSO - SETUP MENU

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
-

--------------------------

Extended Setup Menu


Execution environments menu
Application load module libraries
DDIO files
Test script libraries
Session log dataset disposition
Test script dataset disposition
DB2 system names and DSNLOAD libraries
PANEXEC load libraries

Code Coverage setup options


Document dataset disposition
Extended Setup Menu
Display all of the above in succession (except 0)

Press ENTER to process

or

enter END command to terminate

10. Begin a new test of program CWXTCOB.


Profile: CWXTCOB -----COMMAND ===> [ENTER]

XPEDITER/TSO - STANDARD (2.1)

-----------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

Scripts

INCLUDE

Execute the commands found in the test script member.

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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
2 COMMAND(S) COMPLETED
----+----1----+----2----+----3
SAME-> K 01 EMPLOYEE-WORK-AREA
> ..............................
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
=====> B PROCEDURE DIVISION USING PARMINFO.
0000000
000351 B 0000-MAINLINE.
0000000
000352
PERFORM 9000-OPEN.
0000000
000353
PERFORM 9100-CHECK-PARM.
0000000
000354
IF GOOD-PARM
0000000
000355
PERFORM 9200-INIT
0000000
000356
PERFORM 8000-READ-INPUT
0000000
000357
UNTIL RECORDS-READ = START-NUMBER
000358
OR END-OF-FILE
000359
PERFORM 1000-PROCESS-DATA
0000000
000360
UNTIL END-OF-FILE
000361
PERFORM 6000-PRINT-EMPLOYEE-REPORT
0000000
000362
MOVE 1 TO REGION-SUB
0000000
000363
IF END-OF-MONTH
0000000
000364
PERFORM 7000-PRINT-REGION-REPORT
0000000

10-9

10-10

Xpediter/TSO COBOL Training Guide

12. Exit the test session.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> exit
SCROLL ===> CSR
2 COMMAND(S) COMPLETED
----+----1----+----2----+----3
SAME-> K 01 EMPLOYEE-WORK-AREA
> ..............................
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
=====> B PROCEDURE DIVISION USING PARMINFO.
0000000
000351 B 0000-MAINLINE.
0000000
000352
PERFORM 9000-OPEN.
0000000
000353
PERFORM 9100-CHECK-PARM.
0000000
000354
IF GOOD-PARM
0000000
000355
PERFORM 9200-INIT
0000000
000356
PERFORM 8000-READ-INPUT
0000000
000357
UNTIL RECORDS-READ = START-NUMBER
000358
OR END-OF-FILE
000359
PERFORM 1000-PROCESS-DATA
0000000
000360
UNTIL END-OF-FILE
000361
PERFORM 6000-PRINT-EMPLOYEE-REPORT
0000000
000362
MOVE 1 TO REGION-SUB
0000000
000363
IF END-OF-MONTH
0000000
000364
PERFORM 7000-PRINT-REGION-REPORT
0000000

Review Program Execution

11-1

Chapter 11 Review Program Execution


Xpediter/TSO allows you to record and review the execution path of your program. Both the statements executed
and the contents of the program variables are captured. Once this information is captured, it is available for review.
The following commands are covered:
MONITOR

Record the execution path.

REVERSE

Activate review mode or change the current direction while in the review mode.

RESUME

Exit from review mode and resume to normal forward execution.

In this chapter you will use review mode to determine the cause of a SOC7 abend.

11-2

Xpediter/TSO COBOL Training Guide

1. Begin a new test of program CWXTCOB using a parm string of 00002.


Profile: CWXTCOB -----COMMAND ===> [ENTER]

XPEDITER/TSO - STANDARD (2.1)

----------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

In order to override the parameter


from your execution JCL, enter
00002 in the PARM field.

( Caps = YES ) ===> 00002

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

EDIT ---- USERID.XPEDITER.SAMPLIB(CWXTJCLC) - 01.08


COLUMNS 001 072
COMMAND ===>
SCROLL ===> CSR
****** ***************************** TOP OF DATA ****************************
000001 //USERIDX JOB (ACCT#),'NAME',CLASS=A,
000002 // MSGCLASS=X,NOTIFY=USERID
000003 //*
000004 //*
EXECUTE CWXTCOB IN BATCH
000005 //*
000006 //CWXTCOB EXEC PGM=CWXTCOB,PARM=00003
000007 //STEPLIB DD
DSN=USERID.LOAD,DISP=SHR
000008 //
DD
DSN=SYS1.COB2LIB,DISP=SHR
000009 //EMPFILE DD
DSN=USERID.XPEDITER.SAMPLIB(CWXTDATA),DISP=SHR
000010 //RPTFILE DD
SYSOUT=X
000011 //SYSOUT
DD
SYSOUT=X
000012 //
****** **************************** BOTTOM OF DATA **************************

Review Program Execution

MONITOR

Record the program execution path.

Primary Command:

MONITOR, MON

Examples:

MONITOR CWXTSUBC:
MON ALL

2. Record the program execution of CWXTCOB.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> monitor
SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
----+-000347
01 PARMINFO
> ..00002
** 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

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+-000347
01 PARMINFO
> ..00002
XPEDITER/TSO is now
** END **
monitoring program execution.

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

11-3

11-4

Xpediter/TSO COBOL Training Guide

3. Begin program execution.


---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+-000347
01 PARMINFO
> ..00002
** 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

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
S0C7 ABEND ENCOUNTERED, USE "AA SNAP" COMMAND FOR ADDITIONAL INFORMATION
000129
05 EMP-COMPENSATION
> 01000.00
PACKED
000137
05 GRAND-TOTAL-EMP
> ???????????
INVALID PACKED
** END **
-----000431
=====>
000433
000434
000435
000436
000437
000438
000439
000440
000441
000442
000443
000444
000445

------------------------------ S0C7 Abend at CWXTCOB:432/AMODE 31 <>


CALC-COMMISSION.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE
TODAYS-DATE
WA-EMP-HIRE-DATE.
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
SET HOLD-IX UP BY 1.
***
*** PROCESS TYPE M (MANAGEMENT) RECORDS. THE MANAGER NAME AND
*** SALARY ARE STORED IN A TABLE FOR USE DURING PRINTING OF THE
*** REGIONAL SALES REPORT.
***
4000-PROCESS-MANAGEMENT.
MOVE WA-EMP-NAME
TO REGION-MANAGER (WA-EMP-REGION).

Review Program Execution

4. Continuously display the variables referenced by the abending statement.


---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
S0C7 ABEND ENCOUNTERED, USE "AA SNAP" COMMAND FOR ADDITIONAL INFORMATION
000129
05 EMP-COMPENSATION
> 01000.00
PACKED
000137
05 GRAND-TOTAL-EMP
> ???????????
INVALID PACKED
** END **
-----000431
k* ==>
000433
000434
000435
000436
000437
000438
000439
000440
000441
000442
000443
000444
000445

------------------------------ S0C7 Abend at CWXTCOB:432/AMODE 31 <>


CALC-COMMISSION.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE
TODAYS-DATE
WA-EMP-HIRE-DATE.
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
SET HOLD-IX UP BY 1.
***
*** PROCESS TYPE M (MANAGEMENT) RECORDS. THE MANAGER NAME AND
*** SALARY ARE STORED IN A TABLE FOR USE DURING PRINTING OF THE
*** REGIONAL SALES REPORT.
***
4000-PROCESS-MANAGEMENT.
MOVE WA-EMP-NAME
TO REGION-MANAGER (WA-EMP-REGION).

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
1 COMMAND(S) COMPLETED
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 **
----------------------------------- 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-5

11-6

Xpediter/TSO COBOL Training Guide

REVERSE

Activate review mode or change the direction of your review of program execution.

Primary Command:

REVERSE, REV

5. Activate review mode.


---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> reverse
SCROLL ===> CSR
1 COMMAND(S) COMPLETED
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 **
----------------------------------- 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).

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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
You are now in
000434
YRS-OF-SERVICE
review mode.
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).

Review Program Execution

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

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
WHEN GRAND-TOTAL-EMP CHANGES
000129 K 05 EMP-COMPENSATION
> ?????????
INVALID PACKED
000137 K 05 GRAND-TOTAL-EMP
> 0000000.00
PACKED
S=5
OCCURS
----+
000111
10 REGION-COMMENT
> .....
--------------------------------- Reverse - Before CWXTCOB:429/AMODE 31 <>
000416
*** DATA IN THE HOLD-TABLE IS USED FOR PRINTING THE EMPLOYEE
000417
*** COMPENSATION REPORT.
000418
***
000419
3000-PROCESS-SALES.
000420
IF WA-SALES-AMOUNT > 0
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
000422
MOVE WA-SALES-AMOUNT TO CALC-SALES
000423
MOVE 0 TO CALC-COMMISSION
000424
MOVE 'S' TO EMP-TYPE
000425
CALL 'CWXTSUBC' USING EMP-TYPE,
000426
CALC-SALES,
000427
CALC-COMMISSION
000428
ELSE
=====>
MOVE 'UH-OH' TO REGION-COMMENT (WA-EMP-REGION).
000430
COMPUTE EMP-COMPENSATION = WA-SALES-SALARY +

11-8

Xpediter/TSO COBOL Training Guide

7. Display the contents of REGION-COMMENT (WA-EMP-REGION) in the working-storage


section of the program.
---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>
SCROLL ===> CSR
WHEN GRAND-TOTAL-EMP CHANGES
000129 K 05 EMP-COMPENSATION
> ?????????
INVALID PACKED
000137 K 05 GRAND-TOTAL-EMP
> 0000000.00
PACKED
S=5
OCCURS
----+
000111
10 REGION-COMMENT
> .....
--------------------------------- Reverse - Before CWXTCOB:429/AMODE 31 <>
000416
*** DATA IN THE HOLD-TABLE IS USED FOR PRINTING THE EMPLOYEE
000417
*** COMPENSATION REPORT.
000418
***
000419
3000-PROCESS-SALES.
000420
IF WA-SALES-AMOUNT > 0
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
000422
MOVE WA-SALES-AMOUNT TO CALC-SALES
000423
MOVE 0 TO CALC-COMMISSION
000424
MOVE 'S' TO EMP-TYPE
000425
CALL 'CWXTSUBC' USING EMP-TYPE,
000426
CALC-SALES,
000427
CALC-COMMISSION
000428
ELSE
p
=>
MOVE 'UH-OH' TO REGION-COMMENT (WA-EMP-REGION).
000430
COMPUTE EMP-COMPENSATION = WA-SALES-SALARY +

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
1 COMMAND(S) COMPLETED
000129 K 05 EMP-COMPENSATION
> ?????????
INVALID PACKED
000137 K 05 GRAND-TOTAL-EMP
> 0000000.00
PACKED
S=5
OCCURS
----+
000111
10 REGION-COMMENT
> .....
--------------------------------- Reverse - Before CWXTCOB:429/AMODE 31 <>
000110
10 REGION-SALES
PIC 9(6)V99.
S=5
OCCURS
----+
000111 P
10 REGION-COMMENT
PIC > .....
000112
**
000113
** FIELDS USED BY CALLED PROGRAM CWXTSUBC TO CALCULATE
000114
** COMMISSION BASED ON SALES AMOUNT
000115
**
000116
01 CALC-COMMISSION-FIELDS.
000117
05 EMP-TYPE
PIC X.
000118
05 CALC-SALES
PIC 9(6)V99
VALUE 0.
000119
05 CALC-COMMISSION
PIC 9(5)V99 COMP-3
VALUE 0.
000120
**
000121
** ACCUMULATORS USED FOR CALCULATING HOURLY EMPLOYEE WAGES,
000122
** TOTAL EMPLOYEE COMPENSATION (SALARY PLUS COMMISSION OR

Review Program Execution

8. Scroll up 5 statements to view the REGION-SALES-TABLE definition.


---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> up 5
SCROLL ===> CSR
1 COMMAND(S) COMPLETED
000129 K 05 EMP-COMPENSATION
> ?????????
INVALID PACKED
000137 K 05 GRAND-TOTAL-EMP
> 0000000.00
PACKED
S=5
OCCURS
----+
000111
10 REGION-COMMENT
> .....
--------------------------------- Reverse - Before CWXTCOB:429/AMODE 31 <>
000110
10 REGION-SALES
PIC 9(6)V99.
S=5
OCCURS
----+
000111 P
10 REGION-COMMENT
PIC > .....
000112
**
000113
** FIELDS USED BY CALLED PROGRAM CWXTSUBC TO CALCULATE
000114
** COMMISSION BASED ON SALES AMOUNT
000115
**
000116
01 CALC-COMMISSION-FIELDS.
000117
05 EMP-TYPE
PIC X.
000118
05 CALC-SALES
PIC 9(6)V99
VALUE 0.
000119
05 CALC-COMMISSION
PIC 9(5)V99 COMP-3
VALUE 0.
000120
**
000121
** ACCUMULATORS USED FOR CALCULATING HOURLY EMPLOYEE WAGES,
000122
** TOTAL EMPLOYEE COMPENSATION (SALARY PLUS COMMISSION OR

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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
S=5
OCCURS
----+
000111
10 REGION-COMMENT
> .....
------------------------------------ Reverse - Before CWXTCOB:429/AMODE 31 <>
000105
01 REGION-SALES-TABLE.
This is the REGION-SALES000106
05 REGION-DATA
OCCURS 4 TIMES.
TABLE definition.
000107
10 REGION-NAME
PIC X(5).
000108
10 REGION-MANAGER
PIC X(15).
000109
10 REGION-SALARY
PIC 9(4)V99.
000110
10 REGION-SALES
PIC 9(6)V99.
S=5
OCCURS
----+
000111 P
10 REGION-COMMENT
PIC > .....
000112
**
000113
** FIELDS USED BY CALLED PROGRAM CWXTSUBC TO CALCULATE
000114
** COMMISSION BASED ON SALES AMOUNT
000115
**
000116
01 CALC-COMMISSION-FIELDS.
000117
05 EMP-TYPE
PIC X.

11-9

11-10

Xpediter/TSO COBOL Training Guide

9. Scroll down to verify that GRAND-TOTAL-EMP comes after REGION-SALES-TABLE.


---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF8]
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
S=5
OCCURS
----+
000111
10 REGION-COMMENT
> .....
------------------------------------ Reverse - Before CWXTCOB:429/AMODE 31 <>
000105
01 REGION-SALES-TABLE.
000106
05 REGION-DATA
OCCURS 4 TIMES.
000107
10 REGION-NAME
PIC X(5).
000108
10 REGION-MANAGER
PIC X(15).
000109
10 REGION-SALARY
PIC 9(4)V99.
000110
10 REGION-SALES
PIC 9(6)V99.
S=5
OCCURS
----+
000111 P
10 REGION-COMMENT
PIC > .....
000112
**
000113
** FIELDS USED BY CALLED PROGRAM CWXTSUBC TO CALCULATE
000114
** COMMISSION BASED ON SALES AMOUNT
000115
**
000116
01 CALC-COMMISSION-FIELDS.
000117
05 EMP-TYPE
PIC X.

10. Continue to scroll down.


---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF8]
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
S=5
OCCURS
----+
000111
10 REGION-COMMENT
> .....
----------------------------------- Reverse - Before CWXTCOB:429/AMODE 31 <>
000118
05 CALC-SALES
PIC 9(6)V99
VALUE 0.
000119
05 CALC-COMMISSION
PIC 9(5)V99 COMP-3
VALUE 0.
000120
**
000121
** ACCUMULATORS USED FOR CALCULATING HOURLY EMPLOYEE WAGES,
000122
** TOTAL EMPLOYEE COMPENSATION (SALARY PLUS COMMISSION OR
000123
** HOURLY EMPLOYEE WAGES PLUS OVERTIME), AND TOTAL MANAGEMENT
000124
** COMPENSATION (SALARY PLUS COMMISSION BASED ON TOTAL SALES
000125
** FOR THE REGION)
000126
**
000127
01 TOTAL-FIELDS.
000128
05 EMP-WAGES
PIC 9(5)V99
COMP-3.
000129
05 EMP-COMPENSATION
PIC 9(5)V99
COMP-3.
000130
05 MGMT-COMPENSATION
PIC 9(5)V99
COMP-3.
000131
**
000132
** TOTAL COMPENSATION GIVEN TO ALL EMPLOYEES (HOURLY AND SALES)

Review Program Execution

11. Add WA-EMP-REGION to the keep window to view its contents.


---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> k wa-emp-region
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
S=5
OCCURS
----+
000111
10 REGION-COMMENT
> .....
----------------------------------- 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

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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-11

11-12

Xpediter/TSO COBOL Training Guide

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

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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.
The occurrence of
000612
WRITE REPORT-RECORD FROM BLANK-LINE.
WA-EMP-REGION has
000613
WRITE REPORT-RECORD FROM BLANK-LINE.
changed from 5 to 2.
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

Review Program Execution

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

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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
> 2
DECIMAL
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 03431H2GAIL LAWRENCE 123 NORT
----------------------------------- Forward - 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

Xpediter/TSO COBOL Training Guide

14. Step forward one statement.


---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go 1
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
> 2
DECIMAL
----+----1----+----2----+----3
MORE->
01 EMPLOYEE-RECORD
> 03431H2GAIL LAWRENCE 123 NORT
----------------------------------- Forward - 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

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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. WA-EMP-REGION
000612
WRITE REPORT-RECORD FROM BLANK-LINE. has changed.
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

Review Program Execution

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

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
1 COMMAND(S) COMPLETED
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
<>
000151
01 EMPLOYEE-WORK-AREA.
000152 P
05 WA-EMP-NUM
PIC > 01431
DECIMAL
The maximum number of
000153 P
05 WA-EMP-TYPE
PIC > S
occurrences for EMP000154
88 HOURLY
VALUE 'H'.
REGION-TYPE is four, not
000155
88 SALES
VALUE 'S'.
five. This explains how the
000156
88 MANAGEMENT
VALUE 'M'.
table overflow occurred and
000157 P
05 WA-EMP-REGION
PIC > 5
DECIMAL
corrupted the data.
000158
88 NORTH
VALUE 1.
000159
88 SOUTH
VALUE 2.
000160
88 EAST
VALUE 3.
000161
88 WEST
VALUE 4.
----+----1----+
000162 P
05 WA-EMP-NAME
PIC > TED NESSMAN
000163
05 WA-EMP-ADDRESS.

11-16

Xpediter/TSO COBOL Training Guide

RESUME

Exit review mode and return to the current execution position.

Primary Command:

RESUME

16. Exit review mode and resume program execution.


---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> resume
SCROLL ===> CSR
1 COMMAND(S) COMPLETED
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 <>
000151
01 EMPLOYEE-WORK-AREA.
000152 P
05 WA-EMP-NUM
PIC > 01431
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 > 5
DECIMAL
000158
88 NORTH
VALUE 1.
000159
88 SOUTH
VALUE 2.
000160
88 EAST
VALUE 3.
000161
88 WEST
VALUE 4.
----+----1----+
000162 P
05 WA-EMP-NAME
PIC > TED NESSMAN
000163
05 WA-EMP-ADDRESS.

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
AT CURRENT EXECUTION POSITION
000129 K 05 EMP-COMPENSATION
> 01000.00
PACKED
000137 K 05 GRAND-TOTAL-EMP
> ???????????
INVALID PACKED
000157 K 05 WA-EMP-REGION
> 5
DECIMAL
000129
05 EMP-COMPENSATION
> 01000.00
PACKED
000137
05 GRAND-TOTAL-EMP
> ???????????
INVALID 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).

Review Program Execution

17. Initialize the GRAND-TOTAL-EMP field to zero to continue program execution.


---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> move 0 to grand-total-emp
SCROLL ===> CSR
AT CURRENT EXECUTION POSITION
000129 K 05 EMP-COMPENSATION
> 01000.00
PACKED
000137 K 05 GRAND-TOTAL-EMP
> ???????????
INVALID PACKED
000157 K 05 WA-EMP-REGION
> 5
DECIMAL
000129
05 EMP-COMPENSATION
> 01000.00
PACKED
000137
05 GRAND-TOTAL-EMP
> ???????????
INVALID 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).

---------------MNTR------ XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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-17

11-18

Xpediter/TSO COBOL Training Guide

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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
TEST COMPLETED
000129 K 05 EMP-COMPENSATION
> 06750.00
PACKED
000137 K 05 GRAND-TOTAL-EMP
> 0046366.00
PACKED
000157 K 05 WA-EMP-REGION
> 3
DECIMAL
** END **
------------------------------------------------ After CWXTCOB/AMODE 31 <>
000366
PERFORM 9900-CLOSE.
====>> 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
000380
ELSE

Review Program Execution

19. Exit the test session.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> exit
SCROLL ===> CSR
TEST COMPLETED
000129 K 05 EMP-COMPENSATION
> 06750.00
PACKED
000137 K 05 GRAND-TOTAL-EMP
> 0046366.00
PACKED
000157 K 05 WA-EMP-REGION
> 3
DECIMAL
** END **
------------------------------------------------ After CWXTCOB/AMODE 31 <>
000366
PERFORM 9900-CLOSE.
====>> 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
000380
ELSE

11-19

11-20

Xpediter/TSO COBOL Training Guide

Counting Execution

12-1

Chapter 12 Counting Execution


Xpediter/TSO allows you to maintain execution counts on statements or paragraphs.
The following commands are covered:
COUNT

Count the number of times a statement or paragraph is executed.

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.

In this chapter you will check for thorough test coverage.

12-2

Xpediter/TSO COBOL Training Guide

1. Begin a new test of program CWXTCOB using a parm string of 00003.


Profile: CWXTCOB -----COMMAND ===> [ENTER]

XPEDITER/TSO - STANDARD (2.1)

-----------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

If the PARM field is left blank, the


parameter string from your execution
JCL will be passed to your program.

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

EDIT ---- USERID.XPEDITER.SAMPLIB(CWXTJCLC) - 01.08


COLUMNS 001 072
COMMAND ===>
SCROLL ===> CSR
****** ***************************** TOP OF DATA ****************************
000001 //USERIDX JOB (ACCT#),'NAME',CLASS=A,
000002 // MSGCLASS=X,NOTIFY=USERID
000003 //*
000004 //*
EXECUTE CWXTCOB IN BATCH
000005 //*
000006 //CWXTCOB EXEC PGM=CWXTCOB,PARM=00003
000007 //STEPLIB DD
DSN=USERID.LOAD,DISP=SHR
000008 //
DD
DSN=SYS1.COB2LIB,DISP=SHR
000009 //EMPFILE DD
DSN=USERID.XPEDITER.SAMPLIB(CWXTDATA),DISP=SHR
000010 //RPTFILE DD
SYSOUT=X
000011 //SYSOUT
DD
SYSOUT=X
000012 //
****** **************************** BOTTOM OF DATA **************************

Counting Execution

COUNT

Count the number of times a statement or paragraph is executed.

Primary Command:

COUNT, COU, C

Examples:

C ALL STATE
COU 8000-READ-INPUT

Line Command:

2. Count the number of executions for each paragraph.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> count all para
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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

12-3

12-4

Xpediter/TSO COBOL Training Guide

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

5. Put a count on statements 376, 379, 382, and 384.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+-000347
01 PARMINFO
> ..00003
** END **
-----000374
000375
c 376
000377
000378
c 379
000380
000381
c 382
000383
c 384
000385
000386
000387
000388

------------------------------------------ Before CWXTCOB/AMODE 31 <>


1000-PROCESS-DATA.
0000000
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
ELSE
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE
WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.
***
*** CALCULATE TYPE H (HOURLY) EMPLOYEE COMPENSATION. ANY

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
4 COMMAND(S) COMPLETED
----+-000347
01 PARMINFO
> ..00003
** END **
-----000374
000375
000376
000377
000378
000379
000380
000381
000382
000383
000384
000385
000386
000387
000388

------------------------------------------ Before CWXTCOB/AMODE 31 <>


1000-PROCESS-DATA.
0000000
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
0000000
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
0000000
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
0000000
ELSE
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE 0000000
WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.
***
*** CALCULATE TYPE H (HOURLY) EMPLOYEE COMPENSATION. ANY

12-5

12-6

Xpediter/TSO COBOL Training Guide

6. Begin program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
SCROLL ===> CSR
4 COMMAND(S) COMPLETED
----+-000347
01 PARMINFO
> ..00003
** END **
-----000374
000375
000376
000377
000378
000379
000380
000381
000382
000383
000384
000385
000386
000387
000388

------------------------------------------ Before CWXTCOB/AMODE 31 <>


1000-PROCESS-DATA.
0000000
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
0000000
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
0000000
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
0000000
ELSE
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE 0000000
WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.
***
*** CALCULATE TYPE H (HOURLY) EMPLOYEE COMPENSATION. ANY

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
TEST COMPLETED
** END **

------ - ------------------------------------------- After CWXTCOB/AMODE 31 <>


000366
PERFORM 9900-CLOSE.
====>> 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.
0000017
000375
IF HOURLY
000376
PERFORM 2000-PROCESS-HOURLY
0000005
000377
ELSE
000378
IF SALES
000379
PERFORM 3000-PROCESS-SALES
0000008
000380
ELSE

Counting Execution

SHOW COUNTS

Display all statements that have an execution counter.

Primary Command:

SHOW COUNTS, SH COU

7. Display all counters.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> show counts
SCROLL ===> CSR
TEST COMPLETED
** END **

------ - ------------------------------------------- After CWXTCOB/AMODE 31 <>


000366
PERFORM 9900-CLOSE.
====>> 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.
0000017
000375
IF HOURLY
000376
PERFORM 2000-PROCESS-HOURLY
0000005
000377
ELSE
000378
IF SALES
000379
PERFORM 3000-PROCESS-SALES
0000008
000380
ELSE

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
SPECIFIED STATEMENTS ARE SHOWN - RESTORE SOURCE WITH 'END'
** END **

------ - ------------------------------------------- After CWXTCOB/AMODE 31 <>


******************************** TOP OF MODULE ********************************
- - - - - - - - - - - - - - - - - - 350 LINES NOT DISPLAYED
000351
0000-MAINLINE.
0000001
- - - - - - - - - - - - - - - - - - 22 LINES NOT DISPLAYED
000374
1000-PROCESS-DATA.
0000017
- - - - - - - - - - - - - - - - - - - 1 LINE NOT DISPLAYED
000376
PERFORM 2000-PROCESS-HOURLY
0000005
- - - - - - - - - - - - - - - - - 2 LINES NOT DISPLAYED
000379
PERFORM 3000-PROCESS-SALES
0000008
- - - - - - - - - - - - - - - - - 2 LINES NOT DISPLAYED
000382
PERFORM 4000-PROCESS-MANAGEMENT
0000004
- - - - - - - - - - - - - - - - - - - 1 LINE NOT DISPLAYED
000384
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE 0000000
- - - - - - - - - - - - - - - - - - 10 LINES NOT DISPLAYED
000395
2000-PROCESS-HOURLY.
0000005

12-7

12-8

Xpediter/TSO COBOL Training Guide

8. Reset the excluded lines.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
SPECIFIED STATEMENTS ARE SHOWN - RESTORE SOURCE WITH 'END'
** END **

------ - ------------------------------------------- After CWXTCOB/AMODE 31 <>


******************************** TOP OF MODULE ********************************
- - - - - - - - - - - - - - - - - - 350 LINES NOT DISPLAYED
000351
0000-MAINLINE.
0000001
- - - - - - - - - - - - - - - - - - 22 LINES NOT DISPLAYED
000374
1000-PROCESS-DATA.
0000017
- - - - - - - - - - - - - - - - - - - 1 LINE NOT DISPLAYED
000376
PERFORM 2000-PROCESS-HOURLY
0000005
- - - - - - - - - - - - - - - - - 2 LINES NOT DISPLAYED
000379
PERFORM 3000-PROCESS-SALES
0000008
- - - - - - - - - - - - - - - - - 2 LINES NOT DISPLAYED
000382
PERFORM 4000-PROCESS-MANAGEMENT
0000004
- - - - - - - - - - - - - - - - - - - 1 LINE NOT DISPLAYED
000384
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE 0000000
- - - - - - - - - - - - - - - - - - 10 LINES NOT DISPLAYED
000395
2000-PROCESS-HOURLY.
0000005

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
** END **

------ - ------------------------------------------- After CWXTCOB/AMODE 31 <>


000366
PERFORM 9900-CLOSE.
====>> 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.
0000017
000375
IF HOURLY
000376
PERFORM 2000-PROCESS-HOURLY
0000005
000377
ELSE
000378
IF SALES
000379
PERFORM 3000-PROCESS-SALES
0000008
000380
ELSE

Counting Execution

12-9

SHOW MODULES

Display a list of application modules loaded and the number of times each module was
executed.

Primary Command:

SHOW MODULES, SH MOD, SH M

9. Display the number of times each module was executed.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> show modules
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
** END **

------ - ------------------------------------------- After CWXTCOB/AMODE 31 <>


000366
PERFORM 9900-CLOSE.
====>> 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.
0000017
000375
IF HOURLY
000376
PERFORM 2000-PROCESS-HOURLY
0000005
000377
ELSE
000378
IF SALES
000379
PERFORM 3000-PROCESS-SALES
0000008
000380
ELSE

------------------------- XPEDITER/TSO - SHOW -------------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
---------------------------------------------------- After CWXTCOB/AMODE 31 ->
********************************* TOP OF DATA **********************************
MODULE CWXTCOB

START 3755FC18 SIZE 000043E8 ENTRY 3755FC18


REUS
LOADED FROM USERID.LOAD
DATE OF LINK EDIT 10/16/07
AMODE 31
RMODE ANY

CSECT CWXTCOB

START 3755FC18 SIZE 000025D0 USE 00001 SOURCE PRESENT


SOURCE LANGUAGE OF PROGRAM IS ENTERPRISE COBOL/ZOS 3.1
DATE OF COMPILE IS 101607 AT 130255
DATE OF LISTING IS 101607 AT 130255
LISTING IS FROM USERID.DDIO

CSECT CWXTDATE START 375621E8 SIZE 000008B0 USE 00015


SOURCE LANGUAGE OF PROGRAM IS COBOL
DATE OF COMPILE IS 101607 AT 130244

NO SOURCE CALL

CSECT CWXTSUBC START 375636E8 SIZE 000008FC USE 00008


SOURCE LANGUAGE OF PROGRAM IS COBOL
DATE OF COMPILE IS 101607 AT 130250

NO SOURCE CALL

12-10

Xpediter/TSO COBOL Training Guide

10. Return to the source listing screen.


------------------------- XPEDITER/TSO - SHOW -------------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
---------------------------------------------------- After CWXTCOB/AMODE 31 ->
********************************* TOP OF DATA **********************************
MODULE CWXTCOB

START 3755FC18 SIZE 000043E8 ENTRY 3755FC18


REUS
LOADED FROM USERID.LOAD
DATE OF LINK EDIT 10/16/07
AMODE 31
RMODE ANY

CSECT CWXTCOB

START 3755FC18 SIZE 000025D0 USE 00001 SOURCE PRESENT


SOURCE LANGUAGE OF PROGRAM IS ENTERPRISE COBOL/ZOS 3.1
DATE OF COMPILE IS 101607 AT 130255
DATE OF LISTING IS 101607 AT 130255
LISTING IS FROM USERID.DDIO

CSECT CWXTDATE START 375621E8 SIZE 000008B0 USE 00015


SOURCE LANGUAGE OF PROGRAM IS COBOL
DATE OF COMPILE IS 101607 AT 130244

NO SOURCE CALL

CSECT CWXTSUBC START 375636E8 SIZE 000008FC USE 00008


SOURCE LANGUAGE OF PROGRAM IS COBOL
DATE OF COMPILE IS 101607 AT 130250

NO SOURCE CALL

11. Exit the test session.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> exit
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
** END **

------------------------------------------------ After CWXTCOB/AMODE 31 <>


000366
PERFORM 9900-CLOSE.
====>> 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.
0000017
000375
IF HOURLY
000376
PERFORM 2000-PROCESS-HOURLY
0000005
000377
ELSE
000378
IF SALES
000379
PERFORM 3000-PROCESS-SALES
0000008
000380
ELSE

Subroutine Testing

13-1

Chapter 13 Subroutine Testing


Xpediter/TSO enables you to test one or more called programs. The called programs can be tested as stand-alone
programs or in conjunction with the calling program.
The following commands are covered:
INTERCEPT

Display the source for a program and set the before and after module
breakpoints.

KEEP LINKAGE

Display the linkage section variables in the keep window.

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.

Only the called program is compiled for Xpediter.

No calling program is available (Stand-alone program is compiled for Xpediter).

13-2

Xpediter/TSO COBOL Training Guide

DEMO PROGRAM

CWXTCOB

CWXTSUBC

CWXTDATE

3 Ways to Test a Called Program


I.

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.

II. ONLY THE CALLED PROGRAM IS COMPILED FOR XPEDITER


Compile CWXTSUBC.
From the Test Standard screen, specify PROGRAM = CWXTCOB.
Enter INTERCEPT CWXTSUBC from the log screen (message 'no source listing data set
member for CWXTCOB' is displayed).
III. NO CALLING PROGRAM IS AVAILABLE (STAND-ALONE PROGRAM)
Compile CWXTSUBC.
From the Test Standard screen, specify PROGRAM = CWXTSUBC.
Initialize the linkage section.

Subroutine Testing

13-3

I. Both the Calling and Called Program Compiled for Xpediter


1. Begin a new test of program CWXTCOB using a parm string of 00003.
Profile: CWXTCOB -----COMMAND ===> [ENTER]

XPEDITER/TSO - STANDARD (2.1) -------------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

If the PARM field is left blank, the


parameter string from your execution
JCL will be passed to your program.

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

EDIT ---- USERID.XPEDITER.SAMPLIB(CWXTJCLC) - 01.08 -- COLUMNS 001 072


COMMAND ===>
SCROLL ===> CSR
****** ***************************** TOP OF DATA ****************************
000001 //USERIDX JOB (ACCT#),'NAME',CLASS=A,
000002 // MSGCLASS=X,NOTIFY=USERID
000003 //*
000004 //*
EXECUTE CWXTCOB IN BATCH
000005 //*
000006 //CWXTCOB EXEC PGM=CWXTCOB,PARM=00003
000007 //STEPLIB DD
DSN=USERID.LOAD,DISP=SHR
000008 //
DD
DSN=SYS1.COB2LIB,DISP=SHR
000009 //EMPFILE DD
DSN=USERID.XPEDITER.SAMPLIB(CWXTDATA),DISP=SHR
000010 //RPTFILE DD
SYSOUT=X
000011 //SYSOUT
DD
SYSOUT=X
000012 //
****** **************************** BOTTOM OF DATA **************************

13-4

Xpediter/TSO COBOL Training Guide

INTERCEPT

Display the source for a program and set the before and after module
breakpoints.

Primary Commands:

INTERCEPT, INT

Example:

INT CWXTSUBC

2. Intercept program CWXTSUBC.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> intercept cwxtsubc
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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
** END **

----------------------------------------------- Before CWXTCOB/AMODE 31 <>


000066 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

Subroutine Testing

3. Modify the program field to display the source for CWXTCOB.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
PROGRAM: cwxtcob
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
** END **
Overtype the program name.

----------------------------------------------- Before CWXTCOB/AMODE 31 <>


000066 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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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 <>
=====> 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

13-5

13-6

Xpediter/TSO COBOL Training Guide

4. Begin program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
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 <>
=====> 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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
000060
01 EMP-TYPE
> S
000061
01 SALES-AMOUNT
> 055000.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
The cursor is now positioned
000071
IF EMP-TYPE EQUAL 'M'
at the BEFORE breakpoint in
000072
PERFORM 2000-PROCESS-MANAGEMENT.
the subroutine.
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

Subroutine Testing

5. Exit the test session.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> exit
SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
000060
01 EMP-TYPE
> S
000061
01 SALES-AMOUNT
> 055000.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-7

13-8

Xpediter/TSO COBOL Training Guide

II. Only the Called Program Compiled for Xpediter


NOTE:

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]

XPEDITER/TSO - STANDARD (2.1)

----------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
If the PARM field is left blank, the parameter string
from your execution JCL will be passed to your
program (refer to page 13.3 for sample execution
JCL).

Initial Script ===>


Post Script ===>
PARM

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

------------------------- XPEDITER/TSO - LOG --------------------------------COMMAND ===>


SCROLL ===> CSR
NO SOURCE LISTING DATA SET MEMBER FOR CWXTCOB
------------------------------------------------------------ Before CWXTCOB ->
********************************* TOP OF DATA **********************************
+-----------------------------------------------------------------------------+
:
JOB: USERID
:
: XPEDITER/TSO RELEASE 07.06.00
CUSTOMER # 000001
STEP: ATSOPROC
:
:
DATE: 10/18/2007 :
: COMPUWARE CORPORATION
TIME: 14.11.22
:
:
SYSTEM: CW01
:
+-----------------------------------------------------------------------------+
XPED TSO SPF
TEST cwxtcob
XPD1113 ADSRA111 SVC BREAKPOINTING IS ACTIVE
*** CWXTCOB FROM USERID.LOAD
LINK 10/16/07
NO SOURCE LISTING INFORMATION FOUND FOR MODULE
******************************** BOTTOM OF DATA ********************************

Subroutine Testing

7. Intercept program CWXTSUBC.


------------------------- XPEDITER/TSO - LOG --------------------------------COMMAND ===> intercept cwxtsubc
SCROLL ===> CSR
NO SOURCE LISTING DATA SET MEMBER FOR CWXTCOB
------------------------------------------------------------ Before CWXTCOB ->
********************************* TOP OF DATA **********************************
+-----------------------------------------------------------------------------+
:
JOB: USERID
:
: XPEDITER/TSO RELEASE 07.06.00
CUSTOMER # 000001
STEP: ATSOPROC
:
:
DATE: 10/18/2007 :
: COMPUWARE CORPORATION
TIME: 14.11.22
:
:
SYSTEM: CW01
:
+-----------------------------------------------------------------------------+
XPED TSO SPF
TEST cwxtcob
XPD1113 ADSRA111 SVC BREAKPOINTING IS ACTIVE
*** CWXTCOB FROM USERID.LOAD
LINK 10/16/07
NO SOURCE LISTING INFORMATION FOUND FOR MODULE
******************************** BOTTOM OF DATA ********************************

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB
COMP DATE: 10/16/2007 COMP TIME: 13:02:50
** END **

-------------------------------------------------------- Before CWXTCOB <>


000066 B PROCEDURE DIVISION USING EMP-TYPE, SALES-AMOUNT, COMM-TOTAL.
000067
0000-MAINLINE.
000068
IF EMP-TYPE EQUAL 'S'
000069
PERFORM 1000-PROCESS-SALES
The source for the subroutine
000070
ELSE
is displayed and before and
000071
IF EMP-TYPE EQUAL 'M'
after breakpoints are set at
000072
PERFORM 2000-PROCESS-MANAGEMENT.
the beginning and end of the
000073 A
GOBACK.
program.
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-9

13-10

Xpediter/TSO COBOL Training Guide

8. Begin program execution of the driver program CWXTCOB.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB
COMP DATE: 10/16/2007 COMP TIME: 13:02:50
** END **

-------------------------------------------------------- Before CWXTCOB <>


000066 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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
000060
01 EMP-TYPE
> S
000061
01 SALES-AMOUNT
> 055000.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
Execution stopped at the
000070
ELSE
BEFORE breakpoint at the
000071
IF EMP-TYPE EQUAL 'M'
beginning of the subroutine.
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

Subroutine Testing

13-11

9. Resume execution of the subroutine.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
000060
01 EMP-TYPE
> S
000061
01 SALES-AMOUNT
> 055000.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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB
COMP DATE: 10/16/2007 COMP TIME: 13:02:50
** END **

----------------------------------------------- After CWXTSUBC/AMODE 31 <>


000066 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.
====>> 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-12

Xpediter/TSO COBOL Training Guide

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 **

----------------------------------------------- After CWXTSUBC/AMODE 31 <>


000066 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.
====>> 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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
000060
01 EMP-TYPE
> S
000061
01 SALES-AMOUNT
> 070000.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

Subroutine Testing

11. Exit the test session.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> exit
SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
000060
01 EMP-TYPE
> S
000061
01 SALES-AMOUNT
> 070000.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-13

13-14

Xpediter/TSO COBOL Training Guide

III. No Calling Program Available (Stand-Alone Program)


12. Begin a new test of program CWXTSUBC - no parm string or File List/JCL Member is required.
Profile: CWXTCOB -----COMMAND ===> [ENTER]

XPEDITER/TSO - STANDARD (2.1)

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTSUBC
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===> NO
===> NO
===> NO

(YES, NO, TDO)


Plan ===>

Press ENTER to process

or

System Flow? ===> NO


System ===>

enter END command to terminate

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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTSUBC COMP DATE: 10/16/2007 COMP TIME: 13:02:50
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

Xpediter/TSO COBOL Training Guide

14. Begin program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTSUBC COMP DATE: 10/16/2007 COMP TIME: 13:02:50
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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
TEST COMPLETED
** END **

----------------------------------------------- After CWXTSUBC/AMODE 31 <>


000066 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.
====>> 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

Subroutine Testing

KEEP LINKAGE

Display the linkage section in a keep window.

Primary Commands:

KEEP LINKAGE, K LINKAGE

13-17

15. Permanently display the variables in the linkage section.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> keep linkage
SCROLL ===> CSR
TEST COMPLETED
** END **

----------------------------------------------- After CWXTSUBC/AMODE 31 <>


000066 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.
====>> 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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTSUBC COMP DATE: 10/16/2007 COMP TIME: 13:02:50
000060 K 01 EMP-TYPE
> S
000061 K 01 SALES-AMOUNT
> 002000.00
DECIMAL
000062 K 01 COMM-TOTAL
> 00040.00
PACKED
** END **
----------------------------------------------- After CWXTSUBC/AMODE 31 <>
000066 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.
====>> A
GOBACK.
000074
***
000075
***
000076
***
000077
1000-PROCESS-SALES.
000078
MOVE SALES-AMOUNT TO SALES-RANGE.
000079
IF S-RANGE1

13-18

Xpediter/TSO COBOL Training Guide

16. Exit the test session.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> exit
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTSUBC COMP DATE: 10/16/2007 COMP TIME: 13:02:50
000060 K 01 EMP-TYPE
> S
000061 K 01 SALES-AMOUNT
> 002000.00
DECIMAL
000062 K 01 COMM-TOTAL
> 00040.00
PACKED
** END **
----------------------------------------------- After CWXTSUBC/AMODE 31 <>
000066 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.
====>> 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

Enhanced Find

14-1

Chapter 14 Enhanced Find


The FIND command enables you to search on character strings, data names, and COBOL structures. FIND can
process data names and identify COBOL statements that directly or indirectly affect other data names.
The following command keywords are covered:
EXCLUDE

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.

In this chapter you will do the following:

Locate data names and determine data relationships.

Locate COBOL structures.

14-2

1.

Xpediter/TSO COBOL Training Guide

Begin a new test of program CWXTCOB using a parm string of 00003.


Profile: CWXTCOB -----COMMAND ===> [ENTER]

XPEDITER/TSO - STANDARD (2.1)

----------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

If the PARM field is left blank, the parameter


string from your execution JCL will be passed to
your program.

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

EDIT ---- USERID.XPEDITER.SAMPLIB(CWXTJCLC) - 01.08 -- COLUMNS 001 072


COMMAND ===>
SCROLL ===> CSR
****** ***************************** TOP OF DATA ****************************
000001 //USERIDX JOB (ACCT#),'NAME',CLASS=A,
000002 // MSGCLASS=X,NOTIFY=USERID
000003 //*
000004 //*
EXECUTE CWXTCOB IN BATCH
000005 //*
000006 //CWXTCOB EXEC PGM=CWXTCOB,PARM=00003
000007 //STEPLIB DD
DSN=USERID.LOAD,DISP=SHR
000008 //
DD
DSN=SYS1.COB2LIB,DISP=SHR
000009 //EMPFILE DD
DSN=USERID.XPEDITER.SAMPLIB(CWXTDATA),DISP=SHR
000010 //RPTFILE DD
SYSOUT=X
000011 //SYSOUT
DD
SYSOUT=X
000012 //
****** **************************** BOTTOM OF DATA **************************

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

Locate character strings, data names, and COBOL structures.

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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

------------------------------------------ Before CWXTCOB/AMODE 31 <>


10 REGION-SALARY
PIC 9(4)V99.
10 REGION-SALES
PIC 9(6)V99.
DEF
10 REGION-COMMENT
PIC X(5).
**
** FIELDS USED BY CALLED PROGRAM CWXTSUBC TO CALCULATE
** COMMISSION BASED ON SALES AMOUNT
**
01 CALC-COMMISSION-FIELDS.
05 EMP-TYPE
PIC X.
05 CALC-SALES
PIC 9(6)V99
VALUE 0.
05 CALC-COMMISSION
PIC 9(5)V99 COMP-3
VALUE 0.
**
** ACCUMULATORS USED FOR CALCULATING HOURLY EMPLOYEE WAGES,
** TOTAL EMPLOYEE COMPENSATION (SALARY PLUS COMMISSION OR

14-3

14-4

Xpediter/TSO COBOL Training Guide

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

------------------------------------------ Before CWXTCOB/AMODE 31 <>


10 REGION-SALARY
PIC 9(4)V99.
10 REGION-SALES
PIC 9(6)V99.
DEF
10 REGION-COMMENT
PIC X(5).
**
** FIELDS USED BY CALLED PROGRAM CWXTSUBC TO CALCULATE
** COMMISSION BASED ON SALES AMOUNT
**
01 CALC-COMMISSION-FIELDS.
05 EMP-TYPE
PIC X.
05 CALC-SALES
PIC 9(6)V99
VALUE 0.
05 CALC-COMMISSION
PIC 9(5)V99 COMP-3
VALUE 0.
**
** ACCUMULATORS USED FOR CALCULATING HOURLY EMPLOYEE WAGES,
** TOTAL EMPLOYEE COMPENSATION (SALARY PLUS COMMISSION OR
** HOURLY EMPLOYEE WAGES PLUS OVERTIME), AND TOTAL MANAGEMENT

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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
<>000420
IF WA-SALES-AMOUNT > 0
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
000422
MOVE WA-SALES-AMOUNT TO CALC-SALES
000423
MOVE 0 TO CALC-COMMISSION
000424
MOVE 'S' TO EMP-TYPE
000425
CALL 'CWXTSUBC' USING EMP-TYPE,
000426
CALC-SALES,
000427
CALC-COMMISSION
000428
ELSE
000429
MOVE 'UH-OH' TO REGION-COMMENT (WA-EMP-REGION).
000430
COMPUTE EMP-COMPENSATION = WA-SALES-SALARY +
000431
CALC-COMMISSION.
000432
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
000433
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000434
YRS-OF-SERVICE

Enhanced Find

EXCLUDE

Exclude from view all lines that were not found.

Keywords:

EXCLUDE, EX, X

4. Find REGION-SALES and exclude other statements.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> f region-sales 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

------------------------------------------ Before CWXTCOB/AMODE 31 <>


IF WA-SALES-AMOUNT > 0
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
MOVE WA-SALES-AMOUNT TO CALC-SALES
MOVE 0 TO CALC-COMMISSION
MOVE 'S' TO EMP-TYPE
CALL 'CWXTSUBC' USING EMP-TYPE,
CALC-SALES,
CALC-COMMISSION
ELSE
MOVE 'UH-OH' TO REGION-COMMENT (WA-EMP-REGION).
COMPUTE EMP-COMPENSATION = WA-SALES-SALARY +
CALC-COMMISSION.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
5 DATA REFS: 1 DEF, 2 USES, 2 MODS FOUND FOR REGION-SALES
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
- - - - - - - - - - - - - - - - - - 109 LINES NOT DISPLAYED
000110
10 REGION-SALES
PIC 9(6)V99.
DEF
- - - - - - - - - - - - - - - - - - 310 LINES NOT DISPLAYED
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
- - - - - - - - - - - - - - - - - - 157 LINES NOT DISPLAYED
000579
MOVE REGION-SALES
(REGION-SUB) TO REG-DTL-SALES.
USE
000580
MOVE REGION-SALES
(REGION-SUB) TO CALC-SALES.
USE
- - - - - - - - - - - - - - - - - - 85 LINES NOT DISPLAYED
000666
MOVE 0 TO REGION-SALES (REGION-SUB).
MOD
- - - - - - - - - - - - - - - - - - 26 LINES NOT DISPLAYED
****************************** BOTTOM OF MODULE *******************************

14-5

14-6

Xpediter/TSO COBOL Training Guide

5. Reset excluded lines.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
5 DATA REFS: 1 DEF, 2 USES, 2 MODS FOUND FOR REGION-SALES
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
- - - - - - - - - - - - - - - - - - 109 LINES NOT DISPLAYED
000110
10 REGION-SALES
PIC 9(6)V99.
DEF
- - - - - - - - - - - - - - - - - - 310 LINES NOT DISPLAYED
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
- - - - - - - - - - - - - - - - - - 157 LINES NOT DISPLAYED
000579
MOVE REGION-SALES
(REGION-SUB) TO REG-DTL-SALES.
USE
000580
MOVE REGION-SALES
(REGION-SUB) TO CALC-SALES.
USE
- - - - - - - - - - - - - - - - - - 85 LINES NOT DISPLAYED
000666
MOVE 0 TO REGION-SALES (REGION-SUB).
MOD
- - - - - - - - - - - - - - - - - - 26 LINES NOT DISPLAYED
****************************** BOTTOM OF MODULE *******************************

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

------------------------------------------ Before CWXTCOB/AMODE 31 <>


IF WA-SALES-AMOUNT > 0
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
MOVE WA-SALES-AMOUNT TO CALC-SALES
MOVE 0 TO CALC-COMMISSION
MOVE 'S' TO EMP-TYPE
CALL 'CWXTSUBC' USING EMP-TYPE,
CALC-SALES,
CALC-COMMISSION
ELSE
MOVE 'UH-OH' TO REGION-COMMENT (WA-EMP-REGION).
COMPUTE EMP-COMPENSATION = WA-SALES-SALARY +
CALC-COMMISSION.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE

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

------------------------------------------ Before CWXTCOB/AMODE 31 <>


IF WA-SALES-AMOUNT > 0
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
MOVE WA-SALES-AMOUNT TO CALC-SALES
MOVE 0 TO CALC-COMMISSION
MOVE 'S' TO EMP-TYPE
CALL 'CWXTSUBC' USING EMP-TYPE,
CALC-SALES,
CALC-COMMISSION
ELSE
MOVE 'UH-OH' TO REGION-COMMENT (WA-EMP-REGION).
COMPUTE EMP-COMPENSATION = WA-SALES-SALARY +
CALC-COMMISSION.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
7 DATA REFS: 3 DEFS, 2 USES, 2 MODS FOUND FOR REGION-SALES
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
- - - - - - - - - - - - - - - - - - 104 LINES NOT DISPLAYED
000105
01 REGION-SALES-TABLE.
DEF
000106
05 REGION-DATA
OCCURS 4 TIMES.
DEF
- - - - - - - - - - - - - - - - - 3 LINES NOT DISPLAYED
000110
10 REGION-SALES
PIC 9(6)V99.
DEF
- - - - - - - - - - - - - - - - - - 310 LINES NOT DISPLAYED
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
- - - - - - - - - - - - - - - - - - 157 LINES NOT DISPLAYED
000579
MOVE REGION-SALES
(REGION-SUB) TO REG-DTL-SALES.
USE
000580
MOVE REGION-SALES
(REGION-SUB) TO CALC-SALES.
USE
- - - - - - - - - - - - - - - - - - 85 LINES NOT DISPLAYED
000666
MOVE 0 TO REGION-SALES (REGION-SUB).
MOD
- - - - - - - - - - - - - - - - - - 26 LINES NOT DISPLAYED
****************************** BOTTOM OF MODULE *******************************

14-8

Xpediter/TSO COBOL Training Guide

7. Reset excluded lines.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
7 DATA REFS: 3 DEFS, 2 USES, 2 MODS FOUND FOR REGION-SALES
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
- - - - - - - - - - - - - - - - - - 104 LINES NOT DISPLAYED
000105
01 REGION-SALES-TABLE.
DEF
000106
05 REGION-DATA
OCCURS 4 TIMES.
DEF
- - - - - - - - - - - - - - - - - 3 LINES NOT DISPLAYED
000110
10 REGION-SALES
PIC 9(6)V99.
DEF
- - - - - - - - - - - - - - - - - - 310 LINES NOT DISPLAYED
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
- - - - - - - - - - - - - - - - - - 157 LINES NOT DISPLAYED
000579
MOVE REGION-SALES
(REGION-SUB) TO REG-DTL-SALES.
USE
000580
MOVE REGION-SALES
(REGION-SUB) TO CALC-SALES.
USE
- - - - - - - - - - - - - - - - - - 85 LINES NOT DISPLAYED
000666
MOVE 0 TO REGION-SALES (REGION-SUB).
MOD
- - - - - - - - - - - - - - - - - - 26 LINES NOT DISPLAYED
****************************** BOTTOM OF MODULE *******************************

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

------------------------------------------ Before CWXTCOB/AMODE 31 <>


IF WA-SALES-AMOUNT > 0
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
MOVE WA-SALES-AMOUNT TO CALC-SALES
MOVE 0 TO CALC-COMMISSION
MOVE 'S' TO EMP-TYPE
CALL 'CWXTSUBC' USING EMP-TYPE,
CALC-SALES,
CALC-COMMISSION
ELSE
MOVE 'UH-OH' TO REGION-COMMENT (WA-EMP-REGION).
COMPUTE EMP-COMPENSATION = WA-SALES-SALARY +
CALC-COMMISSION.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE

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

------------------------------------------ Before CWXTCOB/AMODE 31 <>


IF WA-SALES-AMOUNT > 0
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
MOVE WA-SALES-AMOUNT TO CALC-SALES
MOVE 0 TO CALC-COMMISSION
MOVE 'S' TO EMP-TYPE
CALL 'CWXTSUBC' USING EMP-TYPE,
CALC-SALES,
CALC-COMMISSION
ELSE
MOVE 'UH-OH' TO REGION-COMMENT (WA-EMP-REGION).
COMPUTE EMP-COMPENSATION = WA-SALES-SALARY +
CALC-COMMISSION.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
5 DATA REFS: 1 DEF, 2 USES, 2 MODS FOUND FOR REGION-SALES
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
000110
10 REGION-SALES
PIC 9(6)V99.
DEF
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
000579
MOVE REGION-SALES
(REGION-SUB) TO REG-DTL-SALES.
USE
000580
MOVE REGION-SALES
(REGION-SUB) TO CALC-SALES.
USE
000666
MOVE 0 TO REGION-SALES (REGION-SUB).
MOD
****************************** BOTTOM OF MODULE *******************************

14-10

Xpediter/TSO COBOL Training Guide

9. Find indirect references to REGION-SALES.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> f ind
SCROLL ===> CSR
5 DATA REFS: 1 DEF, 2 USES, 2 MODS FOUND FOR REGION-SALES
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
000110
10 REGION-SALES
PIC 9(6)V99.
DEF
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
000579
MOVE REGION-SALES
(REGION-SUB) TO REG-DTL-SALES.
USE
000580
MOVE REGION-SALES
(REGION-SUB) TO CALC-SALES.
USE
000666
MOVE 0 TO REGION-SALES (REGION-SUB).
MOD
****************************** BOTTOM OF MODULE *******************************

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
11 DATA REFS: 3 DEFS, 3 USES, 5 MODS FOUND FOR REGION-SALES
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
000110
10 REGION-SALES
PIC 9(6)V99.
000118
05 CALC-SALES
PIC 9(6)V99
VALUE 0.
DEF
000175
10 WA-SALES-AMOUNT
PIC 9(5)V99.
DEF
000298
05 REG-DTL-SALES
PIC ZZZZZ9.99.
DEF
000420
IF WA-SALES-AMOUNT > 0
USE
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
USE
000422
MOVE WA-SALES-AMOUNT TO CALC-SALES
1 USE, 1 MOD
000426
CALC-SALES,
MOD
000579
MOVE REGION-SALES
(REGION-SUB) TO REG-DTL-SALES.
MOD
000580
MOVE REGION-SALES
(REGION-SUB) TO CALC-SALES.
MOD
000584
CALC-SALES,
MOD
000666
MOVE 0 TO REGION-SALES (REGION-SUB).
****************************** BOTTOM OF MODULE *******************************

Enhanced Find

10. Find the next level of indirect references to REGION-SALES.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> f ind
SCROLL ===> CSR
11 DATA REFS: 3 DEFS, 3 USES, 5 MODS FOUND FOR REGION-SALES
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
000110
10 REGION-SALES
PIC 9(6)V99.
000118
05 CALC-SALES
PIC 9(6)V99
VALUE 0.
DEF
000175
10 WA-SALES-AMOUNT
PIC 9(5)V99.
DEF
000298
05 REG-DTL-SALES
PIC ZZZZZ9.99.
DEF
000420
IF WA-SALES-AMOUNT > 0
USE
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
USE
000422
MOVE WA-SALES-AMOUNT TO CALC-SALES
1 USE, 1 MOD
000426
CALC-SALES,
MOD
000579
MOVE REGION-SALES
(REGION-SUB) TO REG-DTL-SALES.
MOD
000580
MOVE REGION-SALES
(REGION-SUB) TO CALC-SALES.
MOD
000584
CALC-SALES,
MOD
000666
MOVE 0 TO REGION-SALES (REGION-SUB).
****************************** BOTTOM OF MODULE *******************************

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
END OF INDIRECT SEARCH
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
000110
10 REGION-SALES
PIC 9(6)V99.
000118
05 CALC-SALES
PIC 9(6)V99
VALUE 0.
DEF
000175
10 WA-SALES-AMOUNT
PIC 9(5)V99.
DEF
000298
05 REG-DTL-SALES
PIC ZZZZZ9.99.
DEF
000420
IF WA-SALES-AMOUNT > 0
USE
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
USE
000422
MOVE WA-SALES-AMOUNT TO CALC-SALES
1 USE, 1 MOD
000426
CALC-SALES,
MOD
000579
MOVE REGION-SALES
(REGION-SUB) TO REG-DTL-SALES.
MOD
000580
MOVE REGION-SALES
(REGION-SUB) TO CALC-SALES.
MOD
000584
CALC-SALES,
MOD
000666
MOVE 0 TO REGION-SALES (REGION-SUB).
****************************** BOTTOM OF MODULE *******************************

14-11

14-12

Xpediter/TSO COBOL Training Guide

11. Reset the excluded lines.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
END OF INDIRECT SEARCH
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
000110
10 REGION-SALES
PIC 9(6)V99.
000118
05 CALC-SALES
PIC 9(6)V99
VALUE 0.
DEF
000175
10 WA-SALES-AMOUNT
PIC 9(5)V99.
DEF
000298
05 REG-DTL-SALES
PIC ZZZZZ9.99.
DEF
000420
IF WA-SALES-AMOUNT > 0
USE
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
USE
000422
MOVE WA-SALES-AMOUNT TO CALC-SALES
1 USE, 1 MOD
000426
CALC-SALES,
MOD
000579
MOVE REGION-SALES
(REGION-SUB) TO REG-DTL-SALES.
MOD
000580
MOVE REGION-SALES
(REGION-SUB) TO CALC-SALES.
MOD
000584
CALC-SALES,
MOD
000666
MOVE 0 TO REGION-SALES (REGION-SUB).
****************************** BOTTOM OF MODULE *******************************

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

------------------------------------------ Before CWXTCOB/AMODE 31


IF WA-SALES-AMOUNT > 0
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOVE WA-SALES-AMOUNT TO CALC-SALES
1 USE, 1
MOVE 0 TO CALC-COMMISSION
MOVE 'S' TO EMP-TYPE
CALL 'CWXTSUBC' USING EMP-TYPE,
CALC-SALES,
CALC-COMMISSION
ELSE
MOVE 'UH-OH' TO REGION-COMMENT (WA-EMP-REGION).
COMPUTE EMP-COMPENSATION = WA-SALES-SALARY +
CALC-COMMISSION.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE

<>
USE
USE
MOD

MOD

Enhanced Find

MODIFY

Identify where the data variable has the potential to be modified.

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

------------------------------------------ Before CWXTCOB/AMODE 31


IF WA-SALES-AMOUNT > 0
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOVE WA-SALES-AMOUNT TO CALC-SALES
1 USE, 1
MOVE 0 TO CALC-COMMISSION
MOVE 'S' TO EMP-TYPE
CALL 'CWXTSUBC' USING EMP-TYPE,
CALC-SALES,
CALC-COMMISSION
ELSE
MOVE 'UH-OH' TO REGION-COMMENT (WA-EMP-REGION).
COMPUTE EMP-COMPENSATION = WA-SALES-SALARY +
CALC-COMMISSION.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE

<>
USE
USE
MOD

MOD

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
2 DATA MODS FOUND FOR REGION-SALES
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
000666
MOVE 0 TO REGION-SALES (REGION-SUB).
MOD
****************************** BOTTOM OF MODULE *******************************

14-13

14-14

Xpediter/TSO COBOL Training Guide

13. Find all paragraph names.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> f para
SCROLL ===> CSR
2 DATA MODS FOUND FOR REGION-SALES
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
MOD
000666
MOVE 0 TO REGION-SALES (REGION-SUB).
MOD
****************************** BOTTOM OF MODULE *******************************

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
20 PARAGRAPHS FOUND
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
000351
0000-MAINLINE.
000374
1000-PROCESS-DATA.
000395
2000-PROCESS-HOURLY.
000419
3000-PROCESS-SALES.
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
000444
4000-PROCESS-MANAGEMENT.
000453
5000-STORE-EMPLOYEE-DETAIL.
000479
5100-SET-INDEX.
000504
6000-PRINT-EMPLOYEE-REPORT.
000527
6100-PRINT-EMPLOYEE-DETAIL.
000550
6200-PRINT-EMPLOYEE-HEADERS.
000572
7000-PRINT-REGION-REPORT.
000601
7100-PRINT-REGION-HEADERS.
000620
8000-READ-INPUT.

Enhanced Find

14. Reset the excluded lines.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
20 PARAGRAPHS FOUND
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
000351
0000-MAINLINE.
000374
1000-PROCESS-DATA.
000395
2000-PROCESS-HOURLY.
000419
3000-PROCESS-SALES.
000421
ADD WA-SALES-AMOUNT TO REGION-SALES (WA-EMP-REGION)
000444
4000-PROCESS-MANAGEMENT.
000453
5000-STORE-EMPLOYEE-DETAIL.
000479
5100-SET-INDEX.
000504
6000-PRINT-EMPLOYEE-REPORT.
000527
6100-PRINT-EMPLOYEE-DETAIL.
000550
6200-PRINT-EMPLOYEE-HEADERS.
000572
7000-PRINT-REGION-REPORT.
000601
7100-PRINT-REGION-HEADERS.
000620
8000-READ-INPUT.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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 <>
=====> 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-15

14-16

Xpediter/TSO COBOL Training Guide

15. Find all call statements.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> f call x
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 <>
=====> 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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
5 CALLS FOUND
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
000405
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000406
YRS-OF-SERVICE
000407
TODAYS-DATE
000408
WA-EMP-HIRE-DATE.
000425
CALL 'CWXTSUBC' USING EMP-TYPE,
000426
CALC-SALES,
000427
CALC-COMMISSION
000433
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000434
YRS-OF-SERVICE
000435
TODAYS-DATE
000436
WA-EMP-HIRE-DATE.
000583
CALL 'CWXTSUBC' USING EMP-TYPE,
000584
CALC-SALES,
000585
CALC-COMMISSION.

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.

Altering Program Flow

15-1

Chapter 15 Altering Program Flow


Xpediter/TSO enables you to alter the execution path of your program by skipping code or branching around code.
The following commands are covered:
SKIP

Bypass the execution of a statement or paragraph.

GOTO

Reposition the current execution pointer of a program.

In this chapter you will do the following:

Bypass execution of a called program.

Redirect the execution path of a program.

15-2

Xpediter/TSO COBOL Training Guide

SKIP

Bypass the execution of a statement or paragraph.

Primary Command:

SKIP, S

Examples:

S 529 THRU 536


SKIP 6000-PRINT-EMPLOYEE-REPORT

Line Command:

1. Bypass calls to program CWXTDATE.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
5 CALLS FOUND
----+-000347
01 PARMINFO
> ..00003
** END **
----------------------------------------------- Before CWXTCOB/AMODE 31 <>
******************************** TOP OF MODULE ********************************
s 405
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000406
YRS-OF-SERVICE
000407
TODAYS-DATE
000408
WA-EMP-HIRE-DATE.
000425
CALL 'CWXTSUBC' USING EMP-TYPE,
000426
CALC-SALES,
000427
CALC-COMMISSION
s 433
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000434
YRS-OF-SERVICE
000435
TODAYS-DATE
000436
WA-EMP-HIRE-DATE.
000583
CALL 'CWXTSUBC' USING EMP-TYPE,
000584
CALC-SALES,
000585
CALC-COMMISSION.
s 656
CALL 'CWXTDATE' USING END-OF-MONTH-SW

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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 <>
******************************** TOP OF MODULE ********************************
000405 S
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000406
YRS-OF-SERVICE
000407
TODAYS-DATE
000408
WA-EMP-HIRE-DATE.
000425
CALL 'CWXTSUBC' USING EMP-TYPE,
000426
CALC-SALES,
000427
CALC-COMMISSION
000433 S
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000434
YRS-OF-SERVICE
000435
TODAYS-DATE
000436
WA-EMP-HIRE-DATE.
000583
CALL 'CWXTSUBC' USING EMP-TYPE,
000584
CALC-SALES,
000585
CALC-COMMISSION.
000656 S
CALL 'CWXTDATE' USING END-OF-MONTH-SW

Altering Program Flow

2. Reset the excluded lines.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF3]
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 <>
******************************** TOP OF MODULE ********************************
000405 S
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000406
YRS-OF-SERVICE
000407
TODAYS-DATE
000408
WA-EMP-HIRE-DATE.
000425
CALL 'CWXTSUBC' USING EMP-TYPE,
000426
CALC-SALES,
000427
CALC-COMMISSION
000433 S
CALL 'CWXTDATE' USING END-OF-MONTH-SW
000434
YRS-OF-SERVICE
000435
TODAYS-DATE
000436
WA-EMP-HIRE-DATE.
000583
CALL 'CWXTSUBC' USING EMP-TYPE,
000584
CALC-SALES,
000585
CALC-COMMISSION.
000656 S
CALL 'CWXTDATE' USING END-OF-MONTH-SW

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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 <>
=====> 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

15-3

15-4

Xpediter/TSO COBOL Training Guide

3. Find the paragraph label for 1000-PROCESS-DATA.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> f 1000-process in para
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 <>
=====> 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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
1 CHARS '1000-PROCESS' FOUND
----+-000347
01 PARMINFO
> ..00003
** END **
-----000373
000374
000375
000376
000377
000378
000379
000380
000381
000382
000383
000384
000385
000386
000387

------------------------------------------ Before CWXTCOB/AMODE 31 <>


***
1000-PROCESS-DATA.
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
ELSE
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE
WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.
***

Altering Program Flow

GOTO

Reposition the current execution pointer of a program.

Primary Command:

GOTO

Examples:

GOTO 365
GOTO 6000-PRINT-EMPLOYEE-REPORT

Line Command:

GT

4. Insert 4 lines after the paragraph label 1000-PROCESS-DATA.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]
SCROLL ===> CSR
1 CHARS '1000-PROCESS' FOUND
----+-000347
01 PARMINFO
> ..00003
** END **
-----000373
i4 74
000375
000376
000377
000378
000379
000380
000381
000382
000383
000384
000385
000386

------------------------------------------ Before CWXTCOB/AMODE 31 <>


***
1000-PROCESS-DATA.
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
ELSE
MOVE ' INVALID EMPLOYEE TYPE ' TO ERROR-LINE
WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.

5. Insert the Xpediter/TSO commands to do the following if WA-EMP-REGION is not = '4':

Suspend program execution


Redirect execution to the perform of the paragraph 8000-READ-INPUT.

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [ENTER]


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+-000347
01 PARMINFO
> ..00003
** END **
-----000373
000374
''''''
''''''
''''''
''''''
000375
000376
000377
000378
000379
000380
000381

------------------------------------------ Before CWXTCOB/AMODE 31 <>


***
1000-PROCESS-DATA.
if wa-emp-region is not = '4'
pause
goto 386
end-if
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT

15-5

15-6

Xpediter/TSO COBOL Training Guide

6. Begin program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
----+-000347
01 PARMINFO
> ..00003
** END **
-----000373
000374
''''''
''''''
''''''
''''''
000375
000376
000377
000378
000379
000380
000381
000382
000383

------------------------------------------ Before CWXTCOB/AMODE 31 <>


***
1000-PROCESS-DATA.
IF WA-EMP-REGION IS NOT = '4'
PAUSE
GOTO 386
END-IF
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
ELSE

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PAUSE REQUESTED BY INSERTED COMMAND
** END **

-----000373
000374
''''''
=====>
''''''
''''''
000375
000376
000377
000378
000379
000380
000381
000382
000383

--------------------------------------- After CWXTCOB:374/AMODE 31 <>


***
1000-PROCESS-DATA.
IF WA-EMP-REGION IS NOT = '4'
PAUSE
GOTO 386
END-IF
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
ELSE

Altering Program Flow

7. Execute one statement.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go 1
SCROLL ===> CSR
PAUSE REQUESTED BY INSERTED COMMAND
** END **

-----000373
000374
''''''
=====>
''''''
''''''
000375
000376
000377
000378
000379
000380
000381
000382
000383

--------------------------------------- After CWXTCOB:374/AMODE 31 <>


***
1000-PROCESS-DATA.
IF WA-EMP-REGION IS NOT = '4'
PAUSE
GOTO 386
END-IF
IF HOURLY
PERFORM 2000-PROCESS-HOURLY
ELSE
IF SALES
PERFORM 3000-PROCESS-SALES
ELSE
IF MANAGEMENT
PERFORM 4000-PROCESS-MANAGEMENT
ELSE

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
** END **

-----000385
=====>
000387
000388
000389
000390
000391
000392
000393
000394
000395
000396
000397
000398
000399

-------------------------------------- Before CWXTCOB:386/AMODE 31 <>


WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.
***
*** CALCULATE TYPE H (HOURLY) EMPLOYEE COMPENSATION. ANY
*** EMPLOYEE WITH MORE THAN 40 HOURS RECEIVES OVERTIME COMPUTED
*** AT 1.5 TIMES THEIR HOURLY RATE. ONCE EMPLOYEE COMPENSATION
*** IS CALCULATED, IT IS STORED IN A HOLD TABLE. THE DATA IN
*** THE HOLD TABLE IS USED FOR PRINTING THE EMPLOYEE COMPENSATION
*** REPORT.
***
2000-PROCESS-HOURLY.
MOVE ZERO TO OT-AMOUNT.
IF WA-EMP-HOURS GREATER THAN 40
COMPUTE EMP-WAGES = WA-EMP-RATE * 40
COMPUTE OT-HOURS = WA-EMP-HOURS - 40

15-7

15-8

Xpediter/TSO COBOL Training Guide

8. Exit the test session.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> exit
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
** END **

-----000385
=====>
000387
000388
000389
000390
000391
000392
000393
000394
000395
000396
000397
000398
000399

-------------------------------------- Before CWXTCOB:386/AMODE 31 <>


WRITE REPORT-RECORD FROM ERROR-LINE.
PERFORM 8000-READ-INPUT.
***
*** CALCULATE TYPE H (HOURLY) EMPLOYEE COMPENSATION. ANY
*** EMPLOYEE WITH MORE THAN 40 HOURS RECEIVES OVERTIME COMPUTED
*** AT 1.5 TIMES THEIR HOURLY RATE. ONCE EMPLOYEE COMPENSATION
*** IS CALCULATED, IT IS STORED IN A HOLD TABLE. THE DATA IN
*** THE HOLD TABLE IS USED FOR PRINTING THE EMPLOYEE COMPENSATION
*** REPORT.
***
2000-PROCESS-HOURLY.
MOVE ZERO TO OT-AMOUNT.
IF WA-EMP-HOURS GREATER THAN 40
COMPUTE EMP-WAGES = WA-EMP-RATE * 40
COMPUTE OT-HOURS = WA-EMP-HOURS - 40

Abend-AID Link

16-1

Chapter 16 Abend-AID Link


Xpediter/TSO has an interface to Abend-AID for Batch. The Abend-AID snapshot report can be requested at any
time during your test session. The report will display information regarding your program and program status, as
well as information on DB2, IMS, VSAM, and IDMS. If your program abends, the report will also contain
diagnostic and analysis information for the abend.
In this chapter you will review the use of Abend-AID for Batch from within an Xpediter/TSO test session.

NOTE:

The Abend-AID link requires Abend-AID for Batch Release 8.0.4 or higher.

16-2

Xpediter/TSO COBOL Training Guide

1. Begin a new test of program CWXTCOB using a parm string of spaces.


Profile: CWXTCOB -----COMMAND ===> [ENTER]

XPEDITER/TSO - STANDARD (2.1)

----------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

To override the parameter string in the execution


JCL, enter a beginning and ending quote in the
PARM field.

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

2. Begin program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
----+-000347
01 PARMINFO
> ..
** 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

Abend-AID Link

3. Display the Abend-AID snapshot report.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> aa snap
SCROLL ===> CSR
S0C7 ABEND ENCOUNTERED, USE "AA SNAP" COMMAND FOR ADDITIONAL INFORMATION
000128
05 EMP-WAGES
> ?????????
INVALID PACKED
000169
10 WA-EMP-HOURS
> 40
DECIMAL
000170
10 WA-EMP-RATE
> ???????
INVALID PACKED
** END **
-----000401
=====>
000403
000404
000405
000406
000407
000408
000409
000410
000411
000412
000413
000414
000415

------------------------------ S0C7 Abend at CWXTCOB:402/AMODE 31 <>


ELSE
COMPUTE EMP-WAGES = WA-EMP-HOURS * WA-EMP-RATE.
COMPUTE EMP-COMPENSATION = EMP-WAGES + OT-AMOUNT.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE
TODAYS-DATE
WA-EMP-HIRE-DATE.
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
SET HOLD-IX UP BY 1.
***
*** CALCULATE TYPE S (SALES) EMPLOYEE COMPENSATION. THE TOTAL
*** SALES FOR THE EMPLOYEE IS PASSED TO THE CALLED PROGRAM WHICH
*** CALCULATES COMMISSION. ONCE EMPLOYEE COMPENSATION IS
*** RETURNED FROM CWXTSUBC, IT IS STORED IN A HOLD-TABLE. THE

------------------------- XPEDITER/TSO - BROWSE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
--------------------------------------- S0C7 Abend at CWXTCOB:402/AMODE 31 ->
SYS04195.T155034.RA000.USERID.R0192605
dd ABENDAID line 000000
******************************** TOP OF DATA **********************************
A B E N D - A I D
A A S N A P
PAGE
1
FRIDAY
19 OCT 2007
H10.02.00 F09/10/2007 R10.02.00
***********************************************************************
*
A b e n d - A I D
D i a g n o s t i c s
*
***********************************************************************
Copyright (C) 1976, 2006, Compuware Corporation. Unpublished.
Rights Reserved Under The Copyright Laws Of The United States.
Licensed for use at: 000001
COMPUWARE CORPORATION
Online Technical Support available at:
JESID
Job
Step
Time

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

Xpediter/TSO COBOL Training Guide

4. Scroll forward for additional diagnostic information.


------------------------- XPEDITER/TSO - BROWSE -----------------------------COMMAND ===> [PF8]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
--------------------------------------- S0C7 Abend at CWXTCOB:402/AMODE 31 ->
SYS04195.T155034.RA000.USERID.R0192605
dd ABENDAID line 000000
******************************** TOP OF DATA **********************************
A B E N D - A I D
A A S N A P
PAGE
1
0 FRIDAY
19 OCT 2007
H10.02.00 F09/10/2007 R10.02.00
***********************************************************************
*
A b e n d - A I D
D i a g n o s t i c s
*
***********************************************************************
Copyright (C) 1976, 2006, Compuware Corporation. Unpublished.
Rights Reserved Under The Copyright Laws Of The United States.
Licensed for use at: 000001
COMPUWARE CORPORATION
Online Technical Support available at:
JESID
Job
Step
Time

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

------------------------- XPEDITER/TSO - BROWSE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB
COMP DATE: 10/16/2007 COMP TIME: 13:02:55
--------------------------------------- S0C7 Abend at CWXTCOB:402/AMODE 31 ->
SYS04195.T155034.RA000.USERID.R0192605
dd ABENDAID line 000021
A data exception, S0C7, occurred during execution of program CWXTCOB.
*******************************************
*
Analysis of Error
*
*******************************************
A Data Exception was caused by data referenced at displacement 332 from
the start of TGT BLW cell 01 (X'0001'). The field contains
X'025C5B'. Refer to the data division map in the program listing to
locate the field name.
The field causing the exception is located in a temporary work field in
the DSA. The actual field in error is in Working-Storage of program
CWXTCOB.
-----------------------------------------------------------------------

Abend-AID Link

5. Return to the source listing screen.


------------------------- XPEDITER/TSO - BROWSE -----------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB
COMP DATE: 10/16/2007 COMP TIME: 13:02:55
--------------------------------------- S0C7 Abend at CWXTCOB:402/AMODE 31 ->
SYS04195.T155034.RA000.USERID.R0192605
dd ABENDAID line 000021
A data exception, S0C7, occurred during execution of program CWXTCOB.
*******************************************
*
Analysis of Error
*
*******************************************
A Data Exception was caused by data referenced at displacement 332 from
the start of TGT BLW cell 01 (X'0001'). The field contains
X'025C5B'. Refer to the data division map in the program listing to
locate the field name.
The field causing the exception is located in a temporary work field in
the DSA. The actual field in error is in Working-Storage of program
CWXTCOB.
------------------------------------------------------------------------

6. Exit the test session.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> exit
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB
COMP DATE: 10/16/2007 COMP TIME: 13:02:55
000128
05 EMP-WAGES
> ?????????
INVALID PACKED
000169
10 WA-EMP-HOURS
> 40
DECIMAL
000170
10 WA-EMP-RATE
> ???????
INVALID PACKED
** END **
-----000401
=====>
000403
000404
000405
000406
000407
000408
000409
000410
000411
000412
000413
000414
000415

------------------------------ S0C7 Abend at CWXTCOB:402/AMODE 31 <>


ELSE
COMPUTE EMP-WAGES = WA-EMP-HOURS * WA-EMP-RATE.
COMPUTE EMP-COMPENSATION = EMP-WAGES + OT-AMOUNT.
ADD EMP-COMPENSATION TO GRAND-TOTAL-EMP.
CALL 'CWXTDATE' USING END-OF-MONTH-SW
YRS-OF-SERVICE
TODAYS-DATE
WA-EMP-HIRE-DATE.
PERFORM 5000-STORE-EMPLOYEE-DETAIL.
SET HOLD-IX UP BY 1.
***
*** CALCULATE TYPE S (SALES) EMPLOYEE COMPENSATION. THE TOTAL
*** SALES FOR THE EMPLOYEE IS PASSED TO THE CALLED PROGRAM WHICH
*** CALCULATES COMMISSION. ONCE EMPLOYEE COMPENSATION IS
*** RETURNED FROM CWXTSUBC, IT IS STORED IN A HOLD-TABLE. THE

16-5

16-6

Xpediter/TSO COBOL Training Guide

Sourceless Debugging

17-1

Chapter 17 Sourceless Debugging


Xpediter/TSO allows you to debug programs if you do not have source code available or if the program has not
been compiled for Xpediter.
The following commands are covered:
MEMORY

View and optionally modify storage.

AT

Set a breakpoint in a program that has not been compiled for Xpediter.

GPREGS

Display and optionally modify the general purpose registers.

SHOW AT

Display all breakpoints set by the AT command.

In this chapter you will do the following:

Gain control of a program that does not have a Compuware source listing.

Display the information available when no source listing file exists.

NOTE:

In order to execute the example in this module, CWXTSUBC must not be present in the
DDIO file.

17-2

Xpediter/TSO COBOL Training Guide

1. Begin a new test of program CWXTCOB using a parm string of 00003.


Profile: CWXTCOB -----COMMAND ===> [ENTER]

XPEDITER/TSO - STANDARD (2.1)

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> CWXTCOB
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES)

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

If the PARM field is left blank, the


parameter string from your execution
JCL will be passed to your program.

===>
===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

EDIT ---- USERID.XPEDITER.SAMPLIB(CWXTJCLC) - 01.08 -- COLUMNS 001 072


COMMAND ===>
SCROLL ===> CSR
****** ***************************** TOP OF DATA ****************************
000001 //USERIDX JOB (ACCT#),'NAME',CLASS=A,
000002 // MSGCLASS=X,NOTIFY=USERID
000003 //*
000004 //*
EXECUTE CWXTCOB IN BATCH
000005 //*
000006 //CWXTCOB EXEC PGM=CWXTCOB,PARM=00003
000007 //STEPLIB DD
DSN=USERID.LOAD,DISP=SHR
000008 //
DD
DSN=SYS1.COB2LIB,DISP=SHR
000009 //EMPFILE DD
DSN=USERID.XPEDITER.SAMPLIB(CWXTDATA),DISP=SHR
000010 //RPTFILE DD
SYSOUT=X
000011 //SYSOUT
DD
SYSOUT=X
000012 //
****** **************************** BOTTOM OF DATA **************************

Sourceless Debugging

MEMORY

Display and optionally modify storage.

Primary Commands:

MEMORY, MEM

Examples:

MEM CWXTSUBC:
MEMORY C75C8
MEMORY +D0
MEMORY R3%+F0

Line Command:

17-3

17-4

Xpediter/TSO COBOL Training Guide

2. Display the storage area for module CWXTSUBC.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> mem cwxtsubc:
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

------------------------- XPEDITER/TSO - MEMORY -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
--------------------------------------------------- Before CWXTCOB/AMODE 31 -BASE = 365276E8 0 - 2 4 - 6 8 - A C - E = 0-2-4-6-8-A-C-E******************************** TOP OF DATA **********************************
000000 ===> 47F0F028
00C3C5C5
00000110
00000014 = .00..CEE........
000010 ===> 47F0F001
98CEAC00
3652779E
00000000 = .00.............
000020 ===> 00000000
00000000
90ECD00C
4110F038 = ..........}...0.
000030 ===> 98EFF04C
07FF0000
365276E8
00000000 = ..0<.......Y....
000040 ===> 36527DE0
36527796
365276E8
36527A10 = ..'\.......Y..:.
000050 ===> 36526B90
365277B2
00104001
00000008 = ..,....... .....
000060 ===> C3E6E7E3
E2E4C2C3
F2F0F0F4
F1F1F1F0 = CWXTSUBC20041110
000070 ===> F1F2F3F0
F0F1F0F3
F0F1F0F1
04740000 = 123001030101....
000080 ===> 0000076C
A0687C4C
20000000
00800109 = ...%..@<........
000090 ===> 01000000
08000000
00000400
00000017 = ................
0000A0 ===> 0000001B
00008000
40404040
0008C3E6 = ........
..CW
0000B0 ===> E7E3E2E4
C2C30500
00013652
6AE00000 = XTSUBC......\..
0000C0 ===> 0000FFFF
FFB23652
76E83652
77200000 = .........Y......
0000D0 ===> 00080000
00063652
77203652
6AE03652 = ............\..
0000E0 ===> 6AB80000
00050000
00000000
00000000 = ...............
0000F0 ===> 00000000
00000000
00000000
00000001 = ................
000100 ===> 40404040
40404040
40404040
40404040 =
000110 ===> 40404040
40404040
40404040
40400000 =
..

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

3. Gain control at the entry point of CWXTSUBC.


------------------------- XPEDITER/TSO - MEMORY -----------------------------COMMAND ===> at cwxtsubc:+0
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
--------------------------------------------------- Before CWXTCOB/AMODE 31 -BASE = 365276E8 0 - 2 4 - 6 8 - A C - E = 0-2-4-6-8-A-C-E******************************** TOP OF DATA **********************************
000000 ===> 47F0F028
00C3C5C5
00000110
00000014 = .00..CEE........
000010 ===> 47F0F001
98CEAC00
3652779E
00000000 = .00.............
000020 ===> 00000000
00000000
4110F038 = ..........}...0.
This is where90ECD00C
the
000030 ===> 98EFF04C
07FF0000
365276E8
00000000 = ..0<.......Y....
breakpoint will
be set.
000040 ===> 36527DE0
36527796
365276E8
36527A10 = ..'\.......Y..:.
000050 ===> 36526B90
365277B2
00104001
00000008 = ..,....... .....
000060 ===> C3E6E7E3
E2E4C2C3
F2F0F0F4
F1F1F1F0 = CWXTSUBC20041110
000070 ===> F1F2F3F0
F0F1F0F3
F0F1F0F1
04740000 = 123001030101....
000080 ===> 0000076C
A0687C4C
20000000
00800109 = ...%..@<........
000090 ===> 01000000
08000000
00000400
00000017 = ................
0000A0 ===> 0000001B
00008000
40404040
0008C3E6 = ........
..CW
0000B0 ===> E7E3E2E4
C2C30500
00013652
6AE00000 = XTSUBC......\..
0000C0 ===> 0000FFFF
FFB23652
76E83652
77200000 = .........Y......
0000D0 ===> 00080000
00063652
77203652
6AE03652 = ............\..
0000E0 ===> 6AB80000
00050000
00000000
00000000 = ...............
0000F0 ===> 00000000
00000000
00000000
00000001 = ................
000100 ===> 40404040
40404040
40404040
40404040 =
000110 ===> 40404040
40404040
40404040
40400000 =
..

------------------------- XPEDITER/TSO - MEMORY -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
--------------------------------------------------- Before CWXTCOB/AMODE 31 -BASE = 365276E8 0 - 2 4 - 6 8 - A C - E = 0-2-4-6-8-A-C-E******************************** TOP OF DATA **********************************
000000 ===> 00F0F028
00C3C5C5
00000110
00000014 = .00..CEE........
000010 ===> 47F0F001
98CEAC00
3652779E
00000000 = .00.............
000020 ===> 00000000
00000000
90ECD00C
4110F038 = ..........}...0.
000030 ===> 98EFF04C
07FF0000
365276E8
00000000 = ..0<.......Y....
000040 ===> 36527DE0
36527796
365276E8
36527A10 = ..'\.......Y..:.
The breakpoint has
000050 ===> 36526B90
365277B2
00104001
00000008 = ..,....... .....
been set.
000060 ===> C3E6E7E3
E2E4C2C3
F2F0F0F4
F1F1F1F0 = CWXTSUBC20041110
000070 ===> F1F2F3F0
F0F1F0F3
F0F1F0F1
04740000 = 123001030101....
000080 ===> 0000076C
A0687C4C
20000000
00800109 = ...%..@<........
000090 ===> 01000000
08000000
00000400
00000017 = ................
0000A0 ===> 0000001B
00008000
40404040
0008C3E6 = ........
..CW
0000B0 ===> E7E3E2E4
C2C30500
00013652
6AE00000 = XTSUBC......\..
0000C0 ===> 0000FFFF
FFB23652
76E83652
77200000 = .........Y......
0000D0 ===> 00080000
00063652
77203652
6AE03652 = ............\..
0000E0 ===> 6AB80000
00050000
00000000
00000000 = ...............
0000F0 ===> 00000000
00000000
00000000
00000001 = ................
000100 ===> 40404040
40404040
40404040
40404040 =
000110 ===> 40404040
40404040
40404040
40400000 =
..

17-5

17-6

Xpediter/TSO COBOL Training Guide

4. Begin execution of program CWXTCOB.


------------------------- XPEDITER/TSO - MEMORY -----------------------------COMMAND ===> go
SCROLL ===> CSR
PROGRAM: CWXTCOB
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:55
--------------------------------------------------- Before CWXTCOB/AMODE 31 -BASE = 365276E8 0 - 2 4 - 6 8 - A C - E = 0-2-4-6-8-A-C-E******************************** TOP OF DATA **********************************
000000 ===> 00F0F028
00C3C5C5
00000110
00000014 = .00..CEE........
000010 ===> 47F0F001
98CEAC00
3652779E
00000000 = .00.............
000020 ===> 00000000
00000000
90ECD00C
4110F038 = ..........}...0.
000030 ===> 98EFF04C
07FF0000
365276E8
00000000 = ..0<.......Y....
000040 ===> 36527DE0
36527796
365276E8
36527A10 = ..'\.......Y..:.
000050 ===> 36526B90
365277B2
00104001
00000008 = ..,....... .....
000060 ===> C3E6E7E3
E2E4C2C3
F2F0F0F4
F1F1F1F0 = CWXTSUBC20041110
000070 ===> F1F2F3F0
F0F1F0F3
F0F1F0F1
04740000 = 123001030101....
000080 ===> 0000076C
A0687C4C
20000000
00800109 = ...%..@<........
000090 ===> 01000000
08000000
00000400
00000017 = ................
0000A0 ===> 0000001B
00008000
40404040
0008C3E6 = ........
..CW
0000B0 ===> E7E3E2E4
C2C30500
00013652
6AE00000 = XTSUBC......\..
0000C0 ===> 0000FFFF
FFB23652
76E83652
77200000 = .........Y......
0000D0 ===> 00080000
00063652
77203652
6AE03652 = ............\..
0000E0 ===> 6AB80000
00050000
00000000
00000000 = ...............
0000F0 ===> 00000000
00000000
00000000
00000001 = ................
000100 ===> 40404040
40404040
40404040
40404040 =
000110 ===> 40404040
40404040
40404040
40400000 =
..

------------------------- XPEDITER/TSO - AT DISPLAY -------------------------COMMAND ===>


SCROLL ===> CSR
AT ADDRESS 365276E8 : 47F0F028
: B 40(,15)
-------------------------------------------------- Before CWXTSUBC/AMODE 31 -BASE = 365276E8 0 - 2 4 - 6 8 - A C - E = 0-2-4-6-8-A-C-E******************************** TOP OF DATA **********************************
000000 ===> 00F0F028
00C3C5C5
00000110
00000014 = .00..CEE........
000010 ===> 47F0F001
98CEAC00
3652779E
00000000 = .00.............
000020 ===> 00000000
00000000
90ECD00C
4110F038 = ..........}...0.
000030 ===> 98EFF04C
07FF0000
365276E8
00000000 = ..0<.......Y....
000040 ===> 36527DE0
36527796
365276E8
0011C9A8 = ..'\.......Y..I.
000050 ===> 36526B90
365277B2
00104001
00000008 = ..,....... .....
000060 ===> C3E6E7E3
E2E4C2C3
F2F0F0F4
F1F1F1F0 = CWXTSUBC20041110
000070 ===> F1F2F3F0
F0F1F0F3
F0F1F0F1
04740000 = 123001030101....
000080 ===> 0000076C
A0687C4C
20000000
00800109 = ...%..@<........
000090 ===> 01000000
08000000
00000400
00000017 = ................
0000A0 ===> 0000001B
00008000
40404040
0008C3E6 = ........
..CW
0000B0 ===> E7E3E2E4
C2C30500
00013652
6AE00000 = XTSUBC......\..
0000C0 ===> 0000FFFF
FFB23652
76E83652
77200000 = .........Y......
0000D0 ===> 00080000
00063652
77203652
6AE03652 = ............\..
0000E0 ===> 6AB80000
00050000
00000000
00000000 = ...............
0000F0 ===> 00000000
00000000
00000000
00000001 = ................
000100 ===> 40404040
40404040
40404040
40404040 =
000110 ===> 40404040
40404040
40404040
40400000 =
..

Sourceless Debugging

GPREGS

Display and optionally modify the contents of the general purpose registers.

Primary Command:

GPREGS

Example:

GPREGS OFF

5. Display the general purpose registers.


------------------------- XPEDITER/TSO - AT DISPLAY -------------------------COMMAND ===> gpregs
SCROLL ===> CSR
AT ADDRESS 365276E8 : 47F0F028
: B 40(,15)
-------------------------------------------------- Before CWXTSUBC/AMODE 31 -BASE = 365276E8 0 - 2 4 - 6 8 - A C - E = 0-2-4-6-8-A-C-E******************************** TOP OF DATA **********************************
000000 ===> 00F0F028
00C3C5C5
00000110
00000014 = .00..CEE........
000010 ===> 47F0F001
98CEAC00
3652779E
00000000 = .00.............
000020 ===> 00000000
00000000
90ECD00C
4110F038 = ..........}...0.
000030 ===> 98EFF04C
07FF0000
365276E8
00000000 = ..0<.......Y....
000040 ===> 36527DE0
36527796
365276E8
0011C9A8 = ..'\.......Y..I.
000050 ===> 36526B90
365277B2
00104001
00000008 = ..,....... .....
000060 ===> C3E6E7E3
E2E4C2C3
F2F0F0F4
F1F1F1F0 = CWXTSUBC20041110
000070 ===> F1F2F3F0
F0F1F0F3
F0F1F0F1
04740000 = 123001030101....
000080 ===> 0000076C
A0687C4C
20000000
00800109 = ...%..@<........
000090 ===> 01000000
08000000
00000400
00000017 = ................
0000A0 ===> 0000001B
00008000
40404040
0008C3E6 = ........
..CW
0000B0 ===> E7E3E2E4
C2C30500
00013652
6AE00000 = XTSUBC......\..
0000C0 ===> 0000FFFF
FFB23652
76E83652
77200000 = .........Y......
0000D0 ===> 00080000
00063652
77203652
6AE03652 = ............\..
0000E0 ===> 6AB80000
00050000
00000000
00000000 = ...............
0000F0 ===> 00000000
00000000
00000000
00000001 = ................
000100 ===> 40404040
40404040
40404040
40404040 =
000110 ===> 40404040
40404040
40404040
40400000 =
..

------------------------- XPEDITER/TSO - AT DISPLAY -------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
-------------------------------------------------- Before CWXTSUBC/AMODE 31 -BASE = 365276E8 0 - 2 4 - 6 8 - A C - E - = 0-2-4-6-8-A-C-E******************************** TOP OF DATA **********************************
000000 ===> 00F0F028
00C3C5C5
00000110
00000014 = .00..CEE........
000010 ===> 47F0F001
98CEAC00
3652779E
00000000 = .00.............
000020 ===> 00000000
00000000
90ECD00C
4110F038 = ..........}...0.
000030 ===> 98EFF04C
07FF0000
365276E8
00000000 = ..0<.......Y....
000040 ===> 36527DE0
36527796
365276E8
0011C9A8 = ..'\.......Y..I.
000050 ===> 36526B90
365277B2
00104001
00000008 = ..,....... .....
000060 ===> C3E6E7E3
E2E4C2C3
F2F0F0F4
F1F1F1F0 = CWXTSUBC20041110
000070 ===> F1F2F3F0
F0F1F0F3
F0F1F0F1
04740000 = 123001030101....
000080 ===> 0000076C
A0687C4C
20000000
00800109 = ...%..@<........
000090 ===> 01000000
08000000
00000400
00000017 = ................
0000A0 ===> 0000001B
00008000
40404040
0008C3E6 = ........
..CW
0000B0 ===> E7E3E2E4
C2C30500
00013652
6AE00000 = XTSUBC......\..
0000C0 ===> 0000FFFF
FFB23652
76E83652
77200000 = .........Y......
0000D0 ===> 00080000
00063652
77203652
6AE03652 = ............\..
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0110
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-7

17-8

Xpediter/TSO COBOL Training Guide

SHOW AT

Display all breakpoints set by the AT command.

Primary Command:

SHOW AT, SH AT

6. Display all breakpoints set in CWXTSUBC.


------------------------- XPEDITER/TSO - AT DISPLAY -------------------------COMMAND ===> show at
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
-------------------------------------------------- Before CWXTSUBC/AMODE 31 -BASE = 365276E8 0 - 2 4 - 6 8 - A C - E - = 0-2-4-6-8-A-C-E******************************** TOP OF DATA **********************************
000000 ===> 00F0F028
00C3C5C5
00000110
00000014 = .00..CEE........
000010 ===> 47F0F001
98CEAC00
3652779E
00000000 = .00.............
000020 ===> 00000000
00000000
90ECD00C
4110F038 = ..........}...0.
000030 ===> 98EFF04C
07FF0000
365276E8
00000000 = ..0<.......Y....
000040 ===> 36527DE0
36527796
365276E8
0011C9A8 = ..'\.......Y..I.
000050 ===> 36526B90
365277B2
00104001
00000008 = ..,....... .....
000060 ===> C3E6E7E3
E2E4C2C3
F2F0F0F4
F1F1F1F0 = CWXTSUBC20041110
000070 ===> F1F2F3F0
F0F1F0F3
F0F1F0F1
04740000 = 123001030101....
000080 ===> 0000076C
A0687C4C
20000000
00800109 = ...%..@<........
000090 ===> 01000000
08000000
00000400
00000017 = ................
0000A0 ===> 0000001B
00008000
40404040
0008C3E6 = ........
..CW
0000B0 ===> E7E3E2E4
C2C30500
00013652
6AE00000 = XTSUBC......\..
0000C0 ===> 0000FFFF
FFB23652
76E83652
77200000 = .........Y......
0000D0 ===> 00080000
00063652
77203652
6AE03652 = ............\..
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0110
R4 ==> 367CC2C0 R5 ==> B65257F0 R6 ==> 367D0039 R7 ==> 367D0110
R8 ==> 367D1110 R9 ==> 367CC100 R10 ==> 36523D58 R11 ==> 365242F8
R12 ==> 0014AA58 R13 ==> 00150018 R14 ==> 800D4BCC R15 ==> 365276E8

------------------------- XPEDITER/TSO - SHOW -------------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
-------------------------------------------------- Before CWXTSUBC/AMODE 31 ->
********************************* TOP OF DATA **********************************
MODULE

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

7. Return to the Memory Display screen.


------------------------- XPEDITER/TSO - SHOW -------------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
-------------------------------------------------- Before CWXTSUBC/AMODE 31 ->
********************************* TOP OF DATA **********************************
MODULE

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

------------------------- XPEDITER/TSO - AT DISPLAY -------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
-------------------------------------------------- Before CWXTSUBC/AMODE 31
BASE = 365276E8 0 - 2 4 - 6 8 - A C - E = 0-2-4-6-8-A-C-E******************************** TOP OF DATA **********************************
000000 ===> 00F0F028
00C3C5C5
00000110
00000014 = .00..CEE........
000010 ===> 47F0F001
98CEAC00
3652779E
00000000 = .00.............
000020 ===> 00000000
00000000
90ECD00C
4110F038 = ..........}...0.
000030 ===> 98EFF04C
07FF0000
365276E8
00000000 = ..0<.......Y....
000040 ===> 36527DE0
36527796
365276E8
0011C9A8 = ..'\.......Y..I.
000050 ===> 36526B90
365277B2
00104001
00000008 = ..,....... .....
000060 ===> C3E6E7E3
E2E4C2C3
F2F0F0F4
F1F1F1F0 = CWXTSUBC20041110
000070 ===> F1F2F3F0
F0F1F0F3
F0F1F0F1
04740000 = 123001030101....
000080 ===> 0000076C
A0687C4C
20000000
00800109 = ...%..@<........
000090 ===> 01000000
08000000
00000400
00000017 = ................
0000A0 ===> 0000001B
00008000
40404040
0008C3E6 = ........
..CW
0000B0 ===> E7E3E2E4
C2C30500
00013652
6AE00000 = XTSUBC......\..
0000C0 ===> 0000FFFF
FFB23652
76E83652
77200000 = .........Y......
0000D0 ===> 00080000
00063652
77203652
6AE03652 = ............\..
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0110
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-9

17-10

Xpediter/TSO COBOL Training Guide

8. Delete the breakpoint on the entry point of CWXTSUBC.


------------------------- XPEDITER/TSO - AT DISPLAY -------------------------COMMAND ===> delete at+0
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
-------------------------------------------------- Before CWXTSUBC/AMODE 31 -BASE = 365276E8 0 - 2 4 - 6 8 - A C - E = 0-2-4-6-8-A-C-E******************************** TOP OF DATA **********************************
000000 ===> 00F0F028
00C3C5C5
00000110
00000014 = .00..CEE........
000010 ===> 47F0F001
98CEAC00
3652779E
00000000 = .00.............
000020 ===> 00000000
00000000
90ECD00C
4110F038 = ..........}...0.
This is the location
000030 ===> 98EFF04C
07FF0000
365276E8
00000000 = ..0<.......Y....
of the breakpoint.
000040 ===> 36527DE0
36527796
365276E8
0011C9A8 = ..'\.......Y..I.
000050 ===> 36526B90
365277B2
00104001
00000008 = ..,....... .....
000060 ===> C3E6E7E3
E2E4C2C3
F2F0F0F4
F1F1F1F0 = CWXTSUBC20041110
000070 ===> F1F2F3F0
F0F1F0F3
F0F1F0F1
04740000 = 123001030101....
000080 ===> 0000076C
A0687C4C
20000000
00800109 = ...%..@<........
000090 ===> 01000000
08000000
00000400
00000017 = ................
0000A0 ===> 0000001B
00008000
40404040
0008C3E6 = ........
..CW
0000B0 ===> E7E3E2E4
C2C30500
00013652
6AE00000 = XTSUBC......\..
0000C0 ===> 0000FFFF
FFB23652
76E83652
77200000 = .........Y......
0000D0 ===> 00080000
00063652
77203652
6AE03652 = ............\..
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0110
R4 ==> 367CC2C0 R5 ==> B65257F0 R6 ==> 367D0039 R7 ==> 367D0110
R8 ==> 367D1110 R9 ==> 367CC100 R10 ==> 36523D58 R11 ==> 365242F8
R12 ==> 0014AA58 R13 ==> 00150018 R14 ==> 800D4BCC R15 ==> 365276E8

------------------------- XPEDITER/TSO - AT DISPLAY -------------------------COMMAND ===>


SCROLL ===> CSR
DELETE COMMAND PROCESSED
-------------------------------------------------- Before CWXTSUBC/AMODE 31 -BASE = 365276E8 0 - 2 4 - 6 8 - A C - E = 0-2-4-6-8-A-C-E******************************** TOP OF DATA **********************************
000000 ===> 47F0F028
00C3C5C5
00000110
00000014 = .00..CEE........
000010 ===> 47F0F001
98CEAC00
3652779E
00000000 = .00.............
000020 ===> 00000000
00000000
90ECD00C
4110F038 = ..........}...0.
The breakpoint has
000030 ===> 98EFF04C
07FF0000
365276E8
00000000 = ..0<.......Y....
been deleted.
000040 ===> 36527DE0
36527796
365276E8
0011C9A8 = ..'\.......Y..I.
000050 ===> 36526B90
365277B2
00104001
00000008 = ..,....... .....
000060 ===> C3E6E7E3
E2E4C2C3
F2F0F0F4
F1F1F1F0 = CWXTSUBC20041110
000070 ===> F1F2F3F0
F0F1F0F3
F0F1F0F1
04740000 = 123001030101....
000080 ===> 0000076C
A0687C4C
20000000
00800109 = ...%..@<........
000090 ===> 01000000
08000000
00000400
00000017 = ................
0000A0 ===> 0000001B
00008000
40404040
0008C3E6 = ........
..CW
0000B0 ===> E7E3E2E4
C2C30500
00013652
6AE00000 = XTSUBC......\..
0000C0 ===> 0000FFFF
FFB23652
76E83652
77200000 = .........Y......
0000D0 ===> 00080000
00063652
77203652
6AE03652 = ............\..
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0110
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

17-11

Enhanced Sourceless Debugging

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

The following commands are covered:


BEFORE

Stop execution before a line of code is executed.

GO

Initiate execution of the program until a breakpoint is reached, an abend is detected, or


the program ends.

GO 1

Execute one statement and stop.

GO n

Execute n statements and stop.

GO n TRACE

Highlight each statement as it is executed.

GO HALF

Execute a half step and stop.

KEEP

Continuously display variable contents in a KEEP window.

SHOW WHEN

Display all WHEN commands currently in effect.

WHEN

Suspend execution when the value of a variable changes or when a


condition is met.

17-12

Xpediter/TSO COBOL Training Guide

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

9. Enter the command to generate a pseudo-assembler view of the program CWXTSUBC.


------------------------- XPEDITER/TSO - AT DISPLAY -------------------------COMMAND ===> ps cwxtsubc
SCROLL ===> CSR
DELETE COMMAND PROCESSED
-------------------------------------------------- Before CWXTSUBC/AMODE 31 -BASE = 365276E8 0 - 2 4 - 6 8 - A C - E = 0-2-4-6-8-A-C-E******************************** TOP OF DATA **********************************
000000 ===> 47F0F028
00C3C5C5
00000110
00000014 = .00..CEE........
000010 ===> 47F0F001
98CEAC00
3652779E
00000000 = .00.............
000020 ===> 00000000
00000000
90ECD00C
4110F038 = ..........}...0.
000030 ===> 98EFF04C
07FF0000
365276E8
00000000 = ..0<.......Y....
000040 ===> 36527DE0
36527796
365276E8
0011C9A8 = ..'\.......Y..I.
000050 ===> 36526B90
365277B2
00104001
00000008 = ..,....... .....
000060 ===> C3E6E7E3
E2E4C2C3
F2F0F0F4
F1F1F1F0 = CWXTSUBC20041110
000070 ===> F1F2F3F0
F0F1F0F3
F0F1F0F1
04740000 = 123001030101....
000080 ===> 0000076C
A0687C4C
20000000
00800109 = ...%..@<........
000090 ===> 01000000
08000000
00000400
00000017 = ................
0000A0 ===> 0000001B
00008000
40404040
0008C3E6 = ........
..CW
0000B0 ===> E7E3E2E4
C2C30500
00013652
6AE00000 = XTSUBC......\..
0000C0 ===> 0000FFFF
FFB23652
76E83652
77200000 = .........Y......
0000D0 ===> 00080000
00063652
77203652
6AE03652 = ............\..
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0110
R4 ==> 367CC2C0 R5 ==> B65257F0 R6 ==> 367D0039 R7 ==> 367D0110
R8 ==> 367D1110 R9 ==> 367CC100 R10 ==> 36523D58 R11 ==> 365242F8
R12 ==> 0014AA58 R13 ==> 00150018 R14 ==> 800D4BCC R15 ==> 365276E8

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
** END **

---------------------------------------------- Before CWXTSUBC/AMODE 31 ->


******************************** TOP OF MODULE ********************************
000002
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 ==> 367D0110
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-13

17-14

Xpediter/TSO COBOL Training Guide

10. Enter the command to find all Load Register instructions.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> f lr all x nol
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
** END **

---------------------------------------------- Before CWXTSUBC/AMODE 31 ->


******************************** TOP OF MODULE ********************************
000002
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 ==> 367D0110
R4 ==> 367CC2C0 R5 ==> B65257F0 R6 ==> 367D0039 R7 ==> 367D0110
R8 ==> 367D1110 R9 ==> 367CC100 R10 ==> 36523D58 R11 ==> 365242F8
R12 ==> 0014AA58 R13 ==> 00150018 R14 ==> 800D4BCC R15 ==> 365276E8

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
12 CHARS 'LR' FOUND
** END **

---------------------------------------------- Before CWXTSUBC/AMODE 31 ->


000108
183F
LR
R3,R15
*..*
000111
05F0
BALR R15,R0
*.0*
000114
05EF
BALR R14,R15
*..*
000115
181F
LR
R1,R15
*..*
000121
18D1
LR
R13,R1
*.J*
000123
1812
LR
R1,R2
*..*
000132
1862
LR
R6,R2
*..*
000136
1872
LR
R7,R2
*..*
000147
05EF
BALR R14,R15
*..*
000307
05EF
BALR R14,R15
*..*
000326
05EF
BALR R14,R15
*..*
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0110
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

BEFORE

Set a breakpoint to stop program execution before a line of code is executed.

Primary Command:

BEFORE, BEF, B

Examples:

B 338
BEFORE CWXTSUBC:

Line Command:

11. Set a before breakpoint on the statement LR R6,R2.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> b 132
SCROLL ===> CSR
12 CHARS 'LR' FOUND
** END **

---------------------------------------------- Before CWXTSUBC/AMODE 31 ->


000108
183F
LR
R3,R15
*..*
000111
05F0
BALR R15,R0
*.0*
000114
05EF
BALR R14,R15
*..*
000115
181F
LR
R1,R15
*..*
000121
18D1
LR
R13,R1
*.J*
000123
1812
LR
R1,R2
*..*
000132
1862
LR
R6,R2
*..*
000136
1872
LR
R7,R2
*..*
000147
05EF
BALR R14,R15
*..*
000307
05EF
BALR R14,R15
*..*
000326
05EF
BALR R14,R15
*..*
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0110
R4 ==> 367CC2C0 R5 ==> B65257F0 R6 ==> 367D0039 R7 ==> 367D0110
R8 ==> 367D1110 R9 ==> 367CC100 R10 ==> 36523D58 R11 ==> 365242F8
R12 ==> 0014AA58 R13 ==> 00150018 R14 ==> 800D4BCC R15 ==> 365276E8

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
1 COMMAND(S) COMPLETED
** END **

---------------------------------------------- Before CWXTSUBC/AMODE 31 ->


000108
183F
LR
R3,R15
*..*
000111
05F0
BALR R15,R0
*.0*
000114
05EF
BALR R14,R15
*..*
000115
181F
LR
R1,R15
*..*
000121
18D1
LR
R13,R1
*.J*
000123
1812
LR
R1,R2
*..*
000132 B 1862
LR
R6,R2
*..*
000136
1872
LR
R7,R2
*..*
000147
05EF
BALR R14,R15
*..*
000307
05EF
BALR R14,R15
*..*
000326
05EF
BALR R14,R15
*..*
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0110
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-15

17-16

Xpediter/TSO COBOL Training Guide

12. Return to the source listing screen.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
1 COMMAND(S) COMPLETED
** END **

---------------------------------------------- Before CWXTSUBC/AMODE 31 ->


000108
183F
LR
R3,R15
*..*
000111
05F0
BALR R15,R0
*.0*
000114
05EF
BALR R14,R15
*..*
000115
181F
LR
R1,R15
*..*
000121
18D1
LR
R13,R1
*.J*
000123
1812
LR
R1,R2
*..*
000132 B 1862
LR
R6,R2
*..*
000136
1872
LR
R7,R2
*..*
000147
05EF
BALR R14,R15
*..*
000307
05EF
BALR R14,R15
*..*
000326
05EF
BALR R14,R15
*..*
GPREGS R0 ==> 367CC248 R1 ==> 001501C8 R2 ==> 367D13D9 R3 ==> 367D0110
R4 ==> 367CC2C0 R5 ==> B65257F0 R6 ==> 367D0039 R7 ==> 367D0110
R8 ==> 367D1110 R9 ==> 367CC100 R10 ==> 36523D58 R11 ==> 365242F8
R12 ==> 0014AA58 R13 ==> 00150018 R14 ==> 800D4BCC R15 ==> 365276E8

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
** END **

---------------------------------------------- Before CWXTSUBC/AMODE 31 ->


******************************** TOP OF MODULE ********************************
000002
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 ==> 367D0110
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

Begin or resume execution of your program. GO can also be issued by pressing [PF12] or [PF24].

Primary Command:

GO

13. Enter the command to resume program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF12]
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
** END **

---------------------------------------------- Before CWXTSUBC/AMODE 31 ->


******************************** TOP OF MODULE ********************************
000002
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 ==> 367D0110
R4 ==> 367CC2C0 R5 ==> B65257F0 R6 ==> 367D0039 R7 ==> 367D0110
R8 ==> 367D1110 R9 ==> 367CC100 R10 ==> 36523D58 R11 ==> 365242F8
R12 ==> 0014AA58 R13 ==> 00150018 R14 ==> 800D4BCC R15 ==> 365276E8

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
** END **

------------------------------------------ Before 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 ==> 00000000 R7 ==> 00000000
R8 ==> 367D1950 R9 ==> 367CCC38 R10 ==> 36527810 R11 ==> 36526B90
R12 ==> 365277E4 R13 ==> 00150200 R14 ==> 36527A10 R15 ==> B6527A1C

17-17

17-18

Xpediter/TSO COBOL Training Guide

KEEP

Continuously display the contents of program variables in a KEEP window.

Primary Commands:

KEEP, K

Examples:

KEEP Rn
K address

14. Enter the command to permanently display the contents of R6.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> K R6
SCROLL ===> CSR
BEFORE BREAKPOINT ENCOUNTERED
** END **

------------------------------------------ Before 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 ==> 00000000 R7 ==> 00000000
R8 ==> 367D1950 R9 ==> 367CCC38 R10 ==> 36527810 R11 ==> 36526B90
R12 ==> 365277E4 R13 ==> 00150200 R14 ==> 36527A10 R15 ==> B6527A1C

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
SYSTEM K

R6
** END **

> 00000000

------------------------------------------ Before 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 ==> 00000000 R7 ==> 00000000
R8 ==> 367D1950 R9 ==> 367CCC38 R10 ==> 36527810 R11 ==> 36526B90
R12 ==> 365277E4 R13 ==> 00150200 R14 ==> 36527A10 R15 ==> B6527A1C

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

------------------------------------------ Before 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 ==> 00000000 R7 ==> 00000000
R8 ==> 367D1950 R9 ==> 367CCC38 R10 ==> 36527810 R11 ==> 36526B90
R12 ==> 365277E4 R13 ==> 00150200 R14 ==> 36527A10 R15 ==> B6527A1C

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
NEXT LOGICAL INSTRUCTION IS CWXTSUBC:133
SYSTEM K

R6
** END **

> 367D13D0

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

17-20

Xpediter/TSO COBOL Training Guide

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

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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
SYSTEM K
MEMORY K

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

Stop execution when a program variable changes value or when a specified


condition is true.

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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
WHEN 367d13d0 l (9) > 'S07000000'
SYSTEM K
MEMORY K

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

Xpediter/TSO COBOL Training Guide

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

------------------------- XPEDITER/TSO - SHOW WHEN --------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
-------------------------------------------------- Before CWXTSUBC/AMODE 31 -DEL
ACTIVE WHEN CONDITIONS
PROGRAM
--- --------------------------------------------------------------- -------367d13d0 l (9) > 'S07000000'
CWXTSUBC
******************************* 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

==>
==>
==>
==>

367D0182
367D0110
365242F8
365276E8

Sourceless Debugging

19. Enter the command to delete the WHEN condition.


------------------------- XPEDITER/TSO - SHOW WHEN --------------------------COMMAND ===>
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
-------------------------------------------------- Before CWXTSUBC/AMODE 31 -DEL
ACTIVE WHEN CONDITIONS
PROGRAM
--- --------------------------------------------------------------- -------d
367d13d0 l (9) > 'S07000000'
CWXTSUBC
******************************* 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

==>
==>
==>
==>

367D0182
367D0110
365242F8
365276E8

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
DELETE COMMAND PROCESSED
-------------------------------------------------- Before CWXTSUBC/AMODE 31 -DEL
ACTIVE WHEN CONDITIONS
PROGRAM
--- --------------------------------------------------------------- -------*** NO WHEN REQUESTS IN EFFECT ***
******************************* 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

==>
==>
==>
==>

367D0182
367D0110
365242F8
365276E8

17-23

17-24

Xpediter/TSO COBOL Training Guide

20. Return to the source display.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> [PF3]
SCROLL ===> CSR
DELETE COMMAND PROCESSED
-------------------------------------------------- Before CWXTSUBC/AMODE 31 -DEL
ACTIVE WHEN CONDITIONS
PROGRAM
--- --------------------------------------------------------------- -------*** NO WHEN REQUESTS IN EFFECT ***
******************************* 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

==>
==>
==>
==>

367D0182
367D0110
365242F8
365276E8

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
SYSTEM K
MEMORY K

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

Execute n statement(s) and stop. GO 1 can be issued by pressing [PF9] or [PF21].

Primary Command:

GO n

21. Enter the command to execute 50 statements.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go 50
SCROLL ===> CSR
PROGRAM: CWXTSUBC
MODULE: CWXTCOB COMP DATE: 10/16/2007 COMP TIME:13:02:50
SYSTEM K

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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

17-25

17-26

Xpediter/TSO COBOL Training Guide

GO n TRACE

Highlight the execution flow of statements or paragraphs in your program.

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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
10 STATEMENTS EXECUTED
SYSTEM K R6
> 367D13D0
----+----1----+----2----+----3
MEMORY K 367D13D0
> S07500000.....................
** END **
------------------------------------------ Before CWXTSUBC:195/AMODE 31 ->
000193
47F0 B414
B
1044(,R11)
*.0..*
000194
D207 8018 7000
MVC
24(8,R8),0(R7)
*K.....*
=====>
96F0 801F
OI
31(R8),X'F0'
*o0..*
000196
D207 D100 8018
MVC
256(8,R13),24(R8)
*K.J...*
000197
96F0 D107
OI
263(R13),X'F0'
*o0J.*
000198
D507 D100 A110
CLC
256(8,R13),272(R10)
*N.J.~.*
000199
4740 B22A
BL/BM 554(,R11)
*. ..*
000200
D207 D100 8018
MVC
256(8,R13),24(R8)
*K.J...*
000201
96F0 D107
OI
263(R13),X'F0'
*o0J.*
000202
D507 D100 A108
CLC
256(8,R13),264(R10)
*N.J.~.*
000203
4720 B22A
BH/BP 554(,R11)
*....*
GPREGS R0 ==> 00150310 R1 ==> 001501C8 R2 ==> 36527B38 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

23. Exit the test session.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> exit
SCROLL ===> CSR
10 STATEMENTS EXECUTED
SYSTEM K R6
> 367D13D0
----+----1----+----2----+----3
MEMORY K 367D13D0
> S07500000.....................
** END **
------------------------------------------ Before CWXTSUBC:195/AMODE 31 ->
000193
47F0 B414
B
1044(,R11)
*.0..*
000194
D207 8018 7000
MVC
24(8,R8),0(R7)
*K.....*
=====>
96F0 801F
OI
31(R8),X'F0'
*o0..*
000196
D207 D100 8018
MVC
256(8,R13),24(R8)
*K.J...*
000197
96F0 D107
OI
263(R13),X'F0'
*o0J.*
000198
D507 D100 A110
CLC
256(8,R13),272(R10)
*N.J.~.*
000199
4740 B22A
BL/BM 554(,R11)
*. ..*
000200
D207 D100 8018
MVC
256(8,R13),24(R8)
*K.J...*
000201
96F0 D107
OI
263(R13),X'F0'
*o0J.*
000202
D507 D100 A108
CLC
256(8,R13),264(R10)
*N.J.~.*
000203
4720 B22A
BH/BP 554(,R11)
*....*
GPREGS R0 ==> 00150310 R1 ==> 001501C8 R2 ==> 36527B38 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-27

17-28

Xpediter/TSO COBOL Training Guide

File Allocation Utility

18-1

Chapter 18 File Allocation Utility


Xpediter/TSO allows you to create a file allocation list from existing JCL, file lists, or CLISTs. This list is used at
execution time to allocate the files your program needs. It may be necessary to create a file list if there are
parameters in your JCL that cannot be automatically processed by Xpediter/TSO or if youd like to make changes to
the existing JCL.
In this chapter you will create a file allocation list from existing JCL.

18-2

Xpediter/TSO COBOL Training Guide

1. Select the prepare option.


---------------------OPTION ===> 1
0
1
2
3
4
5
F
FA
FI
C
CS
T
X

XPEDITER/TSO 7.6 - PRIMARY MENU

DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT

Profile ===> CWXTCOB

----------------------

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 **

For Online Technical Support Reference: http://frontline.compuware.com


Copyright (c) 2007, Compuware Corporation. All rights reserved.
(800) 538-7822
Press ENTER to process

or

enter END command to terminate

2. Select the edit allocation list option.


-----------------OPTION ===> 4
1
2
3
4

XPEDITER/TSO - PROGRAM PREPARATION MENU

CONVERT COMPILE JCL


COMPILE FACILITY
BIND FACILITY MENU
EDIT ALLOCATION LIST

------------------

Convert compile JCL for XPEDITER


Compile programs for XPEDITER
Bind application plans or packages
Edit or Create file allocation lists

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

>

Press ENTER to process

<
or

enter END command to terminate

File Allocation Utility

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]

XPEDITER/TSO - EDIT FILE LIST

-----------------------

Specify File Allocation List Below:


ISPF Library:
Project
Group
Type
Member

===>
===>
===>
===>

USERID
XPEDITER
ALLOC
CWXTCOB

(Blank for member selection list)

Other Partitioned or Sequential Dataset:


Dataset Name ===>
Volume Serial ===>
(If not cataloged)
Copy from JCL, CLIST, or Other File Allocation List
Dataset Name ===> 'SYS2.XPEDITER.SAMPLIB(CWXTPROC)'
Copy Option ===> PROMPT
(Replace, Append, Prompt, or Cancel copy)
Automatic Expand ===> YES
(Yes/No)
Step Selection ===> CWXTCOB (Program name for automatic step selection)
Press ENTER to Process

---------------------COMMAND ===>
Line
D
I
R

Commands:
(Delete)
(Insert)
(Repeat)

or

Enter END Command to Terminate

XPEDITER/TSO - EDIT FILE LIST 1

-------- 3 DDs Copied


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-3

18-4

Xpediter/TSO COBOL Training Guide

4. Direct RPTFILE output to the terminal.


---------------------COMMAND ===> [ENTER]
Line
D
I
R

XPEDITER/TSO - EDIT FILE LIST 1

-------- 3 DDs Copied


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

Commands:
(Delete)
(Insert)
(Repeat)

XPEDITER/TSO - EDIT FILE LIST 1

---------- 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
'''''
'''''
'''''
'''''
'''''
'''''
'''''
'''''

File Allocation Utility

18-5

5. Scroll right to view the remaining allocation screens.


---------------------COMMAND ===> [PF11]
Line
D
I
R

XPEDITER/TSO - EDIT FILE LIST 1

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

XPEDITER/TSO - EDIT FILE LIST 2 (SMS)

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

Xpediter/TSO COBOL Training Guide

6. Select more detail about EMPFILE.


------------------- XPEDITER/TSO - EDIT FILE LIST 2 (SMS)
COMMAND ===> [ENTER]
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?
------------------------------------------------------------------------------s
EMPFILE
'''''
RPTFILE
'''''
SYSOUT
'''''
'''''
'''''
'''''
'''''
'''''
'''''
'''''

----------------------OPTION ===>
DDNAME: EMPFILE
1
2
3
4
5

XPEDITER/TSO - FILE PARMS MENU

----------------------

DSN: 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'

ALLOCATION
DCB
SYSOUT
PROTECTION
HFS

Specify
Specify
Specify
Specify
Specify

Press ENTER to Process

data set allocation parameters


data set description parameters
JES SYSOUT parameters
data set security parameters
Hierarchical File System parameters

or

Enter END Command to Terminate

File Allocation Utility

7. Specify the dataset allocation parameters.


----------------------OPTION ===> 1
DDNAME: EMPFILE
1
2
3
4
5

XPEDITER/TSO - FILE PARMS MENU

----------------------

DSN: 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'

ALLOCATION
DCB
SYSOUT
PROTECTION
HFS

Specify
Specify
Specify
Specify
Specify

Press ENTER to Process

data set allocation parameters


data set description parameters
JES SYSOUT parameters
data set security parameters
Hierarchical File System parameters

or

Enter END Command to Terminate

8. Exit the Allocation Parms screen.


---------------------COMMAND ===> [PF3]
Primary Commands:
DDNAME: EMPFILE

XPEDITER/TSO - ALLOCATION PARMS

----------------------

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 ________

OPEN ___ (In/Out)

STORCLAS ===> ________ MGMTCLAS ===> ________


SUBSYS ===> ____________________________________________________________

18-7

18-8

Xpediter/TSO COBOL Training Guide

9. Specify the dataset description parameters.


----------------------OPTION ===> 2
DDNAME: EMPFILE
1
2
3
4
5

XPEDITER/TSO - FILE PARMS MENU

----------------------

DSN: 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'

ALLOCATION
DCB
SYSOUT
PROTECTION
HFS

Specify
Specify
Specify
Specify
Specify

Press ENTER to Process

data set allocation parameters


data set description parameters
JES SYSOUT parameters
data set security parameters
Hierarchical File System parameters

or

Enter END Command to Terminate

10. Exit the DCB Parms screen.


-------------------------COMMAND ===> [PF3]
Primary Commands:
DDNAME: EMPFILE

XPEDITER/TSO - DCB PARMS

-------------------------

SA (Select Allocation)
SD
SO (SYSOUT)
DSN: 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'

SP (Protection)

DCB ===> ______________________________________________ (Ref DSNAME)


RECFM _____ LRECL _____ BLKSIZE _____ DSORG ___
OPTCD _____ KEYLEN ___ KEYOFF _____ (SMS Only)
BFTEK _ BUFNO ___ BUFL _____ BUFOFF __ BFALN _ LIMCT _____
NCP __ TRTCH ______ DEN _ PRTSP _ STACK _ FUNC _____
DIAGNS _____ EROPT ___ (ACC/SKP/ABE)
RECORG ===> __ (SMS Only)

RLS ===> ___ (SMS Only)

DSNTYPE ===> ________ (SMS Only)


LIKE ===> ______________________________________________ (SMS Only)
DATACLAS ===> ________

File Allocation Utility

11. Exit the File Parms menu.


----------------------OPTION ===> [PF3]
DDNAME: EMPFILE
1
2
3
4
5

XPEDITER/TSO - FILE PARMS MENU

----------------------

DSN: 'SYS2.XPEDITER.SAMPLIB(CWXTDATA)'

ALLOCATION
DCB
SYSOUT
PROTECTION
HFS

Specify
Specify
Specify
Specify
Specify

Press ENTER to Process

data set allocation parameters


data set description parameters
JES SYSOUT parameters
data set security parameters
Hierarchical File System parameters

or

Enter END Command to Terminate

12. Exit the Edit File List 1 screen.


---------------------COMMAND ===> [PF3]
Line
D
I
R

Commands:
(Delete)
(Insert)
(Repeat)

XPEDITER/TSO - EDIT FILE LIST 1

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

Xpediter/TSO COBOL Training Guide

13. Exit the Edit File List screen.


----------------------COMMAND ===> [PF3]

XPEDITER/TSO - EDIT FILE LIS

Allocation List Saved

Specify File Allocation List Below:


ISPF Library:
Project
Group
Type
Member

===>
===>
===>
===>

USERID
XPEDITER
ALLOC
CWXTCOB

(Blank for member selection list)

Other Partitioned or Sequential Dataset:


Dataset Name ===>
Volume Serial ===>
(If not cataloged)
Copy from JCL, CLIST, or Other File Allocation List
Dataset Name ===> 'SYS2.XPEDITER.SAMPLIB(CWXTPROC)'
Copy Option ===> PROMPT
(Replace, Append, Prompt, or Cancel copy)
Automatic Expand ===> YES
(Yes/No)
Step Selection ===>
(Program name for automatic step selection)
Press ENTER to Process

or

Enter END Command to Terminate

14. Return to the Xpediter/TSO Primary menu.


-----------------OPTION ===> [PF3]
1
2
3
4

XPEDITER/TSO - PROGRAM PREPARATION MENU

CONVERT COMPILE JCL


COMPILE FACILITY
BIND FACILITY MENU
EDIT ALLOCATION LIST

------------------

Convert compile JCL for XPEDITER


Compile programs for XPEDITER
Bind application plans or packages
Edit or Create file allocation lists

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

>

Press ENTER to process

<
or

enter END command to terminate

Batch Connect

19-1

Chapter 19 Batch Connect


Batch connect provides the following two modes of testing in a batch region:

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 connect facilitates testing of the following:

Batch jobs with multiple steps, enabling you to test one or more of the steps.

Programs requiring large region size

Programs using tape input or output.

In this chapter you will submit a job for interactive batch testing using Xpediter's batch connect facility.

INTERACTIVE VS. BATCH CONNECT PROCESSING


BATCH CONNECT

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

Xpediter/TSO COBOL Training Guide

1. Select option 3 for batch connect testing.


---------------------OPTION ===> 3
0
1
2
3
4
5
F
FA
FI
C
CS
T
X

XPEDITER/TSO 7.6 - PRIMARY MENU

DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT

Profile ===> CWXTCOB

----------------------

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 **

For Online Technical Support Reference: http://frontline.compuware.com


Copyright (c) 2007, Compuware Corporation. All rights reserved.
(800) 538-7822
Press ENTER to process

or

enter END command to terminate

2. Select option 1 to connect to a submitted batch job.


Profile: CWXTCOB
OPTION ===> 1

--------

Xpediter/TSO 7.6 - Batch

Batch

- Debug programs interactively under batch

Multi-Batch

- Debug multiple jobs interactively under batch

Press ENTER to process

NOTE:

-------------------------

or

enter END command to terminate

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

3. Specify the JCL to execute the demo program.


-------------------- XPEDITER/TSO - PROCESS EXECUTE JCL -------------------------COMMAND ===> [ENTER]
Primary Commands:
ISPF Library:
Project ===>
Group
===>
Type
===>
Member ===>

blank (Process JCL)

===>

Browse

===>

Edit

SEtup

STatus

===>

(Blank for member selection list)

Other Partitioned or Sequential Dataset:


Dataset Name ===> 'USERID.XPEDITER.SAMPLIB(CWXTPROC)'
Volume Serial ===>
(If not cataloged)

Press ENTER to process

or

enter END command to terminate

4. Fill in the jobcard and press Enter to process.


------------- XPEDITER/TSO - JOB CARD FOR SUBMIT PROC EXPANSION
COMMAND ===> [ENTER]

-------------

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
-

following utilities make use of this information:


CONVERT COMPILE JCL
EDIT ALLOCATION LIST (File Allocation Utility)
BATCH CONNECT

===>
===>
===>
===>

JOB CARD INFORMATION:


----*----1----*----2----*----3----*----4----*----5----*----6----*----7-//USERIDX JOB (ACCOUNT),'NAME',CLASS=A,MSGCLASS=X
//*
//*
//*
Press ENTER to Process

or

Enter END Command to Terminate

19-4

Xpediter/TSO COBOL Training Guide

5. Select the steps for interactive and unattended testing.


----------------------COMMAND ===> [ENTER]

XPEDITER/TSO - SELECT JOB STEP

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 ===>

XPEDITER/TSO - SELECT JOB STEP

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

6. Submit the job.


----------------------COMMAND ===> sub

XPEDITER/TSO - SELECT JOB STEP

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 ********************************

----------------------COMMAND ===> sub

XPEDITER/TSO - SELECT JOB STEP

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

Xpediter/TSO COBOL Training Guide

7. Check the job status.


----------------------COMMAND ===> st

XPEDITER/TSO - SELECT JOB STEP

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

-------- JOB SUBMITTED


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 *******************************

8. View the job status waiting for connection.


+XPD0011 VTAM NODE: A01CS000 USER: USERID
JOBNAME: USERIDX
+XPD0012 JOBNUMBER: JOB06095 STEP: RUN01
PROCSTEP: STEP01
+XPD0013 IS WAITING FOR CONNECTION ON SYSTEM CW01.
***

Batch Connect

9. Connect to the batch job using the attach command.


--------------------------COMMAND ===> [ENTER]
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

(Specific jobname, blank for TSO userid, or


'*' for all jobs using batch connect)
(JOBNAME/JOBID)

CMD JOBNAME JOBID


STATUS H CONNECT MESSAGE
------------------------------------------------------------------------------a
USERIDX JOB06095 RUNNING N Ready
******************************* Bottom of data ********************************

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


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

NOTE:

When the source is displayed, all Xpediter/TSO debugging commands are available.

19-7

19-8

Xpediter/TSO COBOL Training Guide

10. Begin program execution.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> 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

------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===>


SCROLL ===> CSR
TEST COMPLETED
** END **

------------------------------------------------ After CWXTCOB/AMODE 31 <>


000366
PERFORM 9900-CLOSE.
====>> 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
000380
ELSE

Batch Connect

11. Resume execution of the batch job.


------------------------- XPEDITER/TSO - SOURCE -----------------------------COMMAND ===> go
SCROLL ===> CSR
TEST COMPLETED
** END **

------------------------------------------------ After CWXTCOB/AMODE 31 <>


000366
PERFORM 9900-CLOSE.
====>> 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
000380
ELSE

12. Press Enter to view the notification screen.


--------------------------COMMAND ===> [ENTER]
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

(Specific jobname, blank for TSO userid, or


'*' for all jobs using batch connect)
(JOBNAME/JOBID)

CMD JOBNAME JOBID


STATUS H CONNECT MESSAGE
------------------------------------------------------------------------------_ USERIDX JOB06095 RUNNING N Ready
CONNECTION ENDED
******************************* Bottom of data ********************************

19-9

19-10

Xpediter/TSO COBOL Training Guide

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

MAXCC=00 - MAX COND CODE 000

XPEDITER/TSO - STATUS
B (Browse)
P (Purge)

C (Cancel)
R (Requeue)

--------------- Row 1 of 1
SCROLL ===> CSR
USERID => USERID

(Specific jobname, blank for TSO userid, or


'*' for all jobs using batch connect)
(JOBNAME/JOBID)

CMD JOBNAME JOBID


STATUS H CONNECT MESSAGE
------------------------------------------------------------------------------_ USERIDX JOB06095 OUTPUT N
******************************* Bottom of data ********************************

Batch Connect

14. Browse the output of the batch job.


--------------------------COMMAND ===> [ENTER]
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

(Specific jobname, blank for TSO userid, or


'*' for all jobs using batch connect)
(JOBNAME/JOBID)

CMD JOBNAME JOBID


STATUS H CONNECT MESSAGE
------------------------------------------------------------------------------b
USERIDX JOB06095 OUTPUT N
******************************* Bottom of data ********************************

Menu Utilities Compilers Help


------------------------------------------------------------------------------BROWSE
USERID.SPF121.OUTLIST
Line 00000000 Col 001 080
Command ===>
Scroll ===> CSR
********************************* Top of Data **********************************
1
J E S 2 J O B L O G -- S Y S T E M C W 0 1 -- N O
0
11.53.58 JOB06095 ---- MONDAY,
22 OCT 2007 ---11.53.58 JOB06095 IRR010I USERID USERID IS ASSIGNED TO THIS JOB.
11.53.00 JOB06095 ICH70001I USERID LAST ACCESS AT 10:28:04 ON MONDAY, OCTOBE
11.53.00 JOB06095 $HASP373 USERIDX STARTED - INIT 2
- CLASS A - SYS CW01
11.53.00 JOB06095 IEF403I USERIDX - STARTED - TIME=11.53.00
11.53.00 JOB06095 --TIMINGS (
11.53.00 JOB06095 -JOBNAME STEPNAME PROCSTEP
RC
EXCP
CONN
TCB
SR
11.53.00 JOB06095 -USERIDX @COMPXT@
00
9
8
.00
.0
11.58.54 JOB06095 -USERIDX RUN01
STEP01
00
677
1333
.03
.0
11.58.54 JOB06095 -USERIDX RUN01
STEP02
00
46
43
.00
.0
11.59.02 JOB06095 -USERIDX RUN02
STEP01
00
721
1281
.03
.0
11.59.03 JOB06095 -USERIDX RUN02
STEP02
00
50
47
.00
.0
11.59.03 JOB06095 -USERIDX #COMPXT#
00
45
40
.00
.0
11.59.04 JOB06095 IEF404I USERIDX - ENDED - TIME=11.59.04
11.59.04 JOB06095 -USERIDX ENDED. NAMETOTAL TCB CPU TI
11.59.04 JOB06095 $HASP395 USERIDX ENDED
0------ JES2 JOB STATISTICS ------ 22 OCT 2007 JOB EXECUTION DATE

19-11

19-12

Xpediter/TSO COBOL Training Guide

15. Find the first occurrence of REPORT.


Menu Utilities Compilers Help
------------------------------------------------------------------------------BROWSE
USERID.SPF121.OUTLIST
Line 00000000 Col 001 080
Command ===> f report
Scroll ===> CSR
********************************* Top of Data **********************************
1
J E S 2 J O B L O G -- S Y S T E M C W 0 1 -- N O
0
11.53.58 JOB06095 ---- MONDAY,
22 OCT 2007 ---11.53.58 JOB06095 IRR010I USERID USERID IS ASSIGNED TO THIS JOB.
11.53.00 JOB06095 ICH70001I USERID LAST ACCESS AT 10:28:04 ON MONDAY, OCTOBE
11.53.00 JOB06095 $HASP373 USERIDX STARTED - INIT 2
- CLASS A - SYS CW01
11.53.00 JOB06095 IEF403I USERIDX - STARTED - TIME=11.53.00
11.53.00 JOB06095 --TIMINGS (
11.53.00 JOB06095 -JOBNAME STEPNAME PROCSTEP
RC
EXCP
CONN
TCB
SR
11.53.00 JOB06095 -USERIDX @COMPXT@
00
9
8
.00
.0
11.58.54 JOB06095 -USERIDX RUN01
STEP01
00
677
1333
.03
.0
11.58.54 JOB06095 -USERIDX RUN01
STEP02
00
46
43
.00
.0
11.59.02 JOB06095 -USERIDX RUN02
STEP01
00
721
1281
.03
.0
11.59.03 JOB06095 -USERIDX RUN02
STEP02
00
50
47
.00
.0
11.59.03 JOB06095 -USERIDX #COMPXT#
00
45
40
.00
.0
11.59.04 JOB06095 IEF404I USERIDX - ENDED - TIME=11.59.04
11.59.04 JOB06095 -USERIDX ENDED. NAMETOTAL TCB CPU TI
11.59.04 JOB06095 $HASP395 USERIDX ENDED
0------ JES2 JOB STATISTICS ------ 22 OCT 2007 JOB EXECUTION DATE

Menu Utilities Compilers Help


-----------------------------------------------------------------------------BROWSE
USERID.SPF121.OUTLIST
CHARS 'REPORT' found
Command ===>
Scroll ===> CSR
RUN DATE 10/22/07
EMPLOYEE COMPENSATION REPORT
PAGE
1

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

16. Find Xpediter.


Menu Utilities Compilers Help
-----------------------------------------------------------------------------BROWSE
USERID.SPF121.OUTLIST
CHARS 'REPORT' found
Command ===> f xpediter
Scroll ===> CSR
RUN DATE 10/22/07
EMPLOYEE COMPENSATION REPORT
PAGE
1

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

Menu Utilities Compilers Help


----------------------------------------------------------------------------BROWSE
USERID.SPF121.OUTLIST
CHARS 'XPEDITER' found
Command ===>
Scroll ===> CSR
:
JOB: USERID
:
: XPEDITER/TSO RELEASE 07.06.00
CUSTOMER # 000001
STEP: STEP1
:
:
DATE: 10/22/2007 :
: COMPUWARE CORPORATION
TIME: 11.53.04
:
:
SYSTEM: CW01
:
+-----------------------------------------------------------------------------+
XPED BATCH
TEST CWXTCOB
INITSCR CWXTCOB
*** CWXTCOB FROM USERID.LOAD
LINK 10/16/07
BEFORE CWXTCOB::CWXTCOB:
AFTER CWXTCOB::CWXTCOB:
BEFORE ALL PARA
This is the information contained
KEEP EMPLOYEE-WORK-AREA
in your script CWXTCOB.
COUNT ALL STATE
PAUSE Before CWXTCOB
BEFORE BREAKPOINT ENCOUNTERED
-------------------------------------------------------- CWXTCOB KEPT ITEMS --

19-13

19-14

Xpediter/TSO COBOL Training Guide

17. Exit the browse.


Menu Utilities Compilers Help
----------------------------------------------------------------------------BROWSE
USERID.SPF121.OUTLIST
CHARS 'XPEDITER' found
Command ===> [PF3]
Scroll ===> CSR
:
JOB: USERID
:
: XPEDITER/TSO RELEASE 07.06.00
CUSTOMER # 000001
STEP: STEP1
:
:
DATE: 10/22/2007 :
: COMPUWARE CORPORATION
TIME: 11.53.04
:
:
SYSTEM: CW01
:
+-----------------------------------------------------------------------------+
XPED BATCH
TEST CWXTCOB
INITSCR CWXTCOB
*** CWXTCOB FROM USERID.LOAD
LINK 10/16/07
BEFORE CWXTCOB::CWXTCOB:
AFTER CWXTCOB::CWXTCOB:
BEFORE ALL PARA
KEEP EMPLOYEE-WORK-AREA
COUNT ALL STATE
PAUSE Before CWXTCOB
BEFORE BREAKPOINT ENCOUNTERED
-------------------------------------------------------- CWXTCOB KEPT ITEMS --

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

(Specific jobname, blank for TSO userid, or


'*' for all jobs using batch connect)
(JOBNAME/JOBID)

CMD JOBNAME JOBID


STATUS H CONNECT MESSAGE
------------------------------------------------------------------------------_
USERIDX JOB06095 OUTPUT N
BROWSED
******************************* Bottom of data ********************************

Batch Connect

18. Return to Select Job Step Screen.


--------------------------COMMAND ===> [PF3]
Line Commands: A (Attach)
I (Info)

XPEDITER/TSO - STATUS

B (Browse)
P (Purge)

Jobname ===>
Sort Sequence ===> JOBID

--------------- Row 1 of 1
SCROLL ===> CSR

C (Cancel)
R (Requeue)

USERID => USERID

(Specific jobname, blank for TSO userid, or


'*' for all jobs using batch connect)
(JOBNAME/JOBID)

CMD JOBNAME JOBID


STATUS H CONNECT MESSAGE
------------------------------------------------------------------------------_
USERIDX JOB06095 OUTPUT N
BROWSED
******************************* Bottom of data ********************************

----------------------COMMAND ===>

XPEDITER/TSO - SELECT JOB STEP

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

Xpediter/TSO COBOL Training Guide

19. End the batch connect test.


----------------------COMMAND ===> [PF3]

XPEDITER/TSO - SELECT JOB STEP

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 ********************************

-------------------- XPEDITER/TSO - PROCESS EXECUTE JCL ------------ Cancelled


COMMAND ===>
Primary Commands:
ISPF Library:
Project ===>
Group
===>
Type
===>
Member ===>

blank (Process JCL)

===>

Browse

===>

Edit

SEtup

STatus

===>

(Blank for member selection list)

Other Partitioned or Sequential Dataset:


Dataset Name ===> 'USERID.XPEDITER.SAMPLIB(CWXTPROC)'
Volume Serial ===>
(If not cataloged)

Press ENTER to process

or

enter END command to terminate

Batch Connect

20. Return to the Primary menu by pressing PF3 twice.


-------------------- XPEDITER/TSO - PROCESS EXECUTE JCL ------------ Cancelled
COMMAND ===> [PF3]; [PF3]
Primary Commands:

blank (Process JCL)

ISPF Library:
Project ===>
Group
===>
Type
===>
Member ===>

===>

Browse

===>

Edit

SEtup

STatus

===>

(Blank for member selection list)

Other Partitioned or Sequential Dataset:


Dataset Name ===> 'USERID.XPEDITER.SAMPLIB(CWXTPROC)'
Volume Serial ===>
(If not cataloged)

Press ENTER to process

---------------------OPTION ===>
0
1
2
3
4
5
F
FA
FI
C
CS
T
X

enter END command to terminate

XPEDITER/TSO 7.6 - PRIMARY MENU

DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT

Profile ===> CWXTCOB

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 **

For Online Technical Support Reference: http://frontline.compuware.com


Copyright (c) 2007, Compuware Corporation. All rights reserved.
(800) 538-7822
Press ENTER to process

or

enter END command to terminate

19-17

19-18

Xpediter/TSO COBOL Training Guide

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

Change the current profile or access the profile screen.

In this chapter you will create a new profile.

20-2

Xpediter/TSO COBOL Training Guide

1. Access the Defaults menu.


---------------------OPTION ===> 0
0
1
2
3
4
5
F
FA
FI
C
CS
T
X

XPEDITER/TSO 7.6 - PRIMARY MENU

DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT

Profile ===> CWXTCOB

----------------------

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 **

For Online Technical Support Reference: http://frontline.compuware.com


Copyright (c) 2007, Compuware Corporation. All rights reserved.
(800) 538-7822
Press ENTER to process

-----------------------OPTION ===>
1
2
3
4

TEST PF KEYS
COLORS
OTHERS
PROFILE

or

enter END command to terminate

XPEDITER/TSO - DEFAULTS MENU


-

Specify
Specify
Specify
Specify

Press ENTER to Process

-----------------------

test session PF keys


color defaults
other default values
current profile name

or

Enter END Command to Terminate

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

XPEDITER/TSO - DEFAULTS MENU


-

Specify
Specify
Specify
Specify

Press ENTER to Process

-----------------------COMMAND ===>

-----------------------

test session PF keys


color defaults
other default values
current profile name

or

Enter END Command to Terminate

XPEDITER/TSO - PROFILE (0.4)

----------------------SCROLL ===> CSR

LINE COMMANDS: S (Select)


D (Delete)
C (Copy)
R (Rename)
U (Use)
PRIMARY COMMANDS: MERGE (copy profiles)
Locate (reposition table)
CURRENT
PROFILE ===> DEFAULT > *** NO DESCRIPTION ***
<
CMD PROFILE
NEW NAME
DESCRIPTION
------------------------------------------------------------------------------_ * DEFAULT
> *** NO DESCRIPTION
<
******************************* BOTTOM OF DATA ********************************

20-4

Xpediter/TSO COBOL Training Guide

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]

XPEDITER/TSO - PROFILE (0.4)

----------------------SCROLL ===> CSR

LINE COMMANDS: S (Select)


D (Delete)
C (Copy)
R (Rename)
U (Use)
PRIMARY COMMANDS: MERGE (copy profiles)
Locate (reposition table)
CURRENT
PROFILE ===> DEFAULT > *** NO DESCRIPTION ***
<
CMD PROFILE
NEW NAME
DESCRIPTION
------------------------------------------------------------------------------C * DEFAULT
VENDOR
> TEST VENDOR PACKAGE X
<
******************************* BOTTOM OF DATA ********************************

-----------------------COMMAND ===>

XPEDITER/TSO - PROFILE (0.4)

----------------------SCROLL ===> CSR

LINE COMMANDS: S (Select)


D (Delete)
C (Copy)
R (Rename)
U (Use)
PRIMARY COMMANDS: MERGE (copy profiles)
Locate (reposition table)
CURRENT
PROFILE ===> DEFAULT > *** NO DESCRIPTION ***
<
CMD PROFILE
NEW NAME
DESCRIPTION
------------------------------------------------------------------------------_ * DEFAULT
> *** NO DESCRIPTION ***
<
_
VENDOR
> TEST VENDOR PACKAGE X
<
******************************* BOTTOM OF DATA ********************************

Profiles

4. Return to the Defaults menu.


-----------------------COMMAND ===> [PF3]

XPEDITER/TSO - PROFILE (0.4)

----------------------SCROLL ===> CSR

LINE COMMANDS: S (Select)


D (Delete)
C (Copy)
R (Rename)
U (Use)
PRIMARY COMMANDS: MERGE (copy profiles)
Locate (reposition table)
CURRENT
PROFILE ===> DEFAULT > *** NO DESCRIPTION ***
<
CMD PROFILE
NEW NAME
DESCRIPTION
------------------------------------------------------------------------------_ * DEFAULT
> *** NO DESCRIPTION ***
<
_
VENDOR
> TEST VENDOR PACKAGE X
<
******************************* BOTTOM OF DATA ********************************

-----------------------OPTION ===>
1
2
3
4

TEST PF KEYS
COLORS
OTHERS
PROFILE

XPEDITER/TSO - DEFAULTS MENU


-

Specify
Specify
Specify
Specify

Press ENTER to Process

-----------------------

test session PF keys


color defaults
other default values
current profile name

or

Enter END Command to Terminate

20-5

20-6

Xpediter/TSO COBOL Training Guide

5. Return to the Xpediter/TSO Primary menu.


-----------------------OPTION ===> [PF3]
1
2
3
4

TEST PF KEYS
COLORS
OTHERS
PROFILE

XPEDITER/TSO - DEFAULTS MENU


-

Specify
Specify
Specify
Specify

Press ENTER to Process

---------------------OPTION ===>
0
1
2
3
4
5
F
FA
FI
C
CS
T
X

Profile ===> DEFAULT

test session PF keys


color defaults
other default values
current profile name

or

Enter END Command to Terminate

XPEDITER/TSO 7.6 - PRIMARY MENU

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 ***

For Online Technical Support Reference: http://frontline.compuware.com


Copyright (c) 2007, Compuware Corporation. All rights reserved.
(800) 538-7822
Press ENTER to process

or

enter END command to terminate

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

XPEDITER/TSO 7.6 - PRIMARY MENU

DEFAULTS
PREPARE
TSO
BATCH
STORED PROC
UTILITIES
FADB2
FILE-AID
FILE-AID/IMS
CODE COVERAGE
CICS
TUTORIAL
EXIT

Profile ===> VENDOR

----------------------

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 ***

For Online Technical Support Reference: http://frontline.compuware.com


Copyright (c) 2007, Compuware Corporation. All rights reserved.
(800) 538-7822
Press ENTER to process

or

enter END command to terminate

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

------

XPEDITER/TSO - STANDARD (2.1)

-----------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> VENDORX
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===> '01/01/2008'

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(VENDORX)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

20-8

Xpediter/TSO COBOL Training Guide

8. Select the option to view the load libraries currently declared to this test session.
Profile: VENDOR -------OPTION ===> 1

XPEDITER/TSO - SETUP MENU

0
1
2
3
4
5
6
7

ENVIRONMENT
LOADLIBS
DDIO
INCLUDES
LOG
SCRIPT
DSNLOAD
PANEXEC

C
D
E
A

CODE COVERAGEDOCUMENT
EXTENDED
ALL
-

--------------------------

Execution environments menu


Application load module libraries
DDIO files
Test script libraries
Session log dataset disposition
Test script dataset disposition
DB2 system names and DSNLOAD libraries
PANEXEC load libraries

Code Coverage setup options


Document dataset disposition
Extended Setup Menu
Display all of the above in succession (except 0)

Press ENTER to process

or

enter END command to terminate

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

10. Return to the Test Standard screen.


Profile: VENDOR -------OPTION ===> [PF3]

XPEDITER/TSO - SETUP MENU

0
1
2
3
4
5
6
7

ENVIRONMENT
LOADLIBS
DDIO
INCLUDES
LOG
SCRIPT
DSNLOAD
PANEXEC

C
D
E
A

CODE COVERAGEDOCUMENT
EXTENDED
ALL
-

Execution environments menu


Application load module libraries
DDIO files
Test script libraries
Session log dataset disposition
Test script dataset disposition
DB2 system names and DSNLOAD libraries
PANEXEC load libraries

Code Coverage setup options


Document dataset disposition
Extended Setup Menu
Display all of the above in succession (except 0)

Press ENTER to process

NOTE:

--------------------------

or

enter END command to terminate

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 ===>

------

XPEDITER/TSO - STANDARD (2.1)

-----------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> VENDORX
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===> '01/01/2008'

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(VENDORX)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

20-9

20-10

Xpediter/TSO COBOL Training Guide

11. Change the current profile to the default profile.


Profile: VENDOR ------ XPEDITER/TSO - STANDARD (2.1)
COMMAND ===> profile default

-----------------------

COMMANDS:

SEtup (Display Setup Menu)


PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:
Program ===> VENDORX
Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===> '01/01/2008'

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(VENDORX)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

Profile: DEFAULT ------ XPEDITER/TSO - STANDARD (2.1)


COMMAND ===>
Profile DEFAULT: *** NO DESCRIPTION ***
COMMANDS: SEtup (Display Setup Menu)
PROFILE (Display Profile Selection)
TEST SELECTION CRITERIA:

-----------------------

Program ===> CWXTCOB


Entry Point ===>
Load Module ===>
Initial Script ===>
Post Script ===>
PARM

( Caps = YES ) ===>

File List/JCL Member


Preview Files?
Code Coverage Test?
Is This a DB2 Test?

===>
===>
===>
===>

'USERID.XPEDITER.SAMPLIB(CWXTJCLC)'
NO
NO
(YES, NO, TDO) System Flow? ===> NO
NO
Plan ===>
System ===>

Press ENTER to process

or

enter END command to terminate

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

Xpediter/TSO COBOL Training Guide

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

Xpediter/TSO COBOL Training Guide