XPEDITER Batch Execution

if you want the reverse command to work initially you need to do MONitor.

These step by step instructions are followed by the actual screens that you will be stepping thru with the
same numbering sequence.

After compiling your program with the 'Debugging Flag' set to 'X' for Xpediter:

1) At the TSO command prompt enter 'tso xpediter'

2) Select ‘3’ BATCH.
3) The following setup steps (3,4,5) are a one time requirement and if they have already been done,
4) skip to step 6 .
5) Enter ‘SE’ to enter ‘Setup’ and establish your system files.
6) Select ‘2’ DDIO.
7) Enter the ‘User’ and ‘Installation’ Libraries exactly as shown (you must hit ‘Enter’ for the
entries to be saved.)
8) Return back to the previous screen and enter the PDS dataset name where your batch execution
JCL resides (must be in a PDS).
9) ‘S’elect JCL member.
10) Set step(s) to be tested interactively to ' I '.
11) 'SUB’mit job.
12) Do 'ST’atus to display job(s).
13) Set 'JOBNAME' to ' * ' to list job(s) that are ready to be attached. Remember, it may take a few
minutes before the job actually begins executing in the que.
14) Enter ' a ' on the command line to attach the job. This will put you in the program
15) at the first statement.

Then use your normal XPED and TSO commands:

- set your breakpoints.
- PF9 to step thru one statement at a time
- PF12 to execute until the next breakpoint.
- etc.

At the end of these instructions, you will find both an illustration of the PF Key assignments and a list of
Xpediter keywords.
1)

Menu Utilities Compilers Options Status Help

------------------------------------------------------------------------------
FSG Program Products Menu Session=1
C301
Option ===> tso xpediter
More: +
0 Settings Terminal and user parameters < Calendar >
1 View Display source data or listings September 2000
2 Edit Create or change source data Su Mo Tu We Th Fr Sa
3 Utilities Perform utility functions 1 2
4 Foreground Interactive language processing 3 4 5 6 7 8 9
5 Batch Submit job for language processing 10 11 12 13 14 15 16
6 Command Enter TSO or Workstation commands 17 18 19 20 21 22 23
7 Dialog Test Perform dialog testing 24 25 26 27 28 29 30
8 SDSF System Search and Display Facility
9 Workplace ISPF Object/Action Workplace Shell Time . . . . : 10:48
10 Unix ISHELL Unix Services for ISPF Day of year. : 255
11 Bookmanager IBM Bookmanager reference utility
12 NetView FTP NetView FTP for ISPF
13 Quickref MVS quick reference utility
14 Panvalet Panvalet browse, edit utilities
15 TSOPlus TSOPLUS primary option menu

Use UP or DOWN Pfkeys to SCROLL menu, enter X Command to Terminate.

2)
---------------------- XPEDITER/TSO 6.6 - PRIMARY MENU ----------------------
OPTION ===> 3

0 DEFAULTS - Specify defaults

1 PREPARE - Prepare programs for debugging
2 TSO - Debug programs interactively under TSO
3 BATCH - Debug programs interactively under batch

5 UTILITIES - Perform utility functions

F FADB2 - Invoke File-AID for DB2
C CODE COVERAGE - Code Coverage NOT INSTALLED
B BULLETIN - Display summary of changes for this release
T TUTORIAL - Display information about XPEDITER/TSO
X EXIT - Exit primary menu

Profile ===> DEFAULT - *** NO DESCRIPTION ***

Copyright (c) 1998, Compuware Corporation. All rights reserved.

(800) 538-7822

Press ENTER to process or enter END command to terminate

3)
-------------------- XPEDITER/TSO - PROCESS EXECUTE JCL -----------------------
COMMAND ===> SE

Primary Commands: blank (Process JCL) Browse Edit SEtup STatus

ISPF Library:
Project ===>
Group ===> ===> ===> ===>
Type ===>
Member ===> (Blank for member selection list)

Other Partitioned or Sequential Dataset:

Dataset Name ===>
Volume Serial ===> (If not cataloged)

Press ENTER to process or enter END command to terminate

4)
Profile: DEFAULT ------- XPEDITER/TSO - SETUP MENU --------------------------
OPTION ===> 2

0 ENVIRONMENT - Execution environments menu

