IBM. Defining Automation Policy. System Automation for z/os. Version 3 Release 5 SC

Transcription

1 System Automation for z/os IBM Defining Automation Policy Version 3 Release 5 SC

2

3 System Automation for z/os IBM Defining Automation Policy Version 3 Release 5 SC

4 ii System Automation for z/os: Defining Automation Policy

5 Contents Figures vii Tables xi How to send your comments to IBM xiii About this publication xv Who Should Use This Publication xv Notes on Terminology xv Where to Find More Information xv The System Automation for z/os Library... xv Related Product Information xvi Summary of Changes for SC xvi New Information xvi Changed Information xviii Deleted Information xix Chapter 1. Introducing the Customization Dialog How to Define Automation Policy: An Outline... 1 Entry Type Introduction Policy Objects and Policy Items Considerations for the SA z/os Graphical Interface 7 Grouping Resources Logically Considerations for Automation Assigning System Automation Symbols (AOCCLONE) Using System Symbols and System Automation Symbols Nested Classes Class Hierarchy Inheritance and Defaulting Chapter 2. Using the Customization Dialog How to Start the Customization Dialog Getting Help How to Navigate in the Customization Dialog How to Use an Entry Type as a Fast Path How to Use a Policy Item as a Fast Path Concurrent User Access How to Cancel Input on a Panel How to Create New Policy Objects How to Rename a Policy Object How to Delete Policy Objects How to Delete a Single Policy Object How to Delete Several Policy Objects in One Go (Bulk Deletion) How to Browse a Policy Item How to Find Data in a Policy Item Command and User Data Policies Common Policy Items DESCRIPTION Policy Item COPY Policy Item WHERE USED Policy Item Select Chapter 3. Scenarios on How to Use the Customization Dialog How to Work with Resources A Grouping Scenario Grouping the Resources How to Use Schedules (Service Periods) Schedule Override Early Start How to Use Triggers and Events Scenario Environment and Behavior A Possible Solution How to Use User E-T Pairs Step 1: Specifying User Data in the Customization Dialog Step 2: Access the User Data How to Implement Message Processing with User-Defined Data Step 1: Specify the User-Defined Data Step 2: Specify the Commands Step 3: Update the NetView Automation Table. 70 Step 4: Write the REXX Script How to Work with Externally Stopped and Started Resources Configuring a resource that is externally started 73 External Startup Sequence Configuring a Resource that is Externally Stopped FORCEDOWN - Configuring a Resource to be Automatically Shutdown Working with MONITOR Resources Passive and Active Monitors Monitor Status Chapter 4. Entry Type Reference Defining Automation for TWS Components Enterprise Entry Type Policy Items for an Enterprise SEND COMMAND OPERS Policy Item INGSEND PARMS Policy Item PROCOPS FOCAL POINTS Policy Item AUTO MSG CLASSES Policy Item SYMBOL DESCRIPTION Policy Item Group Entry Type Creating a New Group Policy Items for Standard Groups Policy Items for Sysplex Groups GROUP INFO Policy Item SYSPLEX Policy Item NMC DEFINITIONS Policy Item LOCAL PAGE DATA SET Policy Item JOB DEFINITIONS Policy Item JOB/ASID DEFINITIONS Policy Item Copyright IBM Corp. 1996, 2014 iii

