Top Banner
User Documentation June 2013 Tivoli Workload Scheduler KM for PATROL Version 1.5.01
214

Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Aug 22, 2020

Download

Documents

dariahiddleston
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

User Documentation June 2013

Tivoli Workload Scheduler KMfor PATROLVersion 1.5.01

Page 2: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Contacting BMC SoftwareYou can access the BMC Software Web site at http://www.bmc.com/. From this Web site, you can obtaininformation about the company, its products, corporate offices, special events, and career opportunities.

United States and Canada Outside United States and Canada

Address BMC Software, Inc.2101 CityWest Blvd. Houston TX 77042-2827

Telephone (01) 713 918 8800

Telephone 713 918 8800 or 800 841 2031

Fax (01) 713 918 8000

Fax 713 918 8000

Copyright 2006 BMC Software, Inc. or licensors, as an unpublished work. All rights reserved.

BMC Software, the BMC Software logos, and all other BMC Software product or service names areregistered trademarks or trademarks of BMC Software, Inc.

IBM is a registered trademark of International Business Machines Corporation.

DB2 is a registered trademark of International Business Machines Corporation.

Oracle is a registered trademark, and the Oracle product names are registered trademarks ortrademarks of Oracle Corporation.

All other trademarks belong to their respective companies.

BMC Software considers information included in this documentation to be proprietary and confidential.Your use of this information is subject to the terms and conditions of the applicable End User LicenseAgreement for the product and the proprietary and restricted rights notices included in thisdocumentation.

Restricted Rights Legend

U.S. Government Restricted Rights to Computer Software. UNPUBLISHED -- RIGHTS RESERVED UNDERTHE COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure of any data andcomputer software by the U.S. Government is subject to restrictions, as applicable, set forth in FARSection 52.227-14, DFARS 252.227-7013, DFARS 252.227-7014, DFARS 252.227-7015, and DFARS252.227-7025, as amended from time to time. Contractor/Manufacturer is BMC Software, Inc., 2101CityWest Blvd., Houston, TX 77042-2827, USA. Any contract notices should be sent to this address.

2

Version 1.5.01

Tivoli Workload Scheduler KM for PATROL

Page 3: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

You can obtain technical support by using the Support page on the BMC Software Web site or bycontacting Customer Support by telephone or e-mail. To expedite your inquiry, please see "BeforeContacting BMC Software."

Support Web Site

You can obtain technical support from BMC Software 24 hours a day, 7 days a week at http://www.bmc.com/support_home. From this Web site, you can

Read overviews about support services and programs that BMC Software offers:

Find the most current information about BMC Software products

Search a database for problems similar to yours and possible solutions

Order or download product documentation

Report a problem or ask a question

Subscribe to receive e-mail notices when new product versions are released

Find worldwide BMC Software support center locations and contact information, including e-mailaddresses, fax numbers, and telephone numbers

Support by Telephone or E-mail

In the United States and Canada, if you need technical support and do not have access to the Web, call800 537 1813. Outside the United States and Canada, please contact your local support center forassistance. To find telephone and email contact information for the BMC Software support center thatservices your location, refer to the Contact Customer Support section of the Support page on the BMCSoftware Web site at http://www.bmc.com/support_home.

Before Contacting BMC Software

Before you contact BMC Software, have the following information available so that Customer Support canbegin working on your problem immediately:

Product information

product name

product version (release number)

license number and password (trial or permanent)

Operating system and environment information machine type operating system type, version, andservice pack or other maintenance level such as:

PUT or PTF

system hardware configuration

serial numbers

related software (database, application, and communication) including type, version, and service

pack or maintenance

level

Sequence of events leading to the problem

Commands and options that you used

Messages received (and the time and date that you received them)

product error messages

messages from the operating system, such as "file system full"

3

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Page 4: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Table of Contents 4

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Table of Contents...........................................................................................................................13Release Notes for v1.5.01

...........................................................................................................................14Overview

...........................................................................................................................14Objectives

...........................................................................................................................14Features

...........................................................................................................................15Hierarchical Structure

...........................................................................................................................15Installation Guide

...........................................................................................................................16System Requirements

...........................................................................................................................17Packages

...........................................................................................................................17Extracting the Setup Files

...........................................................................................................................18Getting the BMC Software Installation Utility

...........................................................................................................................18Installation Procedure

...........................................................................................................................30Uninstalling Tivoli Workload Scheduler KM for PATROL

...........................................................................................................................36Loading and Configuring

...........................................................................................................................36Loading the KM

..................................................................................................................36Preparing to Load the KM

..................................................................................................................37Loading the KM on PATROL Console

..................................................................................................................37Loading the KM on PATROL Central

..................................................................................................................37Loading the KM on BMC Portal

...........................................................................................................................38Configuring the KM

..................................................................................................................38Discovery Cycle

...........................................................................................................................38Unloading the KM

..................................................................................................................38Unloading the KM from the PATROL Agent

..................................................................................................................38Unloading the KM from the PATROL Console

..................................................................................................................39Unloading the KM from the PATROL Central Console

...........................................................................................................................39User Guide

...........................................................................................................................39Administering TWS KM

..................................................................................................................39Starting the NETMAN Process

..................................................................................................................40Stopping the Process Tree

..................................................................................................................40Starting the Process Tree

..................................................................................................................41Stopping the Production Processes

...........................................................................................................................41Customizing Parameters

...........................................................................................................................42Debugging TWS KM

Page 5: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Table of Contents 5

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

...........................................................................................................................42Displaying a Parameter Graph, Gauge, or Text Output

...........................................................................................................................42Enabling Cluster Mode

...........................................................................................................................43Launching Administration Utilities

...........................................................................................................................43Refreshing Parameters

...........................................................................................................................44Reporting from TWS KM

...........................................................................................................................44Schedule, Job, and Prompt Filters

...........................................................................................................................45Tivoli Workload Scheduler Database Validation

...........................................................................................................................45Reference Guide

...........................................................................................................................45Application Classes and Icons

..................................................................................................................47MAESTRO

..................................................................................................................47TWS_CPU_CONT

..................................................................................................................47TWS_CPU

..................................................................................................................47TWS_PROCESS_CONT

..................................................................................................................47TWS_PROCESS

..................................................................................................................47TWS_PROMPTS_CONT

..................................................................................................................47TWS_PROMPTS_CPU

..................................................................................................................48TWS_PROMPTS

..................................................................................................................48TWS_SUMMARY

..................................................................................................................48TWS_SCHEDULES_CONT

..................................................................................................................48TWS_SCHEDULES_CPU

..................................................................................................................48TWS_SCHEDULES

..................................................................................................................48TWS_SCHEDULES_STATUS

..................................................................................................................48TWS_JOBS_CONT

..................................................................................................................49TWS_JOBS

..................................................................................................................49TWS_JOBS_STATUS

...........................................................................................................................49InfoBoxes

..................................................................................................................49TWS_SERVER Application InfoBox

..................................................................................................................49TWS_CPU Application InfoBox

..................................................................................................................50TWS_PROMPTS Application InfoBox

..................................................................................................................51TWS_SCHEDULES Application InfoBox

..................................................................................................................51TWS_JOBS Application InfoBox

...........................................................................................................................52Menus

..................................................................................................................52MAESTRO Menu

..................................................................................................................55TWS_CPU_CONT Menu

..................................................................................................................55TWS_CPU Menu

..................................................................................................................56TWS_PROMPTS_CONT Menu

Page 6: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Table of Contents 6

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

..................................................................................................................56TWS_PROMPTS Menu

..................................................................................................................56TWS_SCHEDULES_CONT Menu

..................................................................................................................56TWS_SCHEDULES_CPU Menu

..................................................................................................................56TWS_SCHEDULES Menu

..................................................................................................................57TWS_JOBS_CONT Menu

..................................................................................................................57TWS_JOBS Menu

...........................................................................................................................58Parameters

..................................................................................................................58Sort Alphabetically

..............................................................................................................58TWSABENDJobs

..............................................................................................................59TWSABENDScheds

..............................................................................................................60TWSABENPJobs

..............................................................................................................61TWSADDJobs

..............................................................................................................63TWSADDScheds

..............................................................................................................64TWSCANCLJobs

..............................................................................................................65TWSCANCLScheds

..............................................................................................................66TWSCpuColl

..............................................................................................................67TWSDONEJobs

..............................................................................................................68TWSERRORJobs

..............................................................................................................69TWSEXECJobs

..............................................................................................................7 1TWSEXECScheds

..............................................................................................................7 2TWSEXTRNJobs

..............................................................................................................7 3TWSFAILJobs

..............................................................................................................7 4TWSFENCEJobs

..............................................................................................................7 5TWSHOLDJobs

..............................................................................................................7 6TWSHOLDScheds

..............................................................................................................7 7TWSINTROJobs

..............................................................................................................7 8TWSJobsDelayTime

..............................................................................................................80TWSJobsElapsedTime

..............................................................................................................81TWSJobsStatus

..............................................................................................................82TWSLinkStatus

..............................................................................................................83TWSPENDJobs

..............................................................................................................84TWSProcessColl

..............................................................................................................85TWSProcessStatus

..............................................................................................................87TWSPromptFull

..............................................................................................................88TWSPromptNum

..............................................................................................................89TWSPromptsColl

Page 7: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Table of Contents 7

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

..............................................................................................................90TWSPromptStatus

..............................................................................................................91TWSPromptText

..............................................................................................................92TWSREADYJobs

..............................................................................................................94TWSREADYScheds

..............................................................................................................95TWSSCHEDJobs

..............................................................................................................96TWSSchedulesColl

..............................................................................................................97TWSSchedulesDelayTime

..............................................................................................................98TWSSchedulesElapsedTime

..............................................................................................................99TWSSchedulesStatus

..............................................................................................................101TWSSTUCKScheds

..............................................................................................................102TWSSUCCJobs

..............................................................................................................103TWSSUCCPJobs

..............................................................................................................104TWSSUCCScheds

..............................................................................................................105TWSSUSPJobs

..............................................................................................................106TWSWAITDJobs

..............................................................................................................107TWSWAITJobs

..................................................................................................................108Sort by Application Class

..............................................................................................................108MAESTRO

.....................................................................................................108TWSCpuColl

.....................................................................................................109TWSProcessColl

.....................................................................................................110TWSPromptsColl

.....................................................................................................111TWSSchedulesColl

..............................................................................................................113TWS_CPU

.....................................................................................................113TWSLinkStatus

..............................................................................................................114TWS_PROCESS

.....................................................................................................114TWSProcessStatus

..............................................................................................................115TWS_PROMPTS

.....................................................................................................115TWSPromptFull

.....................................................................................................116TWSPromptNum

.....................................................................................................117TWSPromptStatus

.....................................................................................................118TWSPromptText

..............................................................................................................120TWS_SUMMARY

.....................................................................................................120TWSABENDJobs

.....................................................................................................121TWSABENDScheds

.....................................................................................................122TWSABENPJobs

.....................................................................................................123TWSADDJobs

Page 8: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Table of Contents 8

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

.....................................................................................................124TWSADDScheds

.....................................................................................................125TWSCANCLJobs

.....................................................................................................126TWSCANCLScheds

.....................................................................................................127TWSDONEJobs

.....................................................................................................129TWSERRORJobs

.....................................................................................................130TWSEXECJobs

.....................................................................................................131TWSEXECScheds

.....................................................................................................132TWSEXTRNJobs

.....................................................................................................133TWSFAILJobs

.....................................................................................................134TWSFENCEJobs

.....................................................................................................135TWSHOLDJobs

.....................................................................................................136TWSHOLDScheds

.....................................................................................................137TWSINTROJobs

.....................................................................................................138TWSPENDJobs

.....................................................................................................140TWSREADYJobs

.....................................................................................................141TWSREADYScheds

.....................................................................................................142TWSSCHEDJobs

.....................................................................................................143TWSSTUCKScheds

.....................................................................................................144TWSSUCCJobs

.....................................................................................................145TWSSUCCPJobs

.....................................................................................................146TWSSUCCScheds

.....................................................................................................147TWSSUSPJobs

.....................................................................................................148TWSWAITDJobs

.....................................................................................................149TWSWAITJobs

..............................................................................................................151TWS_SCHEDULES

.....................................................................................................151TWSSchedulesDelayTime

.....................................................................................................152TWSSchedulesElapsedTime

.....................................................................................................153TWSSchedulesStatus

..............................................................................................................154TWS_JOBS

.....................................................................................................154TWSJobsDelayTime

.....................................................................................................155TWSJobsElapsedTime

.....................................................................................................156TWSJobsStatus

..................................................................................................................158Sort by Type

..............................................................................................................158Collector

.....................................................................................................158TWSCpuColl

.....................................................................................................159TWSProcessColl

Page 9: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Table of Contents 9

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

.....................................................................................................160TWSPromptsColl

.....................................................................................................161TWSSchedulesColl

..............................................................................................................162Consumer

.....................................................................................................162TWSABENDJobs

.....................................................................................................163TWSABENDScheds

.....................................................................................................164TWSABENPJobs

.....................................................................................................165TWSADDJobs

.....................................................................................................166TWSADDScheds

.....................................................................................................167TWSCANCLJobs

.....................................................................................................169TWSCANCLScheds

.....................................................................................................170TWSDONEJobs

.....................................................................................................171TWSERRORJobs

.....................................................................................................172TWSEXECJobs

.....................................................................................................173TWSEXECScheds

.....................................................................................................174TWSEXTRNJobs

.....................................................................................................175TWSFAILJobs

.....................................................................................................176TWSFENCEJobs

.....................................................................................................177TWSHOLDJobs

.....................................................................................................179TWSHOLDScheds

.....................................................................................................180TWSINTROJobs

.....................................................................................................181TWSJobsDelayTime

.....................................................................................................182TWSJobsElapsedTime

.....................................................................................................183TWSJobsStatus

.....................................................................................................184TWSLinkStatus

.....................................................................................................185TWSPENDJobs

.....................................................................................................187TWSProcessStatus

.....................................................................................................188TWSPromptFull

.....................................................................................................189TWSPromptNum

.....................................................................................................190TWSPromptStatus

.....................................................................................................191TWSPromptText

.....................................................................................................192TWSREADYJobs

.....................................................................................................193TWSREADYScheds

.....................................................................................................194TWSSCHEDJobs

.....................................................................................................196TWSSchedulesDelayTime

.....................................................................................................197TWSSchedulesElapsedTime

.....................................................................................................198TWSSchedulesStatus

Page 10: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Table of Contents 10

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

.....................................................................................................199TWSSTUCKScheds

.....................................................................................................200TWSSUCCJobs

.....................................................................................................201TWSSUCCPJobs

.....................................................................................................203TWSSUCCScheds

.....................................................................................................204TWSSUSPJobs

.....................................................................................................205TWSWAITDJobs

