TRROPTS

Purpose

The TRROPTS statement defines routing options from a z/OS tracker that is connected to the controller through shared DASD, SNA (VTAM®), XCF, or TCP/IP. Include TRROPTS in the statements for each z/OS tracker in your Tivoli Workload Scheduler for z/OS configuration, except where the tracker and controller are started in the same address space. Use TRROPTS where OPCOPTS OPCHOST(NO) is specified.

TRROPTS is defined in the member of the EQQPARM library as specified by the PARM parameter on the JCL EXEC statement.

Format

Read syntax diagramSkip visual syntax diagram>>-TRROPTS--HOSTCON(-+-DASD-+-)--------------------------------->
                     +-SNA--+
                     +-TCP--+
                     '-XCF--'
 
>--+-----------------------------+------------------------------>
   |          .-,------------.   |
   |          V              |   |
   '-SNAHOST(---VTAM LU name-+-)-'
 
>--+-------------------------------+---------------------------->
   '-TCPHOSTNAME(-+-hostname---+-)-'
                  '-IP address-'
 
>--+---------------------------------+-------------------------><
   |                .-424--------.   |
   '-TCPPORTNUMBER(-+-TCPIP port-+-)-'
 

Parameters

HOSTCON(DASD|SNA|TCP|XCF)
The HOSTCON keyword identifies the connection that is used when transmitting events to the controller.

If you specify HOSTCON(DASD), you cannot specify EWSEQNO on the EWTROPTS statement.

If you specify HOSTCON(SNA), the SNAHOST keyword must contain the NCF LU name of the controller. This tracker must also have the NCFAPPL keyword specified in the OPCOPTS statement.

If you specify HOSTCON(XCF), the XCFOPTS statement must also be present.

If you specify HOSTCON(TCP), set also TCPHOSTNAME to identify the remote controller.

SNAHOST(VTAM LU name,...,VTAM LU name)
The SNAHOST keyword is required for trackers connected to the controller through an SNA link. This keyword defines the VTAM LU name of the controller and any standby controllers. In a hot standby configuration, you can specify several LU names. At initialization, the tracker logs on to the LU at the SNAHOST that becomes active first. That is, the tracker attempts to communicate with the first IBM Tivoli Workload Scheduler for z/OS started task that is identified as the controller. If you specify the SNAHOST keyword, the HOSTCON keyword must be SNA.
TCPHOSTNAME (hostname|IP address)
Specifies the host name or IP address of the remote controller. Valid values are fully-qualified names up to 52 characters. This parameter is required.
TCPPORTNUMBER (value|424)
Defines the TCP/IP port number used to communicate with the remote controller. Valid values are from 0 to 65535. If not specified, the default value of 424 is used.

Examples

 TRROPTS HOSTCON(SNA)        1 
         SNAHOST(NCFAPPL1)   2 

In this example of a TRROPTS statement:

 1 
The tracker is connected to the controller through a VTAM link.
 2 
The name of the NCF LU used by the controller is NCFAPPL1.