CHGCLURCY

La commande Modification de la reprise de cluster (CHGCLURCY) sert à la reprise sur incident. N'utilisez cette commande que sur instruction du fournisseur de services. Elle ordonne à un noeud d'un groupe de ressources de cluster d'effectuer une action de reprise spécifique. L'action de reprise peut annuler le protocole en cours, forcer la reprise de l'objet groupe de ressources de cluster associé au groupe de ressources de cluster, forcer une nouvelle jonction au groupe de ressources de cluster, mettre fin au travail associé au groupe de ressources de cluster, ou provoquer la soumission d'un travail de groupe de ressources de cluster sur le noeud où la commande CHGCLURCY a été exécutée. Le travail de groupe de ressources de cluster soumis ne doit pas être en cours d'exécution. The Change Cluster Recovery (CHGCLURCY) command is used for problem recovery. Use this command only when directed by service provider. It directs a node in a cluster resource group to perform a specific recovery action. The recovery action can cancel the current protocol, force a recovery of the cluster resource group object associated with the cluster resource group, force a rejoin with the cluster resource group, end the job that is associated with the cluster resource group, cause a cluster resource group job to be submitted on the node where the CHGCLURCY command was executed. The cluster resource group job being submitted must not be currently running.

Ces actions sont destinées à être utilisées lorsqu'un groupe de ressources de cluster rencontre un problème et que vous devez lui imposer une action de reprise. Le problème peut ne pas être dû à Cluster Resource Services. Par exemple, Cluster Resource Services soumet un travail pour appeler les programmes d'exit utilisateur. Si le travail est retenu, il apparaît à l'utilisateur que le groupe de ressources de cluster est bloqué. L'utilisateur ne sait pas forcément quel travail de programme d'exit a été soumis et ne peut donc effectuer aucune reprise en dehors du cluster. L'exécution de l'action de reprise appropriée avec CHGCLURCY peut satisfaire Cluster Resource Services, qui peut alors faire échouer le protocole ayant appelé le travail du programme d'exit et poursuivre. The actions are intended to be used when a cluster resource group is experiencing a problem, and you need to force some recovery action onto the group. The problem may not be due to Cluster Resource Services. For example, Cluster Resource Services submits a job to invoke user exit programs. If the job is held, then it appears to a user that the cluster resource group is hung. A user may not know what exit program job was submitted, and so cannot perform any recovery outside of the cluster. Performing the appropriate recovery action with CHGCLURCY can satisfy Cluster Resource Services so it can fail the protocol that invoked the exit program job and continue.

Restrictions:

1. Pour utiliser cette commande, vous devez posséder le droit spécial de contrôle des travaux (*JOBCTL), ainsi que le droit spécial de service (*SERVICE) ou être autorisé à la fonction Service Trace du système d'exploitation via la prise en charge de l'administration des applications d'iSeries Navigator. Vous devez également posséder le droit de modification (*CHANGE) sur tout objet groupe de ressources de cluster visé par cette commande. To use this command you must have job control (*JOBCTL) special authority, and either service (*SERVICE) special authority or be authorized to the Service Trace function of the operating system through iSeries Navigator's Application Administration support. You must also have change (*CHANGE) authority to any cluster resource group object that is to be acted upon with this command.
2. Le cluster doit être à la version 3 ou supérieure pour que cette commande fonctionne à distance (sur un noeud autre que celui qui émet la commande). The cluster must be at version 3 or greater for this command to work remotely (work on any node other than the node issuing the command).
3. Cluster Resource Services doit être actif ou en cours de démarrage sur le noeud à partir duquel cette commande est émise. Cluster Resource Services must either be active or in the process of starting on the node that this command is issued from.
4. Seuls les noeuds qui possèdent un travail pour le groupe de ressources de cluster visé peuvent participer à cette commande. Only nodes that have a job for the desired cluster resource group may participate in this command.
5. Pour déterminer si cette commande a abouti, consultez les historiques de travail des travaux de cluster concernés à la recherche d'un message CPDBB06 indiquant l'action de reprise effectuée. To determine if this command succeeded, check the job logs of the affected cluster jobs for a CPDBB06 message indicating the recovery action performed.

Avertissement : Soyez prudent avec cette commande : les actions de reprise ne peuvent être ni annulées ni interrompues. Warning: Use caution with this command, recovery actions cannot be undone or canceled.

Paramètres

Cluster (CLUSTER)

Indique le cluster sur lequel l'opération est effectuée. Specifies the cluster that is to be operated upon.

Ce paramètre est obligatoire. This is a required parameter.

nom

Indique le nom du cluster sur lequel une action de reprise est effectuée. Specifies the name of the cluster to which a recovery action will be performed.

Groupe de ressources de cluster (CRG)Cluster resource group (CRG)

Indique le groupe de ressources de cluster sur lequel l'opération est effectuée. Specifies the cluster resource group that is to be operated upon.

Ce paramètre est obligatoire. This is a required parameter.

