Error Handling

In addition to the normal command parsing errors and illegal command errors from the utility SXOutil, the following new errors pertaining to the creation and manipulation of the cluster block, are introduced:

MESSAGE: Cluster label exists already, cannot create another one

Level:

CAUSE: This error is returned while executing the command SXOMAKELABEL. This error indicates that an initial Cluster Ownership ID block has already been created by invoking the command SXOMAKELABEL.

ACTION: You only can reset this label to the current system by invoking the command SXSETLABEL. If there is a need to re-create the Cluster ID block, then issue the SXOREMOVELABEL command first.

MESSAGE: Volume mounted in invalid state for desired operation

Level:

CAUSE: The command failed because the volume is mounted in a wrong state.

ACTION: The volume should be in MASTER state in order to create (SXOMAKELABEL) the Cluster Ownership ID block as well as to purge (SXOREMOVELABEL) it. It should be in LONER state to reset (SXOSETLABEL) to the current system.

MESSAGE: Volume not a member of the set being initialized

Level:

CAUSE: There is a mismatch between the setname and the ldev being passed to the SXOMAKELABEL or SXOSETLABEL command.

ACTION: Cluster Ownership ID block can be created or reset only on the master volume of a volume set.

MESSAGE: Cluster ID is invalid for system volume set

Level:

CAUSE: Cluster Ownership ID block is valid only for user volume sets.

MESSAGE: Cannot RESET because no Cluster label is found

Level:

CAUSE: Cluster ID block needed to be created before it can be reset to the current system.

ACTION: Issue the command SXMAKELABEL before issuing SXOSETLABEL command.

MESSAGE: Cannot purge. Cluster label not initialized

Level:

CAUSE: Just a warning to indicate that the volume set is not switchable. Issue SXOMAKELABEL command to create the Cluster ID block before accessing the block using other commands.

MESSAGE: Insufficient capabilities to execute this command.

Level:

CAUSE: User does not have proper capability to execute this command.

ACTION: User requires either CV or SM capability to execute Cluster/iX commands.

Error Handling

Technical documentation

» Table of Contents