The XCFOPTS statement defines run-time options for Tivoli Workload Scheduler for z/OS systems that use services of the cross-system coupling facility (XCF). Specify this statement for a tracker, controller, or standby controller that uses XCF for communication.

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

>>-XCFOPTS--GROUP(-XCF group name-)----------------------------->
 
>--MEMBER(-XCF member name-)------------------------------------>
 
>--+------------------------------+----------------------------><
   |           .-,------------.   |
   |           V              |   |
   '-TAKEOVER(---+-HOSTFAIL-+-+-)-'
                 '-SYSFAIL--'
 

GROUP(XCF group name)

The name of the XCF group that the Tivoli Workload Scheduler for z/OS system should join. This is an alphanumeric name consisting of 1 to 8 characters where the first character is alphabetic.

The name of this XCF group must be different from the one defined in the DSTOPS and FLOPTS groups.

MEMBER(XCF member name)

The XCF member name that identifies the Tivoli Workload Scheduler for z/OS system. This is an alphanumeric name consisting of 1 to 8 characters where the first character is alphabetic.

The member name must be unique within the group. If a Tivoli Workload Scheduler for z/OSsystem tries to join a group with the same name as an existing member, an error message is issued, and Tivoli Workload Scheduler for z/OS ends.

TAKEOVER(HOSTFAIL,SYSFAIL)

The TAKEOVER keyword applies to a Tivoli Workload Scheduler for z/OS system where you specify OPCHOST(STANDBY) on the OPCOPTS statement. It defines the situations when the standby system automatically takes over from the host Tivoli Workload Scheduler for z/OS system if the host fails. If you have not specified TAKEOVER, Tivoli Workload Scheduler for z/OS sends a WTO message to the operator console asking the operator to manually start takeover actions. You can specify either one or both of the takeover conditions.

HOSTFAIL

Automatic takeover occurs when the controller fails.

SYSFAIL

Automatic takeover occurs when the system that the Tivoli Workload Scheduler for z/OS controller is running on fails.

 XCFOPTS MEMBER(GRP1STBY)             1 
         GROUP(XCFGRP1)               2 
         TAKEOVER(HOSTFAIL,SYSFAIL)   3 

In this example of an XCFOPTS statement:

 1 

A standby controller has a member name of GRP1STBY.

 2 

GRP1STBY is a member of the XCF group XCFGRP1.

 3 

The standby controller automatically attempts to take over the functions of the controller if the controller fails, or if the z/OS system that the controller is running on fails.