*ALL

Tous les groupes, y compris les groupes réservés QCSTCTL et QCSTCRGM. All groups, including the reserved groups QCSTCTL and QCSTCRGM.

nom

Indiquez le nom du groupe de ressources de cluster. Les noms réservés des groupes Cluster Control et Cluster Resource Group Manager, respectivement QCSTCTL et QCSTCRGM, peuvent également être indiqués. Specify the name of the cluster resource group. The reserved names for the Cluster Control and Cluster Resource Group Manager groups, QCSTCTL and QCSTCRGM, respectively, may also be specified.

Identificateur de noeud (NODE)Node identifier (NODE)

Indique le noeud de cluster sur lequel l'opération est effectuée. Specifies the cluster node that is to be operated upon.

Ce paramètre est obligatoire. This is a required parameter.

*ALL

Tous les noeuds actifs du cluster. All active nodes in the cluster.

nom

Indiquez le nom du noeud de cluster. Specify the name of the cluster node.

Action (ACTION)

Indique une action de reprise pour le groupe de ressources de cluster indiqué sur le noeud indiqué. Specifies a recovery action for the specified cluster resource group on the specified node.

Ce paramètre est obligatoire. This is a required parameter.

Remarques : Notes:

1. La seule valeur valide pour NODE(*ALL) est *END. The only valid value for NODE(*ALL) is *END.
2. La seule valeur valide pour CRG(*ALL) est *END. The only valid value for CRG(*ALL) is *END.
3. Pour une valeur de paramètre CRG de QCSTCTL ou QCSTCRGM, les actions *RESTART ou *REJOIN provoquent l'arrêt de la mise en cluster sur le noeud indiqué, puis le noeud démarre automatiquement. Pour *END, la mise en cluster s'arrête sur le noeud et n'est pas redémarrée automatiquement. For a CRG parameter value of QCSTCTL or QCSTCRGM, actions *RESTART or *REJOIN will cause clustering to end on the specified node, and then the node will automatically start. For *END, clustering will end on the node and clustering will not be automatically started.
4. Pour *STRCRGJOB, seul un nom de groupe de ressources de cluster spécifique est autorisé. Les valeurs spéciales QCSTCTL ou QCSTCRGM ne sont pas autorisées. For *STRCRGJOB,only a specific cluster resource group name is allowed. Special values of QCSTCTL or QCSTCRGM are not allowed.

*CANCEL

Annule la demande de protocole en cours. Si aucun protocole n'est en cours, l'action est ignorée. Cancels the current protocol request. If no protocol is in-progress, the action is ignored.

*RESTART

Redémarre le noeud indiqué dans le groupe de ressources de cluster indiqué en effectuant une action de démarrage, sans que le groupe de ressources de cluster n'effectue de basculement du noeud. L'objet groupe de ressources de cluster associé au groupe de ressources de cluster est récupéré depuis un autre noeud du domaine de reprise du groupe. S'il n'existe pas d'autre noeud actif dans le domaine de reprise, le groupe de ressources de cluster devient inactif et aucune autre opération n'a lieu sur celui-ci tant qu'un autre noeud du domaine de reprise disposant d'un objet groupe de ressources de cluster valide n'a pas démarré. Restart the specified node in the specified cluster resource group by performing a start action without the cluster resource group doing any failover of the node. The cluster resource group object associated with the cluster resource group will be recovered from another node in the recovery domain of the group. If there is not another active node in the recovery domain, then the cluster resource group will go inactive and no further operations on it will occur until another node in the recovery domain starts that has a valid cluster resource group object.

*REJOIN

Rétablit la jonction du noeud indiqué au groupe de ressources de cluster indiqué. Le groupe de ressources de cluster effectue d'abord un basculement, puis démarre automatiquement le noeud pour ce seul groupe de ressources de cluster. Rejoin the specified node in the specified cluster resource group. The cluster resource group will first do a failover, and then the cluster resource group will automatically start the node only for that cluster resource group.

*END

Met fin au travail du groupe de ressources de cluster sur le noeud indiqué. Cela peut provoquer un basculement dans le groupe de ressources de cluster. Le groupe de ressources de cluster ne démarre pas automatiquement le noeud, et aucune autre opération de groupe de ressources de cluster ne peut être effectuée sur le noeud sans avoir d'abord arrêté, puis démarré la mise en cluster sur le noeud. End the cluster resource group job on the specified node. This may cause a failover in the cluster resource group. The cluster resource group will not automatically start the node, and no further cluster resource group operations can be performed on the node without first ending, then starting, clustering on the node.

*STRCRGJOB

Soumet un travail de groupe de ressources de cluster sur ce noeud uniquement. Le paramètre NODE doit contenir le nom du noeud local. Submit a cluster resource group job on this node only. The NODE parameter must contain the name of the local node.

Exemples

Exemple 1 : Action de reprise pour un noeud d'un groupe de ressources de cluster Example 1: Recovery Action for One Node in One Cluster Resource Group

