Program Directory for IBM Tivoli Advanced Reporting for DFSMShsm V Program Number 5698-B14. for Use with z/os. Document Date: February 2009

Transcription

1 IBM Program Directory for IBM Tivoli Advanced eporting for DFSMShsm V2.2.0 Program Number 5698-B14 for Use with z/os Document Date: February 2009 GI

2 Note! Before using this information and the product it supports, be sure to read the general information under 7.0, Notices on page 29. Copyright International Business Machines Corporation All rights reserved. Note to U.S. Government Users Documentation related to restricted rights Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.

3 Contents 1.0 Introduction Advanced eporting for DFSMShsm Description Advanced eporting for DFSMShsm FMIDs Program Materials Basic Machine-eadable Material Optional Machine-eadable Material Program Publications Basic Program Publications Optional Program Publications Program Source Materials Publications Useful During Installation Program Support Program Services Preventive Service Planning Statement Support Procedures Program and Service Level Information Program Level Information Service Level Information Installation equirements and Considerations Driving System equirements Machine equirements Programming equirements Target System equirements Machine equirements Programming equirements Installation equisites Operational equisites Toleration/Coexistence equisites Incompatibility (Negative) equisites DASD Storage equirements DASD Storage equirements by FMID FMIDs Deleted Special Considerations Installation Instructions Installing Advanced eporting for DFSMShsm SMP/ Considerations for Installing Advanced eporting for DFSMShsm SMP/ Options Subentry Values Copyright IBM Corp iii

4 6.1.3 SMP/ CALLLIBS Processing Sample Jobs Installation Job Generator Utility Introduction to the Job Generator Product Selection Installing into an existing CSI Create New SMP/ Support Files - Optional Create New SMP/ CSI - Optional Allocate SMP/ Target and Distribution Libraries Create DDDF ntries Perform SMP/ CIV Perform SMP/ APPLY Perform SMP/ ACCPT Activating Advanced eporting for DFSMShsm Notices Trademarks Contacting IBM Stware Support Figures 1. Basic Material: Unlicensed Publications Publications Useful During Installation PSP Upgrade and Subset ID Component IDs Driving System Stware equirements Mandatory Installation equisites Mandatory Operational equisites Conditional Operational equisites Total DASD Space equired by Advanced eporting for DFSMShsm Storage equirements for SMP/ Work Data Sets Storage equirements for SMP/ Data Sets Storage equirements for Advanced eporting for DFSMShsm Target Libraries Storage equirements for Advanced eporting for DFSMShsm Distribution Libraries Storage equirements for HAH220 Libraries Storage equirements for HKH220 Libraries Storage equirements for HKS110 Libraries SMP/ Options Subentry Values Sample Installation Jobs for base function Sample Installation Jobs for base and monitoring agent functions iv Advanced eporting for DFSMShsm Program Directory

5 1.0 Introduction This Program Directory is intended for the system programmer responsible for program installation and maintenance. It contains information concerning the material and procedures associated with the installation IBM Tivoli Advanced eporting for DFSMShsm. This publication refers to IBM Tivoli Advanced eporting for DFSMShsm as Advanced eporting for DFSMShsm. The Program Directory contains the following sections: 2.0, Program Materials on page 4 identifies the basic and optional program materials and documentation for Advanced eporting for DFSMShsm. 3.0, Program Support on page 6 describes the IBM support available for Advanced eporting for DFSMShsm. 4.0, Program and Service Level Information on page 8 lists the APAs (program level) and PTFs (service level) incorporated into Advanced eporting for DFSMShsm. 5.0, Installation equirements and Considerations on page 9 identifies the resources and considerations required for installing and using Advanced eporting for DFSMShsm. 6.0, Installation Instructions on page 20 provides detailed installation instructions for Advanced eporting for DFSMShsm. It also describes the procedures for activating the functions Advanced eporting for DFSMShsm, or refers to appropriate publications. Before installing Advanced eporting for DFSMShsm, read the CBPDO Memo To Users and the CBPDO Memo To Users xtension that were supplied with this program in stcopy form as well as this Program Directory and then keep them for future reference. Section 3.2, Preventive Service Planning on page 6 tells you how to find any updates to the information and procedures in this Program Directory. Advanced eporting for DFSMShsm is supplied in a Custom-Built Product Delivery Offering (CBPDO, 5751-CS3). The Program Directory is provided in stcopy form on the CBPDO tape which is identical to the hardcopy form provided with your order. All service and HOLDDATA for Advanced eporting for DFSMShsm are included on the CBPDO tape. Do not use this Program Directory if you are installing Advanced eporting for DFSMShsm with a SystemPac or ServerPac. When using these ferings, use the jobs and documentation supplied with the fering. This documentation provides references to specific sections the Program Directory as required. Prior to installing Advanced eporting for DFSMShsm, read IBM Tivoli Advanced eporting for DFSMShsm: Monitoring Agent Planning and Configuration Guide. This book focuses on the things you will need to know for a successful installation and configuration this product. Copyright IBM Corp