.....................................................................................................206TWSWAITJobs

...........................................................................................................................207Additional Information and Support

...........................................................................................................................207Where to Find Additional Help

Page 11: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Tivoli Workload SchedulerKM for PATROL

Page 12: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically
Page 13: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

13Release Notes for v1.5.01

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Release Notes for v1.5.01

What's NewSupport for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through theMASTER cluster node and automatically fail over when there is cluster fail over.

Monitoring Only the Last Job: A new filter has been added to monitor only the latest scheduled jobs,if enabled.

The Job report only displays the latest monitored schedule's jobs. Schedules' jobs resulting from aprevious execution are no longer available in the report.

Schedule date/time (SchedTime) is now included in the events from TWSJobsStatus andTWSSchedulesStatus.

The schedule status (TWS_SCHEDULES_STATUS) label now includes the SchedTime.

The default limitation for monitored number of allowed CPUs and Jobs is removed. The KM upgradewill not reset them. If you are upgrading the KM from an older version, use the "Set Number ofInstances" menu and delete any number of instances set for CPUs or Jobs.

Changes and ImprovementsAlerting Late Schedule & Jobs: KM triggers alerts for late (deadline breached) jobs and schedules.

Clear Jobs and Clear Schedules menus now keep the alerts on TWSJobsStatus andTWSSchedulesStatus acknowledged.

Fixed IssuesTWS_SETUP instance would not appear in the PATROL console when the "conman" commandreturns configuration errors. The KM discovery now ignores any errors found in the "conman"command output.

Missing Job Status Instance: When there are more than one job under a schedule, the KM did notcreate the job status instance under each job instance. This is corrected in this version.

Support for OR Jobs: KM correctly monitors TWS schedules/jobs configured with two or more jobsin OR condition.

Missing Latest Schedule Status: The latest schedule status was not applied toTWSSchedulesStatus, when there are more than one job reported for a schedule. This is nowcorrected.

Custom Events for Prompts: Detail custom event is added for TWSPromptStatus which includesCPU, Schedule, Job, Message Number and the actual Prompt text.

Page 14: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

14Overview

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Overview

ObjectivesThe primary objective of TWS KM is to ensure the availability, maximum schedule/job throughputperformance, and integrity of your scheduling environment. This section describes how to use TWS KMto achieve these goals. A PATROL Developer or Operator Console can be used, as required, to changeany of the default behaviors listed below.

The KM also provides specific monitoring of the status of prompts, jobs and schedules to ensure thatany problems are detected and reported.

Monitoring Server Availability

TWS KM monitors the TWS Master server processes to ensure availability (i.e. The processes netman,batchman, jobman, and mailman are running). The parameter TWSServerStatus monitors availabilityof all of the above processes. In the event of any process not running the parameter will go into analarm state. As a result of this several recovery actions are initiated; these being a window appearingon the PATROL Console indicating the status of all five key processes, and the same informationrecorded as a parameter annotation point.

Monitoring CPU Availability

TWS KM monitors the link status of all the CPU’s as defined within TWS. If the CPU becomes unlinkedfor more than two collection cycles (allowing for Jnextday to run each day) then an alarm is raised. EachCPU can be managed within the Knowledge Module, with the correct login details provided by thePATROL operator, allowing the following actions; link, unlink, start, stop.

FeaturesTivoli Workload Scheduler KM for PATROL is designed to make managing your enterprise schedulingenvironment as easy as possible. Each parameter that represents a potential problem in Tivoli WorkloadScheduler has been flagged with a range of acceptable values. If the value moves outside that rangeinto the warning range, the base of the parameter icon (and the bases of all preceding icons used tonavigate to the parameter) turn yellow. If the value moves into the alarm range, the icons flash red.

Tivoli Workload Scheduler KM for PATROL provides the following core capabilities:

Page 15: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

15Overview

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

monitor the system processes responsible for running Tivoli Workload Scheduler

monitor the status of the Master, Domain Managers, Fault Tolerant Agents, Standard Agents, andExtended Agent to ensure that they are linked and available

monitoring of outstanding prompts provide statistics on the number of schedules in each of thestates such as READY, HOLD, SUCC, etc

provide statistics on the number of jobs in each of the states such as READY, HOLD, SUCC, etc

monitor schedules that match the filter criteria

monitor jobs that match the filter criteria

ability to control schedules and jobs

launch X-Windows administration tools (UNIX only)

ability to validate database configurations

reports of production schedules

Hierarchical StructureTivoli Workload Scheduler KM for PATROL is organized as groups of application classes.

The top level icon for TWS KM is a single instance of the TWS_MA ESTRO application class, labeled Tivoli WorkloadScheduler. Only one installed version of TWS will be monitored. Automatic discovery will initially detect the currentlyactive version of TWS.

By double-clicking an application class icon, you will find the parameters that monitor your TWS system.Instead of parameters, some application classes may contain additional application classes, applicationinstances, or both. For example, for the TWS_SCHEDULES application class, you will find one icon foreach discovered schedule that matches the schedule filter. Within each of these discovered scheduleswill be an icon for each job that matches the job filter for each schedule.

Each of these are application classes. The icon for each job represents an instance of the TWS_JOBSapplication class. From each job instance icon, you can find parameters.

Installation Guide

Introduction

This section describes the installation procedure for Tivoli Workload Scheduler KM for PATROL on anyPATROL component (Agents, Consoles, Console Server, etc.). As the setup is based on the BMCSoftware Installation Utility, this procedure applies to all operating systems supported by Tivoli WorkloadScheduler KM for PATROL.

Page 16: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

16Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

System Requirements

Supported Operating Systems

Tivoli Workload Scheduler KM for PATROL can be run on the following operating systems:

Unix - Solaris, HP-UX, Digital Unix, AIX, Linux

Windows

TWS KM may run on other variants of Unix, on which Tivoli Workload Scheduler runs, but has not beentested.

On Windows platforms the Tivoli Workload Scheduler installation is identified by checking the Windowsregistry. Depending on the version of Tivoli Workload Scheduler, the registry entries can be found underone of the following registry paths:

“HKEY_LOCAL_MACHINE\SOFTWARE\Unison Software, Inc.\Unison

Maestro\”

“HKEY_LOCAL_MACHINE\SOFTWARE\IBM\Tivoli Workload

Scheduler”

“HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\Tivoli

Workload Scheduler”.

Therefore the PATROL Agent user should have read access to the registry path.

64-bit installation of Tivoli Workload Scheduler may not be detected through the 32-bit PATROL Agent, unless theabove registry path is copied under:HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432NODE\.

Supported Versions

Tivoli Workload Scheduler KM for PATROL supports the following versions for PATROL and TivoliWorkload Scheduler:

Tivoli Workload Scheduler: version 5.2 and above running on Solaris, HP-UX, Digital Unix, AIX,Linux or Windows platforms.

BMC PATROL Agent: version 3.4.20 and above.

BMC PATROL Console: version 3.4 and above.

BMC Portal: version 2.5 and above.

Security Requirements

Tivoli Workload Scheduler KM for PATROL does not require any specific security rights. The only baserequirement is that the PATROL account should be able to run the conman and cpuinfo (UNIX only)commands to be able to view CPU, Schedule, Job, Prompt and TWS application status details. If forsome reason the Security file in TWS has been configured to restrict access, then the PATROL accountmay need to be added to the file, to have display access to most components.

Specific menus do require the operators to enter the login and password of a valid user to perform

Page 17: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

17Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWS Operations.

Disk and Memory Usage

When monitoring a standard installation of TWS using TWS KM, the PATROL Agent will consumeapproximately 800KB of additional system memory. A Tivoli Workload Scheduler for PATROL mastermachine configured with additional CPU’s, or with filters for prompts, schedules, or jobs that createmore instances, this will consume additional memory resources as per other KMs used by the PATROLAgent.

When monitoring a standard installation of TWS using TWS KM, the PATROL Agent will generateapproximately 200K of history data per day. An installation configured with additional CPU’s or modifiedfilter rules will generate more history data as per other KMs used by the PATROL Agent.

The number of monitored TWS component instances can be reduced using the Set Number of Instances menu.

PackagesThe Tivoli Workload Scheduler KM for PATROL packages are available on the BMC Software Web siteand the Sentry Software Web site.

There are two packages, each of which can be used to install the KM on every PATROL component(Agent, Console, etc.) according to the platform you are using.

For Windows systems: tws_ALL_1501.zip

For UNIX and Linux systems: tws_ALL_1501.tar

The Tivoli Workload Scheduler KM for PATROL packages are designed for use with the BMC

Software Installation Utility (formerly known as Thorium). They need to be merged with the latestavailable version of the BMC Software Installation Utility. Please see instructions.

Extracting the Setup FilesLike most Knowledge Modules for PATROL, you need to install Tivoli Workload Scheduler KM for PATROLon the following components of your PATROL architecture:

Every managed system with a PATROL Agent

Every PATROL Console (Classic) that will show Tivoli Workload Scheduler performance-relatedinformation and alerts

The Console Server

PATROL Central – Web Edition

Page 18: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

18Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Getting the BMC Software Installation UtilityIn order to install Tivoli Workload Scheduler KM for PATROL, you need the latest version of the BMCSoftware Installation Utility. You can download the latest Installation Utility from the BMC Software EPD(electronic product download) from: http://webapps.bmc.com/signon/content/logon.jsp on the BMCSoftware Website, or from the Tivoli Workload Scheduler KM for PATROL page on the Sentry SoftwareWebsite.

Choose the appropriate package depending on the platform you plan to install Tivoli Workload SchedulerKM for PATROL on:

For UNIX/Linux systems: ins_ALL_<version>.tar

For Windows systems: ins_WINDOWS_<version>.exe

The packages are valid for all the PATROL components: Agent, Console, Console Server, etc.

Place the Installation Utility package in the same folder as the Tivoli Workload Scheduler KM for PATROLpackages.

Installation ProcedureInstalling Tivoli Workload Scheduler KM for PATROL is an automated process managed by a wizard. Thewizard goes through the necessary steps to install Tivoli Workload Scheduler KM for PATROL and allfiles associated with it. You are simply prompt for the product's folder location and the product/components to install.

Browse to the bmc_products folder where the files have been extracted (both Tivoli Workload SchedulerKM for PATROL and the Common Installer).

Page 19: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

19Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

On Windows: Launch the setup.exe program

On UNIX: Launch the setup.sh script

To install Tivoli Workload Scheduler KM for PATROL1. Allow the perl.exe program to listen on this port: Click Allow access.

Installation Wizard - Step 1: Windows Security A lert

Page 20: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

20Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

2. The welcome screen of the installer appears. Click Next to continue.

Installation Wizard - Step 2: Welcom e

Page 21: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

21Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

3. Read the license agreement, click the Accept option and then click Next to continue.

Installation Wizard - Step 3: Rev iewing License A greem ent

Page 22: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

22Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

4. Select Install products on this computer now and click Next to continue.

Installation Wizard - Step 4: Selecting Installation Options

Page 23: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

23Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

5. Specify the BMC Software products folder. See the BMC Software documentation for moreinformation about the BMC Software products folder. Click Next to continue.

Installation Wizard - Step 5: Selecting the Installation Directory

Page 24: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

24Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

6. Select Default. Installing Tivoli Workload Scheduler KM for PATROL does not require anycustomization. Click Next to continue.

Installation Wizard - Step 6: Selecting an Installation Ty pe

7. Select one or several of the following options:

Managed System to install Tivoli Workload Scheduler KM for PATROL on a PATROL Agent.

Console Systems role to install Tivoli Workload Scheduler KM for PATROL on a PATROL ClassicConsole.

Common services to install Tivoli Workload Scheduler KM for PATROL on the Console Server oron PATROL Central – Web Edition.

Click Next to continue.

Page 25: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

25Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Installation Wizard - Step 7: Selecting Roles

Select as many options as required.

Page 26: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

26Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

8. Check the Tivoli Workload Scheduler KM for PATROL box to install the KM (it should be selectedby default). Click Next to continue.

Installation Wizard - Step 8: Selecting Products and Com ponents

Page 27: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

27Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

9. Review the installation parameters and click Start Install to launch the installation procedure.

Installation Wizard - Step 9: Rev iewing Installation Options

Page 28: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

28Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

10. The setup program displays the actions performed and indicates the percentage of completion.Once the installation complete, click Next to view the installation results.

Installation Wizard - Step 10: Installation Status

Page 29: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

29Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

11. The wizard displays the installation results.Click View Log to display a detailed log of the installation procedure. Click Next and then Finish toexit the setup program.

Installation Wizard - Step 11: Installation Results

12. Click the Finish button to complete and close the installation wizard.

Page 30: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

30Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Installation Wizard - Step 12: Com pleting and closing the Installation Wizard

A Help button is available at each step of the procedure. Click to display the installation online help. The Exit buttonallows you to stop the installation procedure.

Uninstalling Tivoli Workload Scheduler KM forPATROLUninstalling Tivoli Workload Scheduler KM for PATROL is an automated process managed by a wizard.The wizard goes through the necessary steps to remove Tivoli Workload Scheduler KM for PATROL andall files associated with it. You are simply prompt for the product's folder location and the product/components to uninstall.

To uninstall Tivoli Workload Scheduler KM forPATROL1. Locate the Uninstall folder under the BMC products directory (typically under C:\Program Files\BMC

Software, or /opt/bmc):

On Windows systems, launch uninstall.exe

Page 31: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

31Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

On UNIX, launch uninstall.sh

Un-install Wizard — Welcom e Step

Page 32: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

32Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

2. Specify the BMC Software products folder. See the BMC Software documentation for moreinformation about the BMC Software products folder.

Un-install Wizard — Specify ing folder

Page 33: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

33Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

3. To uninstall the KM, select Tivoli Workload Scheduler KM for PATROL.

Un-install Wizard — Selecting Products and Com ponents Directory

Page 34: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

34Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

4. Click Start Uninstall

Un-install Wizard — Rev iewing Selected Products & com ponents and start uninstalling

Page 35: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

35Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

5. A page displays the list of products/components processed and the percentage of completion. ClickNext to continue.

Un-install Wizard — Status

Page 36: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

36Installation Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

6. A page displaying SUCCESS indicates that Tivoli Workload Scheduler KM for PATROL is nowuninstalled.

Un-install Wizard — Uninstall Results

Loading and Configuring

This chapter provides instructions for loading and configuring Tivoli Workload Scheduler KM for PATROLby Sentry Software.

Loading the KM

This section provides instructions to load TWS KM on Microsoft Windows and Unix platforms.

Before you load the TWS KM, you must install the KM on PATROL Console and PATROL Agent systems.

Preparing to Load the KM1. Start the PATROL Console and update the connection to all PATROL Agent systems where the TWS

KM is installed.

2. Check the value of the PATROL Agent tuning variable, /AgentSetup/AgentTuning/pslInstructionMax, and if necessary, increase it