1 LOADLIBS - Application load module libraries
2 DDIO - DDIO files
3 INCLUDES - Test script libraries
4 LOG - Session log dataset disposition
5 SCRIPT - Test script dataset disposition
6 DSNLOAD - DB2 system names and DSNLOAD libraries

A ALL - Display all of the above in succession (except 0)

Press ENTER to process or enter END command to terminate

5)
Profile: DEFAULT -------- XPEDITER/TSO - DDIO FILES -------------------------
COMMAND ===>

User Libraries:

(1) ===> 'AATLIB.VO.XPEDITER.LISTING'

(2) ===>
(3) ===>
(4) ===>
(5) ===>
(6) ===>

Installation Libraries: (This list contains overrides to installed defaults)

(7) ===> 'C000.B0SCWS.VM.R760.CX.DDIO'

(8) ===>
(9) ===>

Press ENTER to process or enter END command to terminate

6)
-------------------- XPEDITER/TSO - PROCESS EXECUTE JCL -----------------------
COMMAND ===>

Primary Commands: blank (Process JCL) Browse Edit SEtup STatus

ISPF Library:
Project ===>
Group ===> ===> ===> ===>
Type ===>
Member ===> (Blank for member selection list)

Other Partitioned or Sequential Dataset:

Dataset Name ===> 'YOUR.PDS'
Volume Serial ===> (If not cataloged)

Press ENTER to process or enter END command to terminate

7)
----------------- XPEDITER/TSO - PROCESS EXECUTE JCL ------- ROW 00001 OF 00032
COMMAND ===> SCROLL ===> PAGE

Line Commands: B (Browse) E (Edit) S (Select for processing)

Dataset: 'B06PZM.DEV.TEST.JCL'

Name VV MM Created Changed Size Init Mod ID

-------------------------------------------------------------------------------
_ AAITMEWI 01.00 00/08/23 00/08/23 12:25 117 117 0 B06PZM
_ DBSQL 01.00 00/05/12 00/05/12 11:51 74 74 0 B06PZM
_ DBTSQL 01.00 00/05/12 00/05/12 11:54 82 82 0 B06PZM
_ DITMCLOS 01.00 00/08/09 00/08/09 10:39 57 57 0 B06PZM
_ DNEDWCLS 01.00 00/08/09 00/08/09 11:11 32 32 0 B06PZM
_ DNITMEWC 01.00 00/08/09 00/08/09 10:59 31 31 0 B06PZM
_ ENDREST 01.00 00/05/05 00/05/05 10:53 45 45 0 B06PZM
_ EZAFPM 01.00 00/06/12 00/06/12 11:52 1151 1151 0 B06PZM
_ FILEMSGQ 01.00 00/04/25 00/04/25 14:36 321 321 0 B06PZM
_ FLEDWCLS 01.00 00/08/09 00/08/09 11:12 32 32 0 B06PZM
_ FLITMCLS 01.00 00/08/09 00/08/09 10:42 57 57 0 B06PZM
_ FLITMEWC 01.00 00/08/09 00/08/09 11:01 31 31 0 B06PZM
S GOCEBBAL 01.00 00/09/07 00/09/07 11:17 132 132 0 B06PZM
_ INEDWCLS 01.00 00/08/09 00/08/09 11:14 32 32 0 B06PZM
_ INITMCLS 01.00 00/08/09 00/08/09 10:44 57 57 0 B06PZM

8)
----------------------- XPEDITER/TSO - SELECT JOB STEP ----- Row 1 to 2 of 2
COMMAND ===> SCROLL ===> PAGE

Line Commands: Primary Commands:

I - Interactive testing
U - Unattended testing
blank - Reset I/U
Edit - Display converted selected steps
END - Exit without processing
RUN - Submit and connect
SEtup - Setup work datasets
SUBmit - Convert selected steps and submit
STatus - Display status of submitted job(s)

Dataset: 'B06PZM.DEV.TEST.JCL(GOCEBBAL)'

PROGRAM INITSCR STEPNAME PROCNAME PROCSTEP EXEC PGM

-------------------------- --------------------------------------------------
__ SORT ________ PS010
I XEDW113 ________ PS020 XPTSO
******************************* Bottom of data ********************************
9)
----------------------- XPEDITER/TSO - SELECT JOB STEP ----- Row 1 to 2 of 2
COMMAND ===> SUB SCROLL ===> PAGE

