User Documentation June 2013 Tivoli Workload Scheduler KM for PATROL Version 1.5.01
User Documentation June 2013
Tivoli Workload Scheduler KMfor PATROLVersion 1.5.01
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
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
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
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
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
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
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
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
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
Tivoli Workload SchedulerKM for PATROL
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.
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:
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.
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
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
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).
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
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
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
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
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
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.
25Installation Guide
Tivoli Workload Scheduler KM for PATROL
Version 1.5.01
Installation Wizard - Step 7: Selecting Roles
Select as many options as required.
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
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
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
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.
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
31Installation Guide
Tivoli Workload Scheduler KM for PATROL
Version 1.5.01
On UNIX, launch uninstall.sh
Un-install Wizard — Welcom e Step
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
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
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
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
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
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.
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.
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.:
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:
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.
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:
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.
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.
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
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
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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
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
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.
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.
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
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
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
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
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.
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
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.
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.
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
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
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
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
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
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
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.
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.
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.
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
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
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
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
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.
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.
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.
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
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
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
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
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
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.
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.
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
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
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
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
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
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.
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.
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
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
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
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
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
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
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
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.
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.
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).
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.
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
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
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
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
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
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
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.
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.
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
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
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
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
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
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
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.
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.
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).
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
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
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
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
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 #
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
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
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
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.
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.
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).
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
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
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
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
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
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
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
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
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.
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.
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).
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
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
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
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
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.
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.
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,
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
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
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
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
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
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
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
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
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.
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.
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.
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
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
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
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
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
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
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
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.
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.
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.
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
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
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
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
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
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
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.
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).
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
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
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
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
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
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
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.
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.
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.
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
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
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
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
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.
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.
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.
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
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
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
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
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
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
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
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
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
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
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
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.