6 1.1 Advanced eporting for DFSMShsm Description nsuring the availability the data sets that are managed by DFSMShsm requires daily analysis its functions. To help maximize productivity, DFSMShsm administrators need pertinent information about DFSMShsm functions in a straightforward, interactive format. Advanced eporting for DFSMShsm is a powerful reporting tool that helps gather critical information from the DFSMShsm environment and creates an interactive display with customizable reporting capabilities, as well as thorough integration with the Tivoli nterprise Portal. New in V2.2: Integration with the Tivoli nterprise Portal (TP) to help you create customized scenarios and alerts from a single GUI Advanced eporting for DFSMShsm provides reporting on: DFSMShsm automatic and on demand tasks Historical data within the control data set (CDS) Current information within the Logy and Logx data sets Completion status the DFSMShsm automatic scheduled functions Advanced eporting for DFSMShsm can be used to filter and mask data. It can: Filter and mask customized reports Filter specific data in the DFSMShsm environment Mask data set names in filters using DFSMS automatic class selection (ACS) masking and wild card operations, such as LIK and UNLIK Advanced eporting for DFSMShsm helps users analyze DFSMShsm information so they can identify problem areas and assess the impact potential changes. Advanced eporting for DFSMShsm : Helps validate ACS routine logic and manage class assignments xports data and automatically creates charts and graphs to help with visual trending, space analysis, and resource utilization Advanced eporting for DFSMShsm can issue DFSMShsm, IDCAMS, and other commands to help correct error conditions in the DFSMShsm environment. Advanced eporting for DFSMShsm : Assists with issuing DFSMShsm corrective commands toward one or all the data matching criteria Provides the capability to perform "what if" analysis before a change is made 2 Advanced eporting for DFSMShsm Program Directory

7 1.2 Advanced eporting for DFSMShsm FMIDs Advanced eporting for DFSMShsm consists the following FMIDs (function modification identifiers): HAH220 HKH220 HKS110 Introduction 3

8 2.0 Program Materials An IBM program is identified by a program number. The program number for Advanced eporting for DFSMShsm is 5698-B14. Basic Machine-eadable Materials are materials that are supplied under the base license and feature numbers, and are required for the use the product. Optional Machine-eadable Materials are orderable under separate feature numbers, and are not required for the product to function. The program announcement material describes the features supported by Advanced eporting for DFSMShsm. Ask your IBM representative for this information if you have not already received a copy. 2.1 Basic Machine-eadable Material The distribution medium for this program is magnetic tape or downloadable files. It is installed using SMP/, and is in SMP/ LFIL format. See 6.0, Installation Instructions on page 20 for more information about how to install the program. Information about the physical tape for the Basic Machine-eadable Materials for Advanced eporting for DFSMShsm can be found in the CBPDO Memo To Users xtension. 2.2 Optional Machine-eadable Material No optional machine-readable materials are provided for Advanced eporting for DFSMShsm. 2.3 Program Publications The following sections identify the basic and optional publications for Advanced eporting for DFSMShsm Basic Program Publications Figure 1 on page 5 identifies the basic unlicensed program publications for Advanced eporting for DFSMShsm. One copy each these publications is included when you order the basic materials for Advanced eporting for DFSMShsm. You can print additional copies when electronic publications are available using the stcopy url provided in the Product Announcement letter or from: To install a monitoring server on z/os, refer to the Program Directory for IBM Tivoli Management Services (GI ) for a complete list publications and installation instructions for its product components. 4 Copyright IBM Corp. 2009

9 Figure 1. Basic Material: Unlicensed Publications Publication Title IBM Tivoli Advanced eporting for DFSMShsm: User's Guide IBM Tivoli Advanced eporting for DFSMShsm: Monitoring Agent Planning and Configuration Guide IBM Tivoli Advanced eporting for DFSMShsm: Monitoring Agent User's Guide Form Number SC SC SC The Advanced eporting for DFSMShsm product manuals and other Tivoli product manuals can be found at the Tivoli Information Center url listed below: Optional Program Publications No optional publications are provided for Advanced eporting for DFSMShsm. 2.4 Program Source Materials No program source materials or viewable program listings are provided for Advanced eporting for DFSMShsm. 2.5 Publications Useful During Installation The publications listed in Figure 2 can be useful during the installation Advanced eporting for DFSMShsm. To order copies, contact your IBM representative or visit the IBM Publications Center at the following Web site: Figure 2. Publications Useful During Installation Publication Title IBM SMP/ for z/os User's Guide IBM SMP/ for z/os Commands IBM SMP/ for z/os eference IBM SMP/ for z/os Messages, Codes, and Diagnosis Form Number SA SA SA GA Program Materials 5

10 3.0 Program Support This section describes the IBM support available for Advanced eporting for DFSMShsm. 3.1 Program Services Contact your IBM representative for specific information about available program services. You can find information in the IBM Stware Support Handbook at the following Web site: The handbook provides information about how to contact IBM Stware Support, depending on the severity your problem, and the following information: egistration and eligibility Telephone numbers and addresses, depending on the country in which you are located What information you need to gather before contacting support 3.2 Preventive Service Planning Before installing Advanced eporting for DFSMShsm, it is VY IMPOTANT that you review the current Preventive Service Planning (PSP) information. The PSP buckets maintain current lists (which have been identified since the package was created) any recommended or required service for this package's installation. This includes stware PSP information that contains HIP, special attention and/or required PTFs against the base release. For program support, access the Stware Support Web site at: PSP Buckets are identified by UPGADs, which specify product levels, and SUBSTs, which specify the FMIDs for a product level. The UPGAD and SUBST values for Advanced eporting for DFSMShsm are included in Figure 3. Figure 3. PSP Upgrade and Subset ID UPGAD SUBST Description A4DFSMSHSM HAH220 Advanced eporting for DFSMShsm base HKH220 Advanced eporting for DFSMShsm monitoring agent HKS110 Common TP Interface 6 Copyright IBM Corp. 2009

