MONOPTS

Purpose

The MONOPTS statement defines monitoring options needed for IBM Tivoli Workload Scheduler for z/OS to work with IBM® Tivoli® Monitoring. This statement is used by a controller.

The MONOPTS statement defines the information needed to activate an IBM Tivoli Monitoring activity. If this statement is provided, the controller starts the monitoring task used to send events to the Tivoli Enterprise Portal client interface.

MONOPTS is defined in the member of the EQQPARM library as specified by the PARM parameter on the JCL EXEC statement. Defining this statement requires the definition of an OMVS segment for the controller user ID.

Format

Read syntax diagramSkip visual syntax diagram>>-MONOPTS--+---------------------+--+---------------------+---->
            |           .-NO--.   |  '-LOCPORT(-+------+-)-'
            '-BULKDISC(-+-YES-+-)-'             '-port-'
 
>--MONHOSTNAME(-+-hostname---+-)--+---------------------+------><
                '-IP address-'    |          .-7500-.   |
                                  '-MONPORT(-+-port-+-)-'

Parameters

BULKDISC YES|NO)
Describes the bulk discovery policy. Valid values are YES and NO, the default is NO.
NO
IBM Tivoli Workload Scheduler for z/OS does not perform an automatic discovery. A discovery is possible only manually using the TSO command.
YES
A bulk discovery is performed each time a daily planning action is requested. A discovery can also be requested manually.
LOCPORT(port)
This parameter is optional and indicates the port number that the Controller will bind to for the TCP/IP communication with the Universal Agent. This parameter must be specified only if the port number is configured in the metafile, otherwise the Controller can use any available port number.
MONHOSTNAME(hostname|IP address)
Specifies the hostname or the IP address of the remote monitoring application. For the integration with IBM Tivoli Monitoring, this is the hostname of the system where the Tivoli Universal Agent component of IBM Tivoli Monitoring is installed. This parameter is mandatory.
MONPORT(value|7500)
This parameter identifies the port number of the remote monitoring application. This is the port number used by the Tivoli Universal Agent component of IBM Tivoli Monitoring. If not specified, the default value of 7500 will be used. The value specified here must correspond to the value defined on the Tivoli Universal Agent.
Note:
CONNTIMEOUT and LOCHOSTNAME are no more supported. If you specify them, the controller issues a warning message notifying that CONNTIMEOUT and HOSTNAME parameters of the TCPOPTS statement will be used.

Examples

MONOPTS  MONHOSTNAME('9.122.227.72')         1 
         MONPORT(7500)                       2 
         LOCHOSTNAME('9.87.130.44')
         BULKDISC(YES)                       3 
         CONNTIMEOUT(10)

In this example of MONOPTS statement:

 1 
This is the IP address of the Tivoli Universal Agent (remote monitoring application).
 2 
This is the port number of the Tivoli Universal Agent.
 3 
A bulk discovery of the monitored resources will be initiated automatically at every planning action (extend, replan).