CHGCLURCY   CLUSTER(EXAMPLE)  CRG(CRG1)  NODE(NODE1)
            ACTION(*CANCEL)

Cette commande annule le protocole en cours dans le groupe de ressources de cluster CRG1 sur le noeud NODE1 du cluster EXAMPLE. This command cancels the current protocol in cluster resource group CRG1 on node NODE1 in cluster EXAMPLE.

Exemple 2 : Action de reprise pour un groupe de ressources de cluster réservé Example 2: Recovery Action for a Reserved Cluster Resource Group

CHGCLURCY   CLUSTER(EXAMPLE)  CRG(QCSTCRGM)
            NODE(NODE1)  ACTION(*RESTART)

Cette commande provoque l'arrêt de la mise en cluster sur NODE1 pour le noeud NODE1 du groupe de ressources de cluster QCSTCRGM du cluster EXAMPLE. La mise en cluster sur NODE1 tente de redémarrer automatiquement, comme si NODE1 avait été démarré avec la commande Démarrage de noeud de cluster (STRCLUNOD). This command causes node NODE1 of cluster resource group QCSTCRGM in cluster EXAMPLE to end clustering on NODE1. Clustering on NODE1 will attempt to automatically restart itself as though NODE1 was started with the Start Cluster Node (STRCLUNOD) command.

Exemple 3 : Action de reprise pour tous les noeuds Example 3: Recovery Action for All Nodes

CHGCLURCY   CLUSTER(EXAMPLE)  CRG(CRG1)
            NODE(*ALL)  ACTION(*END)

Cette commande provoque l'arrêt de tous les travaux de cluster sur tous les noeuds associés au groupe de ressources de cluster CRG1 du cluster EXAMPLE. Aucune autre opération sur CRG1 ne peut être effectuée sur un noeud donné tant que la mise en cluster n'a pas été arrêtée, puis démarrée sur ce noeud. Les commandes Fin de noeud de cluster (ENDCLUNOD) et STRCLUNOD peuvent servir à arrêter et démarrer un noeud de cluster. This command causes all cluster jobs on all nodes associated with cluster resource group CRG1 in cluster EXAMPLE to end. No further operations on CRG1 can be performed on a given node until that node has clustering ended, and then started. The End Cluster Node (ENDCLUNOD) and STRCLUNOD commands may be used for ending and starting a cluster node.

Exemple 4 : Action de reprise pour tous les groupes Example 4: Recovery Action for All Groups

CHGCLURCY   CLUSTER(EXAMPLE)  CRG(*ALL)
            NODE(NODE1)  ACTION(*END)

Cette commande provoque l'arrêt de tous les travaux de cluster sur le noeud NODE1 du cluster EXAMPLE. Cela a pour effet d'arrêter la mise en cluster sur NODE1. Pour démarrer les travaux de cluster sur NODE1, la mise en cluster doit être démarrée sur NODE1. La commande STRCLUNOD peut servir à démarrer un noeud de cluster. This command causes all cluster jobs on node NODE1 in cluster EXAMPLE to end. This has the effect of ending clustering on NODE1. To start the cluster jobs on NODE1 requires NODE1 to have clustering started on it. The STRCLUNOD command may be used for starting a cluster node.

Exemple 5 : Démarrage du travail CRG1 sur le noeud NODE1 Example 5: Start CRG1 Job on Node NODE1

CHGCLURCY   CLUSTER(EXAMPLE)  CRG(CRG1)
            NODE(NODE1)  ACTION(*STRCRGJOB)

Cette commande provoque la soumission du travail de groupe de ressources de cluster CRG1 sur le noeud NODE1. Pour démarrer le travail de groupe de ressources de cluster sur NODE1, la mise en cluster doit être démarrée sur NODE1. La commande STRCLUNOD peut servir à démarrer un noeud de cluster. This command will cause cluster resource group job, CRG1, on node NODE1 to be submitted. To start the cluster resource group job on NODE1 requires NODE1 to have clustering started on it. The STRCLUNOD command may be used for starting a cluster node.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF222E

Le droit spécial &1 est requis.

CPF98A2

Vous n'avez pas les droits sur la commande ou l'API &1. Not authorized to &1 command or API.

CPFBB02

Le cluster &1 n'existe pas. Cluster &1 does not exist.

CPFBB09

Le noeud de cluster &1 n'existe pas dans le cluster &2. Cluster node &1 does not exist in cluster &2.

CPFBB0F

Le groupe de ressources de cluster &1 n'existe pas dans le cluster &2. Cluster resource group &1 does not exist in cluster &2.

CPFBB70

La demande &1 n'est pas compatible avec la version en cours du cluster. Request &1 not compatible with current cluster version.

CPFBBA0

Le noeud de cluster &1 du groupe de ressources de cluster &2 ne répond pas. Cluster node &1 in cluster resource group &2 is not responding.