DMPCLUTRC

La commande Vider trace de cluster (DMPCLUTRC) est utilisée pour l'analyse des incidents. Elle vide dans un fichier les informations de trace et de débogage relatives au cluster. Les informations sont vidées localement sur un ou plusieurs noeuds du cluster, pour un ou plusieurs groupes de ressources de cluster. Chaque groupe de ressources de cluster vidé possède un membre dans le fichier. Le nom du membre est le nom du groupe de ressources de cluster. Les informations vidées dépendent du groupe de ressources de cluster concerné. La quantité d'informations vidées est déterminée par le niveau de vidage. Seuls les noeuds qui ont un travail Cluster Resource Services actif pour le groupe de ressources de cluster indiqué produisent une sortie de vidage. The Dump Cluster Trace (DMPCLUTRC) command is used for problem analysis. It dumps cluster-related trace and debug information to a file. The information is dumped locally on one or more cluster nodes, for one or more cluster resource groups. Each cluster resource group that is dumped has a file member in the file. The name of the file member is the name of the cluster resource group. The information dumped is dependent on the particular cluster resource group. The amount of information dumped is determined by the dump level. Only nodes that have an active Cluster Resource Services job for the specified cluster resource group will have a dump output.

Restrictions:

1. Pour utiliser cette commande, vous devez posséder soit le droit spécial de service (*SERVICE), soit une autorisation pour la fonction Service Trace du système d'exploitation via la prise en charge de l'administration des applications d'iSeries Navigator. To use this command, you must have either service (*SERVICE) special authority or be authorized to the Service Trace function of the operating system through iSeries Navigator's Application Administration support.
2. Vous devez également posséder le droit d'utilisation (*USE) sur tout objet groupe de ressources de cluster à vider avec cette commande. You must also have use (*USE) authority to any cluster resource group object that is to be dumped with this command.
3. 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).
4. 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.
5. 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.
6. Pour déterminer si cette commande a abouti, recherchez un fichier de vidage sur les noeuds concernés. Si aucun fichier n'y figure, consultez l'historique du travail de cluster associé pour y trouver des messages. To determine if this command succeeded, check the affected nodes for a dump file. If a file is not there, then check the job log for the associated cluster job for messages.

Paramètres

Cluster (CLUSTER)

Indique le nom du cluster dont les informations doivent être vidées ou imprimées. Specifies the cluster name for which information is to be dumped or printed.

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

nom

Indiquez le nom du cluster. Specify the name of the cluster.

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

Indique le groupe de ressources de cluster à vider. Specifies the cluster resource group that is to be dumped.

*ALL

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

nom

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

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

Identificateur de noeud (NODE)Node identifier (NODE)

Indique le noeud de cluster à vider. Specifies the cluster node that is to be dumped.

*LOCAL

Le noeud local, c'est-à-dire le noeud sur lequel cette commande est émise. The local node, that is, the node this command is issued on.

*ALL

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

nom

Indique le nom du noeud de cluster. Specifies the name of the cluster node.

Niveau (LEVEL)

Indique le niveau de vidage. La quantité et le type d'informations de chaque niveau dépendent du groupe de ressources de cluster vidé. Specifies the dump level. The amount and kind of information in each level is dependent on the particular cluster resource group being dumped.

*BASIC

Indique le niveau de base des informations de vidage. Cela vide les informations conservées en continu sous forme d'informations d'enregistreur de vol. Specifies the basic level of dump information. This dumps information that is maintained continuously as flight recorder information.

*ERROR

Indique le niveau d'erreur des informations de vidage. Cela vide les informations d'erreur et inclut les informations du niveau *BASIC. Specifies the error level of dump information. This dumps error information, and includes the *BASIC level information.

*INFO

Indique le niveau informationnel des informations de vidage. Cela vide les informations de fin d'exécution et d'avertissement et inclut le niveau *ERROR. Specifies the informational level of dump information. This dumps completion and warning information, and includes the *ERROR level.

*VERBOSE

Indique le niveau détaillé des informations de vidage. Cela vide les informations détaillées de trace et de débogage et inclut le niveau *INFO. Specifies the verbose level of dump information. This dumps detailed trace and debugging information, and includes the *INFO level.

Fichier physique (FILE)

Indique le fichier physique dans lequel le vidage est écrit. Le fichier est écrit sur chaque noeud pour lequel le vidage est demandé, conformément au paramètre OVERWRITE. Le même nom de bibliothèque est utilisé sur tous les noeuds. Si un nom de fichier autre que *NODE est indiqué, le nom du fichier sera également le même sur tous les noeuds. Specifies the physical file that the dump is written to. The file is written on each node that the dump is requested on in accordance with the OVERWRITE parameter. The same library name is used on all nodes. If a file name is specified other than *NODE, then the file name will also be the same on all nodes.

Qualificatif 1 : Fichier physique Qualificatif 1: Fichier physique

*NODE

