Previous Topic: Example: SYSOUT control optionNext Topic: Examples: SYSPLEX control option

Specific Control Options › SYSPLEX—XES and XCF Availability

SYSPLEX—XES and XCF Availability

Valid on z/OS.

Use the XES and XCF SYSPLEX control options to make the capabilities of both XES and XCF available.

XES is the z/OS Coupling Facility service that allows sharing of data across the SYSPLEX. CA Top Secret uses an XES list structure to share file blocks between all connected systems. XES enables CA Top Secret to share data between systems joined to the Coupling Facility sharing the same Security File.

XCF is a message routing facility, used by CA Top Secret to propagate commands issued on one system to all the other connected systems. XCF enables CA Top Secret to send TSS MODIFY commands to other systems in the sysplex joined to the sending‑systems' group. XCF can be active even when XES is not used. This is the case when the CONNECT command only has a group‑name but no structure‑name.

Note: There is no CONNECT parameter. The Coupling Facility is connected implicitly when the SYSPLEX control option is used for the connect process.

This control option uses the Parameter file and O/S or TSS MODIFY command entry methods.

This control option has the following format:

SYSPLEX(connect‑name,group‑name,structure‑name)
        |(DISCONNECT[XES])
        |(TRACE(ON|OFF))
connect‑name

Indicates the connection by which this system is known. A connect‑name can be any alphanumeric combination. If a connect‑name is not specified, CA Top Secret substitutes the SMFID in this field and adds an alpha prefix, “S”, to ensure a valid connect‑name.

Range: Up to 16 bytes

group‑name

Indicates the group to which the system belongs in the sysplex. The group‑name can be any alphanumeric combination. Providing a group name is optional.

Range: Up to eight bytes

structure‑name

Indicates the List structure being used to contain the Security File in the Coupling Facility. The structure‑name has no default and can be alphanumeric combination.

Range: Up to 16 bytes

DISCONNECT

Without specifying any options, informs CA Top Secret to disconnect from both XES and XCF. If you specify:

No re‑connect is attempted until a new structure is allocated in the Coupling Facility by a manual CONNECT command. To determine if a structure was reallocated, use the TSS MODIFY(STATUS(SYSPLEX)) command, or the D XCF,STR z/OS operator command.

An XES connection without an XCF connection is allowed.

TRACE

Activates (ON) or deactivates (OFF) a trace of all calls to the Coupling Facility. There are two messages issued:

Default: SMFID.