6 COMMAND DEFINITIONS Policy Item COMMAND FLOODING Policy Item RESOURCE DEFINITIONS Policy Item RECOVERY OPTIONS Policy Item SubGroup Entry Type Creating a New SubGroup Policy Items for SubGroups System Entry Type Creating a New System Policy Items for Systems SYSTEM INFO Policy Item AUTOMATION SYMBOLS Policy Item AUTOMATION CONSOLE Policy Item PROCESSOR Policy Item TARGET SYSTEM INFO Policy Item IPL INFO Policy Item ApplicationGroup Entry Type Creating a New ApplicationGroup Policy Items for ApplicationGroups APPLGROUP INFO Policy Item APPLICATIONS Policy Item TRIGGER Policy Item SERVICE PERIOD Policy Item RELATIONSHIPS Policy Item RESOURCES Policy Item GENERATED RESOURCES Policy Item MEMBER OF Policy Item Application Entry Type Creating a New Application Policy Items for Applications UPWARD CLASS Policy Item DOWNWARD CLASS/INST Policy Item APPLICATION INFO Policy Item AUTOMATION FLAGS Policy Item APPLICATION SYMBOLS Policy Item TRIGGER Policy Item SERVICE PERIOD Policy Item RELATIONSHIPS Policy Item MESSAGES/USER DATA Policy Item STARTUP Policy Item SHUTDOWN Policy Item THRESHOLDS Policy Item MINOR RESOURCES Policy Item SYSTEM ASSOCIATION Policy Item GENERATED RESOURCES Policy Item MEMBER OF Policy Item for Applications Policy Items for JES2 Subsystems Policy Items for JES3 Subsystems Policy Items for CICS Subsystems Policy Items for DB2 Subsystems Policy Items for IMS Subsystems Policy Items for TWS Subsystems Policy Items for USS Subsystems Events Entry Type Creating a New Event Policy Items for Events CONDITION Policy Item Service Periods Entry Type Policy Items for Service Periods SERVICE WINDOW Policy Item Triggers Entry Type Policy Items for Triggers CONDITION Policy Item Processor Entry Type Creating a New Processor Policy Items for Mainframe Processors Policy Items for PSM Processors Monitor Resource Entry Type Policy Items for Monitor Resources MONITOR INFO Policy Item MESSAGES/USER DATA Policy Item HEALTHSTATE Policy Item TRIGGER Policy Item zenterprise Ensembles Entry Type Creating a New zenterprise Ensemble Policy Items for zenterprise Ensembles ENSEMBLE INFO Policy Item Pacing Gates Entry Type Policy Items for Pacing Gates PACING GATE INFO Policy item OPC System Detail Entry Type OPCAO ENVIRON Policy Item OPC Controller Details Entry Type OPCA PCS Policy Item OPC Special Resources Entry Type SPECIAL RESOURCE Policy Item OPC Workstation Domains Entry Type Code Processing for OPC Workstation Domains 257 Messages Entry Type Messages Policy Items MESSAGE AUTOMATION Policy Item MPF DEFINITIONS Policy Item AT/MRT INSERTS Policy Item BUILD CONTROL Policy Item Timers Entry Type TIMERS Policy Item Tape Attendance Entry Type ATTEND TIME Policy Item MVS Component Entry Type Policy Items for MVS Component PREDEFINED MESSAGES Policy Item MESSAGES/USER DATA Policy Item MINOR RESOURCES Policy Item MVSCOMP Defaults Entry Type Policy Items for MVSCOMP Defaults System Defaults Entry Type Policy Items for System Defaults AUTOMATION OPTIONS Policy Item Application Defaults Entry Type Policy Items for Application Defaults Automation Operators Entry Type Policy Items for Automation Operators Notify Operators Entry Type Policy Items for Notify Operators NOTIFY OPERATORS Policy Item Network Entry Type Policy Items for Network SDF FOCALPOINT Policy Item FULL SESSIONS Policy Item GATEWAY Policy Item OMEGAMON Policy Item AUTHENTICATION Policy Item iv System Automation for z/os: Defining Automation Policy

7 SOAP SERVER Policy Item Sysplex Defaults Entry Type Policy Items for Sysplex Defaults RESOURCE INFO Policy Item Resident CLISTs Entry Type Policy Items for Resident CLISTs Status Display Entry Type Policy Items for Status Display SDF DETAILS Policy Item User E-T Pairs Entry Type Policy Items for User E-T Pairs E-T DATA Policy Item Chapter 5. Policy Database Maintenance Policy Database Selection List Creating a New Policy Database Using SA z/os Sample Policies Specifying Options for Policy Databases Logging Policy Database Modifications Chapter 6. Creating Reports about Policy Databases Chapter 7. Building and Distributing Configuration Files How to Define Data Sets for Build Processing Building the Configuration Files Configuration Files Build Options Distributing the Configuration Files Generating a Job for Batch Build Chapter 8. Automation Table, Message Revision Table, and MPFLSTxx member The NetView Automation Table The NetView Message Revision Table Enabling AT Updates Setting AT/MRT Scope MPFLSTxx member System and Application Specific Overrides The INGMSGSA Automation Table Predefined SA z/os Messages The +SA_PREDEFINED_MSGS MVS Component Entry Modifying Predefined Messages How to Apply Service Updates Batch Import with Data Modification Importing Sample Add-On Policies Making Updates with Text Files Supported Policies Updating Policy Objects Using Text Files Creating New Policy Objects Using Text Files 361 Deleting Policy Objects Using Text Files Generating a Job for Batch Update Chapter 10. Conversion Function Moved and Restructured Data Converting from SA z/os Initial Policy Database Conversion Selective Policy Database Conversion Generating a Job for Batch Conversion Write Data to File using a Batch Job Appendix A. Concurrent Customization by Multiple Users Concurrent User Access Capabilities Concurrent User Access within the Customization Dialog Policy Definitions Usage Policy Database Selection Entry Type Selection Entry Name Selection Changing Links Appendix B. More about Using the Customization Dialog Changing Your Customization Dialog Environment 371 Enabling and Disabling AT / MRT Syntax Checking Extending Policy Definitions Defining Data Sets for Batch Processing Defining ISPF Temporary Data Sets for Batch Build User-written Functions Alternate Configuration Support How to Define Alternate Configurations for Systems How to Build Alternate Configurations Restrictions Appendix C. Notices Trademarks Terms and conditions for product documentation 385 Chapter 9. Data Management Start Panel for Data Management Importing Policy Database Data Glossary Index Contents v

