CF Clients Attributes

The CF Clients attributes group monitors user connections to coupling facility structures.


Address Space Address space name. Valid format is a simple text string of 1 through 8 characters; for example, JES2.

ASID Hexadecimal address space ID.

CF Name Name of the coupling facility. Valid format is a simple text string from 1 through 8 characters; for example, COUPLER1.

Connection Name Name of the connection between the address space and the CF structure. Valid format is a simple text string of 1 through 16 characters; for example, JES2_SYSA.

Connection Problem Flag Flag indicating whether or not this connection is in a problem state. A Connection Status of FAILEDPERS or FAILING is considered a problem. Valid values are 1 (problem) or 0 (no problem).

Connection Status Status of the current coupling facility connection. Valid values are:

Active

This connection is currently active.

FailedPers

This connection has failed but is being maintained because the connector specified connection disposition of"keep". It is expected that the failed connector will attempt to reconnect.

Failing

The connection is attempting to fail but some connected users of the structure have not yet responded to the fail/disconnect event.

Disconnecting

The user is attempting to disconnect from the structure but some connected users of the structure have not yet responded to the fail/disconnect event.

ConnectedKeep

Connected with CONDISP=KEEP (that is, a persistent connection).

ConnectedRebuild

Connected to both structures during structure rebuild.

Note: You would not normally see any of the following statuses for a structure. They should exist for very brief periods of time. If one of these statuses persists for more than five minutes it would indicate a severe problem with either the structure or the monitoring facility.

RebuildActive

Structure rebuild process is in progress

RebuildStopped

A structure rebuild process has been stopped usually by operator command.

RebuildOldStr

This is the original structure in a rebuild process.

RebuildNewStr

This is the new structure in a rebuild process.

RebuildQuiesce

A structure rebuild has been initiated. Connections need to stop usage of the structure and confirm. This phase will be complete when all connections have issued IXLEERSP for the Rebuild Quiesce event.

RebuildComplete

A structure rebuild is in progress. Connections can connect to new structure. This phase will be complete when all connections have issued IXLREBLD REQUEST=COMPLETE.

RebuildCleanup

A structure rebuild is in progress. Connections have completed their part of the process and final cleanup is in progress. This phase will be complete when all connections have issued IXLEERSP for the Rebuild Cleanup event.

RebuildStartOperator

A rebuild process was started by the operator.

RebuildStartConnector

A rebuild process was started by one of the connecting applications.

RebuildLostOldFacility

A rebuild process was stopped because connectivity was lost to the coupling facility containing the original structure.

RebuildFailed

A rebuild process failed.

RebuildStoppedOperator

A rebuild process was stopped by operator command.

RebuildStoppedConnector

A rebuild process was stopped by one of the connected users.

RebuildLostNewFacility

A rebuild process was stopped because connectivity was lost to the coupling facility containing the new structure.

RebuildOldStrFailed

A rebuild process stopped because the original structure failed.

Managed System A sysplex in your enterprise that is being monitored by OMEGAMON XE on z/OS agents. Valid value is a character string with a maximum length of 32 bytes, in the format <plexname>:MVS:SYSPLEX.

Structure Name Name of the coupling facility structure. Valid format is a simple text string of 1 through 16 characters; for example, IXCSTR1.

Structure Type Type of structure. Valid values are Cache, List, or Lock.

System Name Name of the coupling facility system; in this case, the name of the z/OS system where the address space is located. Valid format is a simple text string of 1 through 8 characters; for example, SYSA.