Creating an IMS environment
You create an IMS environment to keep conversion projects and definitions for different IMS systems in one place. Help is available for each panel.
About this task
An IMS environment consists of library definitions such as RESLIB, DBDLIB, MDALIB and, perhaps, RECON. Projects are connected to an environment.
Environments typically have names such as TEST or PROD. There is no limit to the number of environments you can create. An environment must be completely defined before it can be used by a project.
Databases can belong to multiple IMS systems. However, only one RECON should represent a database.
Parameters and data sets are uniquely defined for each IMS environment, and most parameters can have an ask-me-later setting. This setting allows you to delay a decision until it is needed and applicable.
Procedure
- Start the ISPF user interface.
The IMS HALDB Toolkit main menu is displayed.
Figure 1. Main menu panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> _ Select Function Current Settings Environment: Version: IMS 14 Tool 1100 0 Setup Utilities 1 Add-Delete-Change Environment 2 Select an Environment 3 Projects in Progress 4 Convert from Full Function to HALDB 5 Convert entire DBD library to HALDB 6 Split or Consolidate HALDB Partitions 7 Database Utilities 8 Other Utilities 9 DBRC for HALDB - Select option 1 from the Main Menu and press Enter.
The Environment Maintenance panel is displayed.
Figure 2. Environment Maintenance panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Environment Maintenance Select Function 1 Display Environment(s) 2 Add a new Environment 3 Delete Environment(s) 4 Change Environment Settings - To add a new environment, select option 2 from the Environment
Maintenance panel and press Enter.
The Define a New Environment panel is displayed:
Figure 3. Define a New Environment panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Define a new Environment Environment Name: PROD Description: Production IMS - Enter an environment name and a description that provides
useful information. Press Enter.
The Project Definition Settings panel is displayed.
You can now define project-related definitions that are specific to the environment.
Figure 4. Project Definition Settings panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Project Definition Settings Project Method: 2 1 Partitioning evaluation separate 2 Partitioning evaluation during UNLOAD JCL Generation: 1 1 Single JOBs for each phase 2 One multi-step JOB (after evaluation) Delete old Database: 1 1 No 2 Yes, before allocation of new 3 Yes, after reload 4 Yes, at the end of the project - On this panel make the following specifications:
- Whether to perform partitioning evaluation separately or during the unload process
- How you would prefer JCL to be generated (as a single JOB for each phase or as one multi-step JOB)
- Whether you would like the data sets of the database that is being converted, to be deleted. If the data sets are to be deleted, specify at which stage the deletion occurs.
When you have finished specifying all of the panel information, press Enter.
The Data sets panel is displayed.
Figure 5. Data sets panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Datasets RESLIB : your.SDFSRESL : : : : : MACLIB : your.SDFSMAC LOADLIB : your.SIHCLOAD DFSVSAMP : your.JCL Member name: VSAMP MDALIB 1: your.MDALIB 2: RECON MDA located in: 4 1 RESLIB 2 MDALIB 1 3 MDALIB 2 4 Specify RECON datasets - From the Data Sets panel, specify
the data sets to use when generating the JCL. When the IMS management of ACBs is enabled, the following libraries must be specified in the RESLIB:
- The SGLXLOAD library of IBM® IMS Tools Base for z/OS® 1.7 or later
- The IMS Catalog Definition exit routine (DFS3CDX0)
Figure 6. Data sets panel when the IMS management of ACBs is enabled ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Datasets RESLIB : your.SDFSRESL : your.SGLXLOAD : your.pgmlib : : : MACLIB : your.SDFSMAC LOADLIB : your.SIHCLOAD DFSVSAMP : your.JCL Member name: VSAMP MDALIB 1: your.MDALIB 2: RECON MDA located in: 4 1 RESLIB 2 MDALIB 1 3 MDALIB 2 4 Specify RECON datasetsIf the RECONs are not located in either the RESLIB or MDALIB data sets, you can specify them explicitly with option 4. Otherwise, the Specify RECON Data set names panel is skipped.
- If you selected option 4 to specify RECON data sets, the Specify
RECON Data Set Names panel is displayed.
Figure 7. Specify RECON Data Set Names panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Specify RECON Data set names: RECON1 your.RECON1 RECON2 your.RECON2 RECON3 your.RECON3 - Specify the RECON data set names to use and press Enter.
The DBD Libraries panel is displayed.
Figure 8. DBD Libraries panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> DBD Libraries DBDLIB 1: your.DBDLIB 2: 3: 4: 5: 6: 7: 8: 9: - Specify the DBD load libraries to use and press Enter.
When the IMS management of ACBs is enabled, do not specify the DBD load libraries to use and press Enter.
Figure 9. DBD Libraries panel when the IMS management of ACBs is enabled ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> DBD Libraries DBDLIB 1: 2: 3: 4: 5: 6: 7: 8: 9:The DBD Conversion Rules panel is displayed.
Figure 10. DBD Conversion Rules panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> DBD Conversion Rules Multi DSG: 2 1 To single DSG 2 Leave as-is 3 Ask during Conversion Convert VSAM to OSAM: 2 1 Yes 2 No 3 Ask during Conversion Change DBD name: 2 1 Yes 2 No Selection Exit: 2 1 Yes 2 No 3 Ask during Conversion Heal Index Pointer 1 1 Yes 2 No 3 Ask during Conversion - Specify the conversion rules to use, and press Enter.
The Save Source Statements panel is displayed.
Press the HELP key for explanation of items on the panel.
Figure 11. Save Source Statements panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Save Source Statements DBD Source: 1 1 No 2 Yes Source File: IDCAMS Source: 1 1 No 2 Yes 3 Yes, but no DELETE file Member Name: 3 1 DBD Name 2 Partition Name 3 DD Name Del File: Def File: - Specify where you would like to save the generated DBD
source and the IDCAMS source statements, and press Enter.
The Primary DBD Partitioning Rules panel is displayed.
Figure 12. Primary DBD Partitioning Rules panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Primary DBD Partitioning Rules Partitions: 2 1 Fixed Number of Partitions 1 2 Fixed Partition Size (MB) 2048 3 Ask during Conversion 4 Specify High Keys PDB Conversion: 2 1 Use existing Keys or Partitions 2 Create new Partition boundaries 3 Ask during Conversion Additional Partitioning Layouts to be created? 2 1 Yes 2 No, use the one created during Collect Combine Database records: 5000 (number of database records) - Specify conversion rules for the primary DBD, and press Enter.
The PSINDEX Definition Rules panel is displayed.
Figure 13. PSINDEX Definition Rules panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> PSINDEX Definition Rules 2 1 Fixed Number of Partitions Partition Number 1 2 Fixed Partition Size Size (MB) 1024 * Ask during Conversion 4 Same high keys as the primary DBD (Index is the ROOT key) (Primary DBD must specify keys) (Defaults to "2" if index not the root key) - Specify the conversion rules for secondary index DBDs,
and press Enter.
The Partition Naming Rules panel is displayed.
Figure 14. Partition Naming Rules panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Partition Naming Rules Partition Name: 1 1 DBD name (up to 6) appended by 1 1 0-9,A-Z 2 A-Z 3 1-9,A-Z 4 01-99 5 AA-99 (..,AZ,A0,..,A9,BA,..) 6 001-999 3 Ask for partition name during Conversion 4 Ask for constant (6 char) during Conversion 5 DBD pattern ******.. Prim ******.. Index (Example: ..***.**) and append rule Partition DSN: 1 1 High-level qualifier and DBD name 2 High-level qualifier and Partition name Specify High-level qualifier: DBSMS.DBIHC 3 Ask during Conversion - Specify the naming rules for partition names and partition
data set names, and press Enter.
The Space Allocation Rules for PHDAM and PHIDAM panel is displayed.
Figure 15. Space Allocation Rules for PHDAM and PHIDAM panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Space Allocation Rules for PHDAM and PHIDAM HDAM RAA Size: 1 1 Clone from DBD 2 (1) and increase 10 percent 3 Ask during Conversion Overflow Size: 1 1 Clone from original data set 2 (1) and increase 10 percent 3 Ask during Conversion Byte limit: 1 1 Same as old DBD 2 None 3 Ask during Conversion SMS Allocation: 2 1 Yes DATACLAS:______ STORCLAS:_____ 2 No, ask for Volume serial 3 Yes,SMS via Data set Name 4 Yes, clone from original data set - Specify space allocation rules for both PHDAM and PHIDAM,
and press Enter.
The Space Allocation Rules for PSINDEX Data Sets panel is displayed.
Figure 16. Space Allocation Rules for PSINDEX Data Sets panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Space Allocation Rules for PSINDEX Data Sets Free Space per CI: 1 1 Copy from old Index 2 Set to 10 percent 3 Ask during Conversion Free Space per CA: 1 1 Copy from old Index 2 Set to 10 percent 3 Ask during Conversion Data set Allocation: 2 1 Fit to current need 2 Add 10 percent 3 Ask during Conversion SMS Allocation: 3 1 Yes DATACLAS:_____ STORCLAS:_____ 2 No, ask for Volume serial 3 Yes, no SMS parameter 4 Yes, copy from original data set CI Size: 4 (1, 2, 4, 6, 8, 12) in Kbytes - Specify space allocation rules for HALDB secondary indexes,
and press Enter.
The Space Allocation Rules for ILDS Data Sets panel is displayed.
Figure 17. Space Allocation Rules for ILDS Data Sets panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Space Allocation Rules for ILDS datasets Free Space per CI: 1 1 Do not specify 2 Set to 10 percent 3 Ask during Conversion Free Space per CA: 1 1 Do not specify 2 Set to 10 percent 3 Ask during Conversion Dataset Allocation: 2 1 Round to full Cylinder 2 Add 10 percent 3 Ask during Conversion SMS Allocation: 3 1 Yes DATACLAS: ____ STORCLAS:_____ 2 No, ask for Volume serial 3 Yes, no SMS parameter CI Size: 8 (1, 2, 4, 6, 8, 12) in Kbytes - Specify space allocation rules for HALDB ILDS data sets,
and press Enter.
The JCL Defaults panel is displayed.
Figure 18. JCL Defaults panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> JCL Defaults JOB statement: //JOBNAME JOB 0,USR,MSGCLASS=X //* //* //* Allocation Rules for UNLOAD file Set the maximum database size to use disk allocation Database Size Limit(MB): 200 Unit name for tape allocation: TAPE RETPD.......: 030 Volume count: 99 Unit name for disk allocation: SYSDA Use REGION=0M? (Y|N) N - Specify the JOBCARD JCL defaults and the allocations rules
to use during the unload process and press Enter.
The Utility Setup for UNLOAD panel is displayed.
Figure 19. Utility Setup for UNLOAD panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Utility Setup for UNLOAD 1 Select Unload type 1 Standard IMS (DFSURGU0) 2 High Performance Unload 1 Select Data set Name Rule for Unload File 1 High Level Qualifier.dbd.timestamp 2 High Level Qualifier.dbd.GDG Specify High Level Qaulifier: your.hlq 3 Prompt for Data set Name Specify HP Unload program library: your.SHPSLMD0 - Specify the specific rules to use for the UNLOAD utility
and press Enter.
The Utility Setup for RELOAD panel is displayed.
Figure 20. Utility Setup for RELOAD panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Utility Setup for RELOAD 1 Select Reload type 1 Standard IMS (DFSURGU0) 2 High Performance Reload Specify STEPLIB for High Performance Reload: your.SHPSLMD0 - Specify the specific rules to use for the RELOAD utility
and press Enter.
The Utility Setup for BACKUP panel is displayed.
Figure 21. Utility Setup for BACKUP panel ------------------------------ IMS HALDB Toolkit ----------------------------- Command ===> Utility Setup for BACKUP 1 Select Backup type 1 Standard IMS (DFSUDMP0) 2 HP Image Copy (FABJMAIN) 1 Select No. of copies (1 or 2) 1 Select Data set Name Rule 1 High Level Qualifier.dbd.ddname.IC.timestamp 2 High Level Qualifier.ddname.IC.timestamp 3 High Level Qualifier.dbd.ddname.IC.GDG 4 High Level Qualifier.ddname.IC.GDG Specify High Level qualifier: your.hlq 5 Use the one created by GENJCL.IC Specify Data set Name for Product Library: your.SHPSLMD0 - Specify the specific rules to use for the image copy utility and press Enter.
Results
After you have completed all panels, a dialog box displays indicating that the environment was successfully created.
If the environment was successfully created, press Enter and the first panel for creating a project will be displayed.
You can create the project now or later.