8 vi System Automation for z/os: Defining Automation Policy

9 Figures 1. Entry Type Selection Panel Entry Name Selection Panel for Groups Policy Selection Panel for Sysplex Groups 7 4. Nested Class Links Inheritance from Classes and Defaulting Customization Dialog Primary Menu Define New Entry Panel for an Application Sample Generic Define New Entry Panel Entry Name Selection Panel: Rename Action Entry Name Rename Pop-up Panel Delete Confirmation Panel for a Single Policy Object Confirmation Panel for Bulk Deletion with WHERE USED Links Sample Description Policy Item Panel Hierarchy of Entry Types Policy Selection Panel Applications for ApplicationGroup Panel for System Application Groups Application Groups Grouping of Applications into Nested ApplicationGroups Scenario: Current Configuration with Sysplex Application Group CICSAOR Scenario: Current Configuration with Applications CICS1AR1, CPSMCMAS, CPSMWUI Scenario: Resources for the CICSAOR Sysplex Application Group Scenario: Current Configuration with Application Group DB Scenario: Current Configuration with Applications Linked to DB Scenario: Select System Panel for DB2 Application group Scenario: Select Resources Panel for DB2 Application Group Scenario: Grouping Resources Scenario: Resources for the CICS Sysplex Application Group Scenario: Current Configuration with Applications Linked to DB Scenario: Select Resources Panel for Application Group NET Scenario: Select Resources Panel for DWHAPG with valid APG Resources Scenario: Select Resources Panel for DWHAPG Scenario: Select Resources Panel for DWHAPG2 after Selection Scenario: Select Resources Panel for DWHAPG Scenario: Select Resources Panel for DWHAPG with Valid APG Resources Scenario: Setting Preferences with the Select Resources Panel for DWHAPG Scenario: Select Resources Panel for DWHAPG with Converted Preferences Scenario: Define New Entry Input Panel for WBSRVAPG Scenario: Final Select Resources Panel for WBSRVAPG Policy Objects in the Solution Generated Resources in the Solution UET Entry-Type Selection Panel UET Keyword-Data Specification Panel Scenario: Using the Message Processing Panel Scenario: User Data Processing Panel Scenario: Command Processing Panel Scenario: Message Processing Panel for AT Entry Scenario: Message Automation Overview Panel Default Values Scenario: Editor with User Values for Automation Table Entry Scenario: Message Automation Overview with User Values Entry Type Selection Panel Entry Type Selections for Product Automation Panel Policy Selection Panel for Enterprises Operator Profile for Sending Commands Panel INGSEND Command Parms Panel Processor Operations Focal Point Information Panel AUTO MSG CLASSES Panel System Automation Symbols (AOCCLONEx) Description Panel Define New Entry Panel for a Sysplex Group Policy Selection Panel for Standard Groups Policy Selection Panel for Sysplex Groups Group Information Panel for Standard Groups Sysplex Policy Definition Panel for Sysplex Groups NMC Definitions Panel for Sysplex Groups Local Page Data Set Recovery Panel Local Page Data Set Recovery Job Definition Panel Long Running ENQ Job/ASID Definitions Panel "Hung" Command Definitions Panel Command Flooding Definition Panel Long Running ENQ Resource Definition Panel Recovery Options Panel Define New Entry Panel for a Subgroup Policy Selection Panel for Subgroups Define New Entry Panel for a System Policy Selection Panel for Systems System Information Panel Automation Symbols Panel Environment Definition: CONSOLE (Route Codes) Panel Copyright IBM Corp. 1996, 2014 vii

