IXCH0248E
Structure Strname is too small for full signalling connectivity.

Explanation

CHECK(IBMXCF,XCF_SIG_STR_SIZE) found that the structure does not contain enough list entries to support full signaling connectivity among all active systems in the sysplex.

When a list within the structure is used for a signaling path, the checkowner_or_installation specification requires that there be at least MinimumNumber list entries available for each signaling path in the sysplex. List entries are used to buffer signals for the path. There are only CurrentNumber list entries per path available to XCF in the current signaling structure.

The number of signaling paths in the sysplex is a function of the number of active systems. Each of the NumberSystems active systems can have two paths (PATHIN and PATHOUT) to every other active system for a total of NumberPaths signaling paths. In order for this structure to meet the checkowner_or_installation specification, at least NeededEntries list entries are required. This total includes some list entry "overhead" needed by XCF for non-pathing functions.

Use the Coupling Facility Structure Sizer Tool (CFSizer) to determine the SIZE parameter for XCF signaling structures. The CFSIZER tool is available at http://www.ibm.com/systems/support/z/cfsizer.

In the message text:
StrName
The signaling structure in use by XCF.
In the message explanation:
MinimumNumber
The checkowner_or_installation specification of the minimum number of list entries per signaling path available to each signaling structure.
CurrentNumber
The number of list entries per signaling path available to XCF in this structure.
NumberSystems
The number of systems active in the sysplex.
NumberPaths
The number of signaling paths to connect all systems.
NeededEntries
The minimum number of list entries in the signaling structure needed to meet the checkowner_or_installation specification.

System action

This check is performed against all signaling structures in use by this system and allocated in a coupling facility. The system continues processing.

Operator response

Report this problem to the system programmer.

System programmer response

Run the Coupling Facility Structure Sizer Tool (CFSizer) to determine the SIZE parameter for this XCF signaling structure. Note that CFSizer calculates 20 list entries required for each list, which is why 20 is the default parameter value for this check. If the checkowner_or_installation specification is greater than 20, the CFSizer results will need to scale up accordingly.

Modify the structure in the CFRM policy with the new size value. Activate that CFRM policy.

If XCF does not automatically rebuild the structure as a result of the policy activation, initiate a rebuild of the structure by issuing the command:

  SETXCF START,REBUILD,STRNAME=IXCxxx          

where IXCxxx is the name of the signaling structure.

On successful completion of the rebuild, XCF issues message IXC457I on the system that (re)allocates the structure to indicate the number of lists in the structure, the number of systems that can establish full signaling connectivity through those lists, and the maximum number of signals (list entries) that can be supported by each list at one time.

Verify that the structure is in use by XCF for signaling:

  D XCF,PI,STRNAME=IXCxxx          
  D XCF,PO,STRNAME=IXCxxx          

Problem determination

N/A

Source

Parallel Sysplex® (XCF)

Module

IXCHCSIG

Routing code

See note 35.

Descriptor code

3 is the default set by this check. See note 1.

Reference Documentation

For additional information about configuring signaling services using XCF list structures, see "Planning Signaling Services in a Sysplex" and "Tuning the Signaling Service" in z/OS MVS Setting Up a Sysplex.

z/OS MVS System Commands