dsmmigfs query

Parameters

Query

Display the current space management settings for the named file system.

options

–Detail

Display detailed HSM settings for the file system. Some settings are displayed only when queried with the detail option:

• The maximum number of migration candidates that are identified by the scout daemon
• The minimum partial file recall size
• The minimum streaming recall size
• The minimum size (in bytes) that qualifies a file for migration
• The local status for the distributed recall environment
• The status for the failover environment

For GPFS™ file systems only:

The dsmmigfs query command without the detail option displays only locally managed file systems. Use the detail option to display information for all space-managed file systems within the IBM® Storage Scale cluster.

When you specify the detail option, the HSM client also displays the node name for each node ID.

–Failover

Display a status overview of the failover environment of all HSM managed cluster nodes. Valid only on GPFS file systems. The output displays the status for the node name, and node ID. The following status can be displayed:

ENABLED

The node can take over space-managed file systems when another HSM node fails. If the node fails, control of the space-managed file systems fails over to other HSM nodes.

ENABLED_TAKEOVER

The node can take over space-managed file systems when another HSM node fails. If the node fails, control of the space-managed file systems does not fail over to other HSM nodes.

ENABLED_HANDOVER

If the node fails, control of the space-managed file systems fails over to other HSM nodes. The node does not take over space-managed file systems when another HSM node fails.

DISABLED

The HSM node does not take control of another HSM node's space-managed file systems. If the node fails, control of the space-managed file systems does not fail over to other HSM nodes.

To enable failover of HSM management of GPFS file systems on source nodes within a cluster environment, issue the dsmmigfs enablefailover command on each source node.

–ERRORLOGName=file_path

Specifies the path and file name of the error log file to be used by this command. Output from only this command is logged to the specified file. Other commands and daemons write output to the error log file specified by the errorlogname option in options file dsm.sys or dsm.opt, or as specified by the DSM_LOG environment variable. If any part of the path you specify does not exist, the space management client creates it.

–Logname=file_path

Specifies the path and file name of the log file to be used by this command. The kinds of events that are logged to the file are specified with the hsmlogeventflags option. Error events are not logged to the file.

–Node=node_value -parsable

Display the IBM Storage Scale status of cluster nodes that are managed by the HSM client. Valid only on GPFS file systems. The minimum abbreviation of the option is one character (-n=node_value). The output displays the following information for each node:

• IBM Storage Scale node name
• IBM Storage Scale node ID
• IBM Storage Scale status. The IBM Storage Scale status can be arbitrating, active, down, or unknown. The status is displayed when you specify the detail option.
• Recall daemon session ID
• Mount disposition
• Ping recall daemon
• Watch daemon session ID
• HSM status. The HSM status can be active or down.

Specify node_value by using one of three formats:

Specify node_value as a node name

Example: -node=system1

Specify node_value as a file that contains a list of node names

Example: -node=/usr/tivoli/tsm/data/nodes.list

Specify node_value by using a key word that defines a class of nodes

Specify one of the following node classes:

all

All nodes in the IBM Storage Scale cluster.

clientnodes

All nodes that do not participate in file system administration activities.

managernodes

All nodes in the pool of nodes from which file system managers and token managers are selected.

nonquorumnodes

All non-quorum nodes in the IBM Storage Scale cluster.

nsdnodes

All NSD server nodes in the IBM Storage Scale cluster.

quorumnodes

All quorum nodes in the IBM Storage Scale cluster.

Example: -node=quorumnodes

When you specify the node option, you can specify the parsable option. The parsable option is optional. The parsable option displays output in a format that can be easily parsed. The minimum abbreviation of the option is four characters (-pars). The parsable format displays the following attributes in order:

• Command name
• Query type
• IBM Storage Scale node name
• IBM Storage Scale node ID
• IBM Storage Scale status
• HSM status
• Recall master session ID
• Mount disposition
• Recall daemon readiness
• Watch daemon session ID

Each attribute value ends with a colon.

The following output is an example of the format when you specify the parsable option:

dsmmigfs:queryNode:interceptor:2:active:active:51AC92F500000000:YES:YES:519EF96D00000000:

dsmmigfs:queryNode:interceptor:2:active:active:51AC92F500000000:YES:YES:
519EF96D00000000:

filesystemspec

The file system name that displays current space management settings. The default is all space managed file systems.