10 78. Select Target Hardware for System Panel Target System Information Panel MVS Target System IPL Information Panel VM Target System IPL Information Panel Define New Entry Panel for a Sysplex Application Group Policy Selection Panel for System Application Groups Application Group Information Panel Applications for ApplicationGroup Panel for System Application Groups Trigger for ApplicationGroup Panel Service Period for ApplicationGroup Panel for System Application Groups Relationship Selection List Panel Define Relationship Panel Example of Strong Chaining Select Resources for ApplicationGroup Panel Generated Resources Panel Member of Panel for ApplicationGroups Define New Entry Panel for Applications Policy Selection Panel for Applications Upward Link to Class Panel Downward Link to Classes or Instances Panel Application Information Panel Flag Automation Specification Panel Application Symbols Panel Trigger for Application Panel Service Period for Application Panel Relationship Selection List Panel Message Processing Panel Command Processing Panel for Applications Reply Processing Panel for Applications Code Processing Panel User Data Processing Panel for Applications Message Automation Overview Panel Automation Table entry Conditions Panel AT Status Specification Panel Editor Panel to Specify an AT Override Message Revision Table Conditions Panel Editor Panel to Specify an MRT Override MPF Specification Panel AT/MRT/MPF Ignore Specification Panel Using the STARTUP Policy Item Subsystem Startup Processing Panel Command Processing Panel for Startup Commands Subsystem Shutdown Processing Panel Command Processing Panel for SHUTINIT or SHUTFINAL Command Processing Panel for SHUTNORM, SHUTIMMED, or SHUTFORCE Reply Processing Panel for SHUTINIT Reply Processing Panel for SHUTNORM, SHUTIMMED and SHUTFORCE Thresholds Definition Panel Minor Resource Definitions Panel System Association Panel Generated Resources Panel Member of Panel for Applications Policy Selection Panel for JES2 Subsystems SPOOLFULL Specification Panel for JES SPOOLFULL Processing Panel for JES SPOOLSHORT Specification Panel SPOOLSHORT Commands Processing Panel for JES JES2 DRAIN Specification Panel Policy Selection Panel for JES3 Subsystems JES3 SPOOLFULL Processing Panel JES3 SPOOLSHORT Processing Panel Policy Selection Panel for CICS Subsystems CICS Control Specifications Panel Policy Selection Panel for DB2 Subsystems DB2 Control Entries Panel Policy Selection Panel for IMS Subsystems IMS Control Region Specifications Panel for Subcategory CTL Policy Selection Panel for TWS Subsystems OPC control specifications Panel Policy Selection Panel for USS Subsystems USS Control Specification Panel for Application Classes USS Control Specification Panel for Application Instances Entry Name Selection Panel for Events Define New Event Panel Policy Selection Panel for Events Unset Condition Panel for Events Policy Selection Panel for Service Periods Service Windows Panel for Service Periods Policy Selection Panel for Triggers Trigger Conditions Panel STARTUP Condition for Trigger Panel Defining a New SA z/os Processor Entry Policy Selection Panel for Processor Processor Information Panel LPAR Definitions Panel Policy Selection Panel for PSM Processors ProcOps Service Machine Information Panel GUEST Definitions Panel Policy Selection for Monitor Resource Monitor Resource Information Panel Message Processing Panel with OMEGAMON Exception Message Automation Overview Panel AT Status Specification Panel CMD Processing Panel for Monitor Resources Code Processing Panel User Defined Data Panel Monitor Resource CMD Processing Panel - Pass Processing User Defined Data Panel Command Processing Panel for the HEALTHSTATE Policy Item Trigger for Monitor Resource Panel Defining a New zenterprise Ensemble Panel zenterprise Ensemble Policy Items Panel zenterprise Ensemble Information Panel Policy Selection Panel for Pacing Gates Pacing Gate Information Panel Policy Selection Panel for OPC System Detail OPC System Details Panel viii System Automation for z/os: Defining Automation Policy

11 185. Policy Selection Panel for OPC Controller Details OPC Controller Details Panel Policy Selection Panel for OPC Special Resources OPC Special Resource Definitions Panel Policy Selection Panel for OPC Workstation Domain Code Processing Panel for TWS Workstation Domain IDs Messages Entry Type Policy Selection Panel Message Definitions Panel Entries linked to Message Panel Message Automation Overview Panel MPFLSTxx Member Definitions Panel User Insert Definition Define Build Control Parameter Policy Selection Panel for Timers Timer Definitions Panel Timer Definitions Panel Policy Selection Panel for Tape Attendance Environment Definition: TAPES Panel Panel for MVS Component Selection Policy Selection Panel for MVS Components Component Selection Panel for MVS Components Message Processing Panel for MVS Components Policy Selection Panel for MVSCOMP Defaults Policy Selection Panel for System Defaults System Automation Options Panel Policy Selection Panel for Application Defaults Policy Selection Panel for Automation Operators Automation Operator Definition Panel Automation Operator Definitions Panel Policy Selection Panel for Notify Operators Operator Notification Panel Notify Operator Message Classes Panel Policy Selection Panel for Network Notification Forwarding Panel Fullscreen TAF Application Definition Panel GATEWAY Definitions Panel OMEGAMON Sessions Definitions Panel OMEGAMON Session Attributes Panel Authentication Definitions Panel SOAP Server Definitions Panel SOAP-Server Attributes Panel Policy Selection Panel for Sysplex Defaults Sysplex Resource Information Defaults Panel Policy Selection Panel for Resident CLISTs Policy Selection Panel for Status Display Status Display Facility Details Panel Policy Selection Panel for User E-T Pairs UET Entry-Type Selection Panel UET Keyword-Data Specification Panel Policy Database Selection Panel Policy Database Selection Panel Create a New Policy Database Panel New Policy Database Data Set Information Panel Options for Policy Database Panel Example of an Activity Log SA z/os Report Selection Menu Policy Data Base Report Parameters Panel Example of Report Output Format FLAT List of Generated Resources Unreferenced Member Report Example Status Messages Report (Excerpt) Example Symbols Report (Excerpt) Build Parameters Panel Message and Logging Functions Panel SA z/os Automation Configuration APAR Apply Options panel Data Management Menu Panel Policy Data Base Import Panel Entry Name Selection Panel for Import Policy Data Selected Entry Names For Import Panel Modify Data Pop-Up Window Import Add-On Policies Panel Entries of Selected Add-on Policies Panel SA z/os Customization Dialog Settings Menu Automation Table Override Checking Edit Policy Selections Panel Define Policy Selection Panel SA z/os Data Set Customization Details Panel ISPF Temporary Data Sets Preallocation for Batch Panel Send Automation Configuration Data Sets Panel Figures ix