11 3.3 Statement Support Procedures eport any difficulties you have using this program to IBM Stware Support. If an APA is required, they will provide the address to which any needed documentation can be sent. Figure 4 on page 7 identifies the component IDs (COMPID) for Advanced eporting for DFSMShsm. Figure 4. Component IDs FMID COMPID Component Name HAH A9800 Advanced eporting for DFSMShsm base 220 HKH A9801 Advanced eporting for DFSMShsm monitoring agent 220 HKS A9402 Common TP Interface 110 TAIN elease Program Support 7

12 4.0 Program and Service Level Information This section identifies the program and any relevant service levels Advanced eporting for DFSMShsm. The program level refers to the APA fixes incorporated into the program. The service level refers to the PTFs incorporated into the program. 4.1 Program Level Information The following APA fixes against previous releases components included with Advanced eporting for DFSMShsm have been incorporated into this release. They are listed by FMID. FMID HAH220 PK69724 PK72556 PK73349 PK Service Level Information No PTFs against this release Advanced eporting for DFSMShsm have been incorporated into the product tape. 8 Copyright IBM Corp. 2009

13 5.0 Installation equirements and Considerations The following sections identify the system requirements for installing and activating Advanced eporting for DFSMShsm. The following terminology is used: Driving system: the system used to install the program. Target system: the system on which the program is intended to run. In many cases, the same system can be used as both a driving system and a target system. However, you may want to set up a clone your system to use as a target system by making a separate IPL-able copy the running system. The clone must include copies all system libraries that SMP/ updates, copies the SMP/ CSI data sets that describe the system libraries, and your PAMLIB and POCLIB. Some cases where two systems must be used include the following: When installing a new level a product that is already installed, the new product will delete the old one. By installing onto a separate target system, you can test the new product while still keeping the old one in production. When installing a product that shares libraries or load modules with other products, the installation can disrupt the other products. Installing onto a test system or clone will allow you to assess these impacts without disrupting your production system. 5.1 Driving System equirements This section describes the environment the driving system required to install Advanced eporting for DFSMShsm Machine equirements The driving system can run in any hardware environment that supports the required stware Programming equirements Figure 5. Driving System Stware equirements Program Number Any one the following: Product Name and Minimum VM/Service Level 5694-A01 z/os V1.8 or later 5655-G44 IBM SMP/ for z/os V3.3 or later Copyright IBM Corp

14 5.2 Target System equirements This section describes the environment the target system required to install and use Advanced eporting for DFSMShsm. Advanced eporting for DFSMShsm installs in the z/os (Z038) SL Machine equirements The target system can run in any hardware environment that supports the required stware Programming equirements Installation equisites An installation requisite is defined as a product that is required and must be present or one that is not required but should be present on the system for the successful installation this product. A mandatory installation requisite identifies products that are required, without exception, or this product will not install on your system. This includes products specified as Ps or Qs. Figure 6. Mandatory Installation equisites Program Number Product Name and Minimum VM/Service Level 5694-A01 z/os V1.8 or later 5698-A79 IBM Tivoli Management Services V6.2 or later The installation the Advanced eporting for DFSMShsm monitoring agent, HKS110 common component FMID, requires the Tivoli nterprise Monitoring Server on z/os be present or installed in the CSI. efer to the Program Directory for IBM Tivoli Management Services (GI ) for a complete list publications and installation instructions for its product components. A conditional installation requisite identifies products that are not required for successful install but may resolve such things as certain warning messages at installation time. They include products that are specified as IF Qs. Advanced eporting for DFSMShsm has no conditional installation requisites. 10 Advanced eporting for DFSMShsm Program Directory

15 Operational equisites An operational requisite is defined as a product that is required and must be present or a product that is not required but should be present on the system for this product to operate all or some its functions. A mandatory operational requisite identifies products that are required, without exception, or this product will not operate its basic function unless the requisite is met. This includes products specified as Ps or Qs. Figure 7. Mandatory Operational equisites Program Number Product Name and Minimum VM/Service Level 5694-A01 z/os V1.8 or later A conditional operational requisite identifies products that are not required for the basic function but are needed at run time for this product to utilize specific functions. They can include products specified as IF Qs. The use the Advanced eporting for DFSMShsm monitoring agent component with a Tivoli nterprise Monitoring Server on z/os requires the monitoring server be installed and operational. Figure 8. Conditional Operational equisites Program Number Product Name and Minimum VM/Service Level 5698-A79 IBM Tivoli Management Services V6.2 or later Function Monitoring services Toleration/Coexistence equisites A toleration/coexistence requisite is defined as a product that must be present on a shared system. These systems can be other systems in a multisystem environment (not necessarily sysplex), a shared DASD environment (such as test and production), or systems that reuse the same DASD at different time intervals. Advanced eporting for DFSMShsm has no toleration/coexistence requisites Incompatibility (Negative) equisites A negative requisite identifies products that must not be installed on the same system as this product. Advanced eporting for DFSMShsm has no negative requisites. Installation equirements and Considerations 11