Page 37: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

37Loading and Configuring

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Loading the KM on PATROL Console1. From the PATROL Console menu bar, choose File>Load KM...

2. Select the TWS_LOAD.kml file, and click Open or OK. The TWS KM will be loaded to the PATROLConsole, and all connected PATROL Agents will start discovering the Tivoli Workload Schedulerenvironment

4. Select File>Save Configuration to save the new list of loaded KM files as the PATROL Consoleuser preference

5. Repeat the above steps on each PATROL Console.

Loading the KM on PATROL Central1. Right click on the PATROL Main Map, and choose Load Knowledge Modules... A wizard box will

display a list of all managed systems.

2. Select the managed systems where the TWS KM is to be loaded, and click Next>. The wizard willdisplay a list of all available .kml files for the managed systems you selected.

3. Select the TWS_LOAD.kml file for each managed system, click Next> and Finish.

If you cannot find the TWS_LOAD.kml file in the wizard list for any system you selected, then the KM has not beeninstalled on that system.

The TWS KM will be loaded to the PATROL Central Console Server, and all connected selected managedsystems will start discovering the Tivoli Workload Scheduler environment.

4. Repeat the above steps for each PATROL Central Management Profile where TWS KM is to beloaded.

Loading the KM on BMC Portal1. Log on to BMC Portal with appropriate credentials to add infrastructure elements.

2. Click on Configure tab.

3. Under Tasks, select Elements to open the Elements page.

4. Click Add.

5. Select Infrastructure Element, and click Next.

6. Select appropriate RSM, and click Next.

7. Enter the label for the element, select PATROL Integration, and click Next.

8. Select/create a group name, and click Next.

9. Select appropriate method to discover the PATROL Agent hosts, and click Next.

10. Fill the required details for discovering the PATROL Agents, and click Commit.

Page 38: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

38Loading and Configuring

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Configuring the KM

This version of the TWS KM cannot be configured from BMC Portal. Use PATROL Console or PATROL Central Console

to access the KM configuration menus (KM commands) described below.

Discovery CycleDiscovery may take up to 15 minutes to automatically find all of the CPU’s, prompts, schedules and jobspresent in the system. Discovery can be forced by choosing Utilities > Patrol > Force Discoveryfrom the host application class menu. Individual schedule and job details will be discovered on the nextcycle the TWSSchedulesColl collector is run after discovery is finished.

Unloading the KM

Unloading the KM from the PATROL Agent1. Remove the TWS KM from the list of preloaded KMs, using the utility wpconfig (on MS Windows)

or xpconfig (on Unix)

2. Remove TWS_LOAD.kml from the PATROL Agent configuration variable /AgentSetup/preloadedKMs.

3. Restart the PATROL Agent.

4. Repeat these steps on every PATROL Agent system (managed node) where the TWS KM is to beunloaded.

The TWS KM cannot be partially unloaded from the PATROL Agent using the above steps. If you need to unloadsome parts of the KM from the PATROL Agent, refer to the PATROL Agent Reference Manual.

Unloading the KM from the PATROL ConsoleApplication classes are unloaded individually. This allows for a partial unloading of the KM to enable it torun as a reduced installation.

To unload the TWS KM completely or partially:

1. Remove the unwanted TWS KM application classes from the list of loaded application classes, asrequired. All TWS KM application classes start with TWS_.

With the PATROL Console for Unix:

From the PATROL Console main window choose Attributes> Application Classes...

Select a TWS KM application class to be removed and choose Edit>Delete.

Repeat for all classes to be removed.

Page 39: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

39Loading and Configuring

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

With the PATROL Console for MS Windows:

From the PATROL Console tree view choose the KM tab and expand the folder ApplicationClasses.

Right-click on a TWS KM application class to be removed and choose Delete.

Repeat for all classes to be removed.

2. Select File>Save Configuration to save the modified list of loaded application classes as thePATROL Console user preference.

3. Repeat these steps on every PATROL Console system where the TWS KM is to be unloaded.

Unloading the KM from the PATROL Central ConsoleA KM can be unloaded from particular managed systems or for all systems across the monitoredenvironment. Application classes may be unloaded individually, or by selecting all classes at once. Thisallows for a partial unloading of the KM to enable it to run as a reduced installation on some or all of themanaged systems.

To completely or partially unload the TWS KM from some or all of the managed systems:

1. Right click on the PATROL Main Map, and choose Unload Knowledge Modules...

2. Select the managed systems where the TWS KM is to be unloaded, and click Next>.

A list is displayed showing all the loaded application classes on each of the selected managed systems.All TWS KM application classes start with TWS_.

3. Select the TWS KM application classes to be removed for the appropriate managed systems, click Next> and Finish.

4. Repeat the above steps for each PATROL Central Management Profile where the TWS KM is to beunloaded.

User Guide

Administering TWS KMThis section describes how to start and stop the TWS production processes.

Starting the NETMAN ProcessWhen the discovery cycle is complete, verify that the application icon appears for the Tivoli WorkloadScheduler instance. If the icon does not appear there may be a problem with your PATROL installation. Refer to the PATROL Installation Guide for help. Alternately the discovery cycle may not have been ableto find your installation of TWS.

The following task explains how to start the TWS netman process automatically on the server. This isequivalent of issuing a StartUp command.:

Page 40: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

40User Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

1. Right-click and hold the mouse pointer on the Tivoli Workload Scheduler application instanceicon.The application menu appears.

2. Choose Start/Stop > Start NETMAN (StartUp). The confirmation dialog box appears.

3. Click yes to proceed. The login and password dialog box appears.

4. Enter the login details of an account that has enough priveleges to start the TWS netman process.

If a problem occurs:

1. Ensure that you have properly installed the KM. Refer to the PATROL Installation Guide for help.

2. Verify the configuration settings

3. Verify the login and password used.

Stopping the Process TreeWhen the discovery cycle is complete, verify that the application icon appears for the Tivoli WorkloadScheduler instance. If the icon does not appear there may be a problem with your PATROL installation.Refer to the PATROL Installation Guide for help. Alternately the discovery cycle may not have been ableto find your installation of TWS.

This task explains how to stop all of the TWS processes automatically on the server. This is equivalentof issuing a conman shutdown command:

1. Right-click and hold the mouse pointer on the Tivoli Workload Scheduler application instance icon.The application menu appears.

2. Choose Start/Stop > Stop Processes (conman shutdown). The confirmation dialog boxappears.

3. Click yes to proceed. The login and password dialog box appears.

4. Enter the login details of an account that has enough privileges to stop the TWS processes. A dialogbox will appear with the results of stopping the processes.

If a problem occurs:

1. Ensure that you have properly installed the KM. Refer to the PATROL Installation Guide for help.

2. Verify the configuration settings

3. Verify the login and password used.

Starting the Process TreeWhen the discovery cycle is complete, verify that the application icon appears for the Tivoli WorkloadScheduler instance. If the icon does not appear there may be a problem with your PATROL installation.Refer to the PATROL Installation Guide for help. Alternately the discovery cycle may not have been ableto find your installation of TWS.

The following task explains how to start all of the TWS processes automatically on the server. This isequivalent of issuing a conman start command:

Page 41: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

41User Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

1. Right-click and hold the mouse pointer on the Tivoli Workload Scheduler application instance icon.The application menu appears.

2. Choose Start/Stop > Start Processes (conman start). The confirmation dialog box appears.

3. Click yes to proceed. The login and password dialog box appears.

4. Enter the login details of an account that has enough privileges to start the TWS processes. Adialog box will appear with the results of starting the processes.

If a problem occurs:

1. Ensure that you have properly installed the KM. Refer to the PATROL Installation Guide for help.

2. Verify the configuration settings

3. Verify the login and password used.

Stopping the Production ProcessesWhen the discovery cycle is complete, verify that the application icon appears for the Tivoli WorkloadScheduler instance. If the icon does not appear there may be a problem with your PATROL installation.Refer to the PATROL Installation Guide for help. Alternately the discovery cycle may not have been ableto find your installation of TWS.

The following task explains how to stop the TWS processes automatically on the server, leaving thenetman process running. This is equivalent of issuing a conman stop command:

1. Right-click and hold the mouse pointer on the Tivoli Workload Scheduler application instance icon.The application menu appears.

2. Choose Start/Stop > Stop Processes (conman stop). The confirmation dialog box appears.

3. Click yes to proceed. The login and password dialog box appears.

4. Enter the login details of an account that has enough privileges to stop the TWS processes. A dialogbox will appear with the results of stopping the processes.

If a problem occurs:

1. Ensure that you have properly installed the KM. Refer to the PATROL Installation Guide for help.

2. Verify the configuration settings

3. Verify the login and password used.

Customizing ParametersMost parameters defined in a KM are activated by default. They continuously monitor key resources andwarn you of potential problems. All parameters in KMs are global parameters; that is, they automaticallyrun on all KM instances discovered. They are the common parameters used for all applications andcomputers. You can customize these parameters at the local level for a specific application or computer.You can customize parameters at the local level by performing some of the tasks listed below.

Page 42: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

42User Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Activating Help

Adding Parameters

Clearing Parameter History

Deleting Parameters

Entering the Parameter Command

Entering the Parameter Environment

Scheduling When the Parameter Runs

Selecting the Parameter Computer Class

Selecting the Parameter Command Type

Selecting the Parameter Type

Setting Alarm Ranges

Setting Parameter Security

Setting the Parameter History Retention Level

Setting the Parameter Output

Setting the State

Suspending Parameters

Debugging TWS KMBefore you begin, verify that the application icon for the loaded application instance is displayed. If theicon does not appear, there may be a problem with your PATROL installation. Refer to the PATROLInstallation Guide for help.

To enable or disable debugging:

1. Right-click and hold the mouse pointer on the Tivoli Workload Scheduler application instanceicon.The application menu appears.

2. Choose Debug. The Debug Admin dialog box appears.

3. Click on the areas for which debugging information is required

4. Click OK. Debugging information will appear on the system output window for the computer.

Displaying a Parameter Graph, Gauge, or TextOutputEach computer icon in the PATROL main window represents an instance of a host system that PATROLis monitoring. When you add a computer to the main window, PATROL establishes a default series ofapplication and parameter icons for monitoring. For information on displaying a parameter graph,gauge, or text output window, see the PATROL for Unix User Guide or the PATROL for W indows UserGuide (Volume 2).

Enabling Cluster ModeThe Enabling Cluster Mode KM Command is used to enable/disable monitoring job, schedule & promptsin IBM/TWS clusters.

To configure the cluster mode for the TWS clusters:

Page 43: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

43User Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

1. Right-click and hold the mouse pointer on the Tivoli Workload Scheduler application instance icon.

2. Click the Knowledge Module Command option.

3. Choose Enable Cluster Mode.

4. Enter the node names which belong to the TWS cluster (use commas as separators, if required).

5. Click Update to save your changes.

Launching Administration UtilitiesThis section describes the X-Window administration functions that are accessible through TivoliWorkload Scheduler KM for PATROL (UNIX only). These utilities require the TWS master server isrunning UNIX and the PATROL Console machine is running X-Windows. These are as follows:

GMAESTRO - GUI window to launch gcomposer and gconman.

GCOMPOSER - create scheduling objects using the GUI.

GCONMAN - manage production environment using the GUI.

COMPOSER - text utility for creating scheduling objects.

CONMAN - text utility for managing production environment.

Refreshing ParametersBefore you begin, verify that the application icon for the loaded application instance is displayed. If theicon does not appear, there may be a problem with your PATROL installation. Refer to the PATROLInstallation Guide for help.

To refresh all parameters for an application instance:

1. Right-click and hold the mouse pointer on the MAESTRO instance icon. The application menuappears.

2. Choose Refresh Parameters. All the parameters are updated for all application classes.

Page 44: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

44User Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Reporting from TWS KMThe reports available are:

List Symphony Log Files - Reports on available Symphony Log Files that are currently availableon the server.

Show All Schedules - Reports on all schedules that are running in the current production day.

Show All Jobs - Reports on all jobs that are running in the current production day.

Show All Resources - Reports on all resource dependencies that are defined against the currentproduction day.

Show All Files - Reports on all file dependencies that are defined against the current productionday.

Show All Prompts - Reports on all prompts that have, or will be issued in the current productionday.

Job Details Listing (rep1) - Runs the standard TWS report rep1.

Prompt Messages Listing (rep2) - Runs the standard TWS report rep2.

User Calendar Listing (rep3) - Runs the standard TWS report rep3.

User Parameters Listing (rep4a) - Runs the standard TWS report rep4a.

Resource Listing (rep4b) - Runs the standard TWS report rep4b.

Job History Listing (rep7) - Runs the standard TWS report rep7.

Job Histogram (rep8) - Runs the standard TWS report rep8.

Planned Prod Schedule (rep11) - Runs the standard TWS report rep11.

Schedule, Job, and Prompt FiltersFilters are used in three key areas of the TWS KM; schedules, jobs, and prompts. Filters allow forcustomization of what is monitored by the Knowledge Module. By default all schedules, jobs, andprompts that are important are monitored.The schedule and job filters will accept the standardwildcards used in TWS - @, %, and ?.

A reference to one or more Maestro entities must be in the following syntax:

CPU query: <Domain>!<CPU>

Schedule query: <CPU>#<Schedule> <Domain>!<CPU>#<Schedule>

Job query: <Schedule>.<Job><CPU>#<Schedule>.<Job><Domain>!<CPU>#<Schedule>.<Job>

Schedule Filter

The schedule filter allows for monitoring of schedules in specific states and also specific schedules thatare specified (either explicitely or using wildcards). By default, only schedules that are in the STUCK andABEND states, and the FINAL schedule itself are monitored.

Page 45: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

45User Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Job Filter

The job filter allows for monitoring of jobs in specific states and also specific jobs that are specified(either explicitely or using wildcards). The jobs depend on the schedule existing. By default, only jobsthat are in the ABEND, ABENP, DONE, ERROR, EXTRN, and FAIL states, and the JNEXTDAY job itselfare monitored.

Prompt Filter

The prompt filter allows for monitoring of prompts in specific states. By default, prompts in the ASKEDstate are monitored.

Tivoli Workload Scheduler Database ValidationThis section describes the method for performing a database validation against each database item.Essentially, each command will run a composer “create <file> from <database item>” and then runs acomposer “validate <file>” from the data that has been dumped. The validation checks the integrity ofthe database objects and will report on any problems.

To validate TWS database:

1. Right-click and hold the mouse pointer on the Tivoli Workload Scheduler application instance icon.The application menu appears.

2. Choose Validate Configurations > Calendars (or another database item). The login andpassword dialog box appears.

3. Enter the login details of an account that has enough privileges to run the validate command. Adialog box will appear with the results of the validation.

Reference Guide

Application Classes and IconsTivoli Workload Scheduler KM for PATROL consists of the following application classes:

