System Automation for z/OS Version 3 Release 4 User’s Guide SC34-2647-00 Note! Before using this information and the product it supports, be sure to read the general information under “Notices” on page xvii. This edition applies to IBM Tivoli System Automation for z/OS (Program Number 5698-SA3) Version 3 Release 4, an IBM licensed program, and to all subsequent releases and modifications until otherwise indicated in new editions or technical newsletters. This edition replaces SC34-2573-02. | IBM welcomes your comments. You may forward your comments electronically, or address your comments to: | IBM Deutschland Research & Development GmbH | Department 3248 | Schoenaicher Strasse 220 | 71032 Boeblingen | Germany If you prefer to send comments electronically, use one of the following methods: FAX (Germany): 07031 16-3456 FAX (Other Countries): +49 7031 16-3456 Internet: [email protected] Internet Visit our home page at http://www.ibm.com/systems/z/os/zos/features/system_automation/ When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright IBM Corporation 1996, 2012. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures ..............vii How the Automation Manager and Automation Agents Cooperate in a Sysplex .......22 Tables ...............ix Locked Votes and Requests ........22 Goal Driven Automation .........23 Automatic Calculation of Schedules (Service Accessibility ............xi Periods) ..............24 Using assistive technologies .........xi Event and Trigger Support ........25 Keyboard navigation of the user interface ....xi Error Thresholds............27 z/OS information ............xi Controlling Application Move and Server Management ..............28 Dotted decimal syntax diagrams . xiii Move Functions ............28 Controlling Application Move with Preference How to send your comments to IBM . xv Values ...............29 If you have a technical problem .......xv SA z/OS Automation Flags .........38 Automation Agent Flags .........39 Notices ..............xvii The Automation Manager Global Automation Flag ................40 Website Disclaimer ...........xvii Setting Automation Flags .........40 Programming Interface Information ......xvii Relationship Between Automation Flags and Trademarks..............xviii Resource Status ............41 Automation Flags and Minor Resource Flags . 42 About This Book ..........xix Statuses Supplied by the Automation Manager . 42 Who Should Use This Book .........xix Observed Status ............43 Where to Find More Information .......xix Automation Status ...........44 The System Automation for z/OS Library . xix Desired Status ............45 Related Product Information........xx Startability Status ...........46 Using LookAt to look up message explanations xx Compound Status ...........46 Related Online Information .........xx Health Status .............47 Summary of Changes for SC34-2647-00 .....xxi | Application Statuses Supplied by Automation New Information ...........xxi || Agents ................47 Changed Information ..........xxi Automation Agent Statuses ........47 Moved Information ..........xxi Application Monitor Status ........55 Deleted Information ..........xxii Automatic Restart Manager Statuses .....55 Mapping the Automation Agent Statuses to the Part 1. Introduction and Concepts . 1 Automation Manager Observed Status ....56 || Monitor Statuses Supplied by Automation Agents 58 Chapter 1. Introducing SA z/OS ....3 SA z/OS Processes Involved in Status Determination ............60 Overview ...............3 Using SA z/OS for Monitoring........61 Component Description...........4 Resynchronization ...........62 System Operations ...........4 || Automation Operators...........62 Processor Operations ..........4 | Automated Function Names/OPERATORS Policy I/O Operations ............4 || Item ................63 Hardware Overview ............4 || Structure of AOFWRKxx Operators .....65 SA z/OS Resources ...........6 Channels ..............8 Chapter 3. Starting and Stopping Processors and Systems .........10 I/O Devices .............10 SA z/OS ..............67 Starting, Stopping, and Maintaining the Automation Chapter 2. Concepts .........11 Manager ...............67 Starting the Automation Manager: START (S) . 67 Automation Concepts ...........11 Stopping the Automation Manager: STOP (P) . 68 Overview of Automation Logic .......11 Making an Automation Manager the Primary . 68 How Requests Become Goals .......18 Stopping the Automation Manager with Different How Request Propagation Works ......18 Options...............68 Relationship Support ..........18 © Copyright IBM Corp. 1996, 2012 iii Obtaining Automation Manager Diagnostic Displaying and Setting Events........102 Information .............69 Determining Automation Agent Flag Values . 103 Takeover File .............69 Displaying Actual and Effective Automation Starting NetView (System Operations) .....70 Agent Flags .............103 Starting and Stopping I/O Operations .....71 Displaying Automation Agent Flag Override Starting and Stopping Processor Operations . 71 Settings ..............104 Setting Automation On or Off: INGAUTO . 104 Chapter 4. Refreshing Automation Working with Application Groups ......104 Policy ...............73 Using INGGROUP ..........106 Moving Sysplex Application Groups......108 Other Ways to Refresh Automation Policy ....73 Setting Timers .............109 Refreshing an Automation Manager Interacting with the Automation Manager ....110 Configuration ............73 Changing the Automation Agent Status.....110 Identifying Current Configuration Files .....74 Monitoring of Resources ..........111 For an Automation Agent ........74 Monitoring Messages ..........111 For the Primary Automation Manager ....74 Monitoring Hardware .........114 Monitoring Health Performance ......115 Part 2. Using SA z/OS on the Host 77 Monitoring OMEGAMON Sessions .....117 Monitoring Processor Status .......120 Chapter 5. Getting Started ......79 Monitoring with the Status Display Facility . 123 Issuing Commands ............79 Setting Up SDF............124 Using Command Dialogs ..........80 Interpreting Colors in SDF and DISPSTAT . 125 Command Logging ............80 How SDF Works ...........125 Accessing SDF ............126 Chapter 6. How to Get Resource Using SDF .............126 How to Check Resource Status Conditions . 128 Information Sysplexwide .......83 Deleting SDF Records .........129 Using INGLIST to View Resources.......83 Captured Message Status Definitions ....130 Specifying Filters with INGFILT ......84 Monitoring and Controlling a Sysplex .....130 Using INGINFO to View a Selected Resource . 85 How to Work with INGPLEX .......130 Displaying Application Group Information ....85 How to Work with INGSTR .......147 Displaying Monitor Information .......85 Monitoring and Controlling Guest Machines and Displaying Relationship Information with INGRELS 85 Logical Partitions ............148 Displaying the Automation Agent View with VM Second Level Systems Support .....148 DISPSTAT ...............86 LPAR Management Functions .......156 Specifying Filters with DISPSFLT ......86 Using the SA z/OS Discovery Library Adapter . 158 Using DISPINFO to Display Detailed Information 87 Overview..............158 Using DISPTREE to Display Dependency Using the SA z/OS Discovery Library Adapter 159 Information ..............88 How SA z/OS Uses Error Thresholds .....160 Displaying Statistical Information .......88 Displaying Threshold Settings and Occurrences 160 How to Set or Change Error Thresholds . 161 Chapter 7. How to Monitor and Control How to Reset Occurrences ........162 Resources .............91 Setting Up Thresholds Using the Customization Starting and Stopping Resources .......92 Dialog...............162 Using INGREQ ............92 Handling Jobs That Are Not Controlled by Using INGVOTE ...........93 SA z/OS ...............163 Using INGHIST ............94 Communicating with Other Systems......164 || Using Runmodes ............94 Sending Commands within a Sysplex ....164 || Defining Runmodes and Runtokens .....95 Sending Commands to a Linux Target System 166 || Assigning Runtokens ..........96 Terminal Access Facility Full-Screen Sessions 166 || Displaying Valid Runmodes ........96 Gateway Sessions ...........168 || Displaying Runtokens ..........96 || Displaying Runmode Qualifications .....97 Chapter 8. Solving Problems with || Displaying Runmode Requests or Votes ....98 Resources.............169 || Setting Runmodes at SA z/OS Initialization Time 99 If Resources Do Not Start .........169 | Setting Runmodes or Forcing a Runmode If Resources Do Not Stop .........170 || Qualification using INGRUN .......99 Availability Scenario ...........170 Using Schedules ............100 Schedule Override...........101 Chapter 9. Using I/O Operations . 181 Resource Override...........101 Making Connectivity Changes........182 Displaying and Setting Trigger Information . 101 iv System Automation for z/OS: User’s Guide Display Commands To Obtain Data About I/O Appendix A. Automation Initialization Resources ..............182 Options ..............211 Connectivity Commands That Affect a Switch . 182 Display and Utility Commands Related to Appendix B. Using the I/O Operations Connectivity Commands .........183 Utility Commands for General Processing ....183 ISPF Dialog ............213 Using the I/O Operations ISPF