Line Commands: Primary Commands:

I - Interactive testing
U - Unattended testing
blank - Reset I/U
Edit - Display converted selected steps
END - Exit without processing
RUN - Submit and connect
SEtup - Setup work datasets
SUBmit - Convert selected steps and submit
STatus - Display status of submitted job(s)

Dataset: 'B06PZM.DEV.TEST.JCL(GOCEBBAL)'

PROGRAM INITSCR STEPNAME PROCNAME PROCSTEP EXEC PGM

-------------------------- --------------------------------------------------
__ SORT ________ PS010
I XEDW113 ________ PS020 XPTSO
******************************* Bottom of data ********************************

***
The following message will appear when the job has actually begun execution and is
waiting for you to 'Attach' it. Remember, the job may have to wait for an initiator.

+XPD0011 VTAM NODE: XP301000 USER: B06PZM JOBNAME: B06PZMCB

+XPD0012 JOBNUMBER: JOB57169 STEP: PS020 PROCSTEP:
+XPD0013 IS WAITING FOR CONNECTION ON SYSTEM C301.
***

10)
----------------------- XPEDITER/TSO - SELECT JOB STEP ----- Row 1 to 2 of 2
COMMAND ===> STatus SCROLL ===> PAGE
JCL HAS BEEN MODIFIED TO DEBUG WITH XPEDITER.
Line Commands: Primary Commands:
I - Interactive testing Edit - Display converted selected steps
U - Unattended testing END - Exit without processing
RUN - Submit and connect
SEtup - Setup work datasets
SUBmit - Convert selected steps and submit
blank - Reset I/U STatus - Display status of submitted job(s)

Dataset: 'B06PZM.DEV.TEST.JCL(GOCEBBAL)'

PROGRAM INITSCR STEPNAME PROCNAME PROCSTEP EXEC PGM

-------------------------- --------------------------------------------------
__ SORT ________ PS010
I XEDW113 ________ PS020 XPTSO
******************************* Bottom of data ********************************
11)
--------------------------- XPEDITER/TSO - STATUS ---------- Row 1 to 1 of 1
COMMAND ===> SCROLL ===> PAGE

Line Commands: A (Attach) B (Browse) C (Cancel)

I (Info) P (Purge) R (Requeue)

Jobname ===> * (Specific jobname, blank for TSO userid, or

'*' for all jobs using batch connect)
Sort Sequence ===> JOBID (JOBNAME/JOBID)

CMD JOBNAME JOBID STATUS H CONNECT MESSAGE

-------------------------------------------------------------------------------
_ B06PZMCB JOB57169 Running Ready
******************************* Bottom of data ********************************

12)
--------------------------- XPEDITER/TSO - STATUS ---------- Row 1 to 1 of 1
COMMAND ===> SCROLL ===> PAGE

Line Commands: A (Attach) B (Browse) C (Cancel)

I (Info) P (Purge) R (Requeue)

Jobname ===> * (Specific jobname, blank for TSO userid, or

'*' for all jobs using batch connect)
Sort Sequence ===> JOBID (JOBNAME/JOBID)

CMD JOBNAME JOBID STATUS H CONNECT MESSAGE

-------------------------------------------------------------------------------
a B06PZMCB JOB57169 Running Ready
******************************* Bottom of data ********************************
PF KEYS

The default settings for the 24 XPEDITER PF keys are listed below. These
values are valid during the XPEDITER/TSO session. ISPF PF keys are not
affected. The ISPF KEYS command or the SET PFn command can be used to
override the defaults.

