TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:tmss10volumerename
 
 

This is an old revision of the document!


 
 

TMSS10VolumeRename

This program renames a volume or list of volumes

Synopsis

TMSS10VolumeRename [-S logonstring] [-V volumefilter] [-C new Customer ID] [-M new Media-ID] [-N new Volume ID] [-c configfile] [-l Live mode]

Description

TMSS10VolumeRename will rename the volume ID of a current volume or list of volumes, keeping history records associated with that volume/s.

Options

TMSS10VolumeRename command options:

  • -S The logon string argument sets the Server logon information.
  • -V The volume filter argument sets the Volume Filter which can be used to filter the traversal of Customer, Media and Volume values. The format of this filter is c.m.v@r, where c is Customer-ID filter, m is Media-ID filter, v is Volume-ID filter and r is Repository-ID filter. To process only volumes not in Repository ACME, “*.*.*@!(ACME).
  • -C New Customer ID.
  • -M New Media-ID.
  • -N New Volume ID.
  • -c The config file argument specifies the path to the Batch Configuration File. The Batch Configuration File allows you to perform advanced traversal of Customer, Media and Volumes, perform advanced barcode pre and post processing and route program output to syslogd. Configuration File capabilities vary from program to program but the syntax remains the same. In the event that logic is not supported it will simply be ignored.
  • -l Live mode.

Exit Status

  1. zero Program has ended successfully.
  2. non-zero Program has not ended successfully.

Environment

Files

  • stdout Output Reports.
  • stderr Diagnostic messages.

Examples

Renaming Volume - New Volume ID

Renaming a single volume to assign a new volume ID, for example if you have a typo in the volume ID you want to fix without losing the historical records accumulated.

To rename volume US04.LTO.111211L6 to US04.LTO.111111L6

Command line syntax

TMSS10VolumeRename -S doco:-doco@localhost -V "US04.LTO.111211L6" -N "111111L6"  -l

Output


             System: TapeTrack
 Report Description: Volume Rename Report
    Production Time: Wednesday, March 21, 2018 - 10:20:18 (AUS Eastern Daylight Time)
       Report Width: 111 bytes

 Seq.   Old Identity         New Identity         Messages                            
 ------ -------------------- -------------------- -----------------------------------
      1 US04.LTO.111211L6    US04.LTO.111111L6    Request OK                          
 ------ -------------------- -------------------- -----------------------------------


Renaming Volume - Same Volume ID, New Customer ID

Command line syntax

TMSS10VolumeRename -S doco:-doco@localhost -V "US04.LTO.123456L6" -N "*" -C "US03" -l

Output


             System: TapeTrack
 Report Description: Volume Rename Report
    Production Time: Wednesday, March 21, 2018 - 10:20:18 (AUS Eastern Daylight Time)
       Report Width: 111 bytes

 Seq.   Old Identity         New Identity         Messages                            
 ------ -------------------- -------------------- -----------------------------------
      1 US04.LTO.123456L6    US03.LTO.123456L6    Request OK                          
 ------ -------------------- -------------------- -----------------------------------

Changelog

Cannot load rss feed.
cli/tmss10volumerename.1551303589.txt.gz · Last modified: 2025/01/21 22:07 (external edit)