16 5.2.3 DASD Storage equirements Advanced eporting for DFSMShsm libraries can reside on all supported DASD types. Figure 9 on page 12 lists the total space required for each type library. Figure 9. Total DASD Space equired by Advanced eporting for DFSMShsm Library Type Total Space equired Target 628 tracks 3390 Distribution 628 tracks 3390 Notes: 1. If you are installing into an existing environment that has the data sets in Figure 12 on page 14 and Figure 13 on page 15 already allocated, ensure sufficient disk space and directory blocks are available to support the requirement listed. This might require you to reallocate some data sets to avoid x37 abends. 2. Use system determined block sizes for efficient DASD utilization for all non-cfm U data sets. For CFM U data sets, a block size is recommended, which is the most efficient from a performance and DASD utilization perspective. 3. The following abbreviations are used for the data set type: U S Unique data set, allocated by this product and used only by this product. To determine the correct storage needed for this data set, this table provides all required information; no other tables (or program directories) need to be referenced for the data set size. Shared data set, allocated by this product and used by this product and others. To determine the correct storage needed for this data set, the storage size given in this table needs to be added to other tables (perhaps in other program directories). If the data set already exists, it must have enough free space to accommodate the storage size given in this table. xisting shared data set, used by this product and others. This data set is NOT allocated by this product. To determine the correct storage needed for this data set, the storage size given in this table needs to be added to other tables (perhaps in other program directories). This existing data set must have enough free space to accommodate the storage size given in this table. If you currently have a previous release this product installed in these libraries, the installation this release will delete the old one and reclaim the space used by the old release and any service that had been installed. You can determine whether or not these libraries have enough space by deleting the old release with a dummy function, compressing the libraries, and comparing the space requirements with the free space in the libraries. For more information on the names and sizes the required data sets, please refer to 6.1.8, Allocate SMP/ Target and Distribution Libraries on page All target and distribution libraries listed have the following attributes: 12 Advanced eporting for DFSMShsm Program Directory

17 The default name the data set may not be changed. The default block size the data set may be changed. The data set may not be merged with another data set that has equivalent characteristics. 5. All target libraries listed have the following attributes: The data set may be SMS-managed. It is not required for the data set to be SMS-managed. It is not required for the data set to reside on the IPL volume. The values in the "Member Type" column are not necessarily the actual SMP/ element types identified in the SMPMCS. 6. All target libraries listed that contain load modules have the following attributes: The data set may not be in the LPA. The data set may be in the LNKLST except for TKANMODS. If you are installing into an existing environment, ensure the values used for the SMP/ work datasets reflect the minimum values shown in Figure 10. Check the corresponding DDDF entries in all zones because use values lower than these can result in failures in the installation process. efer to the SMP/ manuals for instructions on updating DDDF entries. Figure 10. Storage equirements for SMP/ Work Data Sets Library DDNAM T Y P O G C F M L C L Prim 3390 Trks Sec 3390 Trks SMPWK1 S PDS FB SMPWK2 S PDS FB SMPWK3 S PDS FB SMPWK4 S PDS FB SMPWK6 S PDS FB SYSUT1 U SQ SYSUT2 U SQ SYSUT3 U SQ SYSUT4 U SQ DI Blks If you are installing into an existing environment, ensure the current SMP/ support dataset allocations reflect the minimum values shown in Figure 11. Check the space and directory block allocation and reallocate the data sets, if necessary. Installation equirements and Considerations 13

18 Figure 11. Storage equirements for SMP/ Data Sets Library DDNAM T Y P O G C F M L C L Prim 3390 Trks Sec 3390 Trks SMPLTS PDS U N/A SMPMTS PDS FB SMPPTS PDS FB N/A SMPSCDS PDS FB SMPSTS PDS FB DI Blks Figure 12 and Figure 13 on page 15 describe the target and distribution libraries required to install Advanced eporting for DFSMShsm in a standalone environment. The storage requirements Advanced eporting for DFSMShsm must be added to the storage required by other programs having data in the same library or path when installing into an existing environment. Additional tables for each FMID are provided to help determine the specific space required for a FMID if some common components are already installed. See 5.2.4, DASD Storage equirements by FMID on page 16 for more information. Figure 12 (Page 1 2). Storage equirements for Advanced eporting for DFSMShsm Target Libraries Library DDNAM Member Type Target Volume T Y P O G C F M L C L 3390 Trks SAHCLST CLIST Any U PDS FB SAHCMDS DATA Any U PDS FB SAHLOAD LMOD Any U PDS U N/A SAHMSGS MSSAG Any U PDS FB SAHPAM DATA Any U PDS FB SAHPNU PANL Any U PDS FB SAHPKGI DATA Any U PDS FB SAHPLNS PANL Any U PDS FB SAHSAMP SAMPL Any U PDS FB TKANCUS CLIST Any PDS FB TKANDATV DATA Any PDS VB TKANMOD LMOD Any PDS U TKANMODL LMOD Any PDS U DI Blks 14 Advanced eporting for DFSMShsm Program Directory

