Creating setup file for your IMS program by using IBM z/OS Debugger Utilities

Note: This section is not applicable to IBM® Developer z/OS® (non-Enterprise Edition).

You can create setup files for your IMS Batch Messaging Process (BMP) program which describe how to create a custom region and defines the STEPLIB concatenation statements that reference the data sets for your IMS program's load module and the z/OS Debugger load module. You can also create and customize a setup file to create a private message region that you can use to test your IMS message processing program (MPP). Creating a private message region with class X allows you to test your IMS program run by transaction X and reduce the risk of interfering with other regions being used by other IMS programs.

To create a setup file for your IMS program by using IBM z/OS Debugger Utilities, do the following steps:

  1. Start IBM z/OS Debugger Utilities. If you do not know how to start IBM z/OS Debugger Utilities, see Starting IBM z/OS Debugger Utilities.
  2. In the IBM z/OS Debugger Utilities panel (EQA@PRIM), type 4 in the Option line and press Enter.
  3. In the Manage IMS Programs panel (EQAPRIS), type 2 in the Option line and press Enter.
  4. In the Create Private Message Regions - Edit Setup File panel (EQAPFORA), type in the information to create a new setup file or edit an existing setup file. Press Enter.

    Create a private message region to customize your application or z/OS Debugger libraries while you debug your application so that you do not impact other user's activities. Consult your system administrator for authorization and rules regarding the creation of private message regions.

    After you specify the setup information required to run your IMS program, you can specify the information needed to create a private message region you can use to test your IMS program or specify how to run a BMP program. To specify this setup information, do the following steps:

  5. In the Edit Setup File panel (EQAPFORI), type in the information to start IMS batch processor. Type a forward slash (/) in the field Enter / to modify parameters, then press Enter to modify parameters for the batch processor.
  6. In the Parameters for IMS Procedures panel (EQAPRIPM), use one of the following values in the TYPE field to indicate which action you want done:
    • MSG to start a private message region.
    • BMP to run a BMP program.

    Enter other parameters as needed. Press PF1 for information about the parameters.

  7. After you type in the specifications, you can submit your job for processing by pressing PF10.