+-----------+--------------+-------------------------------------------------+
| PF KEY | DEFAULT | DESCRIPTION OF FUNCTION |
| | SETTING | |
+-----------+--------------+-------------------------------------------------+
| PF1/PF13 | HELP | Elaborates an XPEDITER/TSO message and invokes |
| | | the context-sensitive tutorial facility. |
+-----------+--------------+-------------------------------------------------+
| PF2 | PEEK CSR | Displays the contents of the data name defined |
| | | by the current cursor position. The cursor |
| | | must be in the source window under a valid data |
| | | name. |
+-----------+--------------+-------------------------------------------------+
| PF14 | FIND CSR | Finds the character string located under the |
| | | cursor position. |
+-----------+--------------+-------------------------------------------------+
| PF3/PF15 | END | Returns you to the previous menu if you are in |
| | | the LOG, HELP, BROWSE, or SHOW functions. |
+-----------+--------------+-------------------------------------------------+
| PF4/PF16 | EXIT | Ends the current XPEDITER/TSO session. |
+-----------+--------------+-------------------------------------------------+
| PF5 | FIND | Repeats the action of the previous FIND |
| | | command. |
+-----------+--------------+-------------------------------------------------+
| PF17 | FIND IND | Scrolls the source display to successive levels |
| | | of indirect references related to a previously |
| | | entered FIND INDIRECT command. |
+-----------+--------------+-------------------------------------------------+
| PF6/PF18 | LOCATE * | Scrolls the source display to the current |
| | | location where execution has been suspended. |
+-----------+--------------+-------------------------------------------------+
| PF7/PF19 | UP | Scrolls the source or data in the Keep window |
| | | up, or toward the top of the file. |
+-----------+--------------+-------------------------------------------------+
| PF8/PF20 | DOWN | Scrolls the source or data in the Keep window |
| | | down, or toward the bottom of the file. |
+-----------+--------------+-------------------------------------------------+
| PF9/PF21 | GO 1 | Executes the next logical instruction in your |
| | | program, then pauses. |
+-----------+--------------+-------------------------------------------------+
| PF10 | LEFT | Scrolls the source display to the left. |
+-----------+--------------+-------------------------------------------------+
| PF11 | RIGHT | Scrolls the source display to the right. |
+-----------+--------------+-------------------------------------------------+
| PF12/PF24 | GO | Starts or resumes execution of your program. |
+-----------+--------------+-------------------------------------------------+
| PF22 | DLEFT | Scrolls data in an Automatic Keep, Keep, or |
| | | Peek window to the left. |
+-----------+--------------+-------------------------------------------------+
| PF23 | DRIGHT | Scrolls data in an Automatic Keep, Keep, or |
| | | Peek window to the right. |
+-----------+--------------+-------------------------------------------------+
Default Program Function (PF) Keys
To obtain help on a topic, enter the HELP command with the appropriate
keyword.

This list is sorted by keyword; enter HELP INDEX for a similar list sorted
by topic.

Keyword: Topic:

AA Command usage and syntax for AA SNAP

