Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
Writing IDF macros HLASM Toolkit Feature Interactive Debug Facility User's Guide GC26-8709-07 |
|
You can tailor IDF through the use of REXX programs (macros) that IDF invokes. These macros have a default ADDRESS of "ASM".
Most IDF commands can be issued within a macro. In particular, you can use the SET and EXTRACT commands to set or extract the settings of various parameters, and the target program's memory and registers. IDF commands may be abbreviated as shown in Abbreviations. There are many potential uses for
IDF macros. A few examples are:
An IDF macro:
You can invoke a macro in several ways:
Here is an example of a special purpose macro that sets up some
breakpoints, opens a Disassembly window, and runs the target program
to the first breakpoint:
Figure 1. Example of
a special purpose macro
IDF propagates the return code from your macro to the caller if it is invoked by another IDF macro. If the top level macro exits with a nonzero return code, IDF issues a message, so if you want to perform your own message handling you need to exit with a return code of zero. There are times when one of several macros is setting an IDF option, and it is difficult to determine just where the option is being set. The MACROLOG option helps debug this sort of macro problem. Whenever this option is in effect, all IDF commands that are issued by either an IDF macro or a IDF exit routine are written to the macro log. See MACROLOG for the name of this log. Warning: Be careful when executing CMS
commands from within your macro. If you are debugging a user-area
program, and your macro invokes another program that runs in the user
area, it destroys your debugging environment. The same care should
be taken with routines that run in the transient area.
Numbers in expressions can be specified in explicit (X'123', F'123') or implicit (123) notation. Numbers that do not explicitly specify the base are evaluated according to the current setting of the HEXINPUT option. When writing macros it is recommended that you use explicit base notation. |
Copyright IBM Corporation 1990, 2014
|