12 x System Automation for z/os: Defining Automation Policy

13 Tables 1. System Automation for z/os Library.... xv 2. System Symbols and System Automation Symbols System Symbols System Automation Symbols Entry Details for Applications in the Scenario Preference Value Scenarios SA z/os Message Classes Policy Selection Filter Attributes Copyright IBM Corp. 1996, 2014 xi

14 xii System Automation for z/os: Defining Automation Policy

15 How to send your comments to IBM We appreciate your input on this publication. Feel free to send us any comments you might have. If you have feedback to the manuals If you have comments on the manuals, like clarity, accuracy, and completeness of the information, use the following method to send your comments: Send an through "Contact Us" at the bottom right of IBM Knowledge Center. Include the following information: v The publication title, for example, IBM System Automation for z/os V3R50 Defining Automation Policy v The topic and page number related to your comment v The text of your comment If you have a technical problem Use one of the following feedback methods: v Contact your IBM service representative v Call IBM technical support v Visit the IBM zseries support web page at When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any way it believes appropriate without incurring any obligation to you. IBM or any other organizations will only use the personal information that you supply to contact you about the issues that you submit. Copyright IBM Corp. 1996, 2014 xiii

16 xiv System Automation for z/os: Defining Automation Policy

17 About this publication This publication describes Tivoli System Automation for z/os (SA z/os). This product plays a key role in supplying high-end automation solutions whereas Tivoli Systems (Tivoli Management Environment, Tivoli) delivers integrated cross-platform management functions. This publication contains information about how to enable SA z/os automation. Who Should Use This Publication Notes on Terminology This publication is primarily intended for automation programmers responsible for defining and maintaining the automation policy. MVS References in this book to MVS refer either to the MVS/ESA product or to the MVS element of z/os. OPC References in this book to OPC refer to Tivoli Workload Scheduler (TWS). Resources, Applications, and Subsystems These three terms are used in the SA z/os library to designate automated entities. The correct term to be used depends on the context. See the chapter Introduction in IBM Tivoli System Automation for z/os Operator's Commands for the definition of these terms. Where to Find More Information The System Automation for z/os Library Table 1 shows the information units in the System Automation for z/os library: Table 1. System Automation for z/os Library Title IBM Tivoli System Automation for z/os Planning and Installation IBM Tivoli System Automation for z/os Customizing and Programming IBM Tivoli System Automation for z/os Defining Automation Policy IBM Tivoli System Automation for z/os User's Guide IBM Tivoli System Automation for z/os Messages and Codes IBM Tivoli System Automation for z/os Operator's Commands IBM Tivoli System Automation for z/os Programmer's Reference IBM Tivoli System Automation for z/os Product Automation Programmer's Reference and Operator's Guide Order Number SC SC SC SC SC SC SC SC Copyright IBM Corp. 1996, 2014 xv

18 Table 1. System Automation for z/os Library (continued) Title IBM Tivoli System Automation for z/os TWS Automation Programmer's and Operator's Reference Guide IBM Tivoli System Automation for z/os End-to-End Automation Adapter IBM Tivoli System Automation for z/os Monitoring Agent Configuration and User's Guide Order Number SC SC SC SA z/os Home Page: For the latest news on SA z/os, visit the SA z/os home page at: Related Product Information For information that supports Tivoli System Automation for z/os, visit the z/os library in IBM Knowledge Center ( knowledgecenter/ssltbw). Summary of Changes for SC This document contains information previously presented in System Automation for z/os V3R4.0 Defining Automation Policy, SC The following sections provide details of significant or major changes in this edition. New Information The following information is new in this edition: UP Status Delay A delay time period field for indicating that an application is UP is introduced in the APPLICATION INFO Policy Item on page 151 of the Application Entry Type. Monitor for IPL Complete A option to provide an IPL completion notice is introduced for an application group, application or monitor resource. See APPLGROUP INFO Policy Item on page 122, APPLICATION INFO Policy Item on page 151, and MONITOR INFO Policy Item on page 237 respectively. IPL Time Limit Complete A new setting is available to indicate how long an IPL takes before being considered as "complete" in the AUTOMATION OPTIONS Policy Item on page 277 of System Defaults Entry Type on page 276. BROWSE option for Policy Database A new BROWSE option is available when working with the Policy Database and in the Customization Dialog Primary menu. See How to Browse a Policy Item on page 24. STARTUP Policy Item The REFRESHSTART and ANYSTART phases are added to the STARTUP Policy Item on page 183 for the Application Entry Type. xvi System Automation for z/os: Defining Automation Policy

