XPEDITOR Quick Reference
XPEDITOR Quick Reference
Quick Reference
Release 7.4
ii XPEDITER/TSO and XPEDITER/IMS Quick Reference
This document and the product referenced in it are subject to the following legends:
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, Code Coverage, File-AID, FrontLine, and Abend-AID are trademarks or registered
trademarks of Compuware Corporation.
CICS, IBM, DB2, and MQSeries are trademarks of International Business Machines
Corporation.
Adobe ® Acrobat ® Reader copyright © 1987-2005 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.
Doc. CWXTQX7E
May 5, 2005
iii
Contents
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii
Intended Audience. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Related Publications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
FrontLine Support Website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Online Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
World Wide Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Notation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Reading the Syntax Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Common Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
CSR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
keyword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
literal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
conditional-expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
PF Key Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Primary Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
AA SNAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
ACCEPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
AFTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
ALLOCATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
AT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
BEFORE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
BOTTOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
BROWSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
CCHILITE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
CONNECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
COUNT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
COVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
DELETE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
DLEFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
DLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
DRIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
DROP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
END . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
EXCLUDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
EXIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
FADB2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
FIND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
GEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
GETMAIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
GO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
GOBACK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
GOTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
iv XPEDITER/TSO and XPEDITER/IMS Quick Reference
GPREGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
IF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
INCLUDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
INSERT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
INTERCEPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
KEEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
LEFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
LINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
LOCATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
LOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
MEMORY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
MONITOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
MOVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
NOLINES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
PAUSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
PEEK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
PSEUDOSOURCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
RESET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
RESUME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
RETEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
RETURN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
REVERSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
RIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
RUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
SHOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
SKIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
SOURCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
TEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
TOGGLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
TOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
TRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
TSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
UP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
USE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
USING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
VERIFY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
WHEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
WHEREIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
WS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
XCHANGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
XPED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
<....................................................... 33
>....................................................... 33
A. .. . .. .. . .. .. . .. . .. .. . .. . .. .. . .. .. . .. . .. .. . .. .. . .. . .. .. 33
A, AA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
B, BB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
C. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
C, CC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
D: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
DA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
DB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
DC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
DD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
DE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
DG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
DH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
DS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
DT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
DV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
E, En, EE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
F, Fn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
G, GG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
GT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
H, Hn, HH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
I, In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
K, Kn, KK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
KE, KEn. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
KH, KHn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
K* . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
L, Ln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
M ...................................................... 37
P, Pn, PP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
PE, PEn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
PH, PHn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
P* . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
S, SS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
T, TT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
V, VV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
X, XX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
XP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Link-Edit Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Introduction Intro
This document summarizes the PF key settings, commands, and link-edit options
for XPEDITER/TSO, XPEDITER/IMS, and XPEDITER for DB2 Extension.
Intended Audience
This Quick Reference is written for application programmers engaged in program
development and maintenance. A working knowledge of COBOL, Assembler,
PL/I, or C, and your local system environment is assumed.
Related Publications
The following Compuware documents are also available for use with the
XPEDITER/TSO and XPEDITER/IMS product:
Online Documentation
Documentation for this product is provided on CD-ROM in several electronic
formats:
• View PDF files with the free Adobe Acrobat Reader, available at
http://www.adobe.com.
• View HTML files with any standard Web browser.
• View BookManager softcopy files with any version of IBM BookManager
READ or the IBM Softcopy Reader. To learn more about BookManager or to
download the free Softcopy Reader, go to http://www.ibm.com.
viii XPEDITER/TSO and XPEDITER/IMS Quick Reference
Notation Rules
The following notation rules are used throughout this document:
• Command names are shown in syntax diagrams with both the full name and
all possible abbreviations.
• A parameter is either a keyword or a variable.
– Maximum strings for keywords are shown in UPPERCASE characters and
must be spelled exactly as shown. The remaining characters of the
keyword can be included at your discretion.
– Variables are user-specified values and are printed in lowercase italics. For
example, dsname indicates you are to substitute a value.
The syntax for commands is described in diagrams that help you visualize
parameter use. The following example shows a command and a parameter:
COMMAND parameter
Read the diagrams from left to right and from top to bottom. These symbols help
you follow the path of the syntax:
Required parameters appear on the horizontal line (the main path). Optional
parameters appear below the main path. Default parameters appear above the
main path and are optional. The command will execute the same whether the
default parameter is included or not.
DEFAULT-KEYWORD
COMMAND REQUIRED-KEYWORD
optional-variable
DEFAULT-KEYWORD1 default-var1
COMMAND
OPTIONAL-KEYWORD2 optional-var2
OPTIONAL-KEYWORD3 optional-var3
If the same parameters are used with several commands, their syntax may be
documented in a separate diagram. In the command syntax, these common
parameters are indicated with separators before and after the parameter name.
COMMAND common-parameter
An arrow returning to the left indicates a repeatable item. If the arrow contains a
comma, separate the repeated items with a comma.
,
COMMAND required-var
x XPEDITER/TSO and XPEDITER/IMS Quick Reference
1
Common Parameters
The following common parameters are used throughout this document.
location
A place at which breakpoints are set or deleted. The following types of locations
are valid:
You can specify a valid location list separated by spaces or commas, or a range;
e.g., statement-number THRU statement-number. THRU is a required keyword
when specifying a range. A range is not valid for program-name.
data
A variable, data-name, data-item, data-label, or register (Rn).
CSR
The cursor. When valid, put the cursor on a data-item, variable, data-label, or
register and press an assigned PF key.
keyword
Any valid Help topic. For example: AFTER, BATCHCON, S0C1.
2 XPEDITER/TSO and XPEDITER/IMS Quick Reference
literal
Signed or unsigned integer or floating point number, alphanumeric string (' '),
hexadecimal string (X' '), or figurative constant (spaces, zeros, high-values, or
low-values).
conditional-expression
Any valid expression supported by XPEDITER/TSO that compares the
relationship of two items, tests the truth value of a specified condition, or checks
when a program variable changes value. Subsequent action of the program is
dependent on the result. The following standard operators are valid:
PF Key Settings
To change any PF key assignment, execute the KEYS command or use the SET
PFnn command.
Primary Commands
AA SNAP
Displays the Abend-AID Snapshot report.
AA SNAP
ACCEPT
For COBOL, assigns a value to a data item.
ACCEPT data
FROM ddname
AFTER
Sets a breakpoint after the execution of an instruction.
AFTER location
AFT
A
name, +/- offset, ALL STATE, ALL PARA, ALL PROG, ALL PROC, ALL LABELS, ALL
FUNC, ALL SQL [subtype], ALL DLI [subtype], ALL MQSERIES [subtype], ALL
variable, a list separated by spaces or commas, or a range using the keyword
THRU.
ALLOCATE
Dynamically accesses the file allocation utility (FAU) from the debugging session,
or allocates an existing file allocation list contained in the named dataset.
ALLOCATE
ALLOC dsname
AT
Sets a breakpoint in a program without source.
AT address
CSECT-name
offset
BEFORE
Sets a breakpoint before the execution of an instruction.
BEFORE location
BEF
B
BOTTOM
Scrolls to the bottom of the currently displayed data.
BOTTOM
BOT
BROWSE
Displays files or datasets.
BROWSE ddname
BRO 'dsname'
CCHILITE
CCHILITE provides visual cues with annotation and a high-intensity background
to indicate which lines have or have not been executed.
CCHILITE option
CONNECT
Connects the terminal to an XPEDITER/TSO Batch Connect job.
CONNECT
nodename NODE
jobname
(jobid)
(jobid)
COUNT
Sets execution counters to gather test coverage statistics.
COUNT location
COU MAX n
C
6 XPEDITER/TSO and XPEDITER/IMS Quick Reference
COVER
Used in the input command stream (XPIN DD) to activate Code Coverage for a
current test. It also denotes a “system name” with which to associate all Code
Coverage results recorded during an execution.
DELETE
Turns off or negates the effect of other XPEDITER commands.
DELETE
DEL ALL
D AFTer
location
AT
address
CSECT-name
offset
BEFore
location
COUnt
location
EXCLude
statement-number
GEN
statement-number
INSert
INTercept
program-name
module-name
Keep
data
CSR
MONitor
module-name
ALL
NOLines
Peek
data
CSR
Skip
location
TRAce
location
VERIFY
location
WHEN
data
conditional-expression
Refer to the specific primary command for a list of valid location choices.
Note: GEN is valid only for COBOL and Assembler, MONITOR is valid only for
COBOL, and VERIFY is valid only for Assembler.
8 XPEDITER/TSO and XPEDITER/IMS Quick Reference
DLEFT
Scrolls the data in a Keep or Peek window to the left by the specified scroll
amount.
DLEFT
n
Data
Half
Max
Page
DLI
Issues calls to IMS using the standard IBM CBLTDLI interface.
DOWN
Scrolls toward the bottom of the data.
DOWN
n
Csr
Data
Half
Max
Page
9
DRIGHT
Scrolls the data in a Keep or Peek window to the right by the specified scroll
amount.
DRIGHT
n
Data
Half
Max
Page
DROP
Valid only for Assembler, DROP releases addressability from a DSECT established
with the USING command.
DROP
address
dsect-name Rn
Rn
END
Terminates the current function and returns to the previous screen.
END
EXCLUDE
Excludes data lines from displaying in the source.
EXCLUDE ALL
EX address1
X THRU address2
offset1
THRU offset2
statement#
THRU statement#
10 XPEDITER/TSO and XPEDITER/IMS Quick Reference
Note: ALL is valid for COBOL, Assembler, and PL/I; address and offset are valid
only for Assembler.
EXIT
Terminates the current test session. The LAST parameter causes the step
completion code to reflect the last abend condition intercepted during the
session. The ABEND parameter causes the step to terminate with the specified
abend code.
EXIT
ABEND Unnnn
Snnn
LAST
FADB2
Accesses File-AID for DB2. Valid only with XPEDITER for DB2 Extension.
FADB2
PARMS
0
BROWSE
1
EDIT
2
UTILITY
3
ANALYSIS
4
TUTORIAL
T
EXPLAIN statement-number
HELP
FIND
Searches for character strings, data names, and COBOL structures. String
delimiters can be '', "", == ==, or nothing. Any number of optional parameters can
be specified with a required parameter. FIND without a keyword repeats the last
find.
11
NEXT
FIND string
F CSR ALL EXclude
FIRST NOLines
LAST
PREV
FIND string
F data name IN COBOL-structure-keyword ALL
CSR FIRST
NEXT
LAST
PREV
SUBset EXclude
NOLines
SUBset EXclude
NOLines
ALL
FIND COBOL-structure-keyword
F FIRST SUBset
NEXT
LAST
PREV
EXclude
NOLines
12 XPEDITER/TSO and XPEDITER/IMS Quick Reference
FIND INDirect
F
GEN
Valid only for COBOL and Assembler, GEN expands macros or compressed EXEC
code.
GEN
address
label-name
offset
statement-number
THRU statement-number
13
GETMAIN
Valid only for Assembler, GETMAIN allocates virtual storage. Any number of
optional parameters can be specified with a required parameter.
GETMAIN n
nK R1
LA=length address A=
LV=length value address
DBLWD
BNDRY=
PAGE
00
INIT=
character
BELOW
LOC=
ABOVE
ANY
0
SP=
subpool number
GO
Begins execution or resumes execution following a pause.
GO
STATE
n FUNC TRace
LABEL
PARA
PROC
PROG
Half
14 XPEDITER/TSO and XPEDITER/IMS Quick Reference
GOBACK
Valid only for COBOL, GOBACK changes the program logic and returns to the
next higher level module.
GOBACK
GOTO
Repositions the current execution pointer.
GOTO statement-number
line-number
paragraph-number
label-name
address
offset
GPREGS
Displays the contents of the general-purpose registers.
ON
GPREGS
OFF
LOG
HELP
Displays additional information about an error message or provides tutorial
information. HELP * redisplays the most recently browsed help file.
MENU
HELP
H *
INDEX
keyword
15
IF
Establishes a conditional expression within a block of inserted lines.
IF conditional-expression
.
.
.
XPEDITER/TSO commands
.
.
.
[ELSE
.
.
.
XPEDITER/TSO commands]
END-IF
INCLUDE
Executes a predefined test script during the session.
INCLUDE test-script-name
INC
INSERT
Temporarily inserts XPEDITER/TSO commands. The primary command syntax
outlined below can be used only in unattended batch or in an INCLUDE test
script. INSERT is only valid as a line command in interactive mode.
INSert statement-number
.
.
.
Any number of XPEDITER/TSO commands
.
.
.
END-INS
16 XPEDITER/TSO and XPEDITER/IMS Quick Reference
INTERCEPT
In an interactive test, the INTERCEPT command loads a module, sets before and
after breakpoints, and displays the source. In an interactive test in BTS or Dialog
Manager, XPEDITER/TSO automatically generates the command.
Note: ENTry is not valid for PL/I. Assembler can use only ENTry and LOAdm.
KEEP
Continuously displays the values of program variables in a Keep window. KeepE
keeps the contents of the elementary items of a group level variable. KeepH keeps
the contents in hexadecimal format. Displayed values are updated as each
breakpoint is encountered.
KEEP data
K LINKAGE
KeepE LOCAL-STORAGE
KeepH WORKING-STORAGE
CSR
LEFT
Scrolls the source listing to the left by the specified scroll amount.
LEFT
n
Data
Half
Max
Page
LINE
Determines whether the line command area will display statements, offsets, or
addresses.
STATE
LINE
LI 24
31
OFFset
LOAD
Dynamically loads a module.
DDNAME XTASKLIB
LOAD module-name
DDNAME ddname
DSNAME dsname
LOCATE
Scrolls to a particular line number in the current program. LOCATE * scrolls to
the current execution point.
LOCATE statement-number
LOC *
L offset
address
18 XPEDITER/TSO and XPEDITER/IMS Quick Reference
LOG
Browses the session log.
LOG
MEMORY
Displays memory from a specified location.
MEMORY statement-number
MEM line-number
paragraph-name
label-name
program-name
module-name
procedure-name
function-name
data
address
offset
MONITOR
Valid only for COBOL, MONITOR records the program’s execution in a buffer.
REVERSE can be used to execute in review mode at a later time.
MONITOR
MON module-name
module-list
ALL
RESET
MOVE
Changes the contents of program variables. In an interactive test, typing over the
displayed value is an implicit MOVE command.
19
Assembler Syntax
NOLINES
Suppresses the message XXX LINES NOT DISPLAYED that appears after an
EXCLUDE command or keyword is issued.
NOLINES
NOL
PAUSE
Sets a pause breakpoint within a block of inserted lines (interactive mode) or
commands (batch mode).
PAUSE
PEEK
Displays the values of program variables. PeekE displays the contents of the
elementary items of a group level variable. PeekH displays the contents in
hexadecimal format.
PEEK data
P LINKAGE
PeekE LOCAL-STORAGE
PeekH WORKING-STORAGE
PSW
CSR
20 XPEDITER/TSO and XPEDITER/IMS Quick Reference
PSEUDOSOURCE
Creates a temporary pseudo-assembler view for a module or CSECT that has no
matching Compuware source listing.
PSEUDOSOURCE module-name
PSEUDOSO offset
PSEUDO
PS
RESET
Restores excluded lines on the source screen and removes any pending line
commands.
RESET
RES EXCLude
RESUME
Valid only for COBOL, RESUME exits review mode and returns to the current
execution position.
RESUME
RETEST
Begins a new test of the same program, even if the current test has not
completed. Valid only in the TSO standard environment.
RETEST
RET
21
RETURN
Valid only for PL/I and Assembler, RETURN changes the program logic and goes
to the return linkage of a program.
RETURN
REVERSE
Valid only for COBOL, REVERSE reviews the execution path that led to the
current breakpoint. Requires previous entry of the MONITOR command.
REVERSE
REV
RIGHT
Scrolls the source listing to the right by the specified scroll amount.
RIGHT
n
Data
Half
Max
Page
RUN
Submits an execution JCL file and connects to the specified job.
RUN dsname
22 XPEDITER/TSO and XPEDITER/IMS Quick Reference
SET
Overrides XPEDITER/TSO defaults. Some values are set only for the duration of
the test session, while others are maintained across sessions. For more
information, see the XPEDITER/TSO and XPEDITER/IMS Reference Manual.
parm group 2
parm group 3
23
Parameter Group 1
ABENDSCR abend-script
ON
ABNDEXIT
AUTOKEEP OFF
BRCOV
CAPS
CARRAY
CBLTRAP
CONFIRM
DATETIME
DYNTRAP
ESPIE
LETRAP
LOG
AUTOKEEP
KEEP
MEMORY
PEEK
VERIFY
RTEREUS
TEMPLATE
UNCHNGED
OFF
AUTOCAN
AUTOCLOS ON
AUTOSCRL
COLS
DUMP
GEN
HEXMODE
LOG FIND
NOINIT
PREINIT
REFRESH
24 XPEDITER/TSO and XPEDITER/IMS Quick Reference
Parameter Group 2
;
CMDDLM
char
1
CMDSIZE
2
3
DATA xx
yy
ALL
DATAFIND
NEXT
OFF
DBCS
ON
DDIGNORE ddname-list
0
DELAY
. 0
0
1 n
2
3
DYNAMIC module-list
EXCLUDE
NOCANCEL
NOCOVER
0
HANDLER
1
INSTR xx
yy
ENglish
LANGUAGE
JApanese
80
LOGSIZE
132
ASIS
LOWCASE
CONVERT
KANA
LOCAL
NONE
32
MODE
64
25
Parameter Group 3
99
NESTED
nnn
.
NONDISP
char
default-value
PFnn
value
1M
REVSIZE
nnnnM
nnnnnnK
IGNORE0
STATIC
OFF
ON
TRANSFER module-name
TRANSLATE OFF
ON
xx
xx
ND
RESET
yy
0
WINDOW AUTOKEEP
MAX nnn
nnn
5
KEEP
MAX nnn
nnn
3
SOURCE
MIN nnn
nnn
The valid options and their keyword, value, or variable are shown below; defaults
are underscored.
26 XPEDITER/TSO and XPEDITER/IMS Quick Reference
ABENDSCR abend-script
ABNDEXIT ON/OFF
AUTOCAN ON/OFF (COBOL only)
AUTOCLOS ON/OFF
AUTOKEEP ON/OFF
BRCOV ON/OFF
CAPS ON/OFF
CARRAY ON/OFF
CBLTRAP ON/OFF (COBOL only)
CMDSIZE 1/2/3
COLS ON/OFF
CONFIRM ON/OFF
DATA xx yy (Assembler only)
DATAFIND NEXT/ALL (COBOL only)
DATETIME ON/OFF
DBCS ON/OFF
DDIGNORE ddname-list
DELAY 0/0.n/1.n/2.n/3.n
DUMP ON/OFF
DYNAMIC module-list
DYNTRAP ON/OFF (COBOL and Assembler only)
ESPIE ON/OFF
EXCLUDE module-list
GEN ON/OFF (COBOL and Assembler only)
HANDLER 0/1
HEXMODE ON/OFF
INSTR xx yy (Assembler only)
LANGUAGE ENglish/JApanese
LETRAP ON/OFF
LOG ON/OFF
LOG AUTOKEEP/FIND/KEEP/MEMORY/PEEK/VERIFY ON/OFF
LOGSIZE 80/132
LOWCASE CONVERT/ASIS/NONE/KANA/LOCAL
MODE 32/64
NOCANCEL module-list (COBOL only)
NOCOVER module-list
NOINIT ON/OFF (COBOL only)
NONDISP ./char
PFnn value
PREINIT ON/OFF
REFRESH ON/OFF
REVSIZE 1M/nnnnM/nnnnnnnK (COBOL only)
STATIC IGNORE0/ON/OFF
TEMPLATE ON/OFF
TRANSFER module-name
(WINDOW) AUTOKEEP (MAX) 0/nnn
(WINDOW) KEEP (MAX) 5/nnn
(WINDOW) SOURCE (MAX) 3/nnn
Note: DELAY is not valid in an unattended batch test. ABENDSCR is valid only
in an unattended batch test. CBLTRAP, DATAFIND, NOCANCEL, NOINIT,
and REVSIZE are valid only for COBOL. GEN and DYNTRAP are not valid
for PL/I. LOG AUTOKEEP VERIFY is valid only for Assembler.
27
SHOW
Displays breakpoints, diagnostic information, or the SET command options.
SHOW ACTive
SH AFTers
ALLOCates
AT
BEFores
BReaks
COMPopts
*
program-name
COUnts
NOLOG
DCBs
DATA
FILEs
FPREGS
Gpregs
IMSfunc
INDEX
INTercept
Keeps
LINKlist
LISTING
MODules
OPTions
PFkeys
PREVious
PROgram
program-name
PSW
PTFs
REGion
SETs
SKips
TRAces
Using
VERify
WHENs
WHERE
ZAPs
Note: AFTER, AT, BEFORE, BREAK, LISTING, PFKEY, and SKIP parameters are not
valid in unattended batch. COMPOPT, DCB, FILE, and INDEX are valid
28 XPEDITER/TSO and XPEDITER/IMS Quick Reference
only for COBOL. PSW is not valid for COBOL. USING and VERIFY are
valid only for Assembler.
SKIP
Temporarily bypasses the execution of a statement.
SKIP location
SKI
S
SOURCE
Changes the module shown on the source display when testing interactively. In
unattended batch (or in an INCLUDE file), use the SOURCE command to qualify
a module to be associated with subsequent XPEDITER commands.
SOURCE
SOU module-name
SO
module-name
The name of the module, external procedure, entry point, or CSECT to be
displayed on the Source screen. You can also refer to a program or module by
the name of the load module.
STATUS
Displays the Status screen which contains a list of the jobs in the system.
STATUS
ST
29
TEST
Specifies the name of the program to be tested and the parameters necessary to
establish the test. This command is used in the input command stream (XPIN
DD).
TEST program-name
ENTry entry-point
LOAdm load-module
INITscr initial-script
POStscr post-script
PARm 'parm-string'
STD
PARm
NOQ
SUB
Note: ENTRY, PARM NOQ, and PARM SUB are not valid for PL/I.
TOGGLE
Allows you to switch back and forth between the Listing screen and the Storage
screen for all languages.
TOGGLE
TOP
Scrolls to the top of the data.
TOP
TRACE
Monitors the program’s logic flow. If MAX n is not used, the default is 25 in
interactive mode and 2500 in unattended batch mode.
TRACE location
TRA MAX n
30 XPEDITER/TSO and XPEDITER/IMS Quick Reference
TSO
Executes TSO commands from within an XPEDITER test session.
TSO tso-command-and-operands
UP
Scrolls toward the top of the data.
UP
n
Csr
Data
Half
Max
Page
USE
Valid only for COBOL in IMS subprogram testing. Establishes addressability for
database PCBs in the linkage section.
Valid with XPEDITER/TSO only when the value of SUB is specified as a test
session parameter for the IMS environment.
31
USING
Valid only for Assembler, USING temporarily establishes addressability to a
DSECT. USING is effective only if the program has established a base register for
the DSECT and loaded the base register with the appropriate value.
VERIFY
Valid only for Assembler, VERIFY displays the contents of an instruction or data
area.
VERIFY address
VER label-name
V offset
statement-number
WHEN
Indicates when a specified condition is true or when a program variable changes
value. In an interactive test, execution is paused. In an unattended batch test,
execution does not pause. A message is written to the log indicating that the
specified condition has been met.
CHANGES
WHEN data-item
register operator literal
address L(len) keyword
class
NOT
WHEREIS
Displays the location of a specific address or CSECT.
WHEREIS
WHERE address
W label-name
module-name
offset
WS
Valid only for COBOL, WS displays working storage.
WS
XCHANGE
Accesses XPEDITER/Xchange to simulate date and time changes for your
applications.
XCHANGE
XCH
XPED
Specifies the environment in the input command stream (XPIN DD). Valid
environments are BATCH (default), BATCH PEM, BTS, BTS PEM, IMS, IMS PEM,
TSO, and TSO PEM.
XPED environment
Line Commands
Double-character line commands are used to specify a block of lines. An n
indicates a number.
33
:
Freezes the line at the current column.
:n
Scrolls a line to column n.
<
In the Keep window, displays the character variable on the line as an array.
>
In the Keep window, displays the variable on the line as a full character string.
A
In the Keep window, displays the character variable on the line as an array.
A, AA
Sets an after breakpoint on a line or block.
B, BB
Sets a before breakpoint on a line or block.
34 XPEDITER/TSO and XPEDITER/IMS Quick Reference
C
In the Keep window, displays the variable on the line as a full character string.
C, CC
Sets a count on a line or block.
D
Deletes all breakpoints on a Procedure Division line.
D:
Enables left and right scrolling on a frozen line.
DA
Deletes the after breakpoint on a line.
DB
Deletes the before breakpoint on a line.
DC
Deletes the count on a line.
35
DD
Deletes all commands and breakpoints on a block of lines.
DE
Deletes the display of elementary values.
DG
Collapses the macro on a line.
DH
Deletes the values displayed in hexadecimal format.
DS
Deletes the skip on a line.
DT
Deletes the column template from above a displayed variable.
DV
Deletes the verified field.
E, En, EE
Displays the elementary items for the first or nth variable on a line or block.
36 XPEDITER/TSO and XPEDITER/IMS Quick Reference
F, Fn
Reshows the first or n line(s) from a block of excluded lines.
G, GG
Expands macros or compressed EXEC code (GEN) on a line or block.
GT
Repositions (GOTO) the current execution pointer to a line.
H, Hn, HH
Displays the first or nth variable on a line or block in hexadecimal format.
I, In
Inserts one or n line(s) below the current line.
K, Kn, KK
Keeps the first or nth variable on a line or block.
KE, KEn
Keeps the elementary items for the first or nth variable on a line.
KH, KHn
Keeps the first or nth variable on a line in hexadecimal format.
K*
Keeps all variables on a line.
37
L, Ln
Reshows the last or n line(s) from a block of excluded lines.
M
Displays memory starting from the address associated with a line.
P, Pn, PP
Temporarily displays (PEEK) the first or nth variable on a line or block.
PE, PEn
Displays the elementary items for the first or nth variable on a line.
PH, PHn
Displays the first or nth variable on a line in hexadecimal format.
P*
Displays all variables on a line.
S, SS
Sets a skip on a line or block.
T, TT
Displays a column template above a displayed or kept item or block.
V, VV
Verifies an instruction or data area on a line or block.
X, XX
Excludes a line or block.
XP
Captures and displays EXPLAIN information about an EXEC SQL or inserted SQL
statement. Valid only with the XPEDITER for DB2 Extension.
Link-Edit Options
All link-edit options are supported except OVLY and NE. Note that NOTEST
deletes SYM records from the load module for Assembler.