Initial product customization using IMS Tools Setup

What does IMS Tools Setup do?

After the selected IMS Tools solution pack products have been installed into SMP/E data sets, IMS Tools Setup provides a process to simplify the initial configuration that is required to begin using the products. IMS Tools Setup generates JCL members that you then submit as jobs, or perform as tasks, to complete the customization process.

IBM IMS Tools Base components are also configured and customized during the IMS Tools Setup process. IBM IMS Tools Base provides important supporting components and infrastructure that are required for the operation of many IMS Tools functions, such as storage repositories, autonomics, and interaction with IMS.

The goal of IMS Tools Setup is to greatly ease the time and effort it takes to have IMS Tools products up and running in your environment.

IMS Tools Setup is intended only for initial product installations, first-time users, and product evaluations. IMS Tools Setup is not intended for maintenance purposes.

IMS Tools products that can use IMS Tools Setup

The following IMS Tools products and solution packs can use IMS Tools Setup for initial configuration:

• IBM IMS Tools Base
• IBM IMS Database Solution Pack for z/OS®
• IBM IMS Fast Path Solution Pack for z/OS
• IBM IMS Recovery Solution Pack for z/OS
• IBM IMS Database Utility Solution for z/OS
• IBM IMS Administration Tool for z/OS
• IBM IMS Cloning Tool for z/OS
• IBM IMS Program Restart Facility for z/OS

Starting IMS Tools Setup

The IMS Tools Setup function (HKTQSETU) can be found in IBM IMS Tools Base. You can start the function by running the following REXX EXEC:

EXEC ‘smpehlq.SHKTCEXE(HKTQSETU)’ ‘HLQ(smpehlq)’

The IMS Tools Setup ISPF panels provide an organized and logical approach to the customization tasks. The panels explain the operation and sequence of each member that is generated in the CUSTJCL data set. The correct JCL job and task operation order is very important.

Each panel contains embedded panel-context and individual field-context Help information. All information about using IMS Tools Setup is contained in the embedded Help. There is no separate user guide.

While using the IMS Tools Setup function to install IMS Tools products or to migrate your products from an earlier release to a later release, you need to specify the names of the libraries, or data sets, that are required for each IMS Tools product. Use the worksheets in the topic "Data set names for IMS Tools Setup" in the IMS Tools Base Configuration Guide to make a summary of the data set names that will be used in your environment.

Completing IMS Tools Setup

After you run the HKTQSETU REXX EXEC, you can refer to the $$READ member in the generated hlq.CUSTJCL data set to view summary information about the JCL members that were generated. Additionally, all individual hlq.CUSTJCL members contain detailed descriptions of the functions for each job.

Each of the generated JCL members begin with the number sign (#) and are named in the logical sequence of operation. Any members ending with the at sign (@) require manual steps. You must begin with the first #xxxx member and submit the JCL job or perform the task. After that job or task completes, you continue on to the next member and submit that JCL job or perform that task, and so forth.

The first few members are all SYSPROG related (APF, LPA, SSN, MVSPPT), followed by security related members, TCP/IP administration, DBA related members, and others.

You must process all members in the correct order to complete the full customization task properly.

Each JCL member has its own descriptive comment section that explains what the member does and which group it might belong to.