Preparing an IMS program
To prepare an IMS™ program, do the following tasks:
- Verify that Planning your debug session and Updating your processes so you can debug programs with Debug Tool have been completed.
- Contact your system programmer to find out the preferred method
for starting Debug Tool and which of the following methods you need to
use to specify TEST run time options:
Starting Debug Tool under IMS by using
CEEUOPT or CEEROPT
You can specify your TEST runtime options by using CEEUOPT
(which is an assembler module that uses the CEEXOPT macro to set application
level defaults, and is link-edited into an application program) or
CEEROPT (which is an assembler module that uses the CEEXOPT macro
to set region level defaults). Every time your application program
runs, Debug Tool is started.
To use CEEUOPT to specify your TEST runtime options,
do the following steps:
- Code an assembler program that includes a CEEXOPT macro invocation
that specifies your application program's runtime options.
- Assemble the program.
- Link-edit the program into your application program by specifying
an INCLUDE LibraryDDname(CEEUOPT-member name)
- Place your application program in the load library used by IMS.
To use CEEROPT to specify your TEST runtime options,
do the following steps:
- Code an assembler program that includes a CEEXOPT macro invocation
that specifies your region's runtime options.
- Assemble the program.
- Link-edit the program into a load module named CEEROPT by specifying
an INCLUDE LibraryDDname(CEEROPT-member name)
- Place the CEEROPT load module into the load library used by IMS.
Managing runtime options for IMSplex users by using Debug Tool Utilities
This topic describes how to add, delete, or modify TEST runtime
options that are stored in the IMS Language Environment runtime
parameter repository. To manage the items in this repository, do the
following steps:
- From the main Debug Tool Utilities panel (EQA@PRIM), type 4 in the
Option line and press Enter.
- In the Manage IMS Programs panel (EQAPRIS), type
1 in the Option line and press Enter.
- In the Manage LE Runtime Options in IMS panel
(EQAPRI), type in the IMSplex ID and optional qualifiers. Debug Tool Utilities
uses this information to search through the IMS Language Environment runtime
parameter repository and find the entries that most closely match
the information you typed in. You can use wild cards (* and %) to
increase the chances of a match. After you type in your search criteria,
press Enter.
- In the Edit LE Runtime Options Entries in IMS panel
(EQAPRIM), a table displays all the entries found in the IMS Language Environment runtime
parameter repository that most closely match your search criteria.
You can do the following tasks in this panel:
- Delete an entry.
- Add a new entry.
- Edit an existing entry.
- Copy an existing entry.
For more information about a command or field, press PF1 to
display a help panel.
- After you finish making your changes, press PF3 to save your
changes and close the panel that is displayed. If necessary, press
the PF3 repeatedly to close other panels until you reach the Manage IMS Programs
panel (EQAPRIS).
Setting up the DFSBXITA user exit routine
To make the debug session use the options you specified in
the Manage LE Runtime Options in IMS function,
you must use the DFSBXITA user exit supplied by IMS. This
exit contains a copy of the Language Environment CEEBXITA user exit that is customized
for IMS. The DFSBXITA user exit either replaces the
exit supplied by Language Environment in CEEBINIT, or is placed in your load
module.
- To make the user exit available installation-wide, do a replace
link edit of the IMS CEEBXITA into the CEEBINIT load
module in your system hlq.SCEERUN Language Environment runtime
library.
- To make the user exit available region-wide, copy the CEEBINIT
in your hlq.SCEERUN library into a private library,
and then do a replace link edit of the IMS CEEBXITA
into the CEEBINIT load module in your private library. Then place
your private library in the STEPLIB DD concatenation sequence before
the system hlq.SCEERUN data set in the MPR region
startup job.
- To make the user exit available to a specific application, link
the IMS CEEBXITA into your load module. The user exit
runs only when the application is run.
The following sample JCL describes how to do a replace link edit
of the IMS CEEBXITA into a CEEBINIT load module:
INCLUDE MYOBJ(CEEBXITA) 1
REPLACE CEEBXITA
INCLUDE SYSLIB(CEEBINIT)
ORDER CEEBINIT MODE AMODE(24),RMODE(24)
ENTRY CEEBINIT
ALIAS CEEBLIBM
NAME CEEBINIT(R)
When you assembled the IMS user exit DFSBXITA, if you named
the resulting object member DFSBXITA, replace CEEBXITA on line 1 with
DFSBXITA.
|
This information center is powered by Eclipse technology. (http://www.eclipse.org)