samdiag

Name

samdiag - Requests detailed information about a resource.

Synopsis

samdiag [-h] [-T] [-V] [-x extra_info] -r Resource_handle

samdiag [-h] [-T] [-V] [-x extra_info] -g Resource_group

samdiag [-h] [-T] [-V] [-x extra_info] Resource_class:Resource:[Node]

samdiag [-h] [-T] [-V] [-x extra_info] -e Engine_name

Description

You can request detailed resource information by using this command. You can enter the command on any node where a System Automation for Multiplatforms daemon is active.

The command samdiag provides the following information about a specified resource:

Status
Dependencies
Binding constraints
Outstanding actions
Flags and exceptions
Requests and votes
History
Variables

Options

-h

Writes the command's usage statement to standard output.

-T

Writes the command's trace messages to standard error. For your software-service organization's use only.

-V

Writes the command's verbose messages to standard output.

-x extra_info

Extra information. This option requests for extra information on the specified resource. The operand extra_info can have the following valid strings:

reqs: requests information.
votes: votes information.
hist: history information.
vars: variable information.
all: all information.

-g Resource_group

The name of the resource group implies that a resource group is specified.

-r Resource_handle

Resource handle. This option implies that a resource handle of a resource is specified.

-e Engine_name

Engine resource name. This option implies that an engine name of a resource is specified. These formats are the engine name formats currently in use:

Cluster
Resource_name/<type>/Resource_class[/Node]

Cluster: This implies that diagnostic information is requested on the cluster or shared domains that are known to System Automation for Multiplatforms.
Resource_name/<type>/Resource_class[/Node]

This format is the most commonly used engine name format. Here the engine resource is identified by the resource's name (Resource_name), the <type> of resource, the resource's class (Resource_class), and optionally the node (Node) the resource is on. The Resource_class, Resource_name, and Node must be separated by a forward slash ("/"). Resource_class is the name of the Resource_class the resource belongs to. Resource_name is the name of the actual resource in its class. The Node must be included when you try to act on a fixed resource. The Node and its resource must be separated by the forward slash or "/" delimiter. Resource <type>

ResGroup: For resource groups.
Equivalency: For equivalencies.
Fixed: For fixed resources.
Float: For floating resources.

Parameters

Resource_class: Resource_name[:Node]: Member Resources. This specifies one resource that is to be acted on. A resource is identified by the resource's class (Resource_class), the resource's name (Resource_name), and optionally the node (Node) the resource is on. Resource_class, Resource_Name, and Node must be separated by a colon. Resource_class is the name of the Resource_class the resource belongs to. Resource_name is the name of the actual resource in its class. The Node must be included when you try to act on a fixed resource. The Node and resource must be separated by the colon or ":" delimiter.

Exit Status

0: The command ran successfully.
1: Error occurred with RMC.
2: Error occurred due to an underlying error in the command script.
3: Incorrect flag on command line.
4: Incorrect parameter on command line.
5: Error occurred due to a user error.
6: Resource specified was not found.

Security

This command requires root authority, or a user ID with appropriate permissions. For more information, see Setting up non-root user Ids for the command line interface.

Files

/usr/sbin/rsct/bin/samdiag: Location of the samdiag command.