IBM Support

Updates to IBM Tools Base for z/OS Autonomics Director User's Guide and Reference (SC19-4376-02)

Product Documentation


Abstract

Updates that apply to IBM Tools Base for z/OS Autonomics Director User's Guide and Reference (SC19-4376-02).

Content

The most recent updates appear at the top of the list.


Update 3

Date of change: December 2020
Change description: Doc changes for APAR PH29101
Topics: Changes apply to multiple topics.

--------------------------------------------

Topic: Autonomics Director overview > Autonomics Director architecture and process flow

Figure "Autonomics Director Process Flow" and the text that follows have been updated as follows:

Start of change

image 7263

End of change
The following process flow steps match the numbers in the figure:
  1. The user customizes the Autonomics Director environment by using the Autonomics Director ISPF interface and server startup parameters.
  2. Start of changeAutonomics Director collects database and group information from the DBD libraries and the RECON data sets. If the IMS-managed ACBs function is enabled, it collects the information from the IMS directory. End of change
...
--------------------------------------------

Topic: Autonomics process >Automatic database and CAGRP discovery

The first paragraph has been updated as follows:

Start of changeAutonomics Director automatically collects database and group information about your IMS environment, including DBDLIB and RECON. If the IMS-managed ACBs function is enabled, it collects the information from the IMS directory. End of change

--------------------------------------------

Topic: Autonomics process > Database grouping

The first paragraph has been updated as follows:

Start of changeAs a mechanism to more easily manage large database environments, the Autonomics Director user interface allows the creation of groups from a list of database resources that are defined in DBDLIB, DBRC, or other user groups. If the IMS-managed ACBs function is enabled, database groups can be created from the IMS directory. End of change

--------------------------------------------

Topic: Autonomics process > Database grouping > User-defined group-managed database reorganization

The third paragraph has been updated as follows:

Start of changeUser-defined group-managed reorganizations and area extensions work in addition to Autonomics Director user grouping capabilities and enable you to create groups of one or more databases that are defined in their DBDLIBs. If the IMS-managed ACBs function is enabled, database groups can be created from the IMS directory. The ability to initiate and control reorganizations and area extensions by group adds efficiency and enables these activities to be processed in parallel for multiple databases, partitions, and areas. End of change

--------------------------------------------

Topic: Starting the Autonomics Director client dialog > Setting up the Autonomics Director Client environment

The "Before you begin" section has been updated as follows:

Before you begin

Autonomics Director uses RECON environments. The IMS Tools Knowledge Base repository must be configured with one or more RECONs defined.

Start of changeAt least one RECON ID is required. Minimally, the RECON ID must include one DBDLIB data set for use in the automatic discovery of databases and DBRC groups. If the IMS-managed ACBs function is enabled, it must include the IMSCATHLQ value. End of change

For detailed IMS Tools Knowledge Base configuration information, see the IBM Tools Base IMS Tools Knowledge Base for z/OS User's Guide.

--------------------------------------------

Topic: Managing the monitor list

A new subtopic has been added as follows:

Start of change

Reading a resource name from the IMS directory

In an IMS-managed ACBs environment, Autonomics Director can retrieve DBD data from the IMS directory.

If IMSCATHLQ, the high-level qualifier of the bootstrap data set for the IMS directory, is registered with the ITKB repository, Autonomics Director retrieves DBD data from the IMS directory. If IMSCATHLQ is not registered, it retrieves DBD data from the DBD library.

For DB Sensor jobs, you need to specify additional parameters so that those jobs can run in IMS-managed ACBs environments.

Setting up Autonomics Director for IMS-managed ACBs environments

  1. Add the SGLXLOAD library to the Autonomics Director server STEPLIB concatenation.
    For details, see "Configuring an Autonomics Director server" in Tools Base Configuration Guide.
  2. Register IMSCATHLQ with the ITKB client.
    For details, see "RECON ID (locale) administration" in Tools Base Configuration Guide.
  3. Refresh the RECON information in Autonomics Director.
    For details, see "Refreshing the Autonomics Director server resources".
  4. Update the skeleton JCL for DB Sensor jobs for IMS-managed ACBs environments.
    • For FF Stand-alone DB Sensor, see "GLOBAL command keywords for FF Stand-alone DB Sensor" in IMS Solution Packs Data Sensor User's Guide.
    • For FP Stand-alone DB Sensor, see "GLOBAL command keywords for FP Stand-alone DB Sensor" in IMS Solution Packs Data Sensor User's Guide.

