Administration Guide and Reference
Total Page:16
File Type:pdf, Size:1020Kb
Tivoli® IBM Tivoli Asset Discovery for z/OS Version 7.2 Version 7 Release 2 Administration Guide and Reference SC27-2701-00 Tivoli® IBM Tivoli Asset Discovery for z/OS Version 7.2 Version 7 Release 2 Administration Guide and Reference SC27-2701-00 Note Before using this information and the product it supports, read the information in “Notices” on page 207. First edition (August 2009) This edition applies to Tivoli Asset Discovery for z/OS, Version 7, Release 2 (product number 5698-B39) and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright International Business Machines Corporation 2009. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures ...............v IBM Tivoli License Compliance Manager for z/OS conversion...............35 About this document ........vii Migration from Dorana Version 5 Release 4....38 Migration from Version 7 Release 1 Limited Availability Fix .............40 How to read the syntax diagrams . ix DB2 objects affected by migration .......43 Chapter 1. Overview of IBM Tivoli Asset Chapter 8. Inquisitor for z/OS .....47 Discovery for z/OS ..........1 Inquisitor JCL .............47 Data Capture phase tasks ..........3 Files used by the Inquisitor .........48 Running the Inquisitor ..........3 Functions performed by the Inquisitor .....49 Running the Usage Monitor ........4 Syntax of Inquisitor requests.........50 Computation phase tasks ..........4 Control statement specification .......51 Reporting phase tasks ...........4 Examples ..............56 Designing requests ............58 Chapter 2. Deployment scenarios....5 Processing migrated libraries ........59 Collection of Inquisitor output ........60 Chapter 3. Installation requirements . 11 Inquisitor for z/OS UNIX .........61 Inquisitor JCL for z/OS UNIX .......61 Hardware requirements ..........11 Files used by the Inquisitor for z/OS UNIX . 62 Processors ..............11 Security considerations when running the Software requirements ...........11 Inquisitor against z/OS UNIX files .....64 z/Architecture software .........11 Tivoli Common Reporting Software .....12 Security and authorization ........12 Chapter 9. Usage Monitor.......65 Usage Monitor JCL ............65 Chapter 4. Installation ........15 Files used by the Usage Monitor .......65 The use of exclusion masks to reduce data ....66 Installing Tivoli Asset Discovery for z/OS ....15 Program name exclusion masking ......66 Installing Tivoli Common Reporting ......15 Data set name exclusion masking ......66 Starting the Usage Monitor .........67 Chapter 5. Post-installation Stopping the Usage Monitor .........67 customization............17 Refreshing Usage Monitor settings.......68 z/OS Customization ...........17 Usage Monitor commands .........69 DB2 customization ...........17 Installing DB2 Connect (if required) ......18 Chapter 10. Inquisitor Import .....89 Creating post-installation jobs ........18 Running Inquisitor Import .........89 Running post-installation jobs .......26 TPARAM parameters ..........89 Customizing tasks for Japanese messages ....27 Chapter 11. The Match Engine.....91 Chapter 6. Post-installation tasks for Running the Match Engine .........91 Tivoli Common Reporting ......29 TPARAM parameters ..........91 Installing the DB2 JDBC driver and license JARs . 29 Starting Tivoli Common Reporting .....30 Chapter 12. Load to Repository ....93 Transferring the Tivoli Common Reporting report Continuous Inventory ...........93 package from the host system .......30 Adding Inquisitor data to an existing Inventory . 93 Importing the Tivoli Common Reporting report Running Load to Repository.........94 package ..............30 TPARAM parameters ..........94 Determining Tivoli Common Reporting JDBC data sources .............30 Configuring the Tivoli Common Reporting report Chapter 13. Usage Import.......95 data sources for JDBC ..........31 Running Usage Import ..........95 Verifying your installation ........31 TPARAM parameters ..........95 Tivoli Common Reporting user roles .....32 Chapter 14. Reporting ........97 Chapter 7. Migration .........35 Reporting using Tivoli Common Reporting ....97 © Copyright IBM Corp. 2009 iii Batch reporting .............103 Running XML export utility .......128 Running the sample HSISBATR batch reporting HSISZCAT ..............129 JCL................104 Running HSISZCAT ..........130 Deleting HSISZCAT Input data sets .....130 Chapter 15. Utilities.........107 Knowledge Base Updates .........107 Chapter 16. DB2 performance Running the Knowledge Base Updates ....107 considerations ...........131 Automation Server for z/OS ........108 Automation Server JCL .........108 Chapter 17. Deployment for large sites 133 Files used by the Automation Server ....108 Running deployment for large sites ......133 Starting the Automation Server ......110 Tivoli Common Reporting for Asset mirror view 134 Stopping the Automation Server ......110 Action processing ...........110 Automation Server control data set maintenance 111 Appendix A. Messages .......135 Automation Server request control statements 112 HSIA - Automation Server messages .....135 Product Tagging utility ..........115 HSIF - Conversion messages ........137 Running the Tagger ..........116 HSII - Utility messages ..........141 Tagger control statements ........116 HSIP - Inquisitor for z/OS messages and codes 147 Region Association ...........119 HSIT - Product Tagging messages ......159 Running Region Association .......119 HSIX - Inquisitor for z/OS UNIX messages and Add Inventory Association .........121 codes ................166 Creating an association .........122 HSIZ - Usage Monitor messages .......167 Running Add Inventory Association.....122 HSIC - Globalization messages .......181 Delete Inventory Association ........122 Return codes ............184 Running Delete Inventory Association ....122 Usage Summary ............123 Appendix B. Repository table layouts 191 Running Usage Summary ........123 Usage Deletion .............124 Appendix C. Deletion of obsolete Running Usage Deletion.........124 libraries in Dorana Version 5 Release Delete Inventory ............125 4 Repository............205 Running Delete Inventory ........125 High-level qualifier listing for Usage Monitor . 125 Running high-level qualifier for Usage Monitor 126 Notices ..............207 Repository Merge ............126 Destination Repository .........126 Related publications ........211 Running Repository Merge ........127 TPARAM table update ..........127 Accessibility............213 Running TPARAM table update ......127 SCRT import utility ...........127 Running SCRT import utility .......128 Index ...............215 XML export utility............128 iv Administration Guide and Reference Figures 1. Sample syntax diagram.........ix 8. Tivoli Common Reporting navigation tree 98 2. Tivoli Asset Discovery for z/OS workflow 2 9. Tivoli Common Reporting Right-click View As 99 3. Hierarchical view of Inventory association 5 10. Tivoli Common Reporting Example 4. Four LPARS, each with own set of DASD 7 Parameter Prompt ..........100 5. Four LPARs, all with Shared DASD, 11. Tivoli Common Reporting Edit User Non-Sysplex ............8 Preferences ............101 6. Sysplex of four LPARs all with Shared DASD 9 12. Tivoli Common Reporting Example Trend 7. Four LPARs, one set of shared DASD, plus a Chart with Hyperlinks ........102 set of nonshared DASD for each LPAR . 10 © Copyright IBM Corp. 2009 v vi Administration Guide and Reference About this document The IBM® Tivoli® Asset Discovery for z/OS® Administration Guide and Reference explains how to install, configure, and use the product. Who should read this document This document is intended for system administrators who install and configure Tivoli Asset Discovery for z/OS, or who perform daily system management tasks, such as inventory gathering and reporting of software distribution. What this document contains v Chapters1-6 Provide information on installation and migration processes and are a reference guide to the product. v Chapters7-17 Provide general reference information. v Appendix A, “Messages,” on page 135 Provides a reference for the messages. v Appendix B, “Repository table layouts,” on page 191 Provides a reference for the Repository table layouts. v Appendix C, “Deletion of obsolete libraries in Dorana Version 5 Release 4 Repository,” on page 205 Provides a reference for the housekeeping of some obsolete libraries in Dorana Version 5 Release 4. © Copyright IBM Corp. 2009 vii viii Administration Guide and Reference How to read the syntax diagrams The syntactical structure of commands described in this document is shown by means of syntax diagrams. Figure 1 shows a sample syntax diagram that includes the various notations used to indicate such things as whether: v An item is a keyword or a variable. v An item is required or optional. v A choice is available. v A default applies if you do not specify a value. v You can repeat an item. Syntax KEYWORD=default_choice COMMAND_NAME required_variable OPTIONAL_KEYWORD=variable KEYWORD= choice2 choice3 repeatable_item1 required_choice1 fragment_name optional_choice1 required_choice2 optional_choice2 required_choice3 , DEFAULT_KEYWORD repeatable_item2 KEYword fragment_name: DEFAULT_KEYWORD KEYWORD3 KEYWORD4 ( variable1 ) KEYWORD1 variable2 variable3 KEYWORD2 , ( variable4 - variable5 ) OPTIONAL_KEYWORD1 OPTIONAL_KEYWORD2 OPTIONAL_KEYWORD3 Figure 1. Sample syntax diagram Here