What's new in IMS Administration Tool

This topic summarizes the technical changes for this edition.

New and changed information is denoted by carets (Symbol that indicates the start of new or changed content) and (Symbol that indicates the end of new or changed content) at the beginning and end of the new or changed information. Editorial changes that have no technical significance are not noted.

Revision markers follow these general conventions:

  • Only technical changes are marked; style and grammatical changes are not marked.
  • If part of an element, such as a paragraph, syntax diagram, list item, task step, or figure is changed, the entire element is marked with revision markers, even though only part of the element might have changed.
  • If a topic is changed by more than 50%, the entire topic is marked with revision markers (so it might seem to be a new topic, even though it is not).

Revision markers do not necessarily indicate all the changes made to the information because deleted text and graphics cannot be marked with revision markers.

Start of change

SC27-9011-28 (May 2024)

Description Related APARs
ISPF client enhancement. When IMS Tools Base Distributed Access Infrastructure (DAI) TAS (Tools Access Server) is running on each of multiple LPARs, requests from the ISPF client are routed to the same DAI TAS as the LPAR on which the IMS system is running. The following topics are updated: PH60740
The following messages are updated:
  • ATY3101E
  • ATYZ001E
PH60043 and PH61300
End of change

SC27-9011-27 (April 2024)

Description Related APARs
Change to the export objects function of the IMS catalog and ACB library management function: The export objects function provides an option to export logical DBDs and GSAM information from DBD and PSB libraries. This enhancement is for the ISPF interface only.

To enable this option, apply the PTF for APAR PH60138 to IMS Library Integrity Utilities.

The following topic is updated: Export objects reference.

PH60147
Documentation update for Run IMS utilities (JCL generation). Added description of required modifications to run product function JCL in IMS-managed ACBs environment. See IMS maintenance tasks and Required modifications for IMS-managed ACBs environment. N/A

SC27-9011-26 (February 2024)

Description Related APARs
Message changes accompanying code changes for fixing retry behavior when certain return and reason codes are received from the IXGWRITE macro. The following messages are updated: ATY8406I, ATY8407I, ATY8408I, ATY8409I PH59741

SC27-9011-25 (January 2024)

Description Related APARs
Enhancement to the manage IMS groups function. In IMS data sharing groups, you can specify whether to obtain DBD, PSB, and ACB libraries information from the RECON ID or not. This enhancement is for the ISPF interface only. PH58182

SC27-9011-24 (November 2023)

Description Related APARs
Changes to the IMS catalog and ACB library management function: The export objects function and the import objects function support initialization of the following data sets, which are used for storing DBD and PSB source statements:
  • Export objects function: Export data sets
  • Import objects function: Backup data sets

If initialization is requested, all existing members in the data sets are deleted before export or import. If initialization is not requested, existing members in the data sets are not deleted; new members are added and any member with the same name is overwritten.

To enable this option, apply the PTF for APAR PH57421 to IMS Library Integrity Utilities.

The following topics are updated:
PH57394

SC27-9011-23 (September 2023)

Description Related APARs
Ability to classify users into two types, super administrators and regular users, by using Security Authorization Facility (SAF). Classifying users is optional. If users are classified, the following changes are made to the IMS Administration Tool environment:
  • Only super administrators can define and change scope designations of products and systems.
  • Only super administrators can configure settings from the Setup and Administration menu. In the ISPF interface, some functions that are available from the Setup and Administration menu are also made available from the Settings menu of each function so that regular users can also configure some settings.
  • Relaxes the permission required to change the options for the record DBD/PSB statements function from UPDATE to READ, allowing super administrators to change the options. Users with UPDATE authority do not need to be changed to READ authority.
