IBM Program Directory for IBM Tivoli OMGAMON X for IS on z/os V5.1.0 Program Number 5698-T07 for Use with z/os Service Updated May 2012 Document Date: July 2012 GI13-2212-01
Note Before using this information and the product it supports, be sure to read the general information under 7.0, Notices on page 38. opyright International Business Machines orporation 2012. 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 ontract with IBM orp.
ontents 1.0 Introduction.................................................. 1 1.1 OMGAMON X for IS on z/os Description............................. 2 1.2 OMGAMON X for IS on z/os FMIDs................................ 2 2.0 Program Materials.............................................. 3 2.1 Basic Machine-eadable Material..................................... 3 2.2 Optional Machine-eadable Material.................................... 3 2.3 Program Publications............................................. 3 2.3.1 Basic Program Publications...................................... 3 2.3.2 Optional Program Publications..................................... 4 2.4 Program Source Materials.......................................... 5 2.5 Publications Useful During Installation................................... 5 3.0 Program Support.............................................. 6 3.1 Program Services............................................... 6 3.2 Preventive Service Planning......................................... 6 3.3 Statement Support Procedures..................................... 7 4.0 Program and Service evel Information................................ 8 4.1 Program evel Information.......................................... 8 4.2 Service evel Information.......................................... 9 5.0 Installation equirements and onsiderations............................ 10 5.1 Driving System equirements........................................ 10 5.1.1 Machine equirements......................................... 10 5.1.2 Programming equirements...................................... 11 5.2 Target System equirements........................................ 11 5.2.1 Machine equirements......................................... 11 5.2.2 Programming equirements...................................... 11 5.2.2.1 Installation equisites....................................... 11 5.2.2.2 Operational equisites...................................... 12 5.2.2.3 Toleration/oexistence equisites................................ 13 5.2.2.4 Incompatibility (Negative) equisites.............................. 13 5.2.3 DASD Storage equirements..................................... 13 5.2.4 DASD Storage equirements by FMID................................ 18 5.3 FMIDs Deleted................................................ 22 5.4 Special onsiderations............................................ 23 6.0 Installation Instructions.......................................... 24 6.1 Installing OMGAMON X for IS on z/os............................... 24 6.1.1 SMP/ onsiderations for Installing OMGAMON X for IS on z/os............ 24 6.1.2 SMP/ Options Subentry Values................................... 24 opyright IBM orp. 2012 iii
6.1.3 SMP/ AIBS Processing..................................... 25 6.1.4 Installation Job Generator Utility.................................... 25 6.1.4.1 Introduction to the Job Generator................................ 26 6.1.4.2 Product Selection.......................................... 26 6.1.4.3 Installing into an existing SI................................... 26 6.1.4.4 Job Generator - Update ommand............................... 27 6.1.5 Sample Jobs............................................... 27 6.1.6 Allocate SMP/ Target and Distribution ibraries.......................... 29 6.1.7 reate DDDF ntries......................................... 29 6.1.8 Perform SMP/ IV....................................... 29 6.1.9 reate a new File System - Optional................................. 30 6.1.10 Allocate File System Paths...................................... 31 6.1.11 Perform SMP/ APPY........................................ 31 6.1.12 Perform SMP/ APT....................................... 35 6.1.13 leaning Up Obsolete Data Sets, Paths, and DDDFs...................... 37 6.2 Activating OMGAMON X for IS on z/os.............................. 37 6.2.1 File System xecution......................................... 37 7.0 Notices..................................................... 38 7.1 Trademarks.................................................. 39 ontacting IBM Stware Support....................................... 40 Figures 1. Basic Material: Unlicensed Publications................................. 4 2. Publications Useful During Installation.................................. 5 3. PSP Upgrade and Subset ID........................................ 7 4. omponent IDs............................................... 7 5. Driving System Stware equirements................................. 11 6. Target System Mandatory Installation equisites............................ 12 7. Target System Mandatory Operational equisites........................... 12 8. Target System onditional Operational equisites........................... 13 9. Total DASD Space equired by OMGAMON X for IS on z/os................ 14 10. Storage equirements for SMP/ Work Data Sets........................... 15 11. Storage equirements for SMP/ Data Sets............................... 16 12. Storage equirements for OMGAMON X for IS on z/os Target ibraries.......... 16 13. OMGAMON X for IS on z/os File System Paths........................ 17 14. Storage equirements for OMGAMON X for IS on z/os Distribution ibraries....... 17 15. Storage equirements for HK5510 ibraries.............................. 18 16. Storage equirements for HKT620 ibraries.............................. 20 17. Storage equirements for HKOB700 ibraries.............................. 20 iv OMGAMON X for IS on z/os Program Directory
18. Storage equirements for HKGW510 ibraries............................. 21 19. SMP/ Options Subentry Values..................................... 24 20. Sample Installation Jobs.......................................... 27 21. SMP/ lements Not Selected....................................... 34 Figures v
vi OMGAMON X for IS on z/os Program Directory
1.0 Introduction This program directory is intended for system programmers who are responsible for program installation and maintenance. It contains information about the material and procedures associated with the installation IBM Tivoli OMGAMON X for IS on z/os. This publication refers to IBM Tivoli OMGAMON X for IS on z/os as OMGAMON X for IS on z/os. The Program Directory contains the following sections: 2.0, Program Materials on page 3 identifies the basic and optional program materials and documentation for OMGAMON X for IS on z/os. 3.0, Program Support on page 6 describes the IBM support available for OMGAMON X for IS on z/os. 4.0, Program and Service evel Information on page 8 lists the APAs (program level) and PTFs (service level) that have been incorporated into OMGAMON X for IS on z/os. 5.0, Installation equirements and onsiderations on page 10 identifies the resources and considerations that are required for installing and using OMGAMON X for IS on z/os. 6.0, Installation Instructions on page 24 provides detailed installation instructions for OMGAMON X for IS on z/os. It also describes the procedures for activating the functions OMGAMON X for IS on z/os, or refers to appropriate publications. Before installing OMGAMON X for IS on z/os, read the BPDO Memo To Users and the BPDO Memo To Users xtension that are supplied with this program in stcopy format and this Program Directory; 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. OMGAMON X for IS on z/os is supplied in a ustom-built Product Delivery Offering (BPDO, 5751-S3). The Program Directory that is provided in stcopy format on the BPDO tape is identical to the hardcopy format if one was included with your order. All service and HODDATA for OMGAMON X for IS on z/os are included on the BPDO tape. Do not use this program directory if you install OMGAMON X for IS on z/os with a SystemPac or ServerPac. When you use one those ferings, use the jobs and documentation supplied with the fering. The fering will point you to specific sections this program directory as needed. opyright IBM orp. 2012 1
1.1 OMGAMON X for IS on z/os Description IBM Tivoli introduces a significant update to IBM Tivoli OMGAMON Performance Monitors for key System z environments. OMGAMON X for IS on z/os V5 contains new capabilities designed to: Improve problem resolution efficiency by requiring fewer steps to isolate root cause performance impact in real time, and therefore providing higher availability. Improve visibility, control, and automation with a new more comprehensive 3270-based user interface capable viewing the entire enterprise-wide environment from a single 3270 screen. educe the time required for installation, configuration, and maintenance by leveraging enhanced IBM Tivoli Monitoring functions and a new Parmgen configuration tool. OMGAMON X for IS on z/os V5: Provides users advanced problem determination assistance using focused problem-solving scenarios designed by customers. These scenarios put related data needed for associated problems into context to resolve today's performance and availability impacts. Improves visibility, control, and automation for subject matter experts by being able to combine both IS and z/os monitors in a new enhanced 3270 workspace. Provides an enhanced 3270 user interface to effectively move between V5.1 OMGAMON monitors to provide a common look, touch, and feel command and control conditions based on System Authorization Facility (SAF) access authority and controls. educes the amount extraneous data generated by performance metrics by organizing the key performance indicators to be viewed based on what customer subject matter experts defined as a process to resolve problems on both z/os and IS systems and follow interrelated problems from the same user interface. Improves problem resolution efficiency by generating fewer 3270 "clicks" to find a root cause performance impact in real time. xploits IBM's ziip process for service level analysis, lowering the cost compute time. everages Tivoli Monitoring V6.2.3 and the new self-describing agent autonomic capability to remove the necessity for using application Ds to manually synchronize management servers and agents. 1.2 OMGAMON X for IS on z/os FMIDs OMGAMON X for IS on z/os consists the following FMIDs: HK5510 HKT620 HKOB700 HKGW510 2 OMGAMON X for IS on z/os Program Directory
2.0 Program Materials An IBM program is identified by a program number. The program number for OMGAMON X for IS on z/os is 5698-T07. 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 OMGAMON X for IS on z/os. 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 physical media or downloadable files. This program is in SMP/ FI format and is installed by using SMP/. See 6.0, Installation Instructions on page 24 for more information about how to install the program. You can find information about the physical media for the basic machine-readable materials for OMGAMON X for IS on z/os in the BPDO Memo To Users xtension. 2.2 Optional Machine-eadable Material No optional machine-readable materials are provided for OMGAMON X for IS on z/os. 2.3 Program Publications The following sections identify the basic and optional publications for OMGAMON X for IS on z/os. 2.3.1 Basic Program Publications Figure 1 on page 4 identifies the basic unlicensed program publications for OMGAMON X for IS on z/os. You can print copies these publications by using the Information enter url provided after the list publications or from the IBM Publication Website url below, when available. http://www.ibm.com/e-business/linkweb/publications/servlet/pbi.wss opyright IBM orp. 2012 3
Figure 1. Basic Material: Unlicensed Publications Publication Title IBM Tivoli OMGAMON X for IS on z/os: User's Guide IBM Tivoli OMGAMON X for IS on z/os: Planning and onfiguration Guide IBM Tivoli OMGAMON X for IS on z/os: Troubleshooting Guide IBM Tivoli OMGAMON for IS on z/os : OMGAMON for IS: User's Guide IBM Tivoli OMGAMON for IS on z/os: Parameter eference IBM Tivoli OMGAMON X for IS TG on z/os: User's Guide OMGAMON X and Tivoli Management Services ommon Publications IBM Tivoli OMGAMON X Monitoring Agents on z/os Quick Start Guide IBM Tivoli OMGAMON nhanced 3270 Interface Guide IBM Tivoli OMGAMON X and Tivoli Management Services on z/os: ommon Planning and onfiguration Guide IBM Tivoli OMGAMON X and Tivoli Management Services on z/os: ommon Parameter eference IBM Tivoli OMGAMON X and Tivoli Management Services on z/os: PAMGN eference IBM Tivoli OMGAMON X and Tivoli Management Services on z/os: nd-to-nd esponse Time Feature eference IBM Tivoli OMGAMON X and Tivoli Management Services on z/os: eports for Tivoli ommon eporting IBM Tivoli OMGAMON X and Tivoli Management Services on z/os: Upgrade Guide Form Number S14-7471 S14-7472 G14-7473 S14-7474 S14-7475 S14-7476 GI11-8918 S22-5426 S23-9734 S14-7280 S22-5435 S27-2303 S27-2304 S27-2500 Prior to installing OMGAMON X for IS on z/os, IBM recommends you review the Quick Start guide as well as the Planning and onfiguration guides listed in Figure 1. efer to the Program Directory for IBM Tivoli Management Services on z/os (GI11-4105) for a complete list publications and installation instructions for its product components. The OMGAMON X for IS on z/os product manuals and other Tivoli product manuals can be found at the Tivoli Information enter url listed below: http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/index.jsp 2.3.2 Optional Program Publications No optional publications are provided for OMGAMON X for IS on z/os. 4 OMGAMON X for IS on z/os Program Directory
2.4 Program Source Materials No program source materials or viewable program listings are provided for OMGAMON X for IS on z/os. 2.5 Publications Useful During Installation You might want to use the publications listed in Figure 2 during the installation OMGAMON X for IS on z/os. To order copies, contact your IBM representative or visit the IBM Publications enter at: http://www.ibm.com/e-business/linkweb/publications/servlet/pbi.wss Figure 2. Publications Useful During Installation Publication Title IBM SMP/ for z/os User's Guide IBM SMP/ for z/os ommands IBM SMP/ for z/os eference IBM SMP/ for z/os Messages, odes, and Diagnosis Form Number SA22-7773 SA22-7771 SA22-7772 GA22-7770 Program Materials 5
3.0 Program Support This section describes the IBM support available for OMGAMON X for IS on z/os. 3.1 Program Services ontact your IBM representative for specific information about available program services. 3.2 Preventive Service Planning Before you install OMGAMON X for IS on z/os, make sure that you have reviewed the current Preventive Service Planning (PSP) information. eview the PSP Bucket for General Information, Installation Documentation, and the ross Product Dependencies sections. For the ecommended Service section, instead reviewing the PSP Bucket, it is recommended you use the IBM.ProductInstall-equiredService fix category in SMP/ to ensure you have all the recommended service installed. Use the FIXAT(IBM.ProductInstall-equiredService) operand on the APPY HK command. See 6.1.11, Perform SMP/ APPY on page 31 for a sample APPY command. If you obtained OMGAMON X for IS on z/os as part a BPDO, HODDATA is included. If the BPDO for OMGAMON X for IS on z/os is older than two weeks by the time you install the product materials, you can obtain the latest PSP Bucket information by going to the following website: http://www14.stware.ibm.com/webapp/set2/psearch/search?domain=psp You can also use S/390 StwareXcel or contact the IBM Support enter to obtain the latest PSP Bucket information. For program support, access the Stware Support Website at http://www.ibm.com/stware/support/. 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 OMGAMON X for IS on z/os are included in Figure 3 on page 7. This product has an installation requirement for IBM Tivoli Management Services on z/os V6.2.3 or higher (5698-A79), so you should review the PSP buckets for it as well. efer to the Program Directory for IBM Tivoli Management Services on z/os (GI11-4105) for those UPGAD and SUBST values. 6 opyright IBM orp. 2012
Figure 3. PSP Upgrade and Subset ID UPGAD SUBST Description OMX5510 HK5510/1220 OMGAMON X for IS on z/os HKT620 nd-to-nd HKOB700/1220 OMNIMON Base HKGW510/1220 OMGAMON X for IS TG on z/os 3.3 Statement Support Procedures eport any problems which you feel might be an error in the product materials to your IBM Support enter. You may be asked to gather and submit additional diagnostics to assist the IBM Support enter in their analysis. Figure 4 identifies the component IDs (OMPID) for OMGAMON X for IS on z/os. Figure 4. omponent IDs FMID OMPID omponent Name HK5510 5698A5800 OMGAMON X for IS on z/os 510 HKT620 5608A41 nd-to-nd 620 HKOB700 5608A41OB OMNIMON Base 700 HKGW510 5698A9300 OMGAMON X for IS TG on z/os 510 TAIN elease Program Support 7
4.0 Program and Service evel Information This section identifies the program and relevant service levels OMGAMON X for IS on z/os. The program level refers to the APA fixes that have been incorporated into the program. The service level refers to the PTFs that have been incorporated into the program. Some the program FMIDs for OMGAMON X for IS on z/os were updated to a new service level (1220) in May 2012. efer to 4.2, Service evel Information on page 9 for details. 4.1 Program evel Information The following APA fixes against previous releases components included with OMGAMON X for IS on z/os have been incorporated into this release. They are listed by FMID. FMID HK5510 OA31319 OA315 3 OA31613 OA31726 OA31847 OA31923 OA31924 OA31925 OA32 63 OA32 78 OA32362 OA32447 OA32541 OA32555 OA32563 OA32573 OA32582 OA32641 OA3286 OA32973 OA32977 OA33 9 OA33116 OA33253 OA33324 OA33393 OA335 3 OA33728 OA33778 OA339 OA339 9 OA34 38 OA34 76 OA3415 OA34841 OA34976 OA35 47 OA35 89 OA35188 OA3523 OA35252 OA35253 OA35257 OA35321 OA35394 OA35563 OA3567 OA35754 OA36153 OA36179 OA36284 OA36375 OA36551 OA368 1 OA369 8 OA36918 OA37 19 OA37132 OA37386 OA374 1 OA37418 OA375 4 OA38 OA38 29 OA38166 OA38257 FMID HKT620 OA16162 OA17633 OA2 7 1 OA215 6 OA2388 OA24718 FMID HKOB700 OA27272 OA27877 OA2797 OA281 3 OA28425 OA28444 OA28724 OA2874 OA29 81 OA29294 OA295 3 OA3 21 OA3 669 OA3 725 OA3 73 OA31413 OA31688 OA31815 OA31937 OA31981 OA32129 OA3214 OA32633 OA33159 OA33889 OA3488 OA3561 OA35624 OA37536 OA37766 OA37926 FMID HKGW510 OA3132 OA31614 OA31693 OA318 9 OA32365 OA32647 OA33137 OA33238 OA3449 OA34597 OA3594 OA365 3 OA368 3 8 opyright IBM orp. 2012
4.2 Service evel Information PTFs containing APA fixes against this release OMGAMON X for IS on z/os have been incorporated into this product package. They are listed by FMID. FMID HK5510 UA643 5 UA64467 UA65165 FMID HKOB700 UA64253 UA65123 FMID HKGW510 UA64294 Program and Service evel Information 9
5.0 Installation equirements and onsiderations The following sections identify the system requirements for installing and activating OMGAMON X for IS on z/os. The following terminology is used: Driving system: the system on which SMP/ is executed to install the program. Target system: the system on which the program is configured and run. In many cases, you can use a system as both a driving system and a target system. However, you can make a separate IP-able clone the running system to use as a target system. The clone must include copies all system libraries that SMP/ updates, copies the SMP/ SI data sets that describe the system libraries, and your PAMIB and POIB. Use separate driving and target systems in the following situations: When you install a new level a product that is already installed, the new level the product will replace the old one. By installing the new level onto a separate target system, you can test the new level and keep the old one in production at the same time. When you install a product that shares libraries or load modules with other products, the installation can disrupt the other products. By installing the product onto a separate target system, you can assess these impacts without disrupting your production system. 5.1 Driving System equirements This section describes the environment the driving system required to install OMGAMON X for IS on z/os. 5.1.1 Machine equirements The driving system can run in any hardware environment that supports the required stware. 10 opyright IBM orp. 2012
5.1.2 Programming equirements Figure 5. Driving System Stware equirements Program Number Product Name Minimum VM Minimum Service evel will satisfy these APAs 5694-A01 z/os V01.11.00 N/A No Included in the shipped product? Note: Installation might require migration to new z/os releases to be service supported. See http://www-03.ibm.com/systems/z/os/zos/support/zos_eos_dates.html. The OMGAMON X for IS TG on z/os component is installed into a file system, either HFS or zfs. Before installing this component, you must ensure that the target system file system data sets are available for processing on the driving system. OMVS must be active on the driving system and the target system file system data sets must be mounted on the driving system. If you plan to install this component in a zfs file system, this requires that zfs be active on the driving system. Information on activating and using zfs can be found in z/os Distributed File Service zseries File System Administration, S24-5989. 5.2 Target System equirements This section describes the environment the target system required to install and use OMGAMON X for IS on z/os. OMGAMON X for IS on z/os installs in the z/os (Z038) S. 5.2.1 Machine equirements The target system can run in any hardware environment that supports the required stware. 5.2.2 Programming equirements 5.2.2.1 Installation equisites Installation requisites identify products that are required and must be present on the system or products that are not required but should be present on the system for the successful installation this product. Mandatory installation requisites identify products that are required on the system for the successful installation this product. These products are specified as Ps or Qs. Installation equirements and onsiderations 11
Figure 6. Target System Mandatory Installation equisites Program Number Product Name Minimum VM Minimum Service evel will satisfy these APAs 5694-A01 z/os V01.11.00 N/A No 5698-A79 IBM Tivoli Management Services on z/os V06.02.03 N/A No Included in the shipped product? Note: Installation might require migration to new z/os releases to be service supported. See http://www-03.ibm.com/systems/z/os/zos/support/zos_eos_dates.html. onditional installation requisites identify products that are not required for successful installation this product but can resolve such things as certain warning messages at installation time. These products are specified as IF Qs. OMGAMON X for IS on z/os has no conditional installation requisites. 5.2.2.2 Operational equisites Operational requisites are products that are required and must be present on the system or products that are not required but should be present on the system for this product to operate all or part its functions. Mandatory operational requisites identify products that are required for this product to operate its basic functions. These products are specified as Ps or Qs. Figure 7. Target System Mandatory Operational equisites Program Number Product Name and Minimum VM/Service evel 5694-A01 z/os V01.11.00 or higher 5698-A79 IBM Tivoli Management Services on z/os V06.02.03 or higher Any one the following: 5655-M15 IS Transaction Server for z/os V03.01.00 with APA PK20490 PK27058 5655-M15 IS Transaction Server for z/os V03.02.00 5655-S97 IS Transaction Server for z/os V04.01.00 5655-S97 IS Transaction Server for z/os V04.02.00 or higher onditional operational requisites identify products that are not required for this product to operate its basic functions but are required at run time for this product to operate specific functions. These products are specified as IF Qs. 12 OMGAMON X for IS on z/os Program Directory
Figure 8. Target System onditional Operational equisites Program Number One or more the following: Product Name and Minimum VM/Service evel 5655-25 IBM IS Transaction Gateway V07.00.00 or higher 5655-W10 IBM IS Transaction Gateway V08.00.00 or higher 5635-DB2 5605-DB2 IBM DB2 V09.01.00 IBM DB2 V10.01.00 or higher 5635-A01 IBM IMS V10.01.00 5635-A02 IBM IMS V11.01.00 or higher 5655-36 WebSphere MQ for z/os V07.00.01 or higher 5655-N01 WebSphere Application Server for z/os V06.01.00 5655-N02 WebSphere Application Server for z/os V07.00.00 5655-W65 WebSphere Application Server for z/os V08.00.00 or higher 5.2.2.3 Toleration/oexistence equisites Toleration/coexistence requisites identify products that must be present on sharing systems. 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 environment at different time intervals. OMGAMON X for IS on z/os has no toleration/coexistence requisites. 5.2.2.4 Incompatibility (Negative) equisites Negative requisites identify products that must not be installed on the same system as this product. OMGAMON X for IS on z/os has no negative requisites. 5.2.3 DASD Storage equirements OMGAMON X for IS on z/os libraries can reside on all supported DASD types. Figure 9 on page 14 lists the total space that is required for each type library. Installation equirements and onsiderations 13
Figure 9. Total DASD Space equired by OMGAMON X for IS on z/os ibrary Type Target 2497 Distribution 2479 File System 15 Total Space equired in 3390 Trks Notes: 1. If you are installing into an existing environment that has the data sets in Figure 12 on page 16 and Figure 14 on page 17 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-fm U data sets. For FM U data sets, a block size 32760 is recommended, which is the most efficient from a performance and DASD utilization perspective. 3. Abbreviations used for data set types are shown as follows. U S Unique data set, allocated by this product and used by only this product. This table provides all the required information to determine the correct storage for this data set. You do not need to refer to other tables or program directories for the data set size. Shared data set, allocated by this product and used by this product and other products. To determine the correct storage needed for this data set, add the storage size given in this table to those given in 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 other products. This data set is not allocated by this product. To determine the correct storage for this data set, add the storage size given in this table to those given in 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. If you currently have a previous release this product installed in these libraries, the installation this release will delete the old release and reclaim the space that was used by the old release and any service that had been installed. You can determine whether 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 about the names and sizes the required data sets, see 6.1.6, Allocate SMP/ Target and Distribution ibraries on page 29. 4. Abbreviations used for the file system path type are as follows. N X P New path, created by this product. Path created by this product, but might already exist from a previous release. Previously existing path, created by another product. 14 OMGAMON X for IS on z/os Program Directory
5. All target and distribution libraries listed have the following attributes: The default name the data set can not be changed. The default block size the data set can be changed. The data set can not be merged with another data set that has equivalent characteristics. 6. All target libraries listed have the following attributes: These data sets can be SMS-managed, but they are not required to be SMS-managed. These data sets are not required to reside on the IP volume. The values in the "Member Type" column are not necessarily the actual SMP/ element types that are identified in the SMPMS. 7. All target libraries that are listed and contain load modules have the following attributes: These data sets can not be in the PA. These data sets can be in the NKST 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. heck 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 ibrary DDNAM T Y P O G F M Prim 3390 Trks Sec 3390 Trks SMPWK1 PDS FB 80 150 150 220 SMPWK2 PDS FB 80 150 150 220 SMPWK3 PDS FB 80 300 600 1320 SMPWK4 PDS FB 80 150 150 220 SMPWK6 PDS FB 80 300 1500 660 SYSUT1 SQ -- -- 75 75 0 SYSUT2 SQ -- -- 75 75 0 SYSUT3 SQ -- -- 75 75 0 SYSUT4 SQ -- -- 75 75 0 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. heck the space and directory block allocation and reallocate the data sets, if necessary. Installation equirements and onsiderations 15
Figure 11. Storage equirements for SMP/ Data Sets ibrary DDNAM T Y P O G F M Prim 3390 Trks Sec 3390 Trks SMPTS PDS U 0 15 150 N/A SMPMTS PDS FB 80 15 150 220 SMPPTS PDS FB 80 300 1500 N/A SMPSDS PDS FB 80 15 150 220 SMPSTS PDS FB 80 15 150 220 DI Blks Figure 12 and Figure 14 on page 17 describe the target and distribution libraries and file system paths that will be allocated by this product's install jobs or that will be required for installation. The space requirements reflect what is specified in the allocation job or the space that this product will require in existing libraries. Additional tables are provided to show the specific space required for libraries that are used by each FMID. See 5.2.4, DASD Storage equirements by FMID on page 18 for more information. The storage requirements OMGAMON X for IS on z/os must be added to the storage required by other programs having data in the same library or path. Figure 12 (Page 1 2). Storage equirements for OMGAMON X for IS on z/os Target ibraries ibrary DDNAM Member Type Target Volume T Y P O G F M 3390 Trks TKANUS IST Any PDS FB 80 76 57 TKANDATV Data Any PDS VB 6160 263 4 TKANX X Any S PDS VB 255 9 44 TKANHNU Help Any PDS FB 80 159 108 TKANISP IST Any S PDS FB 80 2 44 TKANMA Macro Any PDS FB 80 18 7 TKANMOD MOD Any PDS U 0 263 200 TKANMOD MOD Any PDS U 0 145 28 TKANMODP MOD Any S PDS U 0 72 N/A TKANMOD MOD Any S PDS U 0 2 44 TKANMODS MOD Any PDS U 0 184 95 DI Blks 16 OMGAMON X for IS on z/os Program Directory
Figure 12 (Page 2 2). Storage equirements for OMGAMON X for IS on z/os Target ibraries ibrary DDNAM Member Type Target Volume T Y P O G F M 3390 Trks TKANOS Data Any S PDS VB 255 2 44 TKANPA Parm Any PDS FB 80 16 4 TKANPNU Panel Any PDS FB 80 969 512 TKANPKGI Data Any PDS FB 80 55 6 TKANSAM Sample Any PDS FB 80 68 42 TKANUTIN UTIN Any S PDS FB 80 2 44 TKANWNU Panel Any S PDS FB 80 44 88 TKOBDATF Data Any S PDS FB 80 2 44 TKOBHP Help Any S PDS FB 80 20 176 TKOHP Help Any U PDS FB 80 8 44 TKOPO Panel Any U PDS FB 80 118 968 DI Blks Figure 13. OMGAMON X for IS on z/os File System Paths DDNAM T Y P Path Name TKANJA N /usr/lpp/kan/bin/ibm Figure 14 (Page 1 2). Storage equirements for OMGAMON X for IS on z/os Distribution ibraries ibrary DDNAM T Y P O G F M 3390 Trks DKANUS PDS FB 80 76 57 DKANDATV PDS VB 6160 263 4 DKANX S PDS VB 255 9 44 DKANHNU PDS FB 80 159 108 DKANISP S PDS FB 80 2 44 DKANJA S PDS VB 255 2 44 DKANMA PDS FB 80 18 7 DI Blks Installation equirements and onsiderations 17
Figure 14 (Page 2 2). Storage equirements for OMGAMON X for IS on z/os Distribution ibraries ibrary DDNAM T Y P O G F M 3390 Trks DKANMOD PDS U 0 243 200 DKANMOD PDS U 0 145 28 DKANMODP S PDS U 0 72 N/A DKANMOD S PDS U 0 2 44 DKANMODS PDS U 0 184 95 DKANOS S PDS VB 255 2 44 DKANPA PDS FB 80 16 4 DKANPNU PDS FB 80 969 512 DKANPKGI PDS FB 80 55 6 DKANSAM PDS FB 80 68 42 DKANUTIN S PDS FB 80 2 44 DKANWNU S PDS FB 80 44 88 DKOBDATF S PDS FB 80 2 44 DKOBHP S PDS FB 80 20 176 DKOHP U PDS FB 80 8 88 DKOPO U PDS FB 80 118 968 DI Blks 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 15 (Page 1 2). Storage equirements for HK5510 ibraries ibrary DDNAM Member Type Target Volume T Y P O G F M 3390 Trks TKANUS IST Any PDS FB 80 47 32 TKANDATV Data Any PDS VB 6160 247 2 TKANX X Any S PDS VB 255 6 9 TKANHNU Help Any PDS FB 80 157 107 DI Blks 18 OMGAMON X for IS on z/os Program Directory
Figure 15 (Page 2 2). Storage equirements for HK5510 ibraries ibrary DDNAM Member Type Target Volume T Y P O G F M 3390 Trks TKANMA Macro Any PDS FB 80 8 5 TKANMOD MOD Any PDS U 0 127 103 TKANMOD MOD Any PDS U 0 117 24 TKANMOD MOD Any S PDS U 0 1 1 TKANMODS MOD Any PDS U 0 102 69 TKANPA Parm Any PDS FB 80 12 2 TKANPNU Panel Any PDS FB 80 969 512 TKANPKGI Data Any PDS FB 80 38 2 TKANSAM Sample Any PDS FB 80 63 38 TKANWNU Panel Any S PDS FB 80 35 27 TKOHP Help Any U PDS FB 80 7 32 TKOPO Panel Any U PDS FB 80 103 682 DKANUS PDS FB 80 47 32 DKANDATV PDS VB 6160 247 2 DKANX S PDS VB 255 6 9 DKANHNU PDS FB 80 157 107 DKANMA PDS FB 80 9 5 DKANMOD PDS U 0 127 103 DKANMOD PDS U 0 117 24 DKANMOD S PDS U 0 1 1 DKANMODS PDS U 0 102 69 DKANPA PDS FB 80 12 2 DKANPNU PDS FB 80 969 512 DKANPKGI PDS FB 80 38 2 DKANSAM PDS FB 80 63 38 DKANWNU S PDS FB 80 35 27 DKOHP U PDS FB 80 7 32 DKOPO U PDS FB 80 103 682 DI Blks Installation equirements and onsiderations 19
Figure 16. Storage equirements for HKT620 ibraries ibrary DDNAM Member Type Target Volume T Y P O G F M 3390 Trks TKANUS IST Any PDS FB 80 1 2 TKANMOD MOD Any PDS U 0 31 11 TKANMOD MOD Any S PDS U 0 1 2 TKANMODS MOD Any PDS U 0 17 20 TKANPKGI Data Any PDS FB 80 4 2 TKANSAM Sample Any PDS FB 80 1 2 DKANUS PDS FB 80 1 2 DKANMOD PDS U 0 11 11 DKANMOD S PDS U 0 1 2 DKANMODS PDS U 0 17 20 DKANPKGI PDS FB 80 4 2 DKANSAM PDS FB 80 1 2 DI Blks Figure 17 (Page 1 2). Storage equirements for HKOB700 ibraries ibrary DDNAM Member Type Target Volume T Y P O G F M 3390 Trks TKANUS IST Any PDS FB 80 13 14 TKANX X Any S PDS VB 255 2 1 TKANHNU Help Any PDS FB 80 2 1 TKANISP IST Any S PDS FB 80 2 1 TKANMA Macro Any PDS FB 80 9 2 TKANMOD MOD Any PDS U 0 99 83 TKANMOD MOD Any PDS U 0 9 1 TKANMODP MOD Any S PDS U 0 59 N/A TKANMODS MOD Any PDS U 0 61 2 TKANOS Data Any S PDS VB 255 2 2 TKANPA Parm Any PDS FB 80 2 1 TKANPKGI Data Any PDS FB 80 10 1 DI Blks 20 OMGAMON X for IS on z/os Program Directory
Figure 17 (Page 2 2). Storage equirements for HKOB700 ibraries ibrary DDNAM Member Type Target Volume T Y P O G F M 3390 Trks TKANSAM Sample Any PDS FB 80 4 2 TKANWNU Panel Any S PDS FB 80 4 6 TKOBDATF Data Any S PDS FB 80 2 1 TKOBHP Help Any S PDS FB 80 18 100 DKANUS PDS FB 80 13 14 DKANX S PDS VB 255 2 1 DKANHNU PDS FB 80 2 1 DKANISP S PDS FB 80 2 1 DKANMA PDS FB 80 9 2 DKANMOD PDS U 0 99 83 DKANMOD PDS U 0 9 1 DKANMODP S PDS U 0 59 N/A DKANMODS PDS U 0 61 2 DKANOS S PDS VB 255 2 2 DKANPA PDS FB 80 2 1 DKANPKGI PDS FB 80 10 1 DKANSAM PDS FB 80 4 2 DKANWNU S PDS FB 80 4 6 DKOBDATF S PDS FB 80 2 1 DKOBHP S PDS FB 80 18 100 DI Blks Figure 18 (Page 1 2). Storage equirements for HKGW510 ibraries ibrary DDNAM Member Type Target Volume T Y P O G F M 3390 Trks TKANUS IST Any PDS FB 80 15 9 TKANDATV Data Any PDS VB 6160 16 2 TKANMOD MOD Any PDS U 0 6 3 TKANMOD MOD Any PDS U 0 19 3 DI Blks Installation equirements and onsiderations 21
Figure 18 (Page 2 2). Storage equirements for HKGW510 ibraries ibrary DDNAM Member Type Target Volume T Y P O G F M 3390 Trks TKANMODP MOD Any S PDS U 0 4 N/A TKANMODS MOD Any PDS U 0 4 4 TKANPA Parm Any PDS FB 80 2 1 TKANPKGI Data Any PDS FB 80 3 1 TKANUTIN UTIN Any S PDS FB 80 2 1 DKANUS PDS FB 80 15 9 DKANDATV PDS VB 6160 16 2 DKANJA S PDS VB 255 2 1 DKANMOD PDS U 0 6 3 DKANMOD PDS U 0 19 3 DKANMODP S PDS U 0 4 N/A DKANMODS PDS U 0 4 4 DKANPA PDS FB 80 2 1 DKANPKGI PDS FB 80 3 1 DKANUTIN S PDS FB 80 2 1 DI Blks 5.3 FMIDs Deleted Installing OMGAMON X for IS on z/os might result in the deletion other FMIDs. To see which FMIDs will be deleted, examine the ++V statement in the SMPMS the product. If you do not want to delete these FMIDs at this time, install OMGAMON X for IS on z/os into separate SMP/ target and distribution zones. Note: These FMIDs are not automatically deleted from the Global Zone. If you want to delete these FMIDs from the Global Zone, use the SMP/ JT NOFMID DTFMID command. See the SMP/ ommands book for details. 22 OMGAMON X for IS on z/os Program Directory
5.4 Special onsiderations To effectively manage a suite products with common components, you can install products into shared zones a consolidated stware inventory (SI). Space requirements are reduced by installing products into shared SI 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 SI zones so product configuration sets up the runtime environment correctly. The installation OMGAMON X for IS on z/os requires the Tivoli nterprise Monitoring Server on z/os be installed in the SI. efer to the Program Directory for IBM Tivoli Management Services on z/os (GI11-4105) for installation instructions its product components. If you are installing into an existing SI zone that contains the listed FMIDs, ensure the maintenance has been installed previously or it must be installed with this product package. HKI31 - UA6367 HKDS623 - UA63672 HKV623 - UA63362 onsider the following items when using shared SI 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 SI 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 SI zones. 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. When OMGAMON X for IS on z/os is used with the IBM Tivoli OMGAMON D on z/os product, they should both be installed in the same SI target and distribution zones. This ensures the maintenance level the ngine and Management Server components, which are used by both products, is at the same level. If they are installed in different SI zones, you should check to ensure the maintenance levels the ngine and Management Server components in both zones are the same or at a compatible level. This is also true for your runtime library environments (T). The PSP bucket will have the most current information and must be reviewed before installation. The OMGAVIW or OMGAMON D configuration document must also be reviewed for other operational considerations. Installation equirements and onsiderations 23
6.0 Installation Instructions This chapter describes the installation method and the step-by-step procedures to install and to activate the functions OMGAMON X for IS on z/os. Please note the following points: If you want to install OMGAMON X for IS on z/os into its own SMP/ environment, consult the SMP/ manuals for instructions on creating and initializing the SMPSI and the SMP/ control data sets. Additionally, to assist you in doing this, IBM has provided samples at the following Website to help you create an SMP/ environment. opies these have been included with the other sample jobs. http://www.ibm.com/support/docview.wss?rs=660&context=sszjdu&uid=swg21066230 You can use the sample jobs that are provided to perform part or all the installation tasks. The SMP/ jobs assume that all DDDF entries that are required for SMP/ execution have been defined in appropriate zones. 6.1 Installing OMGAMON X for IS on z/os 6.1.1 SMP/ onsiderations for Installing OMGAMON X for IS on z/os Use the SMP/ IV, APPY, and APT commands to install this release OMGAMON X for IS on z/os. 6.1.2 SMP/ Options Subentry Values The recommended values for certain SMP/ SI subentries are shown in Figure 19. Using values lower than the recommended values can result in failures in the installation. DSSPA is a subentry in the GOBA options entry. PMAX is a subentry the GNA entry in the GOBA options entry. See the SMP/ manuals for instructions on updating the global zone. Figure 19. SMP/ Options Subentry Values Subentry Value omment DSSPA 300,1200,1200 Use 1200 directory blocks PMAX SMP/ Default IBM recommends using the SMP/ default for PMAX. 24 opyright IBM orp. 2012
6.1.3 SMP/ AIBS Processing OMGAMON X for IS on z/os uses the AIBS function provided in SMP/ to resolve external references during installation. When OMGAMON X for IS on z/os is installed, ensure that DDDFs exist for the following libraries: SSIB SNOBJ SBND2 SIB SKD SZAMTX Note: The DDDFs above are used only to resolve the link-edit for OMGAMON X for IS on z/os using AIBS. These data sets are not updated during the installation OMGAMON X for IS on z/os. 6.1.4 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. Be aware that not all products are supported at this time and maintenance might have to be installed to get the latest updates for the product table. It is recommended you use this job generation utility to create a set jobs to install the product package when installing into an existing environment rather than using the sample jobs provided for each product. The job generation utility is delivered in the onfiguration Assistance Tool component the Tivoli Management Services on z/os product, which is a requisite this product. This utility is enhanced thru the maintenance stream so there could be an issue if it is invoked from an environment without the latest maintenance. nsure the latest maintenance is installed for the components this product to get the latest updates for the product table. If you are installing for the first time into a new environment and don't have an existing environment available to invoke this utility, you must use the sample jobs for the Tivoli Management Services on z/os product and install it first. This will install the FMID containing the job generation utility and the latest maintenance. Then you can invoke the utility from the target library TKIINST to install other products in the package. You can access the job generation utility in two different ways. For an existing environment, find the SMP/ target library with the low-level qualifier TKIINST. After you locate the TKIINST file, invoke the utility by using ISPF option 6 and entering the following command. ex 'hilev.tkiinst(kijg )' You can also access the utility from the installation and configuration tool by selecting option 2 (Install products) from the main menu. Then select option 0 (Generate install J) from the "Install Products" panel. You can use the online help available as a tutorial to become familiar with the utility and its processes. Installation Instructions 25
6.1.4.1 Introduction to the Job Generator The job generation utility creates a set jobs to define a SMP/ environment (SI and supporting data sets), allocate product libraries (target and distribution zone data sets and DDDFS), and install the products (IV APPY APT). You can use these jobs to create a totally new environment or to install the products into an existing SI. 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 J. Process og One the members the generated job library is KIJGOG, which is 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 IV, APPY, and APT jobs are always generated even if the selected products are already in the target SI. In that case, the jobs install additional maintenance when available. 6.1.4.2 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 and you should always select the appropriate version the IBM Tivoli Management Services on z/os product (5698-A79) that is an installation requisite for this product fering. This will install the necessary FMIDs and maintenance for a new environment but also ensure any requisite maintenance will be processed when installing into an existing environment. 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. 6.1.4.3 Installing into an existing SI When the high-level qualifiers point to an existing environment, the job generation utility eliminates the jobs that allocate and initialize the SI. The job generation utility 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 KIJGAN is generated to report on the available space for each the existing libraries that will have new data. However, KIJGAN cannot check for the maintenance stream requirements. 26 OMGAMON X for IS on z/os Program Directory
The space analyzer function is very helpful in identifying data set space issues that might cause X37 abends during APPY and APT processing. 6.1.4.4 Job Generator - Update ommand The job generation utility was enhanced to allow dynamic additions to the product table. The UPDAT routine is used to obtain additional data for products that are available but not yet included in the installation job generator table, KIDJG00. You must have the product FIs available on DASD in order to run this routine and all components the product must be available. After a successful run, the output this routine will replace the KIDJG00 member the work data set. If you make multiple changes to the data member be sure to save the original member as a backup. Note: Not all products qualify for inclusion in the job generator process at this time. efer to the online help for more information about this facility. 6.1.5 Sample Jobs If you choose not to use the installation job generator utility documented in the previous section, you can use the sample jobs that were created for OMGAMON X for IS on z/os. This will require you to research and tailor each the jobs accordingly. The sample jobs provided expect a SI to exist already. The sample installation jobs in Figure 20 are provided as part the product to help you install OMGAMON X for IS on z/os. Figure 20. Sample Installation Jobs Job Name Job Type Description FI K5J3AO AOAT Sample job to allocate target and distribution libraries IBM.HK5510.F17 K5J4DDF DDDF Sample job to define SMP/ DDDFs IBM.HK5510.F17 K5J5 IV Sample IV job IBM.HK5510.F17 K5J6BDI MKDI Sample job to invoke the supplied KGWMKDI X to allocate file system paths IBM.HK5510.F17 K5J7APP APPY Sample APPY job IBM.HK5510.F17 K5J8A APT Sample APT job IBM.HK5510.F17 The installation OMGAMON X for IS on z/os requires the Tivoli nterprise Monitoring Server on z/os be installed in the SI. efer to the Program Directory for IBM Tivoli Management Services on z/os (GI11-4105) for installation instructions its product components. Installation Instructions 27