Notes:

  • DBD data registered with the Autonomics Director monitor list is not updated automatically. If the DBDLIB and the IMS directory contain different DBD data, update monitor list entries.
  • Logical DBD and GSAM DBD are not supported.
  • Staging data sets for the IMS directory are not supported.

End of change

--------------------------------------------

Topic: Scheduling and automating > Scheduling a reorganization or area extension > Creating a user group

The first paragraph of this topic has been changed as follows:

Start of changeYou can create customized groups of databases from a list of available database resources that are defined in the DBDLIB and DBRC groups. If the IMS-managed ACBs function is enabled, database groups can be created from the IMS directory. End of change

--------------------------------------------

Topic: Troubleshooting > Runtime error messages (IAV)

The following new messages have been added:

Start of change

IAVD464I COULD NOT LOCATE DATABASE IN THE IMS DIRECTORY.
Explanation: The Autonomics Director database discovery task did not find the database that is being added to the monitor list in the IMS directory.
System action: Processing continues.
User response: Make sure that the DBD entry exists in the IMS directory for the database that you are adding to the monitor list.

End of change

--------------------------------------------

Topic: Troubleshooting > Frequently asked questions

The following FAQ entry has been updated:

Why do I get error message "DBD not in DBDLIB" when adding members of a DBGRP group to the monitor list?

Start of changeIf members of a DBGRP are DEDB areas or HALDB partitions, Autonomics Director does not know the database name of those members and therefore cannot retrieve DBD data from DBDLIB to build monitor list entries. If the IMS-managed ACBs function is enabled, it cannot retrieve DBD data from the IMS directory. The solution is to add them individually by using the 'DATABASE' method instead of the 'DBGRP' method.  End of change


Update 2
Date of change: November 2020

Change description: Documentation changes for APAR PH25441. This APAR provides a new utility, Monitor List Registration utility, to register multiple IMS databases to the monitor list.
Topics: Changes apply to multiple topics.

--------------------------------------------

Topic: Managing the monitor list > Adding or updating monitor list entries

The following paragraph has been added to the About this task section:

About this task
A list of available Autonomics Director resources is populated automatically. These entries can be added or removed from the monitor list, and can also be updated.
Restriction: Autonomics Director autonomic discovery can locate on the master DBD.
Start of changeThe following procedure explains how to add or update a single entry in the monitor list. If you want to add or update multiple entries at once, use the batch utility, Monitor List Registration utility (IAVBUTL0). For more information, see "Monitor List Registration utility (IAVBUTL0)". End of change
Procedure
...
--------------------------------------------

Topic: Reference: Autonomics Director utilities

New topics for the new Monitor List Registration utility (IAVBUTL0) have been added, as follows:

Monitor List Registration utility (IAVBUTL0)
    Running the Monitor List Registration utility
    Example JCL for the Monitor List Registration utility
    EXEC and DD statements for the Monitor List Registration utility
    Control statements for the Monitor List Registration utility
    Output from the Monitor List Registration utility
    Return codes: Monitor List Registration utility

The following PDF contains the new contents:

Start of changeaiiada62_for_APAR_PH25441_utility.pdf End of change

Note: Page, figure, table, and cross-reference numbers in this PDF extract might not match your current user guide version. Use this documentation extract for content update purposes only. Change bar markings on the left side of the page indicate the new or changed information. This information will be included in the next refresh of the entire user guide.

--------------------------------------------

Topic: Troubleshooting > Runtime error messages (IAV)

New messages have been added. The following PDF contains the new contents:

Start of changeaiiada62_for_APAR_PH25441_messages.pdfEnd of change

Note: Page, figure, table, and cross-reference numbers in this PDF extract might not match your current user guide version. Use this documentation extract for content update purposes only. Change bar markings on the left side of the page indicate the new or changed information. This information will be included in the next refresh of the entire user guide.


