What's new in IMS Administration Tool
This topic summarizes the technical changes for this edition.
New and changed information is denoted by carets (
) and (
) 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.
SC27-9011-37 (October 2025)
| Description | Related APARs |
|---|---|
| Database and Application Administration
function and IMS Catalog and Directory Management function
enhancement. Supports a compiler error handling option for
copybook import, which is available during IMS resource change
(database and application administration function) and import
objects (IMS catalog and directory management function). You can
select a runtime option to control DBDGEN behavior when the
COBOL or PL/I compiler returns a non-zero return code during
copybook import. The option determines whether DBDGEN continues
or stops based on the compiler result. For a list of available
options, see Runtime options. The following topics are added or updated:
|
PH67717 |
Command and Audit Log Archive (ATYARCH0)
utility enhancement. The ATYARCH0 utility previously supported
only SYSIN control statements. It is enhanced to also support
ATYIN control statements. This enhancement provides the
following capabilities:
For more information, see Reference: Command and Audit Log Archive (ATYARCH0) utility. The
following topics are added or updated:
|
PH67958 |
SC27-9011-36 (September 2025)
| Description | Related APARs |
|---|---|
| Run IMS Utilities (JCL generation) function
enhancement: IMS Administration Tool is enhanced to
automatically discover and set required values for the IMSCATHLQ
statement for JCL templates. You no longer need to manually
register values for the IMSCATHLQ statement. Steps to add the IMSCATHLQ statement are removed from Required template modifications for IMS-managed ACBs environment. |
PH67637 |
| Documentation updates for Run IMS Utilities
(JCL generation). JCL templates for IMS Tools products have been
updated to support IMS-managed ACBs. Modifications that were
previously required to the JCL templates for the listed IMS
Tools products are no longer necessary. Updated IMS maintenance tasks to reflect changes introduced by the following APARs:
|
N/A |
SC27-9011-35 (July 2025)
| Description | Related APARs |
|---|---|
| Documentation updates for Run IMS Utilities
(JCL generation). JCL templates for IMS Tools products have been
updated to support IMS-managed ACBs. Modifications that were
previously required to the JCL templates for the listed IMS
Tools products are no longer necessary. Updated IMS maintenance tasks to reflect changes introduced by the following APARs:
|
N/A |
SC27-9011-34 (June 2025)
| Description | Related APARs |
|---|---|
| IMS catalog and directory management function
enhancement. The IMS catalog space and DBD/PSB analysis function
is enhanced to report cross-reference information between DBD
and PSB instances in the IMS catalog. By identifying
dependencies between DBDs and PSBs, you can maintain
relationship integrity and determine which DBDs and PSBs might
be affected when modifying or deleting DBDs or PSBs. The
function also generates downloadable CSV files containing the
cross-reference information. The following topics are updated or added:
IMS catalog and ACB library management function is renamed to IMS catalog and directory management function. |
PH65962 |
| Documentation updates for Run IMS Utilities
(JCL generation). JCL templates for IMS Fast Path Solution Pack
and IMS High Performance Prefix Resolution have been updated to
support IMS-managed ACBs. Modifications that were previously
required to the JCL templates for IMS Fast Path Solution Pack
and IMS High Performance Prefix Resolution are no longer
necessary. Updated IMS maintenance tasks to reflect changes introduced by the following APARs:
|
N/A |
SC27-9011-33 (April 2025)
| Description | Related APARs |
|---|---|
| Documentation update. Added an ATY@OBJU JCL sample. See Sample ATY@OBJU JCL. | N/A |
SC27-9011-32 (December 2024)
| Description | Related APARs |
|---|---|
IMS SPUFI enhancement. IMS SPUFI supports SQL
DDL statements, which you can use to define, update, and delete
program and database definitions. The following topics are added
or updated:
|
PH63927 |
SC27-9011-31 (October 2024)
| Description | Related APARs |
|---|---|
| Documentation update. A COBOL data type is added to Table "Data attributes mapping from COBOL copybook to DBD DATATYPE" in Copybook import. | PH63663 |
SC27-9011-30 (September 2024)
| Description | Related APARs |
|---|---|
| IMS catalog and directory management function enhancement. To improve the performance in displaying analysis reports, changes were made to the function and ISPF panels. The following topics are updated: | PH62891 |
| Removed information about the web interface, which was available through IBM® Management Console for IMS and Db2® for z/OS®. | N/A |
SC27-9011-29 (June 2024)
| Description | Related APARs |
|---|---|
| A restriction is added to the following topics: | PH61724 |
| Documentation updates. The following topics are updated: | N/A |
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:
|
PH60043 and PH61300 |
SC27-9011-27 (April 2024)
| Description | Related APARs |
|---|---|
| Change to the export objects function of the
IMS catalog and directory 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 template 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. The
following topics are updated or added: |
PH58182 |
SC27-9011-24 (November 2023)
| Description | Related APARs |
|---|---|
Changes to the IMS catalog and directory
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:
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:
The following topics are updated or added:
|
PH55647 |
|
Ability to define DBD libraries, PSB libraries, and ACB
libraries for IMS data sharing groups of IMS Administration
Tool.
The following topics are updated or added:
|
PH55647 |
Documentation updates:
|
N/A |
SC27-9011-22 (April 2023)
| Description | Related APARs |
|---|---|
Changes to the import objects function of the
IMS catalog and directory management function:
|
PH53764 |
SC27-9011-21 (February 2023)
| Description | Related APARs |
|---|---|
Changes to the IMS catalog and directory
management function:
|
PH52162 |
SC27-9011-20 (December 2022)
| Description | Related APARs |
|---|---|
DBD and PSB statement recording option for IMS
resource change and import objects functions.
|
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 directory management
enhancement. DBD/PSB Detail report is enhanced as follows:
For more information, see IMS catalog space and DBD/PSB analysis. |
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):
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: IMS SPUFI DML 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:
The following topics are updated: |
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:
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 directory 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 directory 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:
|
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:
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: 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 |
|---|---|
|
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 |