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.
AllowAlter Specifies
whether or not this connection allows structure alter to be initiated
for the structure. Possible values are Yes and No.
AllowRebuild Specifies
whether or not this connection allows user-managed structure rebuild
to be initiated for the structure. Possible values are Yes and
No.
Allow System Managed Duplexing Specifies whether or not this connection
allows system-managed processes to be intiated for the structure. Possible
values are Yes and No.
Allow User Managed Duplexing Specifies whether or not this connection
allows user-managed structure rebuild with duplexing to be initiated
for the structure. Possible values are Yes, No, and Not available.
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.
CF Utilization Percent
The percentage of CF processor time used by the structure.
The sum of the values in this column is less than 100%, because not all CF processor time is attributable to structures.
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: Typically, you do not see any of the following statuses
for a structure. They 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
for 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.
Suspend Specifies
if this connection can tolerate suspension of work units during system-managed
processing for a structure. Possible values are Yes, No, and
Not available.
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.