MONPOL

Purpose

The MONPOL statement defines the monitoring policy based on which HCL Workload Automation for Z sends monitoring events to IBM® Tivoli® Monitoring. This monitoring is related to operations only. The operations satisfying the specified policy, together with all operations with the EXTERNAL MONITOR job option set to YES, constitute the current set of monitored operations. One or more values can be specified for the MONPOL statement.

This statement is also used to automatically set the EXTERNAL MONITOR job option of an operation to YES, when a specific event occurs.

For detailed information about the EXTERNAL MONITOR job option, see Options that apply to all operations.

Format


1  MONPOL  OPERATION (
2.1 CRITICAL
2.1! ERROR
2.1 LATE
2.1 DURATION
2.1 MANUAL
1 )

Parameters

(OPERATION CRITICAL||ERROR|LATE|DURATION|MANUAL)
Defines the criteria used to select operations to be monitored by IBM® Tivoli® Monitoring.

If you set this parameter to ERROR, LATE, or DURATION, the corresponding operations will be automatically set with the EXTERNAL MONITOR job option to YES.

CRITICAL
The scheduler will monitor operations that are:
  • Eligible for WLM assistance.
  • Included in a critical network.
  • Added to the hot list.
ERROR
All operations that ended in error will be monitored. This is the default value.

For these operations, the EXTERNAL MONITOR job option is automatically set to YES.

LATE
All late operations will be monitored. An operation is considered late if it reaches its latest start time and is not started, complete, or deleted.

For these operations, the EXTERNAL MONITOR job option is automatically set to YES.

DURATION
All operations that run beyond their estimated duration time will be monitored.

For these operations, the EXTERNAL MONITOR job option is automatically set to YES.

MANUAL
Only the operations with EXTERNAL MONITOR job option set to YES, will be selected.

By setting MANUAL, the settings ERROR, LATE, and DURATION are not considered; only CRITICAL is taken into account, if it is set.

Note:
  1. The MONPOL statement is not retroactive. Based on the specified policy, operations will be selected for monitoring only when their next change of status matching the MONPOL criteria occurs. If an operation is in one of the specified states before MONPOL is in effect, it will not be monitored.
  2. When an operation has been promoted to "monitored" for a LATE or DURATION condition, it will continue to be monitored even if the EXTERNAL MONITOR option for the operation is subsequently changed to NO.
MONPOL   OPERATION (CRITICAL        1
                    LATE
                    DURATION)
        
In this example of MONPOL statement:
1
Operations eligible for WLM assistance, included in a critical network, and added to the hot list will be automatically selected for monitoring.

All the late operations and those that run beyond their estimated duration time, will be set with the EXTERNAL MONITOR job option to YES.