PH55647
Ability to define DBD libraries, PSB libraries, and ACB libraries for IMS data sharing groups of IMS Administration Tool.
  • DBD, PSB, and ACB libraries can be defined only through the ISPF interface.
  • When DBD, PSB, and ACB libraries are defined, information about defined libraries is stored to IMS Tools Knowledge Base as RECON ID. Information in RECON ID is also shared with IMS Tools Base and IMS Administration Foundation. PTFs of the following APARs must be applied:
    • APAR PH55736 to IMS Tools Base 1.7.
    • If you are using IMS Administration Foundation, APAR PH56865 to IBM® Unified Management Server.

  • Data set information that is stored in RECON ID is used during the DBDGEN, PSBGEN, ACBGEN, and catalog populate processes of the IMS resource change function and the import objects function.
    • Before this APAR/PTF is applied, IMS Administration Tool used DBD, PSB, and ACB library data sets that it discovers from the IMS control region JCL and PROCLIB. After this APAR/PTF is applied, IMS Administration Tool uses DBD libraries, PSB libraries, and ACB libraries that are defined for the IMS data sharing group.
    • If no DBD, PSB, and ACB libraries are defined for the IMS data sharing group, IMS Administration Tool uses the data sets discovered from the IMS control region JCL and PROCLIB.
  • The libraries that are defined for IMS data sharing group are also referred to by IMS Management Console when IMS Administration Tool functions are used through IMS Management Console.
PH55647
Documentation updates: N/A

SC27-9011-22 (April 2023)

Description Related APARs
Changes to the import objects function of the IMS catalog and ACB library management function:
  • (ISPF interface only) An option to migrate non-IMS-managed ACBs to IMS-managed ACBs is added to the Import Objects panel.
  • Import objects jobs can run whether the IMS system is active or inactive. However, when it processes IMS-managed ACBs and if initialization of IMS catalog is requested, the IMS system must be inactive.
The following topics are updated:
PH53764

SC27-9011-21 (February 2023)

Description Related APARs
Changes to the IMS catalog and ACB library management function:
  • An option to generate batch JCL for deleting obsolete instances is added to DBD Detail Report and PSB Detail Report panels.
  • (ISPF interface only) Estimated average sizes of DBD/PSB instances are no longer displayed in IMS catalog space analysis and summary reports.
The following topics are updated:
PH52162

SC27-9011-20 (December 2022)

Description Related APARs
DBD and PSB statement recording option for IMS resource change and import objects functions.
  • Records DBD and PSB statements (before and after change) to the audit log (z/OS System Logger) or data sets.
  • Recorded DBD and PSB statements can be viewed from the View Audit Log panel.
  • If the recording destination is data sets, data set names are also written to audit log records. You can view recorded DBD and PSB statements from the View Audit Log panel by clicking the data set name in the audit log (ISPF interface only).
  • Security Authorization Facility (SAF) facility class ATYADMIN.SETUP controls who can change audit log settings.
PH50782

SC27-9011-19 (November 2022 second update)

Description Related APARs
IMS command processing. Documentation changes related to system abend B37 that occurs with SYSPRINT DD when using IMS command processor (batch processing). The following topics are updated: PH50788

SC27-9011-18 (November 2022)

Description Related APARs
Command and Audit Log Archive (ATYARCH0) utility enhancement. The utility can archive log records that are generated by IMS Command Control Facility. The following topics are added, updated, or removed: PH50044

SC27-9011-17 (September 2022)

Description Related APARs
Documentation update: A message that appears while setting up a Java environment for IMS SPUFI JBP can be ignored. Description is added to Setting up a Java environment for IMS SPUFI JBP. N/A

SC27-9011-16 (August 2022)

Description Related APARs
IMS catalog and ACB library management enhancement. DBD/PSB Detail report is enhanced as follows:
  • For each DBD/PSB instance, shows relevant DBD and PSB members found in IMS directory or ACB libraries.
  • More detailed status indicators.
  • C column that indicates mismatch between DBD/PSB members and active/pending instances.
  • Supports the capability to delete instances.

For more information, see IMS catalog space analysis and summary reports.

PH47747
Documentation changes to support IBM IMS Tools Base for z/OS 1.7. N/A

SC27-9011-15 (June 2022)