Application Class Description Parent/Child Relationship

TWS_MAESTRO displays the Maestro information None (Top level)

TWS_CPU_CONT container for CPU information Child to TWS_MAESTRO

TWS_CPU displays CPU information Child to TWS_MAESTRO

TWS_PROCESS_ CONT container for process information Child to TWS_MAESTRO

TWS_PROCESS displays information about keyMaestro processes

Child to TWS_PROCESS_CONT

TWS_PROMPTS_ CONT container for prompt information Child to TWS_MAESTRO

Page 46: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

46Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWS_PROMPTS_CPU container for prompts related to aspecific cpu

Child to TWS_PROMPTS_CONT

TWS_PROMPTS displays prompt information Child to TWS_PROMPTS_CPU

TWS_SUMMARY displays summary information aboutschedules and jobs

Child to TWS_MAESTRO orTWS_SCHEDULES_ CPU

TWS_SCHEDULES_ CONT container for schedule and jobdetails

Child to TWS_MAESTRO

TWS_SCHEDULES_ CPU container for schedules and jobsrelated to a specific cpu

Child to TWS_SCHEDULES_ CONT

TWS_SCHEDULES displays information about schedule Child to TWS_SCHEDULES_ CPU

TWS_SCHEDULES_ STATUS displays current status of theschedule

Child to TWS_SCHEDULES

TWS_JOBS_CONT container for jobs Child to TWS_SCHEDULES

TWS_JOBS displays information about the job Child to TWS_JOBS_CONT

TWS_JOBS_STATUS displays current status of the job Child to TWS_JOBS

They have specific menus and menu items associated with them. Each application class is representedby an icon:

MAESTRO TWS_CPU_CONT TWS_CPU TWS_PROCESS_CONT

TWS_PROCESS TWS_PROMPTS_CONT TWS_PROMPTS_CPU TWS_PROMPTS

TWS_SUMMARY TWS_SCHEDULES_CONT

TWS_SCHEDULES_CPU

TWS_SCHEDULES

TWS_SCHEDULES_STATUS

TWS_JOBS_CONT TWS_JOBS TWS_JOBS_STATUS

Page 47: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

47Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

MAESTROThe MAESTRO application monitors information relating the Tivoli Workload Scheduler Server. There isonly one instance of the TWS_SERVER application and this is labeled MAESTRO.

TWS_CPU_CONTThe TWS_CPU_CONT application holds instances of TWS_CPU. There is one instance of this applicationclass labeled CPUS. This application class contains instances of the TWS_CPU for each process beingmonitored.

TWS_CPUThe TWS_CPU application monitors the link status of each agent. Each CPU defined within TivoliWorkload Scheduler is represented by an application instance for TWS_CPU. The name of each reflectsthe CPU defined within Tivoli Workload Scheduler.

TWS_PROCESS_CONTThe TWS_PROCESS_CONT application holds instances of TWS_PROCESS. There is one instance of thisapplication class labeled PROCESSES. This application class contains instances of the TWS_PROCESSfor each process being monitored.

TWS_PROCESSThe TWS_PROCESS application monitors key processes. The TWS_PROCESS icons appear in theTWS_PROCESS_CONT container window. The TWS_PROCESS container window has one instance foreach monitored Tivoli Workload Scheduler process, namely netman, mailman, batchman, and jobman.

TWS_PROMPTS_CONTThe TWS_PROMPTS_CONT application class contains any outstanding prompts, or prompts that matchthe predefined filter rule within the Tivoli Workload Scheduler environment.

TWS_PROMPTS_CPUThe TWS_PROMPTS_CPU application class contains any outstanding prompts, or prompts that matchthe predefined filter rule within the Tivoli Workload Scheduler environment for the current CPU.

Page 48: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

48Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWS_PROMPTSThe TWS_PROMPTS application provides information about the status of the current prompt thatmatches the predefined filter rule within the Tivoli Workload Scheduler environment for the current CPU.

TWS_SUMMARYThe TWS_SUMMARY application monitors summary information related to the number of schedulesand jobs in each of the different states that are available.

TWS_SCHEDULES_CONTThe TWS_SCHEDULES_CONT application container is created to hold any schedules and jobs thatmatch the respectively defined filters. An application instance of TWS_SCHEDULES_CONT is created atthe top level labeled SCHEDULES.

TWS_SCHEDULES_CPUThe TWS_SCHEDULES_CPU application is created for each matching CPU to hold any schedules andjobs that match the respectively defined filters.

TWS_SCHEDULESThe TWS_SCHEDULES application monitors the status of a matching schedule. The TWS_SCHEDULESicon appears in the TWS_SCHEDULES_CPU container window. The TWS_SCHEDULES containerwindow has one instance for each schedule discovered.

TWS_SCHEDULES_STATUSThe TWS_SCHEDULES_STATUS application provides instant status information for the current schedulebeing monitored. The name of the instance represents the current status of the schedule.

TWS_JOBS_CONTThe TWS_JOBS_CONT application contains matching job instances for the current schedule. Aninstance of TWS_JOBS_CONT is created for each schedule and is named JOBS.

Page 49: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

49Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWS_JOBSThe TWS_JOBS application monitors the status of the selected job. An instance is created for eachmatching job in the selected schedule. The name of the instance reflects the name of the job.

TWS_JOBS_STATUSThe TWS_JOBS_STATUS application provides instant status information for the current job beingmonitored. The name of the instance represents the current status of the job.

InfoBoxesInfoBoxes display summary information about an instance or application.

TWS_SERVER Application InfoBoxInfo Item Meaning

KM Version Version of Tivoli Workload Scheduler KM for PATROL

KM Release Date Date of release of the Knowledge Module

Installation Directory Displays directory where the software is installed.

User Name User name that the Tivoli Workload Scheduler KM forPATROL software runs as.

Version Version of Tivoli Workload Scheduler software.

Platform Platform that Tivoli Workload Scheduler software is runningon.

Operating System Operating System that Tivoli Workload Scheduler softwareis running on.

TWS_CPU Application InfoBoxInfo Item Meaning

CPU ID The name of the cpu to which this information applies.

Host The name of the cpu on which batchman is running. Fordomain managers and fault-tolerant agent cpus, this is thesame as CPUID. For standard agent cpus, this is the nameof the domain manager. For extended agents, this is thename of the host cpu.

TCP Port Number The TCP port number of CPUID from its cpu definition.

Node Type Node types are: UNIX, WINT, MPEV, MPIX, and OTHER.

Cpu Type Cpu types are: MASTER, MANAGER, FTA, S-AGENT, and X-AGENT.

Full Status Full Status mode (on/off)

AUTO Link Auto-link (on/off)

Mailman Server ID The mailman server id (a-z, 0-9).

Page 50: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

50Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Link Definition The link definition. This may be one of: only DS commands,only TCP statements, or both DS commands and TCPstatements

Jobman Version The version of jobman

Time Zone The time zone (the value of the TZ environment variable).For extended agents, the time zone of its host.

Info The Operating System version and cpu model. Forextended agents, no information is returned.

Run The run number of the Production Control file(Symphony).

Limit The Maestro job limit

Fence The Maestro job fence.

Date The date batchman started executing the Symphonyfile.

Time The time batchman started executing the Symphonyfile.

Method For extended agents only. The name of the access methodspecified in the cpu definition.

Domain The name of the domain in which the cpu is a member.

Link State The state of the cpu link from the Master. This is normallyLINKED or UNLINKED. No entry is displayed for the Mastermachine.

Link Type Type of link that has been established. This will be one ofthe following: DS, TCP/IP, HOST, X-AGENT, ?, or blank ifthe CPU is not linked.

Jobman Init Indicates if jobman is initialised (YES/NO)

Jobman Running Indicates if jobman is running (YES/NO)

Link to Master The link type from the Master CPU to the selected CPU. Linktypes are TCP/IP, DS, HOST, and X-AGENT. If the field isblank, the CPU is not linked.

TWS_PROMPTS Application InfoBoxInfo Item Meaning

Prompt State The states are:

YES Replied to with "y".

NO Replied to with "n".

ASKED Issued, but no reply.

INACT Not yet issued

Prompt Message Number The message number of a literal prompt.

CPU The name of the cpu on which a literal prompt was issued.

Schedule The Schedule (if applicable) that this prompt applies to.

Job The Job (if applicable) that this prompt applies to.

Prompt The full prompt as displayed.

Page 51: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

51Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWS_SCHEDULES Application InfoBoxInfo Item Meaning

CPU The cpu on which the schedule runs.

Schedule The name of the schedule.

Schedule State The state of the schedule. Schedule states are:

abend Schedule terminated unsuccessfully.

add Schedule has just been submitted.

cancl Schedule cancelled.

exec Schedule is executing.

hold Awaiting dependency resolution.

ready Dependencies resolved, ready to launch.

stuck Execution interrupted. No jobs will be launchedwithout operator intervention.

succ Schedule completed successfully.

Priority The priority of the schedule.

Estimated Start Estimated schedule start time in HH:MM format. If the time ismore than 24 hours in the future, the date is listed instead ofthe time.

Estimated Elapse Estimated schedule run time based on logged statistics inMM:SS format.

Estimated End Estimated schedule end time in HH:MM:SS format?.

Start Schedule start time in HH:MM format. If the time is more than24 hours in the past, the date is listed instead of the time.

Elapse Schedule run time in MM:SS format.

End Schedule end time in HH:MM:SS format.

Jobs # The number of jobs in the schedule.

Jobs OK The number of jobs that have completed successfully.

Sch Limit The schedule’s job limit. If blank, no limit is in effect.

TWS_JOBS Application InfoBoxInfo Item Meaning

CPU The cpu on which the job runs.

Schedule The name of the schedule.

Job The name of the job.

Job State The state of the schedule or job. Job states are:

abend Job terminated with a non-zero exit code.

abenp "abend" confirmation received, but job notcompleted.

add Job is being submitted.

done (MPE only) Job completed in an unknown state.

Page 52: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

52Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

error For an internetwork dependency, an error occurredwhile checking for the remote status.

exec Job is executing.

extrn For an internetwork dependency, unknown status.An error occurred, a rerun action was just performed onthe EXTERNAL job, or the remote job or schedule does notexist.

fail Unable to launch job.

fence Job ’s priority is below the fence.

hold Job awaiting dependency resolution.

intro Job introduced for launching by the system.

pend Job completed, awaiting confirmation.

ready Job ready to launch, all dependencies resolved.

sched Job’s at time has not arrived.

succ Job completed with zero exit code.

succp "succ" confirmation received, but job not completed.

susp (MPE only) Job suspended by breakjob command.

wait (X-agent jobs and MPE only) Job is being moved toready.

waitd (MPE only) Job is in the wait state, and is deferred.

Priority The schedule or job priority. A plus sign (+) preceding thepriority means the job has been launched.

Estimated Start Estimated job start time in HH:MM format. If the time is morethan 24 hours in the future, the date is listed instead of thetime.

Estimated Elapse Estimated job run time based on logged statistics in MM:SSformat.

Estimated End Estimated job end time in HH:MM:SS format.

Start Job start time in HH:MM format. If the time is more than 24hours in the past, the date is listed instead of the time.

Elapse Job run time in MM:SS format.

End Job end time in HH:MM:SS format.

Job Number Job number of completed job.

Menus

MAESTRO MenuCommand Description

Start/Stop The sub-menu which contains the administration functions to start and stop theTivoli™ Workload Scheduler processes.

Start NETMAN (StartUp) This option asks for confirmation to proceed with starting the Tivoli™ WorkloadScheduler process (netman). The user is prompted with a login and passwordscreen in order to run the command to start the process. The account enteredmust have the necessary permissions to start the process. This option does notstart the other processes in the Maestro Process Tree.

Page 53: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

53Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Stop (conman shutdown) This option asks for confirmation to proceed with stopping all the Tivoli™Workload Scheduler processes. The user is prompted with a login and passwordscreen in order to run the command to stop the processes. The account enteredmust have the necessary permissions to stop the processes. This option will stopall the processes in the Maestro Process Tree.

Start Processes (conman start) This option asks for confirmation to proceed with starting the Tivoli™ WorkloadScheduler processes. The user is prompted with a login and password screen inorder to run the command to start the processes. The account entered musthave the necessary permissions to start the processes. This option will start allthe processes in the Maestro Process Tree.

Stop Processes (conman stop) This option asks for confirmation to proceed with stopping the Tivoli™ WorkloadScheduler processes. The user is prompted with a login and password screen inorder to run the command to stop the processes. The account entered musthave the necessary permissions to stop the processes. This option will stop theprocesses in the Maestro Process Tree except for netman.

Launch X-Windows Applications The sub-menu which launches Tivoli™ Workload Scheduler text or X-Windowsprograms for UNIX machines only.

Launch GMAESTRO Launch main Maestro GUI Application where gcomposer and gmaestro can belaunched. Menu item only available on UNIX. Must have an X-Windows applicationto display the output. Menu item requires a login and password to run thecommand.

Launch GCOMPOSER Launch gcomposer GUI Application to create or modify scheduling objects.Menu item only available on UNIX. Must have an X-Windows application to displaythe output. Menu item requires a login and password to run the command.

Launch COMPOSER Launch composer Text-based Application to create or modify scheduling objects.Output will be in an Xterm window. Menu item only available on UNIX. Must havean X-Windows application to display the output. Menu item requires a login andpassword to run the command.

Launch GCONMAN Launch gconman GUI Application for managing the production dayenvironment. Menu item only available on UNIX. Must have an X-Windowsapplication to display the output. Menu item requires a login and password to runthe command.

Launch CONMAN Launch conman Text-based for managing the production day environment.Output will be in an Xterm window. Menu item only available on UNIX. Must havean X-Windows application to display the output. Menu item requires a login andpassword to run the command.

Filter The sub-menu provides windows to define filters for schedules, jobs, andprompts.

Schedules Filter window to specify the schedules that will be monitored. Schedules can befiltered on a state basis (e.g. ABEND, STUCK, SUCC, etc.) or on aCPU#SCHEDULE name basis. The states are all listed and those of interest canbe selected from the list. By default schedules in the STUCK and ABEND statesare monitored. In addition, specific schedules can be monitored. By default the@#FINAL schedule is always monitored. Standard Maestro wildcards can be used(e.g. @, ?, and %) to assist in looking for schedules that match a specific pattern(e.g. list all schedules belonging to the Human Resources department could byshown using a filter of @#HR@ if all the schedules for the HR department beganwith HR.

Page 54: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

54Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Jobs Filter window to specify the jobs that will be monitored. Jobs can be filtered on astate basis (e.g. ABEND, FAIL, SUCC, etc.) or on a CPU#SCHEDULE.JOB namebasis. The states are all listed and those of interest can be selected from the list.Alternately, all can be selected by clicking on the All Filters button. By defaultjobs in the ABEND, ABENP, DONE, ERROR, EXTRN, and FAIL states aremonitored. In addition, specific jobs can be monitored. By default the@#@.JNEXTDAY job is always monitored. Standard Maestro wildcards can beused (e.g. @, ?, and %) to assist in looking for jobs that match a specific pattern(e.g. list all jobs belonging to the Human Resources department could be shownusing a filter of @#@.HR@ if all the jobs for the HR department began with HR.

Prompts Filter window to specify the prompts that will be monitored. Prompts can befiltered on a state basis (e.g. INACT, ASKED, YES, and NO). By default promptsin the ASKED state are monitored.

Reports The sub-menu which launches Tivoli™ Workload Scheduler reports to provideimportant information.

List Symphony Log Files Reports on available Symphony Log Files that are currently available on theserver.

Show All Schedules Reports on all schedules that are running in the current production day.

Show All Jobs Reports on all jobs that are running in the current production day.

Show All Resources Reports on all resource dependencies that are defined against the currentproduction day.

Show All Files Reports on all file dependencies that are defined against the current productionday.

Show All Prompts Reports on all prompts that have, or will be issued in the current production day.

Maestro Reports The sub-menu which launches Tivoli™ Workload Scheduler reports to provideimportant information.

Job Details Listing (rep1) Runs the standard Tivoli™ Workload Scheduler report rep1.

Prompt Messages Listing (rep2) Runs the standard Tivoli™ Workload Scheduler report rep2.

User Calendar Listing (rep3) Runs the standard Tivoli™ Workload Scheduler report rep3.

User Parameters Listing (rep4a) Runs the standard Tivoli™ Workload Scheduler report rep4a.

Resource Listing (rep4b) Runs the standard Tivoli™ Workload Scheduler report rep4b.

Job History Listing (rep7) Runs the standard Tivoli™ Workload Scheduler report rep7.

Job Histogram (rep8) Runs the standard Tivoli™ Workload Scheduler report rep8.

Planned Prod Schedule (rep11) Runs the standard Tivoli™ Workload Scheduler report rep11.

Planned Prod Summary (reptr) Runs the standard Tivoli™ Workload Scheduler report reptr -pre -summary.

Planned Prod Detail (reptr) Runs the standard Tivoli™ Workload Scheduler report reptr -pre -detail.

Actual Prod Summary (reptr) Runs the standard Tivoli™ Workload Scheduler report reptr -post -summary.

Actual Prod Detail (reptr) Runs the standard Tivoli™ Workload Scheduler report reptr -post -detail.

Validate Configurations The sub-menu which dumps the scheduling objects from the database (using thecomposer "create" command) and runs the validate command against them.

Calendars Validates Calendar definitions.

CPU’s Validates CPU definitions.

Jobs Validates Job definitions.

Parameters Validates Parameter definitions.

Prompts Validates Prompt definitions.

Page 55: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

55Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Resources Validates Resource definitions.

Schedules Validates Schedule definitions.

Users Validates User definitions.

psetcode Information Provides licensing and validation code information from Tivoli™ WorkloadScheduler using the psetcode -d and psetcode -i commands.

Set Number of Instances This option allows setting limitation on number of CPUs and Jobs monitored. Bydefault, there is no limitation set allowing all CPUs and Jobs to be discovered andmonitored.

Reset Global Channel This option will reset the global channel used for collecting information from TivoliWorkload Scheduler. The global channel will close the session to conman andrestart a new channel.

Debug This option turns on debugging information for several areas of reporting. It isintended to provide limited additional information output onto the system consolewindow.

Refresh Parameters This option will refresh PATROL parameters for the TWS_MAESTRO applicationclass.

About This option gives details about the KM version.

TWS_CPU_CONT MenuCommand Description

Enable CPUs Allows selected CPUs to be enabled for monitoring. By default all CPUsare monitored.

TWS_CPU MenuCommand Description

Schedules Reports on current schedules that are running against this CPU.

Jobs Reports all jobs that are run against the current CPU.

Resources Reports on all resource dependencies that are defined in the productionday for the current CPU.

Files Reports on all file dependencies that are defined in the production dayfor the current CPU.

CPU Information Reports on CPU information by running the cpuinfo command.

Limit Changes the CPU Limit for the number of job that can be simultaneouslyrun against this CPU.

Fence Changes the Fence limit for jobs that run against this CPU. A job musthave a priority one higher than the Fence limit to actually run.

Start Issues a conman start command to the CPU.

Stop Issues a conman stop command to the CPU.

Link Issues a link command to the CPU.

Unlink Issues an unlink command to the CPU.

Page 56: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

56Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWS_PROMPTS_CONT MenuCommand Description

Filter Prompts Filter window to specify the prompts that will be monitored. Prompts canbe filtered on a state basis (e.g. INACT, ASKED, YES, and NO). Bydefault prompts in the ASKED state are monitored.

Show All Prompts Report to show all prompts in all states.

TWS_PROMPTS MenuCommand Description

Reply The sub-menu which contains the menus to respond to a prompt.

Yes Respond Yes to the prompt.

No Respond No to the prompt.

Dependent Objects Report on the dependencies on the prompt.

TWS_SCHEDULES_CONT MenuCommand Description

Filter Schedules Filter window to specify the schedules that will be monitored. Schedules can befiltered on a state basis (e.g. ABEND, STUCK, SUCC, etc.) or on aCPU#SCHEDULE name basis. The states are all listed and those of interest canbe selected from the list. By default schedules in the STUCK and ABEND statesare monitored. In addition, specific schedules can be monitored. By default the@#FINAL schedule is always monitored. Standard Maestro wildcards can be used(e.g. @, ?, and %) to assist in looking for schedules that match a specific pattern(e.g. list all schedules belonging to the Human Resources department could beshown using a filter of @#HR@ if all the schedules for the HR department beganwith HR.

Clear All Alarms Clears all Schedule and Job alarms. This applies directly to the parameters TWSSchedulesStatus and TWSJobsStatus.

TWS_SCHEDULES_CPU MenuCommand Description

Schedules Reports on current schedules that are running against this CPU.

Jobs Reports all jobs that are run against the current CPU.

Clear All Alarms Clears all Schedule and Job alarms for the selected CPU. This applies directly tothe parameters TWSSchedulesStatus and TWSJobsStatus.

TWS_SCHEDULES MenuCommand Description

Show Schedule Reports on the selects schedule providing status information.

Show Jobs Reports on the jobs currently running against the selected schedule.

Page 57: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

57Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Limit Changes the job limit for the selected schedule. This limits the number of jobsthat can run simultaneously in the schedule. This limit is over-ruled by the CPUlimit defined.

Priority Changes the priority for the schedule. Only schedules and jobs with a priorityhigher than the CPU’s Fence limit will be able to run.

Release Release the selected schedule’s dependencies.

Cancel Schedule Cancels the selected schedule. If a schedule is canceled before it is launched, itwill not launch. If canceled after it is launched, its executing jobs are allowed tocomplete, but no other jobs are launched. Jobs and schedules that aredependent on the canceled schedule are released immediately.

Display Schedule Definition Display schedule definitions

Display Job Definition Displays the contents of the job’s script files for all the jobs defined for thecurrent schedule.

A larms

Clear Schedule Alarm Clears the TWSSchedulesStatus alarm for the current schedule.

Clear Job Alarms Clears all the job alarms for the parameters TWSJobsStatus for the currentschedule.

Clear Schedule and Jobs Alarms Clears the schedule and job alarms for the selected schedule.

TWS_JOBS_CONT MenuCommand Description

Clear Job Alarms Clears all the job alarms for the parameters TWSJobsStatus for the currentschedule.

TWS_JOBS MenuCommand Description

Priority Changes the priority for the job. Only schedules and jobs with a priority higherthan the CPU’s Fence limit will be able to run. The priority of a job will not run at ahigher priority than the schedule it is currently running in.

Release Releases the current job from all of it’s dependencies.

Cancel Job Cancels the selected job. If a job is canceled before it is launched, it will notlaunch. If canceled after it is launched, the job continues to execute. If anexecuting job is canceled and it completes in the ABEND state, no automatic jobrecovery steps are attempted. Jobs and schedules that are dependent on thecanceled job are released immediately.

Rerun Reruns the selected job. To rerun a job, it must be in the succ, fail or abendstate. A rerun job is placed in the same schedule as the original job, and inheritsthe original’s dependencies. If you rerun a repetitive (every) job, the rerun job isscheduled to run at the same rate as the original job.

Kill Stops an executing job. On UNIX, this is accomplished with a UNIX kill command.The kill operation is not performed by Conman, but is executed by Jobman, sothere may be a short delay. Killed jobs terminate in the abend state. Any jobs orschedules that are dependent on a killed job are not released. Killed jobs can bererun.

Confirm The sub-menu which contains the menus to acknowledge the status of a job.

SUCC Confirm the completion of a job that was scheduled with the SUCC state.

Page 58: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

58Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

ABEND Confirm the completion of a job that was scheduled with the ABEND state.

Stdlist The standard list files for the job selection are displayed in their standard format.

Dependent Objects The jobs used in follows dependencies are listed followed by the dependent jobsand schedules. Jobs are listed in the basic showjobs format.

Display Job Definition Display the contents of the job’s script file.

Clear Job Alarm Clears the alarm on the TWSJobsStatus parameter.

Parameters

Sort Alphabetically

TWSABENDJobs

This parameter displays the number of jobs that are in the ABEND state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the ABEND state. The job terminated with a non-zero exit code.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Page 59: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

59Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSABENDScheds

This parameter displays the number of schedules that are in the ABEND state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the ABEND state. The schedule terminated unsuccessfully.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Page 60: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

60Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSABENPJobs

This parameter displays the number of jobs that are in the ABENP state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the ABENP state. ABEND confirmation received, but the job has not completed.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 61: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

61Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSADDJobs

This parameter displays the number of jobs that are in the ADD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the ADD state. The job is being submitted.

Page 62: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

62Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 63: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

63Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWSADDScheds

This parameter displays the number of schedules that are in the ADD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the ADD state. The schedule has just been submitted.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Page 64: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

64Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSCANCLJobs

This parameter displays the number of jobs that are in the CANCL state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the CANCL state. The job has been canceled.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Range: Undefined

Page 65: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

65Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSCANCLScheds

This parameter displays the number of schedules that are in the CANCL state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the CANCL state. The schedule has been canceled.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Page 66: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

66Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSCpuColl

The TWSCpuColl collector collects information for the TWS_CPU Knowledge Module consumerparameters.

Detailed Description

This collector sets consumer parameters (TWSLinkStatus) in the TWS_CPU application class. TheTWSCpuColl collector collects information regarding the status of each defined CPU within Tivoli™Workload Scheduler.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Not applicable.

Page 67: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

67Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon None

Unit Not applicable

Output Range Not applicable

Poll Time 10 minutes

Status Active

Variable Name Not applicable

Parameter Type Collector

Value Set By Not applicable

TWSDONEJobs

This parameter displays the number of jobs that are in the DONE state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the DONE state. The job has completed in an unknown state (MPE only).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Page 68: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

68Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSERRORJobs

This parameter displays the number of jobs that are in the ERROR state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the ERROR state. For an internetwork dependency , an error occured while checking for theremote status.

Default Action Taken by PATROL

Not applicable.

Page 69: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

69Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSEXECJobs

This parameter displays the number of jobs that are in the EXEC state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the EXEC state. The job is currently executing.

Page 70: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

70Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 71: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

71Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWSEXECScheds

This parameter displays the number of schedules that are in the EXEC state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the EXEC state. The schedule is currently executing.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 72: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

72Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWSEXTRNJobs

This parameter displays the number of jobs that are in the EXTRN state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the EXTRN state. For an internetwork dependency, unknown status. An error occured, arerun action was just performed on the EXTERNAL job, or the remote job or schedule does not exist.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Page 73: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

73Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSFAILJobs

This parameter displays the number of jobs that are in the FAIL state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the FAIL state. Unable to launch the job. This is typically if the user account does not exist,the script, or command, does not exist, the jobmanrc file cannot be run, the stdlist file could not beopened, or could not login as the user and change to the user’s home directory.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Page 74: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

74Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSFENCEJobs

This parameter displays the number of jobs that are in the FENCE state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the FENCE state.The job’s priority is below the fence of the CPU.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Page 75: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

75Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSHOLDJobs

This parameter displays the number of jobs that are in the HOLD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the HOLD state. The job is awaiting dependency resolution.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Page 76: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

76Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSHOLDScheds

This parameter displays the number of schedules that are in the HOLD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the HOLD state. The schedule is awaiting dependency resolution.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 77: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

77Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSINTROJobs

This parameter displays the number of jobs that are in the INTRO state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the INTRO state. The job has been introduced for launching by the system.

Default Action Taken by PATROL

Not applicable.

Page 78: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

78Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSJobsDelayTime

This parameter monitors the delay time of the job.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the delay time of the jobstart. This is derived from the estimated start time and the actual start time of the job.

Page 79: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

79Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit Minutes (-1 = Not Executed; -2 = Unknown)

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 80: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

80Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWSJobsElapsedTime

This parameter monitors the delay time of the job.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the elased time of the jobsince the actual start time.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit Minutes (-1 = Not Executed; -2 = Unknown)

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Page 81: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

81Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSJobsStatus

This parameter monitors the status of the current job and displays the current state that the job is in.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the status of the currentjob. The valid states are as follows: 0=ALARM CLEARED, 1=ADD, 2=INTRO, 3=READY, 4=EXEC,5=SUCC, 6=SUCCP, 7=SUSP, 8=WAIT, 9=WAITD, 10=FENCE, 11=HOLD, 12=PEND, 13=SCHED,14=CANCL, 15=ABEND, 16=ABENP, 17=DONE, 18=ERROR, 19=EXTRN, 20=FAIL. Theparameter will alarm if the schedule is in the ABEND through to FAIL states.

When a Job failure is detected, a detail event will be triggered. This event reports the CPU, Schedule,Job, Job State & Job Number as follows:

