8 Using imsgenconf to Generate Tuxedo ART for IMS Configuration

You can use the imsgenconf tool to generate Tuxedo ART for IMS configurations from z/OS definitions. Before using imsgenconf you must create a directory (definition directory) containing the following files:

  • One IMS online transaction/batch application definition dataset:

    One dataset that contains APPLCTN and TRANSACT macro. Only could have one dataset.

  • PSB files:

    Datasets that contain PSBGEN macro. Could have multiple datasets.

  • DBD files:

    Datasets that contain DBD macro. Could have multiple datasets.

If you only wants to generate Tuxedo ART for IMS configurations for particular Transaction/Batch applications, you can create a white list (IMS.WHITE) or black list (IMS.BLACK), under the top definition directory.

  • If IMS.WHITE exists under top definition directory, imsgenconf only generates configurations for transactions/batch applications which are defined in the white list.
  • If IMS.BLACK exists under top definition directory, imsgenconf only generates configurations for transactions/batch applications which are not defined in the black list.
  • If both the IMS.WHITE and IMS.BLACK exist under the top definition directory, IMS.WHITE is the default.
  • If both IMS.WHITE and IMS.BLACK does not exist under the top definition directory, imsgenconf will generate configurations for all transaction/Batch applications.

For more information, see Configuration Files in the Tuxedo ART for IMS Reference Guide

For DB related configuration in imsdbs.desc, imsgenconf only generates configurations for the DBs that are actually used by the Transaction/Batch applications.

Note:

For Batch or transaction oriented batch programs, if the program name is not equal to PSBNAME, you must manually change “NAME=program” in imsapps.desc.

The following must also be configured manually:

imsresources.desc: The persistent transaction definition configuration.

$ART_IMS_CONFIG/$dbname/segments.desc: Segment description file of one IMS/DB for ODBA solution.

$ART_IMS_CONFIG/$dbname/$segments.desc: Description file of one segment for one IMS/DB for ODBA solution.