IXC582I
STRUCTURE strname ALLOCATED BY alloctype.
PHYSICAL STRUCTURE VERSION: physver1 physver2
STRUCTURE TYPE: strtype
CFNAME: cfname
ALLOCATION SIZE: allocsize u
Start of change[MAX STRUCTURE SIZE: maxsize u]
[MAX STRUCTURE SCM: maxscmsize u]End of change

POLICY SIZE: policysize u
POLICY INITSIZE: policyinitsize u
POLICY MINSIZE: policyminsize u
[Start of changePOLICY SCMMAXSIZE: policyscmsize uEnd of change]
[IXLCONN STRSIZE: ixlconnstrsize u]
ENTRY COUNT: entrycnt
[ELEMENT COUNT: elementcnt]
[EMC COUNT: emccnt]
[LOCKS: lockentries]
Start of change[MAX SCM ENTRY COUNT: emaxscmentrycnt]
[MAX SCM ELEMENT COUNT: emaxscmelementcnt]End of change

[ENTRY:ELEMENT RATIO: entratio : elemratio]
[EMC STORAGE PERCENTAGE: emcstgpct]
text

Explanation

A structure was allocated in a coupling facility with an actual allocation size that may exceed the size specifications requested by the CFRM active policy definitions at the time of structure allocation. The actual allocation size is compared to the policy INITSIZE if specified or the policy size if INITSIZE is not specified. The size discrepancy may result from structure allocation "by counts" which allocates the structure with the desired counts of structure objects (entries, data elements, EMCs), regardless of the resulting structure size. Another example of a size discrepancy results when the IXLCONN STRSIZE specified is greater than the specified policy INITSIZE.

In the message text:
strname
The name of the allocated structure.
alloctype
Method of structure allocation
counts
The structure was allocated by target counts.
size/ratio
The structure was allocated by target structure size and ratios.
physver1
First half of the physical version number of the alocated instance of the structure.
physver2
Second half of the physical version number of the allocated instance of the structure.
strtype
One of the following:
list
The structure is an unserialized list structure.
cache
The structure is a cache structure.
serialized list
The structure is a serialized list structure.
lock
The structure is a lock structure.
cfname
The name of the coupling facility in which the structure has been allocated.
allocsize
The allocated size of the structure.
u
The integer size unit specification. One of the following:
  • K (kilobytes)
  • M (megabytes)
  • G (gigabytes)
  • T (terabytes)
Note: The size unit displayed may be converted to the largest size unit that can be used to represent the size and avoids any rounding. For example, a allocsize of 1048576K may be converted to a allocsize of 1G for the purpose of messages. A allocsize of 120000K will not cause the displayed size to be converted because it is not an even multiple of megabytes, gigabytes, or terabytes.
Start of changemaxsizeEnd of change
Start of changeThe maximum size of the structure as determined at allocation time based on the CFRM policy and environmental factors.End of change
Start of changemaxscmsizeEnd of change
Start of changeThe maximum amount of storage-class memory the structure can use as determined at allocation time based on the CFRM policy and environmental factors.End of change
policysize
The CFRM active policy defined SIZE of the structure.
policyinitsize
The CFRM active policy defined INITSIZE of the structure. If INITSIZE is not specified, this value will be zero.
policyminsize
The CFRM active policy defined MINSIZE of the structure. If not specified, the default value will be displayed. When ALLOWAUTOALT(YES) is specified, MINSIZE defaults to 75% of the INITSIZE value (or the SIZE value if INITSIZE is not specified). Otherwise, MINSIZE defaults to zero.
Start of changepolicyscmmaxsizeEnd of change
Start of changeThe SCMMAXSIZE for the structure as specified or defaulted to in the CFRM active policy. End of change
ixlconnstrsize
The STRSIZE requested by the CF structure exploiter on the IXLCONN macro. If not specified by the exploiter, this value will be zero. This value will also be zero when the structure is being allocated by a system-managed process rather than directly by an exploiter using the IXLCONN macro.
entrycnt
The total count of entries allocated for the structure.
elementcnt
The total count of data elements allocated for the structure. Not displayed when the count is zero.
emccnt
The total count of event monitor controls (EMCs) allocated for the strucutre. Event monitor controls are only present in list structures that support certain types of monitoring. Not displayed when the count is zero.
lockentries
The total number of lock entries. Only displayed for lock or serialized list structures.
Start of changeemaxscmentrycntEnd of change
Start of changeEstimated maximum number of entries that can be stored in the storage-class memory associated with this structure. Only displayed if the structure is allocated with support for storage-class memory.End of change
Start of changeemaxscmelementcntEnd of change
Start of changeEstimated maximum number of elements that can be stored in the storage-class memory associated with this structure. Only displayed if the structure is allocated with support for storage-class memory.End of change
entratio
The entry portion of the entry-to-element ratio. Zero for a structure without entries.
elemratio
The element portion of the entry-to-element ratio. Zero for a structure without data.
emcstgpct
The percentage of structure storage being used for Event Monitor Controls (EMC) objects. Event monitor controls are only present in list structures that support certain types of monitoring. Not displayed when the percentage is zero.
text
One of the following:
ALLOCATION SIZE EXCEEDS CFRM POLICY DEFINITIONS
The structure allocation size exceeds the size indicated by CFRM active policy definitions allowing for rounding up to a multiple of the CF storage increment size. The allocation size is compared to the policy INITSIZE if specified or the policy size if INITSIZE is not specified.
ALLOCATION SIZE IS WITHIN CFRM POLICY DEFINITIONS
The structure allocation size is within the size indicated by CFRM active policy definitions allowing for rounding up to a multiple of the CF storage increment size.The allocation size is compared to the policy INITSIZE if specified or the policy size if INITSIZE is not specified.

System action

System processing continues. The system writes the message to the hardcopy log.

System programmer response

If the allocation size of the structure exceeds CFRM policy definitions, consider whether it is necessary to update the CFRM policy to increase the requested structure size to the actual allocated structure size as indicated by this message.

Start of changeA structure allocated with support for storage-class memory may be allocated with a structure size that exceeds CFRM policy definitions in order to avoid an INVALID TARGET STRUCTURE COUNTS condition. Only system-managed rebuild allocation may be able to avoid that condition. Consider using the CF Sizer tool, available on the Parallel Sysplex website http://www.ibm.com/systems/support/z/cfsizer, for help in determining structure SIZE, INITSIZE, and SCMMAXSIZE attributes.End of change

If the structure has increased in size as a result of rebuilding or duplexing the structure into a CF at a different (higher) CFLEVEL than the one in which the original structure is allocated, and you intend to continue to use the higher CFLEVEL in the future, update the CFRM policy size definitions to be in line with the allocated structure size indicated by this message. Failure to do so might result in the structure being allocated with an inadequate structure size, or possibly not being allocatable at all, when the structure is initially allocated in the future. This might result in system, subsystem, or application outages.

If the structure has increased in size when rebuilding or duplexing the structure into a CF at the same CFLEVEL in which the original structure is allocated, there Start of changemay beEnd of change no need to update the CFRM policy definitions to reflect the larger allocated structure size indicated by this message.

Similarly, when the structure has been allocated larger than the policy INITSIZE value because the structure exploiter has requested a larger IXLCONN STRSIZE value, there is no need to update the CFRM policy definitions to reflect any size-related changes.

Ensure that the increased CF storage allocation for the structure can be accommodated not only within the current CF, but also in any other CF images in which the structure is eligible to be allocated.

Source

Cross System Coupling Facility (SCXCF)

Module

IXCL2ASR, IXCL2ATH

Routing code

10