Update 1
Date of change:
September 2018
Change description: Documentation changes for APAR PH01825.
Topics: Changes apply to multiple topics.

--------------------------------------------

Topic: Managing the Autonomics Director server > Displaying the Autonomics Director server resources >  Displaying server resources using the ISPF interface

The following example has been modified:

(Figure 4 in PDF) Example: Parameter information panel

Start of change

ISRBROBA USRT001.ECDBT13.IMSAD.CMDOUT1
Command ===>
********************************* Top of Data ********************
IAV0087I - PARAMETER VALUE TYPE
IAV0087I - CYCLETIM 00001 GLOBAL - ADSRV
IAV0087I - SWEEPINT 00001 GLOBAL - ADSRV
IAV0087I - WLMRINT 00000 GLOBAL - ADSRV
IAV0087I - SENSAGE 00000 GLOBAL - ADSRV
IAV0087I - EVALINT 00000 GLOBAL - ADSRV
IAV0087I - XCFGROUP IAVADM00 GLOBAL - ADSRV
IAV0087I - ITKBGROUP FPQSRVT4 GLOBAL - ADSRV
IAV0087I - RACFAPPL NONE GLOBAL - ADSRV
IAV0087I - JCLLIB IMSTESTS.RGE410.FPQ1 GLOBAL - ADSRV
IAV0087I - ADREPOS IAV_AUTODIR GLOBAL - ADSRV
IAV0087I - POLCACHE 008 GLOBAL - ADSRV
IAV0087I - RECOVERY ENABLE GLOBAL - ADSRV
IAV0087I - MODE ACTIVE LOCAL - ADSRV
IAV0087I - IAVPARMS IAVCOMON LOCAL - ADSRV
IAV0087I - XCFMEMB ADSERVER LOCAL - ADSRV
IAV0087I - RACFAGE 00010 LOCAL - ADSRV
******************************** Bottom of Data ******************

End of change

--------------------------------------------

Topic: Managing the Autonomics Director server > Displaying server resources using the DISPLAY command

The following example for the output from the DISPLAY SERVER TYPE(PARMS)command has been modified:

Start of change

IAV0087I - PARAMETER VALUE TYPE
IAV0087I - CYCLETIM 00060 GLOBAL
IAV0087I - SWEEPINT 00060 GLOBAL
IAV0087I - WLMRINT 00001 GLOBAL
IAV0087I - SENSAGE 00000 GLOBAL
IAV0087I - EVALINT 00000 GLOBAL
IAV0087I - XCFGROUP IAVADM00 GLOBAL
IAV0087I - ITKBGROUP FPQSRVT3 GLOBAL
IAV0087I - RACFAPPL NONE GLOBAL
IAV0087I - JCLLIB IMSTESTS.RGE410.FPQ1 GLOBAL
IAV0087I - ADREPOS IAV_AUTODIR GLOBAL
IAV0087I - POLCACHE 008 GLOBAL
IAV0087I – RECOVERY ENABLE GLOBAL
IAV0087I - MODE ACTIVE LOCAL
IAV0087I - IAVPARMS IAVCOMON LOCAL
IAV0087I - XCFMEMB ADSERVER@ECDBT09 LOCAL
IAV0087I - RACFAGE 00010 LOCAL

End of change

--------------------------------------------

Topic: Troubleshooting > Runtime error messages (IAV)

The following message has been added:

Start of change

IAV0704I RECOVERY SENSOR AND EVALUATION AUTOMATION IS DISABLED

Explanation: The Autonomics Director environment has IMS Recovery Solution Pack.

However, Recovery Sensor and evaluation jobs will not be performed automatically because they are disabled.

System action: Processing continues.

User response: None.

End of change

Publication Number

SC19-4376-02

[{"Line of Business":{"code":"LOB17","label":"Mainframe TPS"},"Business Unit":{"code":"BU054","label":"Systems w/TPS"},"Product":{"code":"SSS8US","label":"IMS Tools Base for z/OS"},"ARM Category":[{"code":"a8m0z000000cvYQAAY","label":"IMS Tools Base for z/OS"}],"Platform":[{"code":"PF035","label":"z/OS"}],"Version":"1.6.0"}]

Document Information

Modified date:
09 June 2021

UID

ibm10730127