Description Related APARs
Changes in IMS directory/BSDS backup and restore. The ISPF panels and the behavior of the IMS directory/BSDS backup and restore function have changed as follows in an environment where an IMS directory is shared by multiple IMS systems (ACBSHR=Y parameter is set):
  • The Search Backups in All IMS IDs field in the Restore from Latest panel is obsolete. IMS Administration Tool identifies the latest backup taken with any sharing IMS systems.
  • The List Backups of the Same IMS Directory in All IMS IDs option in the Backup List panel is obsolete. All backups from all sharing IMS systems are displayed in a list from which you can select the backup to use for restore.
  • Prior to this APAR, settings parameters must be defined for each IMS system. After this APAR, if you define settings parameters for one of the sharing IMS systems, these setting parameter values are applied to all other sharing IMS systems.

These changes are for the ISPF interface only.

PH46468
Documentation changes related to the database and application administration function. Modified some descriptions to accommodate terminology changes made to the ISPF panels. The following topics are updated: PH46865

Documentation changes related to the IMS SPUFI function. IMS SPUFI JBP issues a SYNC(commit) DL/I call on ISPUFI execution regardless of whether all SQL statements are successfully processed or not. The function has been modified so that a SYNC(commit) DL/I call is issued only when all of the SQL statements are successfully processed. The following topic is updated: IMS SPUFI overview

PH46335, PH46774

SC27-9011-14 (May 2022)

Description Related APARs
Changes made to an ISPF panel for IMS SPUFI (IMS SQL processing using file input). The following topic is updated: Set IMS SPUFI options reference PH46335

SC27-9011-13 (April 2022)

Description Related APARs

Documentation updates:

N/A

SC27-9011-12 (March 2022)

Description Related APARs
IMS directory/BSDS backup and restore enhancement. Before restoring the IMS directory, the compare function can compare the backup of IMS directory with the IMS catalog database. This enhancement is for the ISPF interface only. The following topics are updated: PH43372
Compare function enhancements. These enhancements are for the ISPF interface only:
  • Before this APAR, the DBD/PSB compare panel can be accessed from the IMS Catalog and ACBLIB Management menu. After this APAR, the panel can be accessed from the Database and Application Administration menu.
  • Ability to compare DBD and PSB resources in IMS directory data sets (either original data sets or backup data sets) with those in the IMS catalog database.
PH41813
Topic "Wildcard support" is removed. N/A

SC27-9011-11 (December 2021)

Description Related APARs
IMS directory/BSDS backup and restore enhancement - SMS class support. You can specify the SMS class for backup and restore data sets. IMS Administration Tool uses the SMS class specifications as follows:
  • Backup: Creates backup data sets using the high-level qualifier (HLQ) and the SMS class specifications.
  • Restore: If the discovery of restore data sets fails and IMS Administration Tool cannot find restore data sets, creates IMS data sets using the SMS class specifications.
This enhancement is for the ISPF interface only. The following topics are updated:
PH41941

SC27-9011-10 (November 2021)

Description Related APARs
Enhancement to the Register an IMS Subsystem interface. When you register an IMS subsystem to IMS Administration Tool, you can supply region parameters for DLISAS, IRLM, DBRC, and JBP regions (in addition to IMS control region parameters). This enhancement is for the ISPF interface only. The following topic is updated: Register an IMS Subsystem reference PH42082

SC27-9011-09 (October 2021)

Description Related APARs
New format for printing decoded DBDGEN and PSBGEN macro statements. The object explorer function (database and application administration) and the export objects function (IMS catalog and ACB library management) support FORMAT_COL10 format for printing decoded DBDGEN and PSBGEN macro statements. This format is available only through the ISPF interface. The following topics are updated: PH41095
Option to delete DBD and PSB instances from the IMS catalog database (IMS catalog and ACB library management). Obsolete DBD and PSB instances can be deleted from DBD Detail Report and PSB Detail Report panels. This option is available only through the ISPF interface. The following topics are updated: PH40909

SC27-9011-08 (September 2021 second update)