19 Figure 12 (Page 2 2). Storage equirements for Advanced eporting for DFSMShsm Target Libraries Library DDNAM Member Type Target Volume T Y P O G C F M L C L 3390 Trks TKANMODP LMOD Any S PDS U 0 14 N/A TKANPA DATA Any PDS FB TKANPKGI DATA Any PDS FB TKANSAM SAMPL Any PDS FB TKANUTIN UTIN Any S PDS FB DI Blks Figure 13. Storage equirements for Advanced eporting for DFSMShsm Distribution Libraries Library DDNAM T Y P O G C F M L C L 3390 Trks AAHCLST U PDS FB AAHCMDS U PDS FB AAHLOAD U PDS U N/A AAHMSGS U PDS FB AAHPAM U PDS FB AAHPNU U PDS FB AAHPKGI U PDS FB AAHPLNS U PDS FB AAHSAMP U PDS FB DKANCUS PDS FB DKANDATV PDS VB DKANMOD PDS U DKANMODL PDS U DKANMODP S PDS U 0 14 N/A DKANPA PDS FB DKANPKGI PDS FB DKANSAM PDS FB DKANUTIN S PDS FB DI Blks Installation equirements and Considerations 15

20 5.2.4 DASD Storage equirements by FMID The tables in this section can help determine the specific space required for components not already installed in an existing environment. There is a table for each FMID included with the product. Figure 14. Storage equirements for HAH220 Libraries Library DDNAM Member Type Target Volume T Y P O G C F M L C L 3390 Trks SAHCLST CLIST Any U PDS FB SAHCMDS DATA Any U PDS FB SAHLOAD LMOD Any U PDS U N/A SAHMSGS MSSAG Any U PDS FB SAHPAM PAM Any U PDS FB SAHPNU PANL Any U PDS FB SAHPKGI DATA Any U PDS FB SAHPLNS PANL Any U PDS FB SAHSAMP SAMPL Any U PDS FB AAHCLST U PDS FB AAHCMDS U PDS FB AAHLOAD U PDS U N/A AAHMSGS U PDS FB AAHPAM U PDS FB AAHPNU U PDS FB AAHPKGI U PDS FB AAHPLNS U PDS FB AAHSAMP U PDS FB DI Blks Figure 15 (Page 1 2). Storage equirements for HKH220 Libraries Library DDNAM Member Type Target Volume T Y P O G C F M L C L 3390 Trks TKANCUS CLIST Any PDS FB TKANDATV DATA Any PDS VB DI Blks 16 Advanced eporting for DFSMShsm Program Directory

21 Figure 15 (Page 2 2). Storage equirements for HKH220 Libraries Library DDNAM Member Type Target Volume T Y P O G C F M L C L 3390 Trks TKANMOD LMOD Any PDS U TKANMODL LMOD Any PDS U TKANPA DATA Any PDS FB TKANPKGI DATA Any PDS FB DKANCUS PDS FB DKANDATV PDS VB DKANMOD PDS U DKANMODL PDS U DKANPA PDS FB DKANPKGI PDS FB DI Blks Figure 16. Storage equirements for HKS110 Libraries Library DDNAM Member Type Target Volume T Y P O G C F M L C L 3390 Trks TKANDATV DATA Any PDS VB TKANMOD LMOD Any PDS U TKANMODP LMOD Any S PDS U 0 14 N/A TKANPA DATA Any PDS FB TKANPKGI DATA Any PDS FB TKANSAM SAMPL Any PDS FB TKANUTIN UTIN Any S PDS FB DKANDATV PDS VB DKANMOD PDS U DKANMODP S PDS U 0 14 N/A DKANPA PDS FB DKANPKGI PDS FB DKANSAM PDS FB DKANUTIN S PDS FB DI Blks Installation equirements and Considerations 17

22 5.3 FMIDs Deleted Installing Advanced eporting for DFSMShsm may result in the deletion other FMIDs. To see what FMIDs will be deleted, examine the ++V statement in the product's SMPMCS. If you do not want to delete these FMIDs at this time, you must install Advanced eporting for DFSMShsm into separate SMP/ target and distribution zones. Note: These FMIDs will not automatically be deleted from the Global Zone. Consult the SMP/ manuals for instructions on how to delete FMIDs from the Global Zone. 5.4 Special Considerations To effectively manage a suite products with common components, you can install products into shared zones a consolidated stware inventory (CSI). Space requirements are reduced by installing products into shared CSI zones avoiding the duplication when different target zones, distribution zones, and data sets are used. Sharing a common set zones also allows SMP/ to automatically manage IFQ situations that exist across product components. If you intend to share a Tivoli nterprise Monitoring Server on z/os with other products, use shared CSI zones so product configuration sets up the runtime environment correctly. The installation the Advanced eporting for DFSMShsm monitoring agent, HKS110 common component FMID, requires the Tivoli nterprise Monitoring Server on z/os be installed in the CSI. If it is already installed, ensure the latest maintenance is installed as well because Advanced eporting for DFSMShsm monitoring agent requires maintenance for some the components included with the monitoring server package. If it is not already installed, the monitoring server components and maintenance should be installed first. efer to the Program Directory for IBM Tivoli Management Services (GI ) for installation instructions its product components. Advanced eporting for DFSMShsm monitoring agent includes a component that is referred to as a common component because it is also included with other products. If you install into an existing environment, you might need to remove the FMID reference for this component from the SMP/ installation jobs to avoid errors because it is already installed. The common component is : HKS110 Consider the following items, if you use shared CSI zones. You must specify the same high-level qualifier for the target and distribution libraries as the other products in the same zones for the configuration tool to work correctly. If you install a product into an existing CSI that contains a previous version the same product, SMP/ deletes the previous version during the installation process. To maintain multiple product versions concurrently, they must be installed into separate CSI zones. 18 Advanced eporting for DFSMShsm Program Directory

