QSG Coupling Facility Structures attributes (z/OS systems only)

Use the QSG Coupling Facility Structures attributes to create situations for detecting problems in coupling facility application structures and the administration structure associated with the queue sharing group. Some information is not provided for administration structures, as noted in the descriptions. QSG Coupling Facility Structures is a multiple-instance attribute group. You cannot mix these attributes with attributes of any other multiple-instance group.

The QSG Coupling Facility Structures attributes are available for QSG environment on z/OS systems only.

% Entries Used The list entries used in the coupling facility structure, expressed as a percentage.

% Stor Used The storage used by the coupling facility structure, expressed as a percentage.

Alter Date & Time The date and time the coupling facility structure was last altered; the value is blank for an administration structure. The valid format is the standard 16-character date/time format (CYYMMDDHHMMSSmmm), where the strings have the following meanings:

C
Century (0 for 20th, 1 for 21st)
YY
Year
MM
Month
DD
Day
HH
Hour
MM
Minute
SS
Second
mmm
Millisecond
Automatic Recovery Indicates whether automatic recovery action is taken when a queue manager detects that the structure has failed. Or when a queue manager loses connectivity to the structure and no systems in the sysplex have connectivity to the coupling facility that the structure is allocated in. Possible values are as follows:
  • No = 0 (The structure is not automatically recovered.)
  • Yes = 1 (The structure and associated shared message data sets are automatically recovered.)

CF Struct Name The name of the coupling facility structure. The valid format is an alphanumeric string of up to 12 uppercase characters.

CF Struct Type The type of this coupling facility structure; Admin indicates an Administration structure and Appl indicates an Application structure. Valid values are as follows:

  • None = 0
  • Admin = 1
  • Appl = 2
  • Unknown = 255
Conn Loss Action Indicates the action to be taken when a queue manager loses connectivity to the CF structure. Possible values are as follows:
  • Terminate = 0 (The queue manager terminates when connectivity to CF structures is lost. )
  • Tolerate = 1 (The queue manager tolerates a loss of connectivity to CF structures and does not terminate.)
  • AsQmgr = 2 (The action taken is based on the setting of the queue manager CFCONLOS attribute.)
  • Unknown = 255

Description (Deprecated) Descriptive comment defined for the coupling facility structure; the value is blank for an administration structure. The valid format is an alphanumeric string of up to 64 case-sensitive characters.

Description Descriptive comment defined for the coupling facility structure; the value is blank for an administration structure. The valid format is an alphanumeric string of up to 256 case-sensitive characters.

Expand Dataset Indicates whether the queue manager expands a shared message data set. Possible values are as follows:
  • Default = 0
  • Yes = 1
  • No = 2
  • Unknown = 255

Failure Date & Time The date and time the coupling facility structure last failed. The valid format is the standard 16-character date/time format (CYYMMDDHHMMSSmmm), where the strings have the following meanings:

C
Century (0 for 20th, 1 for 21st)
YY
Year
MM
Month
DD
Day
HH
Hour
MM
Minute
SS
Second
mmm
Millisecond

Max Stor The maximum storage size of the coupling facility structure, in kilobytes (KB). The valid format is an integer.

Max Entries The maximum number of list entries in the coupling facility structure. The valid format is an integer.

Offload Size 1 The size of messages selected to be offloaded when the capacity threshold specified in the Offload Threshold 1 value is reached. All messages exceeding the size specified will be selected to be offloaded. For example, 32K indicates that all messages exceeding 32K will be offloaded.

Offload Size 2 The size of messages selected to be offloaded when the capacity threshold specified in the Offload Threshold 2 value is reached. All messages exceeding the size specified will be selected to be offloaded. For example, 4K indicates that all messages exceeding 4K will be offloaded.

Offload Size 3 The size of messages selected to be offloaded when the capacity threshold specified in the Offload Threshold 3 value is reached. All messages exceeding the size specified will be selected to be offloaded. For example, 0K indicates that all remaining messages will be offloaded.

Offload Threshold 1 The initial threshold for the used capacity of the coupling facility structure. For example, 70% represents that the offload will be triggered when 70% of the coupling facility structure storage is used.

Offload Threshold 2 The secondary threshold for the used capacity of the coupling facility structure. For example, 80% indicates that the offload will be triggered when 80% of the coupling facility structure storage is used.

Offload Threshold 3 The final threshold for the used capacity of the coupling facility structure. For example, 90% represents that the offload will be triggered when 90% of the coupling facility structure storage is used.

Offload Usage The offload method that is being used to offload messages. Possible values are as follows:
  • None = 0
  • SMDS = 1
  • DB2 = 2
  • Both = 3
  • Unknown = 255

Origin Node The IBM MQ Monitoring agent-assigned name of the node on which the data for the queue sharing group originates. This name takes the form qsgname::MQQSG, where qsgname is the name of the queue sharing group. The valid format is an alphanumeric string of up to 128 case-sensitive characters.

QSG Name The name of the queue sharing group. The valid format is an alphanumeric string of up to 4 case-sensitive characters.

Recovery Supported Whether Recovery is supported for this coupling facility structure. The value is No for an administration structure. Valid values are No = 0 and Yes = 1.

Struct Level Indicates the functional level of the coupling facility structure. The valid format is an integer. The value is zero for an administration structure.

Struct Status The status of the coupling facility structure. Valid values are as follows:

  • None = 0,
  • NotFound = 1,
  • Active = 2,
  • Failed = 3,
  • InBackup = 4,
  • InRecover = 5,
  • Unknown = 255

Used Entries The number of list entries used in the coupling facility structure.