Description Related APARs
Documentation changes related to IMS directory/BSDS backup enhancement. The following topics are updated: PH38517

SC27-9011-07 (September 2021)

Description Related APARs
IMS directory/BSDS backup enhancement. Automatic backup (Auto Backup) is supported. By enabling automatic backup, a backup of the IMS directory is taken after a successful completion of the IMPORT DEFN command. New and changed topics are as follows:
Also, the naming rules for the backup data set are changed as follows:
  • IMS ID is added to the data set name.
  • The maximum number of characters for the high-level qualifier (HLQ) is changed from 32 to 27.
For the naming rules, see IMS directory/BSDS backup and restore settings reference.
PH38517

SC27-9011-06 (July 2021)

Description Related APARs
The backup list, which is available in the DBD/PSB compare function for IMS directory data sets, is enhanced. In the DBD/PSB Compare IMS Directory Data Sets panel, new fields are introduced. You can select data sets from the backup list when selecting the source IMS directory and the target IMS directory. See DBD/PSB compare reference—IMS directories. PH38430

SC27-9011-05 (June 2021)

Description Related APARs
Enhancements related to IMS directory support. These enhancements are available only for the ISPF interface. PH36741
IMS Administration Tool can decode DBD and PSB instances stored in the IMS catalog database. Changes are made to the following topics: PH31048
The Run IMS utilities (JCL generation) function supports a new JCL template for registering databases to DBRC. See IMS maintenance tasks for a list of JCL templates available with the Run IMS utilities function. PH29930

SC27-9011-04 (November 2020)

Description Related APARs
Enhancements for the IMS Administration Tool ISPF interface. The ISPF interface has been enhanced to support the following capabilities: These new capabilities are available only with the ISPF interface. The web interface does not support these new capabilities.

Step-by-step instructions to use these enhancements are provided in Technote: How to change DBDs and PSBs by using IBM IMS Administration Tool for z/OS.

PH28185

SC27-9011-03 (March 2020)

Description Related APARs
PH15400
IMS SPUFI (ISPUFI) function enhancement to support processing of SQL statements with an IMS Java application. See Setting up a Java environment for IMS SPUFI JBP and IMS SPUFI overview. PH19835
Messages added to Messages (ATY0 - ATY9) and Messages (ATYA - ATYZ). N/A

SC27-9011-02 (November 2019)

Description Related APARs
PL/I copybook import support and compare functionality enhancement (IMS directory active and staging data sets). See the following topics: PI99608
New option, ASMAOPT, for changing assembler options used for DBDGEN and PSBGEN. See the following topics: PH08089
Command and Audit Log Archive (ATYARCH0) utility enhancement. See Reference: Log data archiving: Configure the Command and Audit Log Archive (ATYARCH0) utility. PH12977
Support concatenation of load module library data sets. Before this APAR, IMS Administration Tool could refer to only one load module library data set. This APAR enhances the tool to support concatenation of data sets so that user customized load module library can be referred to in addition to the IMS Administration Tool product load module library. See the following topics: PH11257
Copybook import and other enhancements. See the following topics: PH15100

SC27-9011-01 (May 2018)

Description Related APARs
  • "Job card" changed to "Job statement" throughout.
  • Remove "Job Options" references.
  • COBOL and PL/I (added) copybooks.
  • SPUFI: "MAX CHAR Field Width" option correction.
  • Catalog and non-catalog IMS environments summary.
  • IMS catalog management business scenarios.
  • Scenarios for "Overwrite existing objects".
  • Example database maintenance tasks for JCL generation.
  • New updated IMS catalog/directory overview.
  • New topic: The role of dynamic discovery
N/A
In database and application administration and IMS catalog management, use "IMS directory active and staging data set" terminology. PI88592 (ATY ISPF), PI90728 (ATY MC) , PI90085 (ATY Discover)
Support for refreshable user exits for IMS AOI (IMS 14 or later required). PI94129
New field designations and descriptions for Register an IMS Subsystem. PI95345