system smtape status show

Show status of SMTape sessions

Availability: This command is available to cluster administrators at the admin privilege level.

Description

This command lists the status of all SMTape sessions in the cluster. By default, this command lists the following information:
  • Session
  • Type
  • Status
  • Progress
  • Path
  • Device
  • Node

Parameters

{ [-fields <fieldname>, ...]
Use this parameter to display additional fields about each session apart from the default entries. This parameter is optional. Any combination of the following fields is valid:
  • Session
  • Node
  • Type
  • Status
  • Path
  • Device
  • Progress
  • Start-time
  • End-time
  • Update-time
  • Backup-snapshot
  • Tape-block-size
  • Error
| [-instance ]}
Displays detailed information about the specified sessions.
[-session <Sequence Number>] - Session Identifier
Selects information about a specific SMTape session. A Session Identifier is a number that is used to identify a particular SMTape session.
[-node {<nodename>|local}] - Node Name
Selects information about sessions related to the specified node.
[-type {backup|restore}] - Operation Type
Selectsinformation about SMTape sessions of the specified operation type.
[-status {COMPLETED|FAILED|ACTIVE|WAITING|ABORTING|UNKNOWN}] - Session Status
Selects information about SMTape sessions having the specified status in the parameter.
[-path <text>] - Path Name
Selects information about SMTape sessions on a volume which is at the specified path name. This is the logical path of the volume and you must specify the path name in the following format: /vserver_name/volume_name.
[-device <text>] - Device Name
Selects information about the SMTape sessions on the specified tape device. You must specify the tape device name in the following format: /node_name/tape_device.
[-progress {<integer>[KB|MB|GB|TB|PB]}] - Bytes Transferred
Selects information about SMTape sessions in which the number of data bytes transferred in a particular session matches with the number specified in this parameter.
[-start-time <MM/DD/YYYY HH:MM:SS>] - Start Time
Selects information about SMTape sessions whose starting time matches the specified starting time.
[-end-time <MM/DD/YYYY HH:MM:SS>] - End Time
Selects information about SMTape sessions whose ending time matches the specified ending time.
[-backup-snapshot <snapshot name>] - Snapshot Name
Selects information about SMTape sessions that use a particular Snapshot copy name which matches the specified Snapshot copy name in the parameter in backup or restore operations.
[-tape-block-size <integer>] - Tape Block Size
Selects information about SMTape sessions that use a particular tape block size which matches the specified tape block size parameter in backup or restore operations.
[-error <text>] - Error Description
Selects information about SMTape sessions that have a particular error description which matches the specified error description in the parameter.

Examples

Displays default entries about the five SMTape sessions.

cluster1::> system smtape status show

Session Type    Status    Progress  Path         Device          Node
------- ------- --------- --------  ------------ --------------- -----------
5       Backup  COMPLETED     50MB  /vsrvr1/vol1 /cls1-01/nrst0l cluster1-01
4       Restore FAILED          0B  /vsrvr1/vol3 /cls1-02/nrst2l cluster1-02
3       Backup  COMPLETED     50MB  /vsrvr1/vol3 /cls1-01/nrst0l cluster1-01
2       Backup  COMPLETED     50MB  /vsrvr1/vol2 /cls1-03/nrst0m cluster1-03
1       Backup  COMPLETED     50KB  /vsrvr1/vol5 /cls1-01/nrst0n cluster1-01
5 entries were displayed.

The following example shows the output with the -instance argument.

cluster1::> system smtape status show -instance

Session Identifier: 1
         Node Name: node1
    Operation Type: Backup
            Status: COMPLETED
         Path Name: /vs1/vol1
       Device Name: /node1/rst0a
 Bytes Transferred: 2048
        Start Time: 1/4/2012 14:26:24
          End Time: 1/4/2012 14:29:45
      Last updated: 1/4/2012 14:29:45
     Snapshot Name: vol1.snapshot
   Tape Block Size: 240
 Error Description: None