ABENDcdS XPEDITER/TSO user abend codes
ABENDS XPEDITER/TSO user abend codes
ACCEPT Command usage and syntax for ACCEPT
After Command usage and syntax for AFTER
ALLOCate Command usage and syntax for ALLOCATE
AT Command usage and syntax for AT
ATTENTion Attention key processing
BATCH Testing with XPEDITER/TSO in batch
BATCHCON Using the BATCH CONNECT facility
Before Command usage and syntax for BEFORE
BOTtom Command usage and syntax for BOTTOM
BREAKs Breakpoints
BROwse Command usage and syntax for BROWSE
CICSCON CICS single point of entry
COBOLII VS COBOL II support
COBolKEY COBOL-Structure keywords
COBOL370 COBOL/370 support
CODEGEN Code generator support
COLON Command usage and syntax for COLON (:)
COLORs Specifying screen colors
CONNECT Command usage and syntax for CONNECT
Count Command usage and syntax for COUNT
COVer Command usage and syntax for COVER
DATABASE Discussion of support for various databases
DB2 ACCESSING File-AID for DB2
DB2EXT Debugging programs w/ File-Aid/DB2 extention
DB2TABle Browsing and editing DB2 tables data
DBCS Supporting double byte character set
DDIO DDIO file facility
DEBUG Sample debugging session
DEFaults Overriding XPEDITER/TSO default setting
DELete Command usage and syntax for DELETE
DFHDRP Shared DL/I database (DFHDRP) support
DLEFT Command usage and syntax for DLEFT
DLI Command usage and syntax for DLI
DRIGHT Command usage and syntax for DRIGHT
DOWN Command usage and syntax for DOWN
DROP Command usage and syntax for DROP
END Command usage and syntax for END
ENHFIND Testing with Enhanced FIND
ENVIRON Operating environment
ERRhandl Error handling information
eXclude Command usage and syntax for EXCLUDE
EXIT Command usage and syntax for EXIT
EXPLAIN Command usage and syntax for EXPLAIN
FADB2 Command usage and syntax for FADB2
FIND Command usage and syntax for FIND
First Command usage and syntax for F(irst)
GEN Command usage and syntax for GEN
GETMAIN Command usage and syntax for GETMAIN
GO Command usage and syntax for GO
GOTO Command usage and syntax for GOTO
GPREGS Command usage and syntax for GPREGS
Help Command usage and syntax for HELP
HOWTO How to get started with XPEDITER
IF Conditional usage and syntax for IF
IMSCODEs IMS status codes explanation
IMSDC Testing in the IMS/DC region
IMSMSGs XPEDITER/IMS messages written to the Log
INClude Command usage and syntax for INCLUDE
INDEX Help topics and keywords, sorted by topic
INSert Command usage and syntax for INSERT
INTercept Command usage and syntax for INTERCEPT
Keep Command usage and syntax for KEEP
Last Command usage and syntax for L(ast)
LE370 LE/370 support
LEFT Command usage and syntax for LEFT
LIne Command usage and syntax for LINE
LOAD Command usage and syntax for LOAD
LOCate Command usage and syntax for LOCATE
LOG Command usage and syntax for LOG
MEMory Command usage and syntax for MEMORY
MIXEDLang Mixed language support
MODIFY Modifying program logic temporarily
MONitor Command usage and syntax for MONITOR
MOVE Command usage and syntax for MOVE
MSGS Messages written to the Log
MULTItsk Multitasking
NOLines Command usage and syntax for NOLINES
NOSource Debugging a program without source
OPTimize Discussion of support for optimized programs
ONCODEs Condition codes for PL/I
PACKages Third party packages
PANexec PANEXEC support
PAUSE Command usage and syntax for PAUSE
Peek Command usage and syntax for PEEK
PFKEYS PF key definitions and scope
PROFiles Using profiles to ypur advantage
PROGData Inspecting program data
PROGFlow Analyzing program logic
QUALIFY Qualification rules
REGION Logn region size requirements
REGISTERs Displaying and changing memory and registers
REGS Displaying and changing memory and registers
RESet Command usage and syntax for RESET
RESUME Command usage and syntax for RESUME
RETest Command usage and syntax for RETEST
RETURN Command usage and syntax for RETURN
REVerse Command usage and syntax for REVERSE
RIGHT Command usage and syntax for RIGHT
RUN Command usage and syntax for RUN
SB14 ABEND notes
SB37 ABEND notes
SCREEN Explanation of the XPEDITER test screen
SCRIPTs Creating and using test scripts
SD37 ABEND notes
SET Command usage and syntax for SET
SHow Command usage and syntax for SHOW
Skip Command usage and syntax for SKIP
SNAP Command usage and syntax for AA SNAP
SNAPAID Displaying environmental data
SORTexit Testing with SORT exit routines
SOurce Command usage and syntax for SOURCE
SOURCELESS Debugging a program without source
SPLITscrn Split screen
SQLCODEs SQL return code explanations
SQLMSGS XPEDITER for DB2 message explanations
STatus Command usage and syntax for STATUS
STRINGfind Searching for character strings
SUBs Testing subroutines under XPEDITER/TSO
SYNTAX Syntax of commands and keywords
S0C1 ABEND notes
S0C4 ABEND notes
S0C5 ABEND notes
S0C7 ABEND notes
S001 ABEND notes
S013 ABEND notes
S031 ABEND notes
S106 ABEND notes
S213 ABEND notes
S806 ABEND notes
T Command usage and syntax for T(emplate)
TEST Command usage and syntax for TEST
TOGGLE Command usage and syntax for TOGGLE
TOP Command usage and syntax for TOP
TRAce Command usage and syntax for TRACE
TSO Command usage and syntax for TSO
UP Command usage and syntax for UP
USE Command usage and syntax for USE
UTILities Utilities
WHEN Command usage and syntax for WHEN
WHEREIS Command usage and syntax for WHEREIS
XCHANGE Command usage and syntax for XCHANGE
XPED Command usage and syntax for XPED
XPEDIO XPEDITER/TSO input and output