HLASM Toolkit Feature Interactive Debug Facility User's Guide
Previous topic |
Next topic
|
Contents
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
HLASM Toolkit Feature Interactive Debug Facility User's Guide
GC26-8709-07
Toolkit Feature Interactive Debug Facility User's Guide
Abstract for Toolkit Feature Interactive Debug Facility User's Guide
What is IDF and how do I start using it?
Introduction to the Interactive Debug Facility
Capabilities
Execution control
Symbol support
Typeover storage modification
Intelligent cursor sensing
Screen swapping
Record and playback
Customization - profile and macros
Where can I run IDF?
Environments supported
Limitations when debugging on TSO
Limitations when debugging on CMS
Limitations when debugging under z/VSE
Getting started with IDF
Program preparation
Program debug basics
Sample debug session on TSO
Sample program preparation
Invoking IDF
Invoking IDF with a TSO batch job
Sample debug session on z/OS
Invoking IDF with a batch job
Sample debug session on CMS
Sample program preparation
Invoking IDF
Sample debug session on z/VSE
Sample program preparation
Invoking IDF
Running IDF on a sample program
Guide to using IDF
Using ASMLANGX to extract source-level information
Assembly requirements
Program build requirements
Building a module on z/OS
Building a module on CMS
Building a phase on z/VSE
Running ASMLANGX
Extraction file allocation on z/OS
Online language extraction on TSO
Batch language extraction on z/OS
Online language extraction on CMS
Batch language extraction on z/VSE
Which files to keep
Return codes
Invoking IDF to debug your program
Running IDF on TSO and CMS
Running IDF via TSO batch job
Running IDF via z/OS batch job
Running IDF on z/VSE
IDF options at invocation
1ADSTOP (CMS only)
AMODE24 | AMODE31 | AMODE64 (z/OS only)
ASCII
AUTOLOAD | NOAUTOLD
AUTOSIZE | NOAUTOSZ
BCX | NOBCX
CKSUBCM
CMDLOG
CMPEXIT
COLORS | COLOURS
COMMAND
DMSO (CMS only)
EXITEXEC
FASTPATH | PATH | PATHFILE
FULLQUAL
HEXDISP
HEXINPUT
IMPMACRO | NOIMPMAC
INVPSW | NOINVPSW
ISA (CMS only)
LIBE (z/OS and CMS)
LINE (CMS only)
LUNAME (z/VSE and z/OS)
LSMDEBUG
MACROLOG
MODE (CMS only)
MODMAP | NOMODMAP (CMS only)
NODSECTS
NUCEXT (CMS only)
OFFSET
OLDBREAK
PASSPGM
PROFILE | NOPROFIL
QWDUMP
RISK
RLOG
ROWSTYLE
SBORDER
SCDACTIV
SELFNUCX (CMS only)
STOPNOP | NOSTOPNP
STOPSTMT | NOSTOPST
SVC97 | NOSVC97 (z/OS only)
SWAP
SYSTEM (CMS only)
TRACEALL
TRANS (CMS only)
UNFTDUMP
Initialization of general-purpose registers (GPRs)
Initialization of floating point registers
Initialization of access registers
The PATH, FASTPATH, and PATHFILE options
Using the PATH option
Using the PATHFILE option
Using the FASTPATH option
Excluding called subroutines
Debugging programs on z/OS
Data set naming conventions
Optional data set file allocations
Breakpoint method selection (TSO)
SVC 97 breakpoints
Invalid opcode breakpoints
Specifying the breakpoint method
Breakpoint method (z/OS batch)
How to specify parameters for your program (TSO)
The COMMAND option (TSO)
How to specify parameters for your program (z/OS Batch)
Loading programs (TSO)
File allocation requirements
The TSOEXEC command
Programs requiring environmental setup (TSO)
The COMMAND option
TSO batch and z/OS batch job requirements
Dynamically loaded programs (TSO)
Programs invoked by REXX (TSO)
ISPF applications (TSO)
DB2 applications (TSO)
Causing a break-in event (TSO)
Your program's defined limits
Programs performing full-screen I/O (TSO)
Applications that use z/OS subtasking
Debugging programs on CMS
Program preparation on CMS
How to specify parameters for your program
User-area programs
CMS transient programs
CMS nucleus extensions loaded explicitly
Self-loading CMS nucleus extensions
Programs requiring environmental setup
The COMMAND option
Dynamically loaded programs
Programs invoked by REXX
Programs declaring interrupt routines
Causing a break-in event
Your program's defined limits
PER versus non-PER mode
Programs performing full-screen I/O
Using a message-trapping tool
Debugging programs on z/VSE
Data set naming conventions
How to specify parameters for your program
Loading programs
JCL requirements
Dynamically loaded programs
Running with subtasks
Running with CICS
Using ASMIDF to debug a CICS/VSE application
Debugging STXIT code
Causing a break-in event
Your program's defined limits
Programs performing full-screen I/O
Windows, PF keys, cursor positioning, and other operational details
Windows
AdStops window (CMS only)
Additional Floating-Point Registers window
Break window
Current Registers window
Disassembly window
Dump window
Entry Point Names window
LSM Information window
Minimized Windows Viewer
Options window
Old Registers window
Skipped Subroutines window
Target Status window
Some examples of actual screens
Specifying a window
PF keys
Command record and playback features
Address expressions
Addresses displayed by IDF
Arguments and cursor positioning
Source-level debug additional capabilities
Controlling single-stepping your program
Displaying and changing items
Variable expressions
Variable scope
Variable names
Simple variables
Aggregate variables
Dot qualification
Based variables
Array indexing
Substrings
Displaying variable names
Displaying CALLERS
Source level support
Commands and operating procedures
IDF commands cross-reference
ABEND (CMS and z/OS)
ADSTOP (CMS only)
ADSTOPS (CMS only)
AFPR
ALARM
ALET
APROGMSG (CMS only)
AREGS
ARRAY
AUDIT
BACK
BASE
BINARY
BIT
BOTTOM
BREAK
BRIEF
CALLERS
CHARACTER
CHECK
CLOSE
COLORS
COMMAND
COMPACT
CREGS (CMS only)
CURSOR
DBREAK
DETAIL
DISASM
DOWN
DROP GLOBAL
DROP MODULE
DROP SYMBOLS
DUMP
DUMPMODE
EPNAMES
EPOFFSET
EXITEXEC
EXLIMIT
FIND
FIRST
FIXED
FLOAT
FMT
FOLLOW
FORMAT
FPC
FPR
GLOBALS
GOTO
GPACK
GPR
GPRG (z/OS only)
GPRH (z/OS only)
GSTATUS
HIDE
HISTORY
ICOUNT
KWDSYN
LANGUAGE +
LANGUAGE COLOR
LANGUAGE COMMENTS
LANGUAGE DEBUG
LANGUAGE DECLARES
LANGUAGE DROP
LANGUAGE LOAD
LANGUAGE MACROS
LANGUAGE OPTIONS
LANGUAGE SCROLL
LANGUAGE STATUS
LANGUAGE STEM
LANGUAGE VERSION
LANGUAGE XPATH (CMS and z/OS)
LAST
LASTMSG
LEFT
LIBE (CMS and z/OS)
LOAD
LOCATE
LOCATION
LOCATION ALET
MACRO
MAJOR
MAP
MAXIMIZE
MINIMIZE
MODE (CMS only)
MODULE
MODULE
MODULE BASE
MODULE SIZE
MOVE
MPACK
MRUN
MRUN invoked through address ASM on CMS
MSG
MSGID (CMS and z/OS)
MSGMODE
MSTATUS
MSTEP
NAMES
NEXT
OFFSET
OPEN
OPTIONS
ORDER
OREGS
PACKED
PARMS
PAUSE
PER (CMS only)
PFK
PFKDISP
PLOCATES
PRESERVE
PREVIOUS
PROGCHK (CMS only)
PROGCK (CMS only)
PSW
PSWSTEAL (CMS only)
QUALIFY
QQUIT
QUIET
QUIETLY
QUIT
RCQUIT
REFRESH
REGS
REGS64 (z/OS only)
REGSTOPS (CMS only)
RESTORE
RETRIEVE
RIGHT
RLOG
RUN
RUNEXIT
R0-R15
SALIMIT
SAREGS
SAVE
SEARCH
SELFNUCX (CMS only)
SET ADSTOP (CMS only)
SET AREG
SET BREAK
SET COMMAND
SET EXITEXEC
SET GLOBAL STEM
SET GLOBAL TEXT
SET ICOUNT
SET OFFSET
SET OPTION
SET PSW
SET REGSTOP (CMS only)
SET SIZE
SHOW
SIZE
SKIPSTEP
SPACE
STATUS
STEP
STMTSTEP
STOKEY
STOREMAP
STRUCTURE
SUBSET (CMS only)
SVC (CMS only)
SWAP
SYMBOL
TASKS (TSO only)
TITLE
TOP
TRIGGER LOAD
TYPE
UNION
UNTIL
UP
VALUE
VARIABLE
VCHANGE
VERSION
VS
VSEP
WATCH
WHERE
XEDEXIT (CMS only)
ZONED
Advanced topics, macros, profiles, exit routines
Writing an IDF profile
When the PROFILE is executed
Command restrictions related to PROFILE execution
Writing IDF macros
REXX linkage considerations
The REXX ADDRESS statement
Initial or default ADDRESS environment
Overriding the default ADDRESS Environment
Saving and restoring an ADDRESS environment
Example macros
EX
REGS
SYSCMD
The IDF exit routine
Naming the exit routine
Controlling exit routine processing
Passing the reason for invocation
Looking at the address
Ignoring the event
Other techniques
Writing a compiled-language IDF exit routine
Specifying that an exit routine is compiled code
Requirements for compiled-language exit routines
REXX variables available to macros
REXX variables with fixed names
REXX variables with variable names
The EXTRACT command
Return codes
ADSTOPS (CMS only)
ALET
AREGS
ARGUMENT | ARGS
ARRAY
BREAK
CALLERS
CMDMSG
COLORS
CURSOR
Symbolic addresses
DISASM
EVENT
EXITEXEC
GLOBAL
GLOBAL STEM
GLOBAL STEMS
GSTATUS
ICOUNT
LANGUAGE ARGUMENTS | ARGS
LANGUAGE COMMANDS | CMDS
LANGUAGE OPTIONS
LANGUAGE STATUS
LANGUAGE STEM
LANGUAGE VERSION
LASTMSG
LOAD
LOCATION
LOCATION ALET
MAP
MODE (CMS only)
MODULES
MSTATUS
NAMES
OPTIONS
PER (CMS only)
PFK
PLIST
PLOCATES
QUALIFY
QUERY SETTING
REGS
REGSTOPS (CMS only)
SCOPE
SCRVAR
SELFNUCX
SKIPSTEP
SOURCE
STOREMAP
STRUCTURE
SVC (CMS only)
SYMBOLS
TASKS
TYPE
UNION
VALUE
VARIABLE
VDECLARE | VDCL
VERSION
VLOC
VVALUE
WINDOWS
ASMLANGX options
ASM
CONDASM | NOCONDASM
DCL | NODCL
DEBUG
ERROR
IFM (CMS only)
INCL | NOINCL
LOUD | QUIET
MACDEF | NOMACDEF
OFM (CMS only)
OFN
OFT
PACK | NOPACK
PFM (CMS only)
PFT
SEQ | NOSEQ
Diagnostic messages
Message numbers and severity levels
ASMLKEDT messages (z/VSE only)
ASMKLK000W
ASMKLK001S
ASMKLK002S
ASMKLK003S
ASMKLK004S
ASMKLK005I
ASMKLK006S
ASMKLK007S
IDF Language Support messages
ASMLVR001E
ASMLVR002E
ASMLVR003E
ASMLVR004E
ASMLVR005E
ASMLVR006E
ASMLVR010I
ASMLVR011I
ASMLVR012I
ASMLVR013I
ASMLVR020E
ASMLVR030E
ASMLVR031E
ASMLVR032E
ASMLVR033E
ASMLVR034E
ASMLVR035E
ASMLVR036E
ASMLVR037E
ASMLVR040I
ASMLVR041I
ASMLVR042I
ASMLVR043I
ASMLVR050I
ASMLVR051I
ASMLVR052E
ASMLVR053I
ASMLVR060E
ASMLVR061E
ASMLVR065E
ASMLVR066E
ASMLVR070E
ASMLVR072W
ASMLVR080I
ASMLVR090I
ASMLVR100E
ASMLVR110E
ASMLVR120I
ASMLVR121E
ASMLVR122E
ASMLVR123E
ASMLVR130I
ASMLVR131W
ASMLVR132E
ASMLVR140I
ASMLVR141W
ASMLVR142E
ASMLVR143E
ASMLVR144E
ASMLVR145E
ASMLVR146I
ASMLVR147I
ASMLVR148W
ASMLVR150I
ASMLVR151I
ASMLVR152I
ASMLVR153I
ASMLVR154I
ASMLVR155I
ASMLVR160I
ASMLVR161I
ASMLVR162E
ASMLVR170I
ASMLVR171I
ASMLVR172E
ASMLVR173E
ASMLVR180I
ASMLVR181I
ASMLVR182E
ASMLVR183E
ASMLVR190I
ASMLVR191I
ASMLVR192E
ASMLVR193E
ASMLVR200E
ASMLVR201E
ASMLVR202E
ASMLVR203E
ASMLVR204E
ASMLVR205E
ASMLVR206E
ASMLVR210E
ASMLVR211E
ASMLVR212E
ASMLVR213E
ASMLVR214E
ASMLVR215E
ASMLVR220E
ASMLVR221E
ASMLVR222W
ASMLVR223E
ASMLVR224W
ASMLVR225W
ASMLVR226E
ASMLVR227E
ASMLVR230E
ASMLVR231E
ASMLVR232E
ASMLVR233E
ASMLVR234E
ASMLVR235E
ASMLVR236E
ASMLVR240E
ASMLVR241E
ASMLVR242E
ASMLVR243E
ASMLVR244E
ASMLVR250E
ASMLVR251W
ASMLVR252W
ASMLVR253E
ASMLVR254E
ASMLVR255E
ASMLVR256E
ASMLVR257E
ASMLVR258E
ASMLVR270E
ASMLVR271E
ASMLVR272E
ASMLVR273E
ASMLVR274E
ASMLVR300E
ASMLVR310E
ASMLVR311E
ASMLVR312E
ASMLVR313E
ASMLVR320E
ASMLVR321E
ASMLVR322E
ASMLVR323E
ASMLVR324E
ASMLVR325E
ASMLVR326E
ASMLVR400E
ASMLVR410E
ASMLVR411E
ASMLVR412E
ASMLVR413E
ASMLVR414E
ASMLVR420E
ASMLVR421S
ASMLVR422E
ASMLVR423E
ASMLVR424E
ASMLVR425E
ASMLVR426W
IDF base debugger messages
ASMMAI001W
ASMMAI002W
ASMMAI003W
ASMMAI004W
ASMMAI005W
ASMMAI006W
ASMMAI007W
ASMMAI008W
ASMMAI009W
ASMMAI010W
ASMMAI011W
ASMMAI012W
ASMMAI013W
ASMMAI014W
ASMMAI015W
ASMMAI016W
ASMMAI017I
ASMMAI018I
ASMMAI019I
ASMMAI020W
ASMMAI021I
ASMMAI022I
ASMMAI023E
ASMMAI025W
ASMMAI026W
ASMMAI027W
ASMMAI028E
ASMMAI029I
ASMMAI030W
ASMMAI032W
ASMMAI033E
ASMMAI034E
ASMMAI035E
ASMMAI037E
ASMMAI038E
ASMMAI039E
ASMMAI040E
ASMMAI041E
ASMMAI042E
ASMMAI044E
ASMMAI045E
ASMMAI046E
ASMMAI048E
ASMMAI049E
ASMMAI050E
ASMMAI051E
ASMMAI057E
ASMMAI058E
ASMMAI060E
ASMMAI061E
ASMMAI062E
ASMMAI064E
ASMMAI065E
ASMMAI066E
ASMMAI067E
ASMMAI068E
ASMMAI069E
ASMMAI070E
ASMMAI071E
ASMMAI073E
ASMMAI074E
ASMMAI075E
ASMMAI080E
ASMMAI081E
ASMMAI083E
ASMMAI084W
ASMMAI085E
ASMMAI087I
ASMMAI088I
ASMMAI089E
ASMMAI090W
ASMMAI091W
ASMMAI095E
ASMMAI096E
ASMMAI097E
ASMMAI098I
ASMMAI100I
ASMMAI102E
ASMMAI103E
ASMMAI104E
ASMMAI105I
ASMMAI106I
ASMMAI107E
ASMMAI108W
ASMMAI109W
ASMMAI112W
ASMMAI113A
ASMMAI114E
ASMMAI115E
ASMMAI116E
ASMMAI117E
ASMMAI118E
ASMMAI119E
ASMMAI120E
ASMMAI121W
ASMMAI126E
ASMMAI127E
ASMMAI128E
ASMMAI129E
ASMMAI134I
ASMMAI135E
ASMMAI136E
ASMMAI137E
ASMMAI138E
ASMMAI139I
ASMMAI140E
ASMMAI141E
ASMMAI142A
ASMMAI143E
ASMMAI144I
ASMMAI145E
ASMMAI146E
ASMMAI148W
ASMMAI149W
ASMMAI150E
ASMMAI151E
ASMMAI152W
ASMMAI153I
ASMMAI154W
ASMMAI155W
ASMMAI156E
ASMMAI157E
ASMMAI158E
ASMMAI159I
ASMMAI160I
ASMMAI161E
ASMMAI162E
ASMMAI163E
ASMMAI164E
ASMMAI165E
ASMMAI166E
ASMMAI167W
ASMMAI168W
ASMMAI169E
ASMMAI172E
ASMMAI173I
ASMMAI176E
ASMMAI178I
ASMMAI179I
ASMMAI180I
ASMMAI181E
ASMMAI182E
ASMMAI183E
ASMMAI185E
ASMMAI187E
ASMMAI188W
ASMMAI189I
ASMMAI190E
ASMMAI191I
ASMMAI192E
ASMMAI193E
ASMMAI194I
ASMMAI195E
ASMMAI196I
ASMMAI197E
ASMMAI198I
ASMMAI199E
ASMMAI200E
ASMMAI201E
ASMMAI202E
ASMMAI203E
ASMMAI204I
ASMMAI205I
ASMMAI207I
ASMMAI208E
ASMMAI209E
ASMMAI210E
ASMMAI211E
ASMMAI212E
ASMMAI213W
ASMMAI214E
ASMMAI215E
ASMMAI216E
ASMMAI217E
ASMMAI218E
ASMMAI219I
ASMMAI221W
ASMMAI222E
ASMMAI223E
ASMMAI224E
ASMMAI225E
ASMMAI226E
ASMMAI227W
ASMMAI228I
ASMMAI229S
ASMMAI237E
ASMMAI238E
ASMMAI239E
ASMMAI241E
ASMMAI242E
ASMMAI243E
ASMMAI245I
ASMMAI246I
ASMMAI247W
ASMMAI248I
ASMMAI250E
ASMMAI252E
ASMMAI253E
ASMMAI254E
ASMMAI255E
ASMMAI256E
ASMMAI257W
ASMMAI262W
ASMMAI264E
ASMMAI265E
ASMMAI266E
ASMMAI272I
ASMMAI275E
ASMMAI500E
ASMMAI501E
ASMMAI502E
ADATA extraction utility messages
ASMXMA001I
ASMXMA002I
ASMXMA003I
ASMXMA004I
ASMXMA005I
ASMXMA006I
ASMXMA007I
ASMXMA008I
ASMXMA010I
ASMXMA011I
ASMXMA013I
ASMXMA014I
ASMXMA015I
ASMXMA016I
ASMXMA017I
ASMXMA018I
ASMXMA050W
ASMXMA051S
ASMXMA052S
ASMXMA054S
ASMXMA055S
ASMXMA056S
ASMXMA057S
ASMXMA058S
ASMXMA059I
ASMXMA100S
ASMXMA101W
ASMXMA102T
ASMXMA103S
ASMXMA104W
ASMXMA105W
ASMXMA111S
ASMXMA114S
ASMXMA115W
ASMXMA116W
ASMXMA120W
ASMXMA130S
ASMXMA131S
ASMXMA132S
ASMXMA133S
ASMXMA134S
ASMXMA135S
ASMXMA136S
ASMXMA137S
ASMXMA138T
ASMXMA139S
ASMXMA150T
ASMXMA151T
ASMXMA152W
ASMXMA153W
ASMXMA154W
ASMXMA155W
ASMXMA156W
ASMXMA157W
ASMXMA159W
ASMXMA160W
ASMXMA161W
ASMXMA162W
ASMXMA163W
ASMXMA164W
ASMXMA165W
ASMXMA166W
ASMXMA167W
ASMXMA168W
ASMXMA200W
ASMXMA201T
ASMXMA210S
ASMXMA211W
ASMXMA212W
ASMXMA213W
ASMXMA214S
ASMXMA220W
ASMXMA221W
ASMXMA222W
ASMXMA223W
ASMXMA224W
ASMXMA225W
ASMXMA226W
ASMXMA228W
ASMXMA229W
ASMXMA231S
ASMXMA232S
ASMXMA233S
ASMXMA235W
ASMXMA240S
ASMXMA241S
ASMXMA242S
ASMXMA311T
Abbreviations
Performance considerations
Migrating from TSO/E TEST to IDF
General considerations
Invoking the target program
Specifying the target program parameters
Bibliography
Glossary
Index
Copyright IBM Corporation 1990, 2014