Adding support for debugging under IMS

To add support for debugging applications that run in IMS, you need to do the following steps:

  1. Choose one of the following methods for specifying TEST runtime options:
    • Specifying the TEST runtime options in a data set, created by the application programmers, which is then extracted by a customized version of the Language Environment® user exit routine CEEBXITA.
    • Specifying the TEST runtime options in one of the following assembler modules:
      • CEEUOPT, which is an assembler module that uses the CEEXOPT macro to set application level defaults, and is link-edited into an application program.
      • CEEROPT, which is an assembler module that uses the CEEXOPT macro to set region level defaults.
    • Specifying the TEST runtime options through the EQASET transaction. The transaction allows application programmers to specify a limited set of TEST runtime options.
    • Specifying the TEST runtime options in a private message region, created by the application programmer using IBM® z/OS® Debugger Utilities option 4.3, "Swap IMS Transaction Class and Run Transaction".
    • Specifying the TEST runtime options in a private message region, created by the application programmer using IBM z/OS Debugger Utilities option 4.5, "IMS Transaction Isolation Facility".
  2. Choose from the following scenarios that best matches your site's environment:
    Scenario A
    You run programs in IMS Transaction Manager, BTS, or DB and are managing TEST runtime options with a user exit. Do the steps described in Scenario A: Running IMS and managing TEST runtime options with a user exit to enable this scenario.
    Scenario B
    You run programs in IMS Transaction Manager, BTS, or DB and are managing TEST runtime options with CEEUOPT or CEEROPT. Do the steps described inScenario B: Running IMS and managing TEST runtime options with CEEUOPT or CEEROPT to enable this scenario.
    Scenario C
    You run assembler programs without Language Environment in IMS Transaction Manager and you specify some TEST runtime options with the EQASET transaction. Do the steps described in Scenario C: Running assembler program without Language Environment in IMS TM and managing TEST runtime options with EQASET to enable this scenario.
    Scenario D
    You run programs in an IMSplex environment and are managing TEST runtime options with either a user exit, CEEUOPT, or CEEROPT. Do the steps described in Scenario D: Running IMSplex environment to enable this scenario.
    Scenario E
    You run Message Processing Programs (MPPs) in IMS Transaction Manager, running in Message Processing Regions (MPRs). You want to isolate application program debugging and to avoid scheduling delays or conflicts with programs which are not being debugged. Do the steps described in Scenario E: Enabling users to launch private message regions and to assign transactions to private message regions to enable this scenario.
    Scenario F
    You run Message Processing Programs (MPPs) in IMS Transaction Manager, running in Message Processing Regions (MPRs). You want to isolate application program debugging and to avoid scheduling delays or conflicts with programs which are not being debugged. Do the steps described in Scenario F: Enabling the Transaction Isolation Facility to enable this scenario. The IMS Transaction Isolation Facility is not available in IBM Wazi Developer for Red Hat® CodeReady Workspaces.
    You can select more than one scenario. If you select more than one scenario, some steps are repeated. Perform those steps only once.
  3. After you have selected the method that your site will use to manage TEST runtime options, notify your application programmers of the chosen method. Ensure that the application programmers follow the directions described in "Preparing an IMS program" in the IBM z/OS Debugger User's Guide and choose the correct method for specifying TEST runtime options. If your application programmers are using the EQASET transaction to specify TEST runtime options, ensure that they follow the directions described in "Running the EQASET transaction" in the IBM z/OS Debugger User's Guide .