XCFOPTS

Purpose

The XCFOPTS statement defines run-time options for IBM® Z Workload Scheduler 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.

Format


1  XCFOPTS  GROUP (  XCF group name )  MEMBER (  XCF member name )?  TAKEOVER (
2.1+ ,
2.1 HOSTFAIL
2.1 SYSFAIL
1 )

Parameters

GROUP(XCF group name)
The name of the XCF group that the IBM® Z Workload Scheduler 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 IBM® Z Workload Scheduler 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 an IBM® Z Workload Scheduler system tries to join a group with the same name as an existing member, an error message is issued, and IBM® Z Workload Scheduler ends.

TAKEOVER(HOSTFAIL,SYSFAIL)
The TAKEOVER keyword applies to an IBM® Z Workload Scheduler system where you specify OPCHOST(STANDBY) on the OPCOPTS statement. It defines the situations when the standby system automatically takes over from the host IBM® Z Workload Scheduler system if the host fails. If you have not specified TAKEOVER, IBM® Z Workload Scheduler 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 IBM® Z Workload Scheduler 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.