TWS job is in ALARM status (CPU: <OTLAIX01>; Schedule: <CF11318AAAAAAAAA>; Job: <JNEXTDAY>; Job State: <ABEND>; Job Number: <#J31480>)

Default Action Taken by PATROLNot applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 20 Alarm

Alarm 1 Threshold 15 – 20 Alarm

Alarm 2 Threshold none set by default

Default Values

Default Value

Page 82: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

82Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit (0-14 = Acceptable, 15-20 = Alert Event)

Output Range

Range: 0 – 20

Warning: Undefined

Alarm: 15 – 20

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSLinkStatus

This parameter monitors the link status of the CPU with the Master CPU.

Detailed Description

This consumer parameter, set by the TWSCpuColl collector, displays the link status of the CPU with theMaster machine.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 2 Alarm

Alarm 1 Threshold 0 – 0 Alarm

Page 83: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

83Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Alarm 2 Threshold 1 – 1 Alarm (n=2)

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit 2=LINKED, 1=JNEXTDAY RUNNING, 0=UNLINKED

Output Range

Range: 0 - 2

Warning: Undefined

Alarm: 0 – 0, 1 – 1

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSCpuColl

TWSPENDJobs

This parameter displays the number of jobs that are in the PEND state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the PEND state. The job has completed and is awaiting confirmation of the exit state by theoperator (state to be set is either SUCC or ABEND).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 84: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

84Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSProcessColl

The TWSProcessColl collector collects information for the TWS_PROCESS Knowledge Moduleconsumer parameters.

Detailed Description

This collector sets consumer parameter (TWSProcessStatus) in the TWS_PROCESS application class.The TWSProcessColl collector collects information regarding the status of the four key Tivoli™ WorkloadScheduler processes (netman, mailman, jobman, and batchman).

Default Action Taken by PATROL

Not applicable.

Page 85: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

85Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Not applicable.

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon None

Unit Not applicable

Output Range Not applicable

Poll Time 10 minutes

Status Active

Variable Name Not applicable

Parameter Type Collector

Value Set By Not applicable

TWSProcessStatus

This parameter monitors the status of the key Tivoli Workload Scheduler processes.

Detailed Description

This consumer parameter, set by the TWSProcessColl collector, monitors the status of key TivoliWorkload Scheduler processes (netman, mailman, jobman, and batchman).

Default Action Taken by PATROL

Not applicable.

Page 86: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

86Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 2 Alarm

Alarm 1 Threshold 0 – 0 Alarm

Alarm 2 Threshold 1 – 1 Alarm (n=2)

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit 2 = yes, 1=Jnextday running, 0 = no

Output Range

Range: 0 - 2

Warning: Undefined

Alarm: 0 – 0, 1 – 1

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSProcessColl

Page 87: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

87Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWSPromptFull

This parameter displays the full prompts message details, including message number, schedule/job thatthe prompt applies to, and the text message of the prompt.

Detailed Description

This consumer parameter, set by the TWSPromptsColl collector, monitors any prompts that match thedefined prompts filter and sets the value to be the full text details of the prompt.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Text

Unit Not applicable

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Page 88: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

88Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSPromptsColl

TWSPromptNum

This parameter displays the number of the prompt in the text parameter.

Detailed Description

This consumer parameter, set by the TWSPromptsColl collector, monitors any prompts that match thedefined prompts filter and sets the value to be the number of the prompt.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Text

Unit Not applicable

Page 89: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

89Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSPromptsColl

TWSPromptsColl

The TWSPromptsColl collector collects information for the TWS_PROMPTS Knowledge Moduleconsumer parameters.

Detailed Description

This collector sets consumer parameters in the TWS_PROMPTS application class. The TWSPromptsCollcollector collects information regarding the status of prompts that match the prompts filter.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Not applicable.

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Page 90: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

90Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Icon None

Unit Not applicable

Output Range Not applicable

Poll Time 10 minutes

Status Active

Variable Name Not applicable

Parameter Type Collector

Value Set By Not applicable

TWSPromptStatus

This parameter monitors the status of the prompt.

Detailed Description

This consumer parameter, set by the TWSPromptsColl collector, monitors any prompts that match thedefined prompts filter and sets the value to be the current status of the prompt (INACT, ASKED, YES,and NO).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 3 Alarm

Alarm 1 Threshold 3 – 3 Warn

Alarm 2 Threshold none set by default

Page 91: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

91Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit 0=INACT,1=NO,2=YES,3=ASKED

Output Range

Range: 0 – 3

Warning: 3 – 3

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSPromptsColl

TWSPromptText

This parameter displays the prompt message that requires a user response.

Detailed Description

This consumer parameter, set by the TWSPromptsColl collector, monitors any prompts that match thedefined prompts filter and sets the value to be the text details of the prompt.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 92: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

92Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Text

Unit Not applicable

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSPromptsColl

TWSREADYJobs

This parameter displays the number of jobs that are in the READY state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the READY state. The job is ready to launch, all of the dependencies have been resolved.

Page 93: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

93Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 94: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

94Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWSREADYScheds

This parameter displays the number of schedules that are in the READY state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the READY state. All dependencies for the schedule have been resolved and isready to launch.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Page 95: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

95Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Value Set By TWSSchedulesColl

TWSSCHEDJobs

This parameter displays the number of jobs that are in the SCHED state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the SCHED state. The job’s at time has not arrived.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Page 96: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

96Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSSchedulesColl

The TWSSchedulesColl collector collects information for the TWS_SCHEDULES, TWS_JOBS, andTWS_SUMMARY Knowledge Module consumer parameters.

Detailed Description

This collector sets consumer parameters in the TWS_SCHEDULES and TWS_JOBS application classes.TWSSchedulesColl collects information regarding the status of all jobs and schedules in Tivoli™Workload Scheduler. It is one of the primary collectors of the Knowledge Module, providing detailedinformation about jobs and schedules that match the filter requirements set by the PATROLAdministrator. The status of each job and schedule is displayed with an application icon(TWS_JOBS_STATUS and TWS_SCHEDULES_STATUS) representing the current state visually.Important information such as the status of each job and schedule is set. Summary information for alljobs and schedules and for selected schedules is also displayed using the parameters in the TWS_SUMMARY application class.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Not applicable.

Default Values

Default Value

Command Type PSL

Page 97: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

97Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon None

Unit Not applicable

Output Range Not applicable

Poll Time 10 minutes

Status Active

Variable Name Not applicable

Parameter Type Collector

Value Set By Not applicable

TWSSchedulesDelayTime

This parameter monitors the delay time of the schedule.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the delay time of theschedule start. This is derived from the estimated start time and the actual start time of the schedule.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Page 98: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

98Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit Minutes (-1 = Not Executed; -2 = Unknown)

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSSchedulesElapsedTime

This parameter monitors the delay time of the schedule.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the elapsed time of theschedule since the actual start time.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 99: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

99Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit Minutes (-1 = Not Executed; -2 = Unknown)

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSSchedulesStatus

This parameter monitors the current state that the current schedule is in.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the status of the currentschedule. The valid states are as follows: 0=ALARM CLEARED, 1=ADD, 2=HOLD, 3=READY,4=EXEC, 5=SUCC, 6=CANCL, 7=JOB FAIL, 8=STUCK, 9=ABEND. The parameter will go into awarning, if the schedule is in the JOB FAIL state. JOB FAIL is not an internal Maestro state, but a specialstate within the KM, for when a job within a schedule fails, but the recovery actions for the job are suchthat the schedule has a SUCC state in Maestro. The parameter will alarm if the schedule is in theSTUCK or ABEND state.

Page 100: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

100Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 9 Alarm

Alarm 1 Threshold 7 – 7 Warn

Alarm 2 Threshold 8 – 9 Alarm

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit 0=ALARM CLEARED, 1=ADD, 2=HOLD, 3=READY, 4=EXEC, 5=SUCC,6=CANCL, 7=JOB FAIL, 8=STUCK, 9=ABEND

Output Range

Range: 0 – 9

Warning: 7 – 7

Alarm: 8 – 9

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 101: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

101Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWSSTUCKScheds

This parameter displays the number of schedules that are in the STUCK state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the STUCK state. The schedule’s execution has been interrupted. No jobs will belaunched without operator intervention.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Page 102: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

102Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Value Set By TWSSchedulesColl

TWSSUCCJobs

This parameter displays the number of jobs that are in the SUCC state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the SUCC state. The job has completed with a zero exit code.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Page 103: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

103Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSSUCCPJobs

This parameter displays the number of jobs that are in the SUCCP state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the SUCCP state. SUCCP confirmation received, but the job has not completed.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Page 104: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

104Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSSUCCScheds

This parameter displays the number of schedules that are in the SUCC state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the SUCC state. The schedule has completed successfully.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Page 105: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

105Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSSUSPJobs

This parameter displays the number of jobs that are in the SUSP state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the SUSP state. The job has been suspended by a breakjob command (MPE only).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Page 106: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

106Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSWAITDJobs

This parameter displays the number of jobs that are in the WAITD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the WAITD state. The job is in the WAIT state and is deferred (MPE only).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Page 107: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

107Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWSWAITJobs

This parameter displays the number of jobs that are in the WAIT state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the WAIT state. The job is being moved to READY (X-agent jobs and MPE only).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 108: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

108Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Sort by Application Class

MAESTRO

The TWSCpuColl collector collects information for the TWS_CPU Knowledge Module consumerparameters.

Detailed Description

This collector sets consumer parameters (TWSLinkStatus) in the TWS_CPU application class. TheTWSCpuColl collector collects information regarding the status of each defined CPU within Tivoli™Workload Scheduler.

Page 109: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

109Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Not applicable.

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon None

Unit Not applicable

Output Range Not applicable

Poll Time 10 minutes

Status Active

Variable Name Not applicable

Parameter Type Collector

Value Set By Not applicable

The TWSProcessColl collector collects information for the TWS_PROCESS Knowledge Moduleconsumer parameters.

Detailed Description

This collector sets consumer parameter (TWSProcessStatus) in the TWS_PROCESS application class.The TWSProcessColl collector collects information regarding the status of the four key Tivoli™ WorkloadScheduler processes (netman, mailman, jobman, and batchman).

Page 110: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

110Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Not applicable.

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon None

Unit Not applicable

Output Range Not applicable

Poll Time 10 minutes

Status Active

Variable Name Not applicable

Parameter Type Collector

Value Set By Not applicable

The TWSPromptsColl collector collects information for the TWS_PROMPTS Knowledge Moduleconsumer parameters.

Detailed Description

This collector sets consumer parameters in the TWS_PROMPTS application class. The TWSPromptsCollcollector collects information regarding the status of prompts that match the prompts filter.

Page 111: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

111Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Not applicable.

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon None

Unit Not applicable

Output Range Not applicable

Poll Time 10 minutes

Status Active

Variable Name Not applicable

Parameter Type Collector

Value Set By Not applicable

The TWSSchedulesColl collector collects information for the TWS_SCHEDULES, TWS_JOBS, andTWS_SUMMARY Knowledge Module consumer parameters.

Detailed Description

This collector sets consumer parameters in the TWS_SCHEDULES and TWS_JOBS application classes.TWSSchedulesColl collects information regarding the status of all jobs and schedules in Tivoli™Workload Scheduler. It is one of the primary collectors of the Knowledge Module, providing detailedinformation about jobs and schedules that match the filter requirements set by the PATROL

Page 112: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

112Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Administrator. The status of each job and schedule is displayed with an application icon(TWS_JOBS_STATUS and TWS_SCHEDULES_STATUS) representing the current state visually.Important information such as the status of each job and schedule is set. Summary information for alljobs and schedules and for selected schedules is also displayed using the parameters in the TWS_SUMMARY application class.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Not applicable.

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon None

Unit Not applicable

Output Range Not applicable

Poll Time 10 minutes

Status Active

Variable Name Not applicable

Parameter Type Collector

Value Set By Not applicable

Page 113: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

113Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWS_CPU

This parameter monitors the link status of the CPU with the Master CPU.

Detailed Description

This consumer parameter, set by the TWSCpuColl collector, displays the link status of the CPU with theMaster machine.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 2 Alarm

Alarm 1 Threshold 0 – 0 Alarm

Alarm 2 Threshold 1 – 1 Alarm (n=2)

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit 2=LINKED, 1=JNEXTDAY RUNNING, 0=UNLINKED

Output Range

Range: 0 - 2

Warning: Undefined

Alarm: 0 – 0, 1 – 1

Poll Time Undefined

Status Active

Page 114: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

114Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSCpuColl

TWS_PROCESS

This parameter monitors the status of the key Tivoli Workload Scheduler processes.

Detailed Description

This consumer parameter, set by the TWSProcessColl collector, monitors the status of key TivoliWorkload Scheduler processes (netman, mailman, jobman, and batchman).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 2 Alarm

Alarm 1 Threshold 0 – 0 Alarm

Alarm 2 Threshold 1 – 1 Alarm (n=2)

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Page 115: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

115Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Unit 2 = yes, 1=Jnextday running, 0 = no

Output Range

Range: 0 - 2

Warning: Undefined

Alarm: 0 – 0, 1 – 1

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSProcessColl

TWS_PROMPTS

This parameter displays the full prompts message details, including message number, schedule/job thatthe prompt applies to, and the text message of the prompt.

Detailed Description

This consumer parameter, set by the TWSPromptsColl collector, monitors any prompts that match thedefined prompts filter and sets the value to be the full text details of the prompt.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Page 116: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

116Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Text

Unit Not applicable

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSPromptsColl

This parameter displays the number of the prompt in the text parameter.

Detailed Description

This consumer parameter, set by the TWSPromptsColl collector, monitors any prompts that match thedefined prompts filter and sets the value to be the number of the prompt.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Page 117: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

117Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Text

Unit Not applicable

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSPromptsColl

This parameter monitors the status of the prompt.

Detailed Description

This consumer parameter, set by the TWSPromptsColl collector, monitors any prompts that match thedefined prompts filter and sets the value to be the current status of the prompt (INACT, ASKED, YES,and NO).

Default Action Taken by PATROL

Not applicable.

Page 118: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

118Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 3 Alarm

Alarm 1 Threshold 3 – 3 Warn

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit 0=INACT,1=NO,2=YES,3=ASKED

Output Range

Range: 0 – 3

Warning: 3 – 3

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSPromptsColl

This parameter displays the prompt message that requires a user response.

Detailed Description

This consumer parameter, set by the TWSPromptsColl collector, monitors any prompts that match thedefined prompts filter and sets the value to be the text details of the prompt.

Page 119: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

119Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Text

Unit Not applicable

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSPromptsColl

Page 120: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

120Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWS_SUMMARY

This parameter displays the number of jobs that are in the ABEND state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the ABEND state. The job terminated with a non-zero exit code.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Page 121: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

121Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of schedules that are in the ABEND state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the ABEND state. The schedule terminated unsuccessfully.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Range: Undefined

Page 122: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

122Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the ABENP state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the ABENP state. ABEND confirmation received, but the job has not completed.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Page 123: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

123Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the ADD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the ADD state. The job is being submitted.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Page 124: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

124Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of schedules that are in the ADD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the ADD state. The schedule has just been submitted.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Page 125: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

125Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the CANCL state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the CANCL state. The job has been canceled.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 126: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

126Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of schedules that are in the CANCL state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the CANCL state. The schedule has been canceled.

Default Action Taken by PATROL

Not applicable.

Page 127: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

127Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the DONE state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the DONE state. The job has completed in an unknown state (MPE only).

Page 128: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

128Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 129: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

129Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

This parameter displays the number of jobs that are in the ERROR state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the ERROR state. For an internetwork dependency , an error occured while checking for theremote status.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 130: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

130Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

This parameter displays the number of jobs that are in the EXEC state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the EXEC state. The job is currently executing.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Page 131: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

131Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Value Set By TWSSchedulesColl

This parameter displays the number of schedules that are in the EXEC state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the EXEC state. The schedule is currently executing.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Page 132: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

132Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the EXTRN state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the EXTRN state. For an internetwork dependency, unknown status. An error occured, arerun action was just performed on the EXTERNAL job, or the remote job or schedule does not exist.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Page 133: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

133Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the FAIL state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the FAIL state. Unable to launch the job. This is typically if the user account does not exist,the script, or command, does not exist, the jobmanrc file cannot be run, the stdlist file could not beopened, or could not login as the user and change to the user’s home directory.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Page 134: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

134Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the FENCE state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the FENCE state.The job’s priority is below the fence of the CPU.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Page 135: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

135Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the HOLD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the HOLD state. The job is awaiting dependency resolution.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Page 136: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

136Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of schedules that are in the HOLD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the HOLD state. The schedule is awaiting dependency resolution.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 137: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

137Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the INTRO state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the INTRO state. The job has been introduced for launching by the system.

Default Action Taken by PATROL

Not applicable.

Page 138: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

138Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the PEND state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the PEND state. The job has completed and is awaiting confirmation of the exit state by theoperator (state to be set is either SUCC or ABEND).

Page 139: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

139Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 140: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

140Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

This parameter displays the number of jobs that are in the READY state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the READY state. The job is ready to launch, all of the dependencies have been resolved.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 141: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

141Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

This parameter displays the number of schedules that are in the READY state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the READY state. All dependencies for the schedule have been resolved and isready to launch.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Page 142: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

142Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the SCHED state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the SCHED state. The job’s at time has not arrived.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Page 143: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

143Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of schedules that are in the STUCK state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the STUCK state. The schedule’s execution has been interrupted. No jobs will belaunched without operator intervention.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Page 144: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

144Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the SUCC state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the SUCC state. The job has completed with a zero exit code.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Page 145: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

145Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the SUCCP state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the SUCCP state. SUCCP confirmation received, but the job has not completed.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Page 146: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

146Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of schedules that are in the SUCC state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the SUCC state. The schedule has completed successfully.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Page 147: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

147Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the SUSP state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the SUSP state. The job has been suspended by a breakjob command (MPE only).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 148: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

148Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the WAITD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the WAITD state. The job is in the WAIT state and is deferred (MPE only).

Default Action Taken by PATROL

Not applicable.

Page 149: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

149Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the WAIT state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the WAIT state. The job is being moved to READY (X-agent jobs and MPE only).

Page 150: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

150Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 151: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

151Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWS_SCHEDULES

This parameter monitors the delay time of the schedule.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the delay time of theschedule start. This is derived from the estimated start time and the actual start time of the schedule.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit Minutes (-1 = Not Executed; -2 = Unknown)

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Page 152: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

152Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter monitors the delay time of the schedule.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the elapsed time of theschedule since the actual start time.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit Minutes (-1 = Not Executed; -2 = Unknown)

Output Range Range: Undefined

Page 153: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

153Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter monitors the current state that the current schedule is in.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the status of the currentschedule. The valid states are as follows: 0=ALARM CLEARED, 1=ADD, 2=HOLD, 3=READY,4=EXEC, 5=SUCC, 6=CANCL, 7=JOB FAIL, 8=STUCK, 9=ABEND. The parameter will go into awarning, if the schedule is in the JOB FAIL state. JOB FAIL is not an internal Maestro state, but a specialstate within the KM, for when a job within a schedule fails, but the recovery actions for the job are suchthat the schedule has a SUCC state in Maestro. The parameter will alarm if the schedule is in theSTUCK or ABEND state.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 9 Alarm

Alarm 1 Threshold 7 – 7 Warn

Alarm 2 Threshold 8 – 9 Alarm

Page 154: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

154Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit 0=ALARM CLEARED, 1=ADD, 2=HOLD, 3=READY, 4=EXEC, 5=SUCC,6=CANCL, 7=JOB FAIL, 8=STUCK, 9=ABEND

Output Range

Range: 0 – 9

Warning: 7 – 7

Alarm: 8 – 9

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

TWS_JOBS

This parameter monitors the delay time of the job.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the delay time of the jobstart. This is derived from the estimated start time and the actual start time of the job.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 155: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

155Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit Minutes (-1 = Not Executed; -2 = Unknown)

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter monitors the delay time of the job.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the elased time of the jobsince the actual start time.

Default Action Taken by PATROL

Not applicable.

Page 156: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

156Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit Minutes (-1 = Not Executed; -2 = Unknown)

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter monitors the status of the current job and displays the current state that the job is in.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the status of the currentjob. The valid states are as follows: 0=ALARM CLEARED, 1=ADD, 2=INTRO, 3=READY, 4=EXEC,

Page 157: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

157Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

5=SUCC, 6=SUCCP, 7=SUSP, 8=WAIT, 9=WAITD, 10=FENCE, 11=HOLD, 12=PEND, 13=SCHED,14=CANCL, 15=ABEND, 16=ABENP, 17=DONE, 18=ERROR, 19=EXTRN, 20=FAIL. Theparameter will alarm if the schedule is in the ABEND through to FAIL states.

When a Job failure is detected, a detail event will be triggered. This event reports the CPU, Schedule,Job, Job State & Job Number as follows:

TWS job is in ALARM status (CPU: <OTLAIX01>; Schedule: <CF11318AAAAAAAAA>; Job: <JNEXTDAY>; Job State: <ABEND>; Job Number: <#J31480>)

Default Action Taken by PATROLNot applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 20 Alarm

Alarm 1 Threshold 15 – 20 Alarm

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit (0-14 = Acceptable, 15-20 = Alert Event)

Output Range

Range: 0 – 20

Warning: Undefined

Alarm: 15 – 20

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 158: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

158Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Sort by Type

Collector

The TWSCpuColl collector collects information for the TWS_CPU Knowledge Module consumerparameters.

Detailed Description

This collector sets consumer parameters (TWSLinkStatus) in the TWS_CPU application class. TheTWSCpuColl collector collects information regarding the status of each defined CPU within Tivoli™Workload Scheduler.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Not applicable.

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon None

Unit Not applicable

Output Range Not applicable

Poll Time 10 minutes

Status Active

Page 159: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

159Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Variable Name Not applicable

Parameter Type Collector

Value Set By Not applicable

The TWSProcessColl collector collects information for the TWS_PROCESS Knowledge Moduleconsumer parameters.

Detailed Description

This collector sets consumer parameter (TWSProcessStatus) in the TWS_PROCESS application class.The TWSProcessColl collector collects information regarding the status of the four key Tivoli™ WorkloadScheduler processes (netman, mailman, jobman, and batchman).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Not applicable.

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon None

Unit Not applicable

Output Range Not applicable

Poll Time 10 minutes

Status Active

Page 160: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

160Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Variable Name Not applicable

Parameter Type Collector

Value Set By Not applicable

The TWSPromptsColl collector collects information for the TWS_PROMPTS Knowledge Moduleconsumer parameters.

Detailed Description

This collector sets consumer parameters in the TWS_PROMPTS application class. The TWSPromptsCollcollector collects information regarding the status of prompts that match the prompts filter.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Not applicable.

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon None

Unit Not applicable

Output Range Not applicable

Poll Time 10 minutes

Status Active

Variable Name Not applicable

Page 161: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

161Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Parameter Type Collector

Value Set By Not applicable

The TWSSchedulesColl collector collects information for the TWS_SCHEDULES, TWS_JOBS, andTWS_SUMMARY Knowledge Module consumer parameters.

Detailed Description

This collector sets consumer parameters in the TWS_SCHEDULES and TWS_JOBS application classes.TWSSchedulesColl collects information regarding the status of all jobs and schedules in Tivoli™Workload Scheduler. It is one of the primary collectors of the Knowledge Module, providing detailedinformation about jobs and schedules that match the filter requirements set by the PATROLAdministrator. The status of each job and schedule is displayed with an application icon(TWS_JOBS_STATUS and TWS_SCHEDULES_STATUS) representing the current state visually.Important information such as the status of each job and schedule is set. Summary information for alljobs and schedules and for selected schedules is also displayed using the parameters in the TWS_SUMMARY application class.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Not applicable.

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon None

Unit Not applicable

Page 162: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

162Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Output Range Not applicable

Poll Time 10 minutes

Status Active

Variable Name Not applicable

Parameter Type Collector

Value Set By Not applicable

Consumer

This parameter displays the number of jobs that are in the ABEND state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the ABEND state. The job terminated with a non-zero exit code.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Page 163: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

163Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of schedules that are in the ABEND state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the ABEND state. The schedule terminated unsuccessfully.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Page 164: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

164Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the ABENP state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the ABENP state. ABEND confirmation received, but the job has not completed.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Page 165: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

165Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the ADD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the ADD state. The job is being submitted.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 166: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

166Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of schedules that are in the ADD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the ADD state. The schedule has just been submitted.

Default Action Taken by PATROL

Not applicable.

Page 167: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

167Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the CANCL state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the CANCL state. The job has been canceled.

Page 168: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

168Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 169: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

169Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

This parameter displays the number of schedules that are in the CANCL state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the CANCL state. The schedule has been canceled.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Page 170: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

170Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the DONE state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the DONE state. The job has completed in an unknown state (MPE only).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Page 171: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

171Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the ERROR state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the ERROR state. For an internetwork dependency , an error occured while checking for theremote status.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Page 172: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

172Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the EXEC state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the EXEC state. The job is currently executing.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Page 173: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

173Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of schedules that are in the EXEC state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the EXEC state. The schedule is currently executing.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Page 174: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

174Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the EXTRN state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the EXTRN state. For an internetwork dependency, unknown status. An error occured, arerun action was just performed on the EXTERNAL job, or the remote job or schedule does not exist.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Page 175: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

175Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the FAIL state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the FAIL state. Unable to launch the job. This is typically if the user account does not exist,the script, or command, does not exist, the jobmanrc file cannot be run, the stdlist file could not beopened, or could not login as the user and change to the user’s home directory.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 176: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

176Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the FENCE state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the FENCE state.The job’s priority is below the fence of the CPU.

Default Action Taken by PATROL

Not applicable.

Page 177: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

177Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the HOLD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the HOLD state. The job is awaiting dependency resolution.

Page 178: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

178Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 179: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

179Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

This parameter displays the number of schedules that are in the HOLD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the HOLD state. The schedule is awaiting dependency resolution.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 180: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

180Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

This parameter displays the number of jobs that are in the INTRO state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the INTRO state. The job has been introduced for launching by the system.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Page 181: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

181Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Value Set By TWSSchedulesColl

This parameter monitors the delay time of the job.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the delay time of the jobstart. This is derived from the estimated start time and the actual start time of the job.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit Minutes (-1 = Not Executed; -2 = Unknown)

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Page 182: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

182Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter monitors the delay time of the job.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the elased time of the jobsince the actual start time.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Page 183: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

183Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Unit Minutes (-1 = Not Executed; -2 = Unknown)

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter monitors the status of the current job and displays the current state that the job is in.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the status of the currentjob. The valid states are as follows: 0=ALARM CLEARED, 1=ADD, 2=INTRO, 3=READY, 4=EXEC,5=SUCC, 6=SUCCP, 7=SUSP, 8=WAIT, 9=WAITD, 10=FENCE, 11=HOLD, 12=PEND, 13=SCHED,14=CANCL, 15=ABEND, 16=ABENP, 17=DONE, 18=ERROR, 19=EXTRN, 20=FAIL. Theparameter will alarm if the schedule is in the ABEND through to FAIL states.

When a Job failure is detected, a detail event will be triggered. This event reports the CPU, Schedule,Job, Job State & Job Number as follows:

TWS job is in ALARM status (CPU: <OTLAIX01>; Schedule: <CF11318AAAAAAAAA>; Job: <JNEXTDAY>; Job State: <ABEND>; Job Number: <#J31480>)

Default Action Taken by PATROLNot applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 20 Alarm

Page 184: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

184Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Alarm 1 Threshold 15 – 20 Alarm

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit (0-14 = Acceptable, 15-20 = Alert Event)

Output Range

Range: 0 – 20

Warning: Undefined

Alarm: 15 – 20

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter monitors the link status of the CPU with the Master CPU.

Detailed Description

This consumer parameter, set by the TWSCpuColl collector, displays the link status of the CPU with theMaster machine.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 185: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

185Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold 0 – 2 Alarm

Alarm 1 Threshold 0 – 0 Alarm

Alarm 2 Threshold 1 – 1 Alarm (n=2)

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit 2=LINKED, 1=JNEXTDAY RUNNING, 0=UNLINKED

Output Range

Range: 0 - 2

Warning: Undefined

Alarm: 0 – 0, 1 – 1

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSCpuColl

This parameter displays the number of jobs that are in the PEND state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the PEND state. The job has completed and is awaiting confirmation of the exit state by theoperator (state to be set is either SUCC or ABEND).

Page 186: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

186Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 187: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

187Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

This parameter monitors the status of the key Tivoli Workload Scheduler processes.

Detailed Description

This consumer parameter, set by the TWSProcessColl collector, monitors the status of key TivoliWorkload Scheduler processes (netman, mailman, jobman, and batchman).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 2 Alarm

Alarm 1 Threshold 0 – 0 Alarm

Alarm 2 Threshold 1 – 1 Alarm (n=2)

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit 2 = yes, 1=Jnextday running, 0 = no

Output Range

Range: 0 - 2

Warning: Undefined

Alarm: 0 – 0, 1 – 1

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Page 188: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

188Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Value Set By TWSProcessColl

This parameter displays the full prompts message details, including message number, schedule/job thatthe prompt applies to, and the text message of the prompt.

Detailed Description

This consumer parameter, set by the TWSPromptsColl collector, monitors any prompts that match thedefined prompts filter and sets the value to be the full text details of the prompt.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Text

Unit Not applicable

Output Range

Range: Undefined

Warning: Undefined

Page 189: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

189Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSPromptsColl

This parameter displays the number of the prompt in the text parameter.

Detailed Description

This consumer parameter, set by the TWSPromptsColl collector, monitors any prompts that match thedefined prompts filter and sets the value to be the number of the prompt.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Page 190: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

190Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Icon Text

Unit Not applicable

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSPromptsColl

This parameter monitors the status of the prompt.

Detailed Description

This consumer parameter, set by the TWSPromptsColl collector, monitors any prompts that match thedefined prompts filter and sets the value to be the current status of the prompt (INACT, ASKED, YES,and NO).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 3 Alarm

Alarm 1 Threshold 3 – 3 Warn

Alarm 2 Threshold none set by default

Page 191: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

191Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit 0=INACT,1=NO,2=YES,3=ASKED

Output Range

Range: 0 – 3

Warning: 3 – 3

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSPromptsColl

This parameter displays the prompt message that requires a user response.

Detailed Description

This consumer parameter, set by the TWSPromptsColl collector, monitors any prompts that match thedefined prompts filter and sets the value to be the text details of the prompt.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Page 192: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

192Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Text

Unit Not applicable

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSPromptsColl

This parameter displays the number of jobs that are in the READY state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the READY state. The job is ready to launch, all of the dependencies have been resolved.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 193: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

193Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of schedules that are in the READY state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the READY state. All dependencies for the schedule have been resolved and isready to launch.

Default Action Taken by PATROL

Not applicable.

Page 194: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

194Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the SCHED state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the SCHED state. The job’s at time has not arrived.

Page 195: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

195Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 196: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

196Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

This parameter monitors the delay time of the schedule.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the delay time of theschedule start. This is derived from the estimated start time and the actual start time of the schedule.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit Minutes (-1 = Not Executed; -2 = Unknown)

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Page 197: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

197Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Value Set By TWSSchedulesColl

This parameter monitors the delay time of the schedule.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the elapsed time of theschedule since the actual start time.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit Minutes (-1 = Not Executed; -2 = Unknown)

Output Range

Range: Undefined

Warning: Undefined

Alarm: Undefined

Page 198: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

198Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter monitors the current state that the current schedule is in.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the status of the currentschedule. The valid states are as follows: 0=ALARM CLEARED, 1=ADD, 2=HOLD, 3=READY,4=EXEC, 5=SUCC, 6=CANCL, 7=JOB FAIL, 8=STUCK, 9=ABEND. The parameter will go into awarning, if the schedule is in the JOB FAIL state. JOB FAIL is not an internal Maestro state, but a specialstate within the KM, for when a job within a schedule fails, but the recovery actions for the job are suchthat the schedule has a SUCC state in Maestro. The parameter will alarm if the schedule is in theSTUCK or ABEND state.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold 0 – 9 Alarm

Alarm 1 Threshold 7 – 7 Warn

Alarm 2 Threshold 8 – 9 Alarm

Page 199: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

199Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Boolean

Unit 0=ALARM CLEARED, 1=ADD, 2=HOLD, 3=READY, 4=EXEC, 5=SUCC,6=CANCL, 7=JOB FAIL, 8=STUCK, 9=ABEND

Output Range

Range: 0 – 9

Warning: 7 – 7

Alarm: 8 – 9

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of schedules that are in the STUCK state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the STUCK state. The schedule’s execution has been interrupted. No jobs will belaunched without operator intervention.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Page 200: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

200Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the SUCC state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the SUCC state. The job has completed with a zero exit code.

Default Action Taken by PATROL

Not applicable.

Page 201: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

201Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the SUCCP state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the SUCCP state. SUCCP confirmation received, but the job has not completed.

Page 202: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

202Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 203: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

203Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

This parameter displays the number of schedules that are in the SUCC state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number ofschedules that are in the SUCC state. The schedule has completed successfully.

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Page 204: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

204Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

This parameter displays the number of jobs that are in the SUSP state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the SUSP state. The job has been suspended by a breakjob command (MPE only).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Page 205: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

205Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the WAITD state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the WAITD state. The job is in the WAIT state and is deferred (MPE only).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default Value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Poll Time Undefined

Status Active

Page 206: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

206Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

This parameter displays the number of jobs that are in the WAIT state.

Detailed Description

This consumer parameter, set by the TWSSchedulesColl collector, displays the total number of jobsthat are in the WAIT state. The job is being moved to READY (X-agent jobs and MPE only).

Default Action Taken by PATROL

Not applicable.

Recommendations

Not applicable.

Range Thresholds

Alarm Threshold

Border Threshold none set by default

Alarm 1 Threshold none set by default

Alarm 2 Threshold none set by default

Default Values

Default value

Command Type PSL

Platform NT, SOLARIS, HP, RS6000, OSF1, SGI

Icon Graph

Unit #

Output Range Not applicable

Page 207: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

207Reference Guide

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Poll Time Undefined

Status Active

Variable Name Not applicable

Parameter Type Consumer

Value Set By TWSSchedulesColl

Additional Information and Support

Where to Find Additional HelpAdditional help for Tivoli Workload Scheduler can be found in the following locations:

Tivoli Workload Scheduler for UNIX Users Guide

Tivoli Workload Scheduler for Windows NT Users Guide

Tivoli Workload Scheduler Release Notes

Tivoli Workload Scheduler Installation Guide

Tivoli Workload Scheduler UNIX Demonstration Guide

Tivoli Workload Scheduler Demonstration Guide Windows NT

http://www.support.tivoli.com

Additional help for Tivoli Workload Scheduler KM for PATROL can be found in the following location: http://www.sentrysoftware.com

Page 208: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically
Page 209: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Index 209

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Index

- A -Administering

TWS KM 39Administration Utilites

Launch 43Application Classes

MAESTRO 47

TWS_CPU 47

TWS_CPU_CONT 47

TWS_JOBS 49

TWS_JOBS_CONT 48

TWS_JOBS_STATUS 49

TWS_PROCESS 47

TWS_PROCESS_CONT 47

TWS_PROMPTS 48

TWS_PROMPTS_CONT 47

TWS_PROMPTS_CPU 47

TWS_SCHEDULES 48

TWS_SCHEDULES_CONT 48

TWS_SCHEDULES_CPU 48

TWS_SCHEDULES_STATUS 48

TWS_SUMMARY 48AUTO Link 49

- B -BMC

BMC Portal 37

- C -Changes 13

Cluster Mode 42

Configure

KM 38CPU

Availability 14CPU ID 49

Cpu Type 49

Customize

Parameters 41

- D -Date 49

Discovery

Cycle 38Disk

Usage 16Display

Gauge 42

Parameter Graph 42

Text Output 42Domain 49

- F -Features 14

Fence 49

Files 17

ins_ALL_<version>.tar 18

ins_WINDOWS_<version>.exe 18

Setup 17

setup.exe 18

setup.sh 18

uninstall.exe 30

uninstall.sh 30Filter

CPU 44

Job 44

Schedule 44Filters

Job 44

Prompt 44

Schedule 44Full Status 49

- H -Hierarchical

Structure 15Host 49

- I -Improvement 13

Info 49

Info Item 49

Page 210: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Index 210

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

Info Item 49

CPU 50, 51

Elapse 51

End 51

Estimated Elapse 51

Estimated End 51

Estimated Start 51

Job 50, 51

Job Number 51

Job State 51

Jobs # 51

Jobs OK 51

Priority 51

Prompt 50

Prompt Message Number 50

Prompt State 50

Sch Limit 51

Schedule 50, 51

Schedule State 51

Start 51InfoBox

TWS_CPU 49

TWS_JOBS 51

TWS_PROMPTS 50

TWS_SCHEDULES 51

TWS_SERVER 49Install / Un-install 15, 30

BMC Software Installation Utility 18

Log 18

Packages 17

Procedure 18

Setup Files 17Installation Directory 49

Introduction 15

Issues

Fixed 13

- J -Jobman Init 49

Jobman Running 49

Jobman Version 49

- K -KM

Load 36, 37

Preloaded 38, 39

Prepare to Load 36

Unload 38, 39KM Release Date 49

KM Version 49

- L -Launch

Administration Utilities 43License Key 49

License Name 49

Licensed CPU’s 49

Limit 49

Link Definition 49

Link State 49

Link to Master 49

Link Type 49

Load

KM 36, 37

Prepare 36

- M -Maestro Operating System 49

Maestro Platform 49

Maestro Version 49

Mailman Server ID 49

Memory

Usage 16Menu

MAESTRO 52

TWS_CPU 55

TWS_CPU_CONT 55

TWS_JOBS 57

TWS_JOBS_CONT 57

TWS_PROMPTS 56

TWS_PROMPTS_CONT 56

TWS_SCHEDULES 56

TWS_SCHEDULES_CONT 56

TWS_SCHEDULES_CPU 56Method 49

Monitoring

CPU Availability 14

Server Availability 14

Page 211: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Index 211

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

- N -NETMAN Process

Start 39New features 13

Node Type 49

- O -Objectives 14

Operating Systems

Linux 17, 18, 30

Unix 17, 18, 30

Windows 17, 18, 30Options

Common services 18

Console Systems role 18

Managed System 18

View Log 18

- P -Parameters

Customize 41

TWSABENDJobs 58, 120, 162

TWSABENDScheds 59, 121, 163

TWSABENPJobs 60, 122, 164

TWSADDJobs 61, 123, 165

TWSADDScheds 63, 124, 166

TWSCANCLJobs 64, 125, 167

TWSCANCLScheds 65, 126, 169

TWSCpuColl 66, 108, 158

TWSDONEJobs 67, 127, 170

TWSERRORJobs 68, 129, 171

TWSEXECJobs 69, 130, 172

TWSEXECScheds 71, 131, 173

TWSEXTRNJobs 72, 132, 174

TWSFAILJobs 73, 133, 175

TWSFENCEJobs 74, 134, 176

TWSHOLDJobs 75, 135, 177

TWSHOLDScheds 76, 136, 179

TWSINTROJobs 77, 137, 180

TWSJobsDelayTime 78, 154, 181

TWSJobsElapsedTime 80, 155, 182

TWSJobsStatus 81, 156, 183

TWSLinkStatus 82, 113, 184

TWSPENDJobs 83, 138, 185

TWSProcessColl 84, 109, 159

TWSProcessStatus 85, 114, 187

TWSPromptFull 87, 115, 188

TWSPromptNum 88, 116, 189

TWSPromptsColl 89, 110, 160

TWSPromptStatus 90, 117, 190

TWSPromptText 91, 118, 191

TWSREADYJobs 92, 140, 192

TWSREADYScheds 94, 141, 193

TWSSCHEDJobs 95, 142, 194

TWSSchedulesColl 96, 111, 161

TWSSchedulesDelayTime 97, 151, 196

TWSSchedulesElapsedTime 98, 152, 197

TWSSchedulesStatus 99, 153, 198

TWSSTUCKScheds 101, 143, 199

TWSSUCCJobs 102, 144, 200

TWSSUCCPJobs 103, 145, 201

TWSSUCCScheds 104, 146, 203

TWSSUSPJobs 105, 147, 204

TWSWAITDJobs 106, 148, 205

TWSWAITJobs 107, 149, 206PATROL

PATROL Agent 16, 38

PATROL Central Console 39

PATROL Console 16, 38PATROL Central 37

PATROL Console 37

Portal 16

Preloaded

KM 38, 39Process

NETMAN 39

Start 39Process Tree

Stop 40Processes

Stop 41Production Processes

Stop 41

- Q -Query

CPU 44

Job 44

Schedule 44

Page 212: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Index 212

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

- R -Release Notes 13

Reporting 44

Reports

Job Details Listing (rep1) 44

Job Histogram (rep8) 44

Job History Listing (rep7) 44

List Symphony Log Files 44

Planned Prod Schedule (rep11) 44

Prompt Messages Listing (rep2) 44

Resource Listing (rep4b) 44

Show All Files 44

Show All Jobs 44

Show All Prompts 44

Show All Resources 44

Show All Schedules 44

User Calendar Listing (rep3) 44

User Parameters Listing (rep4a) 44Requirements

Disk usage 16

Memory usage 16

Security 16

System 16Run 49

- S -Security

Requirements 16Serial Number 49

Server

Availability 14States

abend 51

abenp 51

add 51

cancl 51

done 51

error 51

exec 51

extrn 51

fail 51

fence 51

hold 51

intro 51

pend 51

ready 51

sched 51

stuck 51

succ 51

succp 51

susp 51

wait 51

waitd 51Stop

Process Tree 40

Production Processes 41Structure

Hierarchy 15System

Requirements 16

- T -TCP Port Number 49

Time 49

Time Zone 49

Tivoli Workload Scheduler 16

Tivoli Workload Scheduler Database

Validate 45TWS_CPU

InfoBox 49

Menu 55TWS_CPU_CONT

Menu 55TWS_JOBS

InfoBox 51

Menu 57TWS_JOBS_CONT

Menu 57TWS_PROMPTS

InfoBox 50

Menu 56TWS_PROMPTS_CONT

Menu 56TWS_SCHEDULES

InfoBox 51

Menu 56TWS_SCHEDULES_CONT

Menu 56TWS_SCHEDULES_CPU

Menu 56TWS_SERVER

InfoBox 49

Page 213: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

Index 213

Tivoli Workload Scheduler KM for PATROL

Version 1.5.01

TWSPromptFull

Parameters 87, 115, 188TWSPromptNum

Parameters 88, 116, 189TWSPromptsColl

Parameters 89, 110, 160TWSPromptStatus

Parameters 90, 117, 190TWSPromptText

Parameters 91, 118, 191TWSREADYJobs

Parameters 92, 140, 192TWSREADYScheds

Parameters 94, 141, 193TWSSCHEDJobs

Parameters 95, 142, 194TWSSchedulesColl

Parameters 96, 111, 161TWSSchedulesDelayTime

Parameters 97, 151, 196TWSSchedulesElapsedTime

Parameters 98, 152, 197TWSSchedulesStatus

Parameters 99, 153, 198TWSSTUCKScheds

Parameters 101, 143, 199TWSSUCCJobs

Parameters 102, 144, 200TWSSUCCPJobs

Parameters 103, 145, 201TWSSUCCScheds

Parameters 104, 146, 203TWSSUSPJobs

Parameters 105, 147, 204TWSWAITDJobs

Parameters 106, 148, 205

- U -Unload

KM 38, 39User Name 49

Utilities

Administration 43

Launch 43Utility

COMPOSER 43

CONMAN 43

GCOMPOSER 43

GCONMAN 43

GMAESTRO 43

- V -Validate

Tivoli Workload Scheduler Database 45Versions

Supported 16

- W -What's new 13

Page 214: Tivoli Workload Scheduler KM for PATROL€¦ · What's New Support for IBM/TWS Clusters: The KM will monitor jobs, schedules & prompts through the MASTER cluster node and automatically

About BMC® SoftwareBMC Software, Inc. NYSE:BMC, is a leading provider of enterprise managementsolutions that empower companies to manage their IT infrastructure from abusiness perspective. Delivering Business Service Management, BMC Softwaresolutions span enterprise systems, applications, databases, and servicemanagement. Founded in 1980, BMC Software has offices worldwide and fiscal2004 revenues of more than $1.4 billion. For more information about BMC

Software, visit www.bmc.com.

About Sentry Software™Sentry Software, a strategic Technology Alliance Partner of BMC Software,provides key monitoring solutions specifically designed to expand thecapabilities of BMC Performance Manager, thus enabling up to 100% coverage ofany infrastructure. Sentry Software specializes in single solutions for multi-platform monitoring of hardware, custom applications or any IT component, andblackout windows. Sentry Software products are deployed in 45 countries acrossthe globe and lead the list of BMC Software’s third-party product sales. For more

information about Sentry Software, please visit www.sentrysoftware.net.