Interpreting MODIFY CATALOG,ECSHR(STATUS) Output

The following is an example of the output for MODIFY CATALOG,ECSHR(STATUS):

*CAS***************************************************************
*  CF Connection: AutoAdd                                         *
* ------------------CATALOG------------------- -----STATUS------  *
* SYS1.VOLCAT.VGENERAL                         Inact(NotShrable)  *
* SYS1.MVSRES.MASTCAT                          Active             *
* UCAT1.USERCAT                                Active             *
* UCAT2.USERCAT                                Inact(Disconnect)  *
* UCAT3.USERCAT                                Inact(NonECSAcc)   *
*CAS***************************************************************

The above example shows that the catalog connection to the coupling facility structure that is used for Enhanced Catalog Sharing is active. If the connection did not exist, return and reason codes that are associated with the failure to connect would be displayed.

The information listed for the status of the ECS facility includes error information if the connection has failed. The possible values for the connection status are:

Autoadd: The system is connected to the ECS structure, and the automatic add function is enabled.
Connect Failure: While attempting to connect to the ECS structure, an error was returned from IXLCONN. The return and reason codes from IXLCONN are also displayed.
Connected: The system is connected to the ECS structure in the coupling facility; AUTOADD is disabled.
Inact(CFFail): The system has disconnected because a coupling facility failure was detected.
Inact(Disconnect): ECS is disconnected from the ECS structure in the coupling facility due to a MODIFY CATALOG command with the ECSHR(DISCONNECT) parameter.
Inact(Restart): The system disconnected while processing a CAS restart.
Quiescing: ECS is currently active, but is in the process of disconnecting.
Rebuild Connected: ECS has connected to the new structure during rebuild processing.
Rebuild Cleanup: ECS has received and processed the rebuild cleanup event.
Rebuild Quiesced: ECS activity has been quiesced due to a rebuild request.
Rebuild Stopped: A rebuild of the ECS structure that was in progress has been stopped.
Unavailable: The catalog is not currently allocated and open in the catalog address space (CAS).
Unknown: The system status of ECS facility is unknown.

If the connection has been terminated because of a service error, a return code, a reason code, and the module ID will be shown under the system connection status line. The return code and reason code of a coupling facility service call will also be displayed if available.

After the system status is displayed, the ECS status of all catalogs that have been referenced since the last system IPL is displayed. The values of status that might appear are:

Active: ECS is active for the catalog.
Inact(CFFail): The catalog is inactive because the coupling facility failed.
Inact(CFFull): An attempt was made to activate the catalog, but the ECS structure in the coupling facility is full.
Inact(Disconnect): The catalog is inactive because the system disconnected from the ECS structure.
Inact(MaxCats): An attempt was made to activate the catalog, but the maximum number of catalogs that are allowed in the ECS structure has been reached.
Inact(NeverConn): The catalog is inactive because the system is not connected to the ECS structure in the coupling facility.
Inact(NonECSAcc): The catalog is inactive because the last system to access the catalog was non-ECS 1.5. system.
Inact(NotElig): The catalog is inactive because it is not ECS-eligible; it does not have the ECSHARING attribute.
Inact(NotShrable): The catalog is inactive because it either is not on a shared volume or does not have SHAREOPTIONS(3,4).
Inact(Removed): The catalog is inactive due to a MODIFY CATALOG command with the ECSHR(REMOVE,...) parameter.
Inact(Unknown): The ECS status of this catalog has never been set or is otherwise unknown.

The status of a catalog is the last status known to the ECS facility. If the status changes, it will not be reflected in this display until the next catalog request that uses that catalog.