system smtape status clear

08/29/2024 Contributors

Clear SMTape sessions

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

Description

This command clears SMTape sessions which are completed, failed or Unknown state.

[-session <Sequence Number>] - Session Identifier: Use this parameter to clear the SMTape sessions with the specified session identifier.
[-node {<nodename>|local}] - Node Name: Use this parameter to clear the SMtape sessions related to the specified node.
[-type {backup|restore}] - Operation Type: Use this parameter to clear the SMTape sessions of the specified operation type. These can be either backup or restore sessions.
[-status {COMPLETED|FAILED|UNKNOWN}] - Session Status: Use this parameter to clear the SMTape sessions which have the status as specified in the parameter.
[-path <text>] - Path Name: Use this parameter to clear the SMTape sessions which have path as specified in the parameter.
[-device <text>] - Device Name: Use this parameter to clear the SMTape sessions on a specific tape device.
[-backup-snapshot <snapshot name>] - Snapshot Name: Use this parameter to clear the SMTape sessions using the Snapshot copy name as specified in the parameter.
[-tape-block-size <integer>] - Tape Block Size: Use this parameter to clear the SMTape sessions with the tape block size as specified in the parameter.

The following example clears all the completed SMTape sessions in the cluster:

cluster1::> system smtape status clear
5 sessions are purged.

The SMTape sessions on the node node1 in the cluster are cleared.

cluster1::> system smtape status clear -node node1
3 sessions are purged.