19 Subsystem Shutdown Processing The Shutdown Pass Interval parameter is made available for the Subsystem Shutdown Processing panel. See SHUTDOWN Policy Item on page 186. Support for mixed case commands Mixed case characters can now be specified in Command Text field in the following entry types: v APL policies STARTUP, SHUTDOWN, JES2 / 3 SPOOLSHORT / SPOOLSHORT CMDS, MESSAGES USER/DATA v APG, MVC policy MESSAGES USER/DATA v MTR policies HEALTHSTATE, MESSAGES USER/DATA Write Data to File using a Batch Job Writing selected Entry Types from the policy database into a flat file in batch is described in Write Data to File using a Batch Job on page 366 Credentials for SOAP Servers The specification of User ID and Password is introduced in the SOAP SERVER Policy Item on page 295 of the Network Entry Type. AT/MRT scope The AT/MRT scope field is added to the former PROCESSING OPTIONS Policy Item, now renamed as the BUILD CONTROL Policy Item on page 263. AT and MRT Inserts In Entry Type MSG, a new policy AT/MRT INSERTS allows user specifications for the NetView automation table (AT) and message revision table (MRT). Messages from INGMSGSA in MRT and MPF In Entry Type MSG, policy BUILD CONTROL, the specification MRT default AUTOMATE =YES now also adds the messages from the SA automation table INGMSGSA to MRT and Message Processing Facility (MPF). AT support On the Automation Table entry Conditions panel, for the field Additional Condition a NetView AT syntax check can be turned on. The AT Status Specification panel now allows a capture message specification. The AT generated by the build process suppresses REXX Say and Trace output, but no longer blocks REXX error messages. MRT support In Entry Type MSG, policy BUILD CONTROL, the new field Route all WTORs to AT allows you to have the MRT entry for those WTORs, which are not yet defined in the PDB, to be generated by System Automation. So a user-defined MRT entry, as described in the chapter "WTOR Processing" of IBM Tivoli System Automation for z/os Customizing and Programming can be removed and this option be turned on. MRT overrides with UPON(OTHERMSG) in the first line are assembled into one common UPON(OTHERMSG) in the generated MRT. About this publication xvii

20 MPF support New fields to support build of MPF member are added in Entry Type MSG, policies MPF DEFINITIONS Policy Item on page 261 and BUILD CONTROL Policy Item on page 263. The MPF generated by the build process now includes messages with leading characters ignored. ISPF split screen support The Customization Dialog can be accessed in multiple ISPF split screen sessions. Pacing Gates A new entry type Pacing Gates is added to Automation Policy. A pacing gate defines the number of applications that may be started or stopped at one time on a system. See Pacing Gates Entry Type on page 250. Changed Information The following information has been changed in this edition: Support of Multiple Users The Customization Dialog supports concurrent access by multiple users across all entry types. References to 'multi-user-capable' entry types on the Figure 50 on page 77 have been removed. EDIT option Policy Database Due to the introduction of the BROWSE function, the old selection Open to access a Policy Database is changed to Edit, and on the Policy Database Selection list the panel with data sets and logging options now can be accessed with selection O Options. OPTIONS on the Policy Database Selection Panel The panel with data set specifications and logging options from the Policy Database Selection list now can be accessed with selection O Options. NEW JES2 policy items are defined Previous policy items for JES2 Systems are divided each into two new policy items. These policy items are now JES2 SPOOLFULL CMDS and JES2 SPOOLFULL CNTL for a JES2 SPOOLFULL specification, and JES2 SPOOLSHORT CNTL and JES2 SPOOLSHORT CMDS for a JES2 SPOOLSHORT specification. See Policy Items for JES2 Subsystems on page 199. PROCESSING OPTIONS Policy Item The PROCESSING OPTIONS Policy Item and panel is renamed to BUILD CONTROL Policy Item on page 263. Categories and Subcategories A range of application categories and subcategories are available for the Application Entry type (APL). The Categories and Subcategories are IBM-defined and user-defined. They replace Application Type and Subtype. Notify Operators, Automation Operators, Local Page Data Set Policies and Entry Type panels Updates are made to the following Entry Types and related panels for specific parameters: Notify Operators, Automation Operators, Local Page Data Set Policy Item under Groups Entry Type. Inform List Entry The list of inform list targets is extended to include ITM. xviii System Automation for z/os: Defining Automation Policy

