CL Command Reference - DMPCLUTRC
CL Command List > DMPCLUTRC Reference
Description:
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. 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. You must also have use (*USE) authority to any cluster resource group object that is to be dumped with this command. 3. 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 must either be active or in the process of starting on the node that this command is issued from.
5. Only nodes that have a job for the desired cluster resource group may particpate in this command.
6. 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.
Examples:
Example 1: Dumping One Cluster Resource Group on One Node
DMPCLUTRC CLUSTER(EXAMPLE) CRG(CRG1) NODE(NODE1)
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.
Example 2: Dumping One Cluster Resource Group on All Nodes
DMPCLUTRC CLUSTER(EXAMPLE) CRG(CRG1) NODE(*ALL)
LEVEL(*ERROR) FILE(QGPL/*NODE) OVERWRITE(*NO)
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.
Example 3: Dumping All Cluster Resource Groups on All Nodes
DMPCLUTRC CLUSTER(EXAMPLE) CRG(*ALL) NODE(*ALL)
LEVEL(*INFO) FILE(MYLIB/DUMP) OVERWRITE(*YES)
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.