L'identificateur du noeud de cluster est utilisé comme nom de fichier. Par exemple, si l'identificateur d'un noeud de cluster est NODE1, le nom du fichier est NODE1. Si plusieurs noeuds sont vidés, chaque noeud aura un nom de fichier différent. The cluster node identifier is used as the file name. For example, if a cluster node identifier is NODE1, then the file name is NODE1. If multiple nodes are being dumped, then each node will have a different file name.

nom

Indiquez le nom du fichier physique. Ce nom est utilisé sur tous les noeuds. Specify the name of the physical file. This name is used on all nodes.

Qualificatif 2: Biblio

QGPL

Le fichier sera créé dans la bibliothèque QGPL. The file will be created in library QGPL.

*CURLIB

La bibliothèque en cours du travail qui appelle cette commande est utilisée. La bibliothèque est déterminée avant l'envoi d'une demande de vidage à tout autre noeud. The current library of the job that is invoking this command is used. The library is determined before a dump request is sent to any other node.

nom

Indiquez le nom de la bibliothèque qui contient le fichier physique. La même bibliothèque est utilisée sur tous les noeuds indiqués. Aucun vidage n'est effectué sur un noeud qui ne possède pas la bibliothèque. Specify the name of the library that contains the physical file. The same library is used on all specified nodes. No dump is taken on any node that does not have the library.

Option d'écrasement (OVERWRITE)Overwrite option (OVERWRITE)

Indique si le fichier indiqué sera écrasé ou non. Si le fichier existe, il sera supprimé puis recréé. Ce paramètre est vérifié noeud par noeud. Si *NO est indiqué avec plusieurs noeuds, seuls les noeuds qui ne possèdent pas le fichier feront l'objet d'un vidage. Un message CPDBB07 est envoyé à l'historique de chaque travail Cluster Resource Services participant au vidage, indiquant la réussite, l'échec ou l'impossibilité d'écraser le fichier sur le noeud. Specifies whether the specified file will be overwritten or not. If the file exists, it will be deleted and re-created. This parameter is checked on a per node basis. If *NO is specified along with multiple nodes, then only those nodes that do not have the file will have dumps taken. A CPDBB07 message is sent to the job log of every Cluster Resource Services job that participates in the dump that indicates success, failure, or the file cannot be overwritten on the node.

*YES

Le fichier indiqué sera écrasé. The specified file will be overwritten.

*NO

Le fichier indiqué ne sera pas écrasé. Si le fichier existe, aucun vidage n'a lieu sur le noeud indiqué. The specified file will not be overwritten. If the file exists, no dump on the specified node occurs.

Exemples

Exemple 1 : Vidage d'un groupe de ressources de cluster sur un noeud Example 1: Dumping One Cluster Resource Group on One Node

DMPCLUTRC   CLUSTER(EXAMPLE)  CRG(CRG1)  NODE(NODE1)

Cette commande vide le groupe de ressources de cluster CRG1 sur le noeud NODE1 du cluster EXAMPLE. Sur NODE1, un fichier nommé QGPL/NODE1 est créé. Il comporte un membre nommé CRG1. This command dumps cluster resource group CRG1 on the node NODE1 in cluster EXAMPLE. On NODE1, a file is created with the name QGPL/NODE1. It has one member named CRG1.

Exemple 2 : Vidage d'un groupe de ressources de cluster sur tous les noeuds Example 2: Dumping One Cluster Resource Group on All Nodes

DMPCLUTRC   CLUSTER(EXAMPLE)  CRG(CRG1)  NODE(*ALL)
            LEVEL(*ERROR)  FILE(QGPL/*NODE)  OVERWRITE(*NO)

Cette commande vide les informations d'erreur du groupe de ressources de cluster CRG1 sur tous les noeuds du cluster si le fichier n'existe pas. Chaque noeud vérifie individuellement si le fichier existe déjà. Le nom du fichier est QGPL/identificateur-de-noeud. This command dumps error information from cluster resource group CRG1 on all cluster nodes if the file does not exist. Each node checks individually for the file already existing. The name of the file is QGPL/node-identifier.

Exemple 3 : Vidage de tous les groupes de ressources de cluster sur tous les noeuds Example 3: Dumping All Cluster Resource Groups on All Nodes

DMPCLUTRC   CLUSTER(EXAMPLE)  CRG(*ALL)  NODE(*ALL)
            LEVEL(*INFO)  FILE(MYLIB/DUMP)  OVERWRITE(*YES)

Cette commande vide tous les groupes de ressources de cluster sur tous les noeuds. Le nom de la bibliothèque est déterminé par le travail qui a appelé cette commande. Si ce nom de bibliothèque est MYLIB, chaque noeud possède un fichier nommé MYLIB/DUMP, avec un membre de fichier par groupe vidé, en plus des membres pour QCSTCTL et QCSTCRGM. Le fichier sera détruit s'il existe et recréé pour le vidage. This command dumps all cluster resource groups on all nodes. The library name is determined by the job that invoked this command. If that library name is MYLIB, then each node has a file named MYLIB/DUMP, with one file member per group dumped in addition to members for QCSTCTL and QCSTCRGM. The file will be destroyed if it exists and re-created for the dump.

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.