21 Processor Policy Support extended under Data Management The policies for the Processors Entry Type are made available to other Entry Types. See Supported Policies in Data Management. AT support The following messages are moved from automation table INGMSGSA to predefined messages in +SA_PREDEFINED_MSGS to allow better user customization: IEE303I, EVJ120I, EQQE037I, EQQE107I, EQQW079W, EQQZ201I. Ignore for AT/MRT/MPF for single messages The panel for 'Ignore / Suppress via MPF' no longer offers a selection for 'Suppress'. Instead it is possible to exclude a message specifically for AT, MRT, or MPF. Deleted Information The following information has been deleted: v The following definitions have been retired: entry type CVP (CICS Connection Period) entry type CCN (CCN Monitor Period) v The Defining Automation for CICS components section is removed from Chapter 4, Entry Type Reference, on page 77. v The Converting from SA z/os 3.2 section is removed Moved and Restructured Data on page 365. v The protocol NVC (and use of the INTERNAL NVC protocol) is removed from the PROCESSOR policy item. See PROCESSOR INFO Policy Item on page 226. v The Keypoint, Reload and CICSPLEX/CMAS Region fields are removed from CICS CONTROL Policy Item on page 205. v The Shutdown Indoubt, Connection Monitor Delay, Terminate Thread Delay and Terminate Thread Cycles fields are removed from DB2 CONTROL Policy Item on page 207. v The DBCTL control region field is removed from IMS CONTROL Policy Item on page 209. v The Build Processor Operations Configuration File Option (9) used to build a processor operations control file is removed from Configuration Files Build Options on page 328. v Add-on policy *SAP removed, *SAPSRV could be used instead. v Add-on policy *HYPERSWAP removed, GDPS/PPRC Hyperswap manager definition can be found in*gdps instead. You may notice changes in the style and structure of some content in this document for example, headings that use uppercase for the first letter of initial words only, and procedures that have a different look and format. The changes are ongoing improvements to the consistency and retrievability of information in our documents. This document contains terminology, maintenance, and editorial changes. About this publication xix

22 xx System Automation for z/os: Defining Automation Policy

23 Chapter 1. Introducing the Customization Dialog Before you can use SA z/os to automate, monitor, and control the resources in your enterprise, you must define your enterprise's automation policy. You use the SA z/os customization dialog to provide information for SA z/os, such as: v Which resources (such as systems or applications) you want to automate, monitor and control v How resources are to be associated (that is, grouped) with each other for automation v The dependencies between resources and groups of resources v What sort of automation, such as automatic startup or shutdown, is to be applied to these resources and how v The conditions that automated actions should occur under, and what actions should be performed v When automation is to be active, and how it handles certain tasks and events during system operation The customization dialog leads the SA z/os policy administrator through the process of defining resources and automation for the enterprise. SA z/os automatically extracts the required information from this to display resources graphically, for example, on the NMC workstation. Before you begin to use the customization dialog to define your enterprise automation policy, you need to determine how you want SA z/os to work within your enterprise. This is part of the process of planning to use SA z/os. There are many considerations for planning to use SA z/os that you should be aware of. For more information, see the planning instructions given in IBM Tivoli System Automation for z/os Planning and Installation. Note: Do not use the customization dialogs on a Kanji terminal because they will not work. If you have your terminal defined as a 3278KN terminal, you can circumvent the Kanji restriction by going into ISPF option 0.1 (panel ID ISPOPT1) and redefining the TERMINAL TYPE to How to Define Automation Policy: An Outline Automation policy is needed if you want to use system operations or processor operations automation functions. About this task The process of defining automation policy comprises the following steps: Procedure 1. At the configuration focal point where you have the customization dialog installed, create the information in the policy database using the ISPF input panels of the customization dialog. 2. Use the BUILD function of the customization dialog to produce the required output, that is, the configuration files: automation control file (ACF), automation manager configuration file (AMC), NetView automation table (AT), the message revision table (MRT), and the MPFLSTxx file. Copyright IBM Corp. 1996,

24 How to Define Automation Policy: An Outline 3. Distribute the generated output to each system in the SA z/os enterprise where SA z/os system operations functions are to run. In general, this is all of the z/os systems in the SA z/os enterprise. In a sysplex, the data set name of the automation control file must be the same on all systems in the sysplex. However, it is highly recommended that you use a shared data set in a sysplex, and if possible, to use a shared data set for the whole enterprise. Results Entry Type Introduction See Chapter 7, Building and Distributing Configuration Files, on page 327 and Figure 249 on page 333 for more information on building and distributing the generated configuration files. All resources in your enterprise, such as systems or applications, or other objects that you use to automate your enterprise data processing, such as components of your z/os operating system, are called entry types. A complete list of SA z/os entry types is given on the Entry Type Selection panel (see Figure 1 on page 6), which is the first panel you see after you have decided which enterprise or policy database you are going to work with. For each entry type you can invoke a series of panels to create, modify, or delete entries of a certain entry type. A single instance of a particular entry type is called a policy object. These entries are referred to by their entry name. When you select an object via its name, you get a list of policy items specific for the entry type that you are working with. For example, the Timers entry type may consist of several named sets of timer definitions, each containing a number of timers. These named sets are selected and linked to a particular system as required. Each set can be linked to an arbitrary number of systems and any number of sets can be linked to any particular system. The letters and numbers in the following list indicate the entry type index on the Entry Type Selection panel. You can use either numbers or letters to select the appropriate entry type. The alphanumeric index is used on other panels of the customization dialog to identify a certain entry type. Detailed information and scenarios on how to automate the resources (applications and application groups) and make them available on certain systems is given in Chapter 3, Scenarios on How to Use the Customization Dialog, on page 35. 1/ENT Enterprise An Enterprise is the top level of your SA z/os structure. It comprises enterprise wide data for the complete policy database. 2/GRP Group A group is the largest subdivision of an SA z/os enterprise. An SA z/os enterprise may have several groups, each consisting of systems or subgroups, or both. A sysplex group can be used to represent a logical sysplex (systems within the same XCF group ID). A standard group can be used to represent a physical sysplex (systems in different XCF group IDs). The definition of groups is a prerequisite for sysplex-wide automation. 2 System Automation for z/os: Defining Automation Policy