23 If you install into an existing environment, you might need to remove data set references from the installation jobs to avoid errors because the data sets already exist. If you are installing into an existing environment that has the data sets already allocated, ensure sufficient space and directory blocks are available to support the requirement listed in the DASD tables. This might require you to reallocate some data sets to avoid x37 abends. Installation equirements and Considerations 19

24 6.0 Installation Instructions This chapter describes the installation method and the step-by-step procedures to install and to activate the functions Advanced eporting for DFSMShsm. Note the following information: If you want to install Advanced eporting for DFSMShsm into its own SMP/ environment, consult the SMP/ manuals for instructions on creating and initializing the SMPCSI and the SMP/ control data sets. Additionally, to assist you in doing this, IBM has provided samples at the following Web site to help you create an SMP/ environment. Copies these have been included with the other sample jobs. Sample jobs have been provided to help perform some or all the installation tasks. The SMP/ jobs assume that all DDDF entries required for SMP/ execution have been defined in the appropriate zones. The SMP/ dialogs can be used instead the sample jobs to accomplish the SMP/ installation steps. 6.1 Installing Advanced eporting for DFSMShsm SMP/ Considerations for Installing Advanced eporting for DFSMShsm This release Advanced eporting for DFSMShsm is installed using the SMP/ CIV, APPLY, and ACCPT commands. The SMP/ dialogs can be used to accomplish the SMP/ installation steps SMP/ Options Subentry Values The suggested values for some SMP/ CSI subentries are shown in Figure 17. If you are installing into an existing environment, check these values because use values lower than these can result in failures in the installation process. DSSPAC is a subentry in the GLOBAL options entry. PMAX is a subentry the GNAL entry in the GLOBAL options entry. efer to the SMP/ manuals for instructions on updating the global zone. Figure 17. SMP/ Options Subentry Values SUB-NTY Value Comment DSSPAC 300,900,1200 Use 1200 directory blocks PMAX SMP/ Default Use the SMP/ default for PMAX. 20 Copyright IBM Corp. 2009

25 6.1.3 SMP/ CALLLIBS Processing Advanced eporting for DFSMShsm monitoring agent, HKS110 common component FMID, uses the CALLLIBS function provided in SMP/ to resolve external references during installation. When Advanced eporting for DFSMShsm monitoring agent is installed, ensure that DDDFs exist for the following libraries: SCBIND SCLIB SCLKD Advanced eporting for DFSMShsm base function, HAH220 FMID, does not use the CALLLIBS function. Note: The DDDFs above are used only to resolve the link-edit for Advanced eporting for DFSMShsm using CALLLIBS. These data sets are not updated during the installation Advanced eporting for DFSMShsm Sample Jobs There are two sets sample installation jobs provided as part the product. The sample installation jobs in Figure 18 are to help you install only the base function Advanced eporting for DFSMShsm. To install both the base and monitoring agent functions, use the sample installation jobs in Figure 19 on page 22. Figure 18. Sample Installation Jobs for base function Job Name Job Type Description LFIL AHJ0SMA Optional Sample job to create new SMP/ support files IBM.HAH220.F10 AHJ0SMI Optional Sample job to create and prime a new SMP/ CSI IBM.HAH220.F10 AHJ0ALO ALLOCAT Sample job to allocate target and distribution libraries IBM.HAH220.F10 AHJ0DDF DDDF Sample job to define SMP/ DDDFs IBM.HAH220.F10 AHJ0C CIV Sample CIV job IBM.HAH220.F10 AHJ0APP APPLY Sample APPLY job IBM.HAH220.F10 AHJ0ACC ACCPT Sample ACCPT job IBM.HAH220.F10 The installation the Advanced eporting for DFSMShsm monitoring agent, HKS110 common component FMID, requires the Tivoli nterprise Monitoring Server on z/os be installed in the CSI. If it is already installed, ensure the latest maintenance is installed as well because Advanced eporting for DFSMShsm monitoring aent requires maintenance for some the components included with the monitoring server package. If it is not already installed, the monitoring server components and maintenance should be installed first. efer to the Program Directory for IBM Tivoli Management Services (GI ) for installation instructions its product components. Installation Instructions 21

26 Figure 19. Sample Installation Jobs for base and monitoring agent functions Job Name Job Type Description LFIL KHJ0ALO ALLOCAT Sample job to allocate target and distribution libraries IBM.HKH220.F7 KHJ0DDF DDDF Sample job to define SMP/ DDDFs IBM.HKH220.F7 KHJ0C CIV Sample CIV job IBM.HKH220.F7 KHJ0APP APPLY Sample APPLY job IBM.HKH220.F7 KHJ0ACC ACCPT Sample ACCPT job IBM.HKH220.F7 You can access the sample installation jobs by performing an SMP/ CIV (refer to , Perform SMP/ CIV on page 26), then copy the jobs from the relfiles to a work data set for editing and submission. See Figure 18 on page 21 or Figure 19 to find the appropriate relfile data set. You may also choose to copy the jobs from the tape or product files by creating and submitting the job below. Use one the //TAPIN or //FILIN DD statements, depending on your distribution medium. If you intend to install only the base function, uncomment the appropriate statement containing IBM.HAH220.F10 for the input dataset. If you intend to install both base and monitoring agent functions, uncomment the appropriate statement containing IBM.HKH220.F7 for the input dataset. Add a job card and change the lowercase parameters to uppercase values to meet your site's requirements before submitting. //STP1 XC PGM=IBCOPY //SYSPINT DD SYSOUT= // TAPIN DD DSN=IBM.HAH22.F1,UNIT=tunit, // TAPIN DD DSN=IBM.HKH22.F7,UNIT=tunit, // VOL=S=volser,LABL=(x,SL), // DISP=(OLD,KP) // FILIN DD DSN=IBM.HAH22.F1,UNIT=SYSALLDA,DISP=SH, // FILIN DD DSN=IBM.HKH22.F7,UNIT=SYSALLDA,DISP=SH, // VOL=S=filevol //OUT DD DSNAM=jcl-library-name, // DISP=(NW,CATLG,DLT), // VOL=S=dasdvol,UNIT=SYSALLDA, // SPAC=(TK,(1,2,5)) //SYSUT3 DD UNIT=SYSALLDA,SPAC=(CYL,(1,1)) //SYSIN DD COPY INDD=xxxxIN,OUTDD=OUT SLCT MMB=(AHJ ACC,AHJ ALO,AHJ APP,AHJ DDF,AHJ C) SLCT MMB=(AHJ SMA,AHJ SMI) SLCT MMB=(KHJ ACC,KHJ ALO,KHJ APP,KHJ DDF,KHJ C) / In the sample above, update the statements as noted below: If using TAPIN: tunit is the unit value matching the product tape. 22 Advanced eporting for DFSMShsm Program Directory

27 volser is the volume serial matching the product tape. x is the tape file number where the data set name is on the tape. efer to the documentation provided by CBPDO to see where the file your choice is on the tape. If using FILIN filevol is the volume serial the DASD device where the downloaded files reside. OUT jcl-library-name is the name the output data set where the sample jobs will be stored. dasdvol is the volume serial the DASD device where the output data set will reside. SYSIN Change xxxxin to either TAPIN or FILIN depending on which input DD statement you chose to uncomment for use. If you chose to uncomment a statement containing IBM.HAH220.F10 for the input dataset, keep the Select statements for members starting with AH and delete the others. If you chose to uncomment a statement containing IBM.HKH220.F7 for the input dataset, keep the Select statements for members starting with KH and delete the others Installation Job Generator Utility A utility is available to generate the necessary installation jobs for this product and others that might be included in the product package deliverable. This job generator utility can be used as an alternative to the sample jobs provided. Be aware that not all products are supported at this time. You can access the utility in two different ways, depending on whether you have an existing environment or not. For an existing environment, find the SMP/ target data set with the low-level qualifier TKCIINST. After you locate the TKCIINST file, invoke the utility by using ISPF option 6 and entering the following command. ex 'hilev.tkciinst(kcijg )' If you do not have an existing environment, you can retrieve elfile 'IBM.HKCI310.F1' in the same way you would retrieve the elfile for the sample jobs. After you retrieve the elfile, invoke the utility by using ISPF option 6 and entering the following command. ex 'IBM.HKCI31.F1(KCIJG )' Use the online help available as a tutorial to become familiar with the utility and its processes. After invoking the help facility, you will see a panel like this one: Installation Instructions 23

28 HLP JOB GNATO HLP COMMAND ===> Create a set batch jobs to install a user selectable set products from either tape, DASD, or HFS. Press NT to read topics in sequence, or select topics by number. 1 Introduction to the Job Generator 2 Product Selection 3 Basic Parameters 4 HFS/zFS root request 5 SMP/ CALLLIBS information 6 Installing into an xisting CSI Introduction to the Job Generator The job generator creates a set jobs to define a SMP/ environment (CSI and supporting data sets), allocate product libraries (target and distribution zone data sets and DDDFS), and install the products (CIV APPLY ACCPT). You can use these jobs to create a totally new environment or to install the products into an existing CSI. Processing Steps The jobs are generated from a series ISPF interactive panels and ISPF file tailoring. The initial step is selection the product mix. The set products will determine any additions to the basic set values needed to create the JCL. At the end the process, the job generator invokes ISPF VIW for the process log, KCIJGLOG. Process Log One the members the generated job library is KCIJGLOG, the process log. This member shows the generating parameters and internal lists that were used to create the batch jobs. It also indicates which jobs were actually produced and need to be run. Note that the CIV, APPLY, and ACCPT jobs are always generated even if the selected products are already in the target CSI. In that case, the jobs install additional maintenance when available Product Selection You can select one or more products from a table that will determine the set FMIDs to install. You must select at least one product. The selection table contains information about all the supported products and might contain entries for products that you do not have or do not wish to install. Select only those products that are available in the package delivered and that you want to install. 24 Advanced eporting for DFSMShsm Program Directory

29 Installing into an existing CSI When the high-level qualifiers point to an existing environment, the job generator eliminates the jobs that allocate and initialize the CSI. The generator suppresses the creation libraries that already exist in the target environment. Instead, the generator creates a job to determine whether sufficient space is available for any additional data to be installed into the libraries. The member KCIJGANL is generated to report on the available space for each the existing libraries that will have new data. KCIJGANL cannot check for the maintenance stream requirements. The space analyzer function is very helpful in identifying data set space issues that might cause X37 abends during APPLY and ACCPT processing Create New SMP/ Support Files - Optional If you do not want to install into an existing environment, you can create a new environment. To allocate new SMP/ support data sets for Advanced eporting for DFSMShsm base function installation, edit and submit sample job AHJ0SMA. Consult the instructions in the sample job for more information. xpected eturn Codes and Messages: Create New SMP/ CSI - Optional If you do not want to install into an existing environment, you can create a new environment. To allocate a new SMP/ CSI and prime it for Advanced eporting for DFSMShsm base function installation, edit and submit sample job AHJ0SMI. Consult the instructions in the sample job for more information. xpected eturn Codes and Messages: Allocate SMP/ Target and Distribution Libraries If you are installing into an existing environment, you might have to remove lines for data sets that already exist. dit and submit sample job AHJ0ALO or KHJ0ALO to allocate the SMP/ target and distribution libraries for Advanced eporting for DFSMShsm. Consult the instructions in the sample job for more information. If you are installing into an existing environment that has the data sets already allocated, ensure sufficient space and directory blocks are available to support the requirement listed in the DASD tables. This might require you to reallocate some data sets to avoid x37 abends. xpected eturn Codes and Messages: 0 Installation Instructions 25

30 6.1.9 Create DDDF ntries If you are installing into an existing environment, you might have to remove lines for data sets that already exist. dit and submit sample job AHJ0DDF or KHJ0DDF to create DDDF entries for the SMP/ target and distribution libraries for Advanced eporting for DFSMShsm. Consult the instructions in the sample job for more information. xpected eturn Codes and Messages: Perform SMP/ CIV Having obtained Advanced eporting for DFSMShsm as part a CBPDO, you can use the CVPDO job found in the CBPDO IMLIB data set to CIV the Advanced eporting for DFSMShsm FMIDs as well as any service and HOLDDATA included on the CBPDO tape. For more information, refer to the documentation included with the CBPDO. You can also choose to edit and submit sample job AHJ0C or KHJ0C to perform the SMP/ CIV for Advanced eporting for DFSMShsm. Consult the instructions in the sample job for more information. xpected eturn Codes and Messages: Perform SMP/ APPLY dit and submit sample job AHJ0APP or KHJ0APP to perform an SMP/ APPLY CHCK for Advanced eporting for DFSMShsm. Add a BYPASS(HOLDSYSTM) operand to the SMP/ control statments in the APPLY job and uncomment the CHCK operand to see which PTFs will be processed because the ++HOLD is bypassed. Consult the instructions in the sample job for more information. To receive the full benefit the SMP/ Causer SYSMOD Summary eport, do not bypass the following on the APPLY CHCK: P, ID, Q, and IFQ. This is because the SMP/ root cause analysis identifies the cause only OS and not WANINGS (SYSMODs that are bypassed are treated as warnings, not errors, by SMP/). nhanced HOLDDATA introduced O HOLDs against FMIDs for HIP APAs. Prior to installing, ensure you have the latest nhanced HOLDDATA (available at The FMIDs can be installed regardless the status unresolved HIPs, however, the stware must not be deployed until the unresolved HIPs have been analyzed to determine applicability. There are two methods to complete an FMID installation where ++HOLDs for HIPs exist for the FMIDs being installed: 26 Advanced eporting for DFSMShsm Program Directory

31 To ensure that all recommended and critical service is installed with the FMIDs, add the SOUCIDs PP, HIP, and SU* to the APPLY command. There may be P or HIP APAs that do not have resolving PTFs available yet. You need to analyze the symptom flags to determine if you want to BYPASS the specific O HOLDs and continue the FMID installation. APPLY S(fmid,fmid,...) FOFMID(fmid,fmid,...) SOUCID(PP,HIP,SU,...) GOUPXTND. This method requires more initial research, but will provide resolution for all HIPs that have fixes available and are not in a P chain. There may still be unresolved Ps or HIPs that require the use BYPASS. To install an FMID as it was installed prior to nhanced HOLDDATA, you can add a BYPASS(HOLDCLASS(HIP)) operand to the APPLY command. This allows the FMID to be installed even though there are HIP O HOLDs against it. Note that not all O HOLDs were bypassed, only the HIP O HOLDs. After the FMIDs are installed, you must run the SMP/ POT SYSMODS command to identify any missing HIP maintenance. APPLY S(fmid,fmid,...) FOFMID(fmid,fmid,...) SOUCID(SU ) GOUPXTND BYPASS(HOLDCLASS(HIP)) other parameters documented in the program directory... This method is the quicker the two, but requires subsequent review the POT SYSMODS to investigate any HIPs. If you bypass any HOLDs during the installation the FMIDs because fixing PTFs were not yet available, you can use the APA Status Tracking (AST) function ServiceLink or the APA Tracking function esourcelink to be notified when the fixing PTF is available. After you have taken any actions indicated by the APPLY CHCK, remove the CHCK operand and run the job again to perform the APPLY. Note: The GOUPXTND operand indicates that SMP/ apply all requisite SYSMODs. The requisite SYSMODS might be applicable to other functions. xpected eturn Codes and Messages from APPLY CHCK: 0 xpected eturn Codes and Messages from APPLY: 0 Installation Instructions 27