What's new in IMS Administration Tool

Updated security settings as follows:

• Fixed an issue where users received an "Insufficient access authority is detected" error when the ATYADMIN.SETUP facility class was not defined, even though this facility class is optional.
• Changed the ATYADMIN.ACCESS facility class from required to optional so that users can choose whether to enable security for IMS Administration Tool access.

• Added Initial product configuration without using IMS Tools Setup. If you do not plan to use IMS Tools Setup for initial configuration, follow the instructions in this topic. Sample members for manual configuration are added to the sample library SATYSAMP.
• Updated prerequisite information. IMS Library Integrity Utilities, previously an optional prerequisite for IMS Administration Tool, is a mandatory requirement.

• You can specify whether to retain copied log records in the z/OS system logger log stream. With SYSIN control statements, copied log records are deleted from the log stream.
• You can write audit log records and command log records to separate data sets. With SYSIN control statements, both types of log records are copied to a single data set.

For more information, see Reference: Command and Audit Log Archive (ATYARCH0) utility.

Steps to add the IMSCATHLQ statement are removed from Required template modifications for IMS-managed ACBs environment.

Updated IMS maintenance tasks to reflect changes introduced by the following APARs:

• PH67229 for IMS Database Solution Pack
• PH67230 for IMS Database Utility Solution
• PH67252 for IMS High Performance Pointer Checker

Updated IMS maintenance tasks to reflect changes introduced by the following APARs:

• PH67071 for IMS High Performance Unload
• PH67072 for IMS HALDB Toolkit
• PH67231 for IMS Database Reorganization Expert
• PH67335 for IMS High Performance Load

The following topics are updated or added:

• Topics in IMS catalog space and DBD/PSB analysis
• New message ATY3962I

IMS catalog and ACB library management function is renamed to IMS catalog and directory management function.

Updated IMS maintenance tasks to reflect changes introduced by the following APARs:

• PH65810 for IMS Fast Path Solution Pack
• PH65942 for IMS High Performance Prefix Resolution

• What does IMS Administration Tool do?
• IMS SPUFI (IMS SQL processing using file input)
• New message ATY3961W

• IMS catalog space and DBD/PSB analysis
• Return codes

• DBD and PSB resource change
• IMS catalog space and DBD/PSB analysis
• IMS SPUFI overview

• IMS catalog space and DBD/PSB analysis
• IMS maintenance tasks
• Required template modifications for IMS-managed ACBs environment

• What does IMS Administration Tool do?
• IMS Administration Tool architecture and process flow
• DBD and PSB resource change
• New message ATYZ045E

• ATY3101E
• ATYZ001E

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

The following topic is updated: Export objects reference.

• 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.

• 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.

• Topics under Changing the product configuration
• Step 5. (Optional) Configuring z/OS system logger for audit log and IMS command log
• Defining a log stream
• Step 3.1 Restricting access to IMS Administration Tool
• Step 3.3 Restricting IMS command group or IMS ID for issuing commands
• Step 8.3 Verifying that the setup completed successfully on IMS system
• Commands, fields, and sample for viewing audit log
• IMS command log overview

• (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.

• DBD and PSB resource change
• IMS catalog and directory management
• Export objects and import objects
• Import objects reference
• Enabling the IMS catalog and migrating to IMS-managed ACBs environment (export objects and import objects function)
• ATY@OBJU JCL statements

• 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.

• IMS catalog space and DBD/PSB analysis
• Return codes
• New messages: ATY3616E, ATY3960E

• 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.

• IMS Command batch processing DD statements
• Messages: ATY0501E, ATY0502E, ATY6034W

• Reference: Command and Audit Log Archive (ATYARCH0) utility
• Compatibility between IMS Administration Tool and IMS Command Control Facility
• Migrating IMS Command Control Facility resources
• Return codes
• New messages: ATY8272E, ATY8273E
• Removed message: ATY8271E

• 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 and DBD/PSB analysis.

• 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.

• DBD/PSB compare reference—between IMS directory and ACB library
• DBD/PSB compare reference—IMS directories
• DBD/PSB compare reference—IMS directory and IMS catalog

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

Documentation updates:

• Restriction added to Scope designations for products
• Updates made to Reference: DBD and PSB update (ATY@OBJU) JCL
• New topic Return codes

• DBD/PSB compare
• New or changed messages: ATY3609W, ATY3609E, ATY3958E

• Before this APAR, the DBD/PSB compare panel can be accessed from the IMS Catalog and Directory 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.

• 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.