25 Entry Type Introduction 3/SBG Subgroup Like groups, subgroups are collections of systems. You define a subgroup by selecting the member systems and assigning a name to the subgroup. Subgroups can be collected into groups. They offer a finer level of structuring groups. 4/SYS System A system is an image of an operating system running on a host processor monitored by SA z/os. The system may be MVS, VM, VSE, LINUX, or CF (coupling facility). A system definition includes for example: v Links to other objects associated with the system, for example, links to application groups v Application defaults v System defaults v System automation symbols 5/APG ApplicationGroup An application group is a set of applications that you assign a name to. You can define two types of application groups: System Application Groups and Sysplex Application Groups. You assign System Application Groups to one or more systems and Sysplex Application Groups to one or more sysplexes. 6/APL Application An application is a z/os subsystem or job that runs on a system in the SA z/os enterprise. SA z/os monitors applications through the messages they issue to the system, MVS commands, and SA z/os-provided services. An application can belong to more than one application group. An application definition includes: v Subsystem name and the name of the procedure that runs the job v Warning and alert thresholds v Start and Stop specifications v Individual automation flags 7/EVT Events Events are used for external dependencies where they represent a process that the automation cannot handle. For example, an operator needs to manually edit a file before the application can continue. SA z/os remembers which events are SET (have occurred) and can be told when to forget them (by defining an UNSET condition). 8/SVP Service Periods Define the availability of applications. A service period is a set of time intervals (service windows) during which a resource (APL, APG, or MTR) should be active or inactive. 9/TRG Triggers In combination with events, triggers are used to control the starting and stopping of resources (APL, APG, or MTR). 10/PRO Processor A processor is the physical or physically-partitioned hardware that a system runs on. A "logical" processor, called the ProcOps Service Machine (PSM) monitors VM guest systems. All processors of the IBM mainframe family are supported, which includes all IBM System z9, IBM System z10, IBM eserver zseries, IBM S/390, and IBM z196 Enterprise. Chapter 1. Introducing the Customization Dialog 3

26 Entry Type Introduction 11/MTR Monitor Resource The Monitor Resource entry type enables you to monitor the performance and health of an application. That is, a separate status informs you about the application's health. This health status can be used by the automation manager to make decisions and, if necessary, trigger automation for the subject application. 12/ENS zenterprise Ensembles The zenterprise Ensembles entry type (ENS) enables you to use zenterprise z/bx Compute power. 13/PAC Pacing Gates The Pacing Gates entry type enables you to create a limit for the number of applications that may start and stop in parallel on the same system. 20/PRD Product Automation With this entry type, you can define automation policy for TWS and CICS. 21/MSG Messages This entry type displays a list of all the messages that are defined in the policy database together with the messages from the MVC entry, +SA_PREDEFINED_MSGS. It also provides all additional specifications for the generation of automation table ( AT), message revision table (MRT) and the MPFLSTxx member. 30/TMR Timers Automation timer definitions. This object is used to schedule automation tasks which are periodic, or which must run at a particular time. 32/TPA Tape Attendance Specifies the time during which tape drives are either attended or unattended. This entry type also allows you to specify whether you want to monitor tape mounts on this system. If you do want to monitor tape mounts, you must enter warning and alert thresholds (in minutes and seconds) indicating how long a wait is allowed in mounting a tape before the response is considered unsatisfactory. 33/MVC MVS Component This entry type allows you to apply automation to various z/os data sets, resources and facilities. 34/MDF MVSCOMP Defaults Sets defaults for z/os component (entry type MVS Component) automation. 35/SDF System Defaults This entry type allows you to set various defaults that are used throughout the system. The values set here may be overridden by other entry types, such as Application, Application Defaults, or MVSCOMP Defaults, or by setting appropriate values in individual applications or MVS Component objects. 36/ADF Application Defaults This entry type specifies default values for automation flags and error threshold settings. These values are used as the default for any Application object on the system that the Application Defaults set is attached to. 37/AOP Automation Operators This entry type maps automation functions to automation operators. Automation operators are automated operator tasks, or autotasks, that can 4 System Automation for z/os: Defining Automation Policy