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-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 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.The
following topics are updated or added:
|
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.
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.
- 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:
- 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.
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 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.
The following topics are updated:
|
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)
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.
The
following topics are added or updated:
|
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.
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:
- 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.
- Before this enhancement, the DBD/PSB compare function could only compare DBD and PSB resources
that are stored in one IMS directory (between active data sets and staging data set). This
enhancement enables the DBD/PSB compare function to compare DBD and PSB resources that are stored in
two IMS directories (one of the IMS directories to compare does not have to be defined to IMS). The
function can also compare the IMS directory against a backup of the IMS directory. New and changed
topics are as follows:
- Supports a new feature, IMS directory/BSDS backup and restore. You can use the backup function
to back up the data sets of the IMS directory, and the restore function to restore the data sets of
the IMS directory from a backup. New topics are added to IMS directory/BSDS backup and restore (ISPF interface only).
|
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:
- Predefine data sets and use them in database and application administration functions and in IMS
catalog and ACB library management functions. See the following topics:
- Select which resource change tasks to perform. See IMS resource change.
- Merge multiple DBD libraries, PSB libraries, or ACB libraries into a single data set. See Merge libraries (ISPF interface only).
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)
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 |