Rational Developer for System z, Version 7.6

Preparing an IMS program

To prepare an IMS™ program, do the following tasks:

  1. Verify that Planning your debug session and Updating your processes so you can debug programs with Debug Tool have been completed.
  2. 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:

  1. Code an assembler program that includes a CEEXOPT macro invocation that specifies your application program's runtime options.
  2. Assemble the program.
  3. Link-edit the program into your application program by specifying an INCLUDE LibraryDDname(CEEUOPT-member name)
  4. Place your application program in the load library used by IMS.

To use CEEROPT to specify your TEST runtime options, do the following steps:

  1. Code an assembler program that includes a CEEXOPT macro invocation that specifies your region's runtime options.
  2. Assemble the program.
  3. Link-edit the program into a load module named CEEROPT by specifying an INCLUDE LibraryDDname(CEEROPT-member name)
  4. 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:

  1. From the main Debug Tool Utilities panel (EQA@PRIM), type 4 in the Option line and press Enter.
  2. In the Manage IMS Programs panel (EQAPRIS), type 1 in the Option line and press Enter.
  3. 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.
  4. 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: For more information about a command or field, press PF1 to display a help panel.
  5. 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.

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.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)