Selects the cluster for the operation. Use either the clusterID or the clusterName to identify the cluster. Optional.
If this option is omitted then the default cluster, as defined with the setcluster command, is used. Note: this parameter is reserved for future use.
-g, --nodeGroupName nodeGroupName
Specifies the nodes group name to query for the sessions. This is NOT case sensitive.
If this option is not specified, all passed nodes are queried.
If neither the nodes nor node group name is passed, all the nodes of all the node groups are queried. Optional.
-n, --nodes nodes
Specifies the nodes to query for the session.
If this option is not specified, all the nodes of the passed node group are queried.
If neither the nodes nor node group name passed, all the nodes of all node groups are queried. Optional.
-i, --sessionID sessionID
Specifies the session ID to query for the session. This option must be used in combination with nodes option. Optional.
-v, --verbose
Shows detailed session information. Optional.
-Y
Creates parsable output. Optional.
Using unlisted options can lead to an error.
Description
The
lsndmpsession
command retrieves the NDMP sessions information running on the nodes of the cluster and returns a map
in either a human-readable format or in a format that can be parsed. The command lists the sessions by job ID.
Command Output Explanation
HOST Node where NDMP session is running
SESSION_ID NDMP session ID
SESSION_TYPE Either DATA_BACKUP for a backup session or DATA_RECOVER for a restore session
BYTES_TRANSFERRED The bytes transferred thus far
START_TIME Time backup or restore session began in seconds since January 1, 1970
DMA_IP IP address of DMA server
DATA_IP IP address being used for data transfer
DATA_STATE Either ACTIVE meaning a currently running session or HALTED meaning a stopped session
TARGET_PATH Full path to location of backup or restore
PREP_DIR_PATH May not be present but if given represents the path within the snapshot
CURRENT_PATH Current path to file being backed up or restored
DIR_PROCESSED The number of directories that have been backed up or restored for the given session
FILE_PROCESSED The number of files that have been backed up or restored for the given session
MOVER_IP IP address of machine storing or retrieving the data
MOVER_STATE State of robotic mover where data is being backed up to or restored from
AVERAGE_THRUPUT Average throughput of backup or restore during the life of the NDMP session
CURRENT_THRUPUT Instantaneous throughput of backup or restore
DEVICE Name of tape device being used for backup or restore if applicable
AGE Duration current NDMP session has been running in hours, minutes and seconds.
LOCATION The current directory being backed up or restored for the given NDMP session.
Diagnostics
0
No error - The command was successful.
1
Syntax Error or Help - The command syntax was incorrect or --help was specified.
2
No Permission - The user does not have permission to issue the command.
3
Version Error - Mismatch between the expected and actual version of the software stack.
4
Communication Error - Communication with other cluster nodes or back-end services failed.
5
Timeout error - An operation waiting for data did not receive it within the time it expected it.
6
Input error - An argument or option was invalid.
7
Server error - An error occurred in a back-end service that caused the command to fail.
8
Command error - An internal error occurred while executing the command.
9
Invalid object - An object referenced by an argument or option value does not exist.
10
Duplicate object - The object to be created already exists.
11
Not enabled - The command is not enabled on this hardware platform.
12
Not licensed - The license agreement was not accepted.
14
User abort - The user aborted the command.
Copyright
Licensed Materials - Property of IBM, 5639-SN1, (C) Copyright IBM Corp. 2009, 2014. All rights reserved.