TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:tmss10volumerename

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
cli:tmss10volumerename [2019/12/12 00:36] – [Options] Scott Cunliffecli:tmss10volumerename [2025/01/21 22:07] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== TMSS10VolumeRename ====== ====== TMSS10VolumeRename ======
-This program renames a [[object:volume|Volume]] or list of [[object:volume|Volumes]]+This program renames, or assigns a new [[object:volume|Volume-ID]], a [[object:volume|Volume]] or list of [[object:volume|Volumes]]
  
 ===== Synopsis ===== ===== Synopsis =====
Line 11: Line 11:
 TMSS10VolumeRename command options: TMSS10VolumeRename command options:
  
-  * ''-S'' The logon string argument sets the [[cli:server_argument|Server logon information]]. +  * ''-S'' The Logon String argument sets the [[cli:server_argument|Server Logon Information]]. 
-  * ''-V'' The volume filter argument sets the Volume Filter which can be used to filter the traversal of [[object:customer:Customer]], [[object:media|Media]] and [[object:volume|Volume]] values. The format of this filter is c.m.v@r, where c is [[object:customer|Customer-ID]] filter, m is [[object:media|Media-ID]] filter, v is [[object:volume|Volume-ID]] filter and r is [[object:repository|Repository-ID]] filter. To process only [[object:volume|Volumes]] not in [[object:repository|Repository]] ACME, "*.*.*@!(ACME).+  * ''-V'' The volume filter argument sets the Volume Filter which can be used to filter the traversal of [[object:customer|Customer]], [[object:media|Media]] and [[object:volume|Volume]] values. The format of this filter is c.m.v@r, where c is [[object:customer|Customer-ID]] filter, m is [[object:media|Media-ID]] filter, v is [[object:volume|Volume-ID]] filter and r is [[object:repository|Repository-ID]] filter. To process only [[object:volume|Volumes]] not in [[object:repository|Repository]] ACME, "*.*.*@!(ACME).
   * ''-C'' New Customer-ID.   * ''-C'' New Customer-ID.
   * ''-M'' New Media-ID.   * ''-M'' New Media-ID.
Line 19: Line 19:
   * ''-l'' Live mode.   * ''-l'' Live mode.
  
 +{{page>cli:fi}}
 ===== Exit Status ===== ===== Exit Status =====
   - **zero** Program has ended successfully.   - **zero** Program has ended successfully.
Line 30: Line 31:
  
 ===== Examples ===== ===== Examples =====
 +
 +<note tip>Run TMSS10VolumeRename in test mode (no -l attribute) to check the results are correct before committing the changes.</note>
  
 ==== Renaming Volume - New Volume-ID ==== ==== Renaming Volume - New Volume-ID ====
Line 38: Line 41:
 === Command line syntax === === Command line syntax ===
  
-<sxh plain;>+<code plain;>
 TMSS10VolumeRename -S doco:-doco@localhost -V "US04.LTO.111211L6" -N "111111L6"  -l TMSS10VolumeRename -S doco:-doco@localhost -V "US04.LTO.111211L6" -N "111111L6"  -l
-</sxh>+</code>
  
 === Output === === Output ===
  
-<sxh plain;>+<code plain;>
  
              System: TapeTrack              System: TapeTrack
Line 55: Line 58:
       1 US04.LTO.111211L6    US04.LTO.111111L6    Request OK                                 1 US04.LTO.111211L6    US04.LTO.111111L6    Request OK                          
  ------ -------------------- -------------------- -----------------------------------  ------ -------------------- -------------------- -----------------------------------
-</sxh>+</code>
  
  
Line 63: Line 66:
  
 ==== Renaming Volume - Same Volume-ID, New Customer-ID==== ==== Renaming Volume - Same Volume-ID, New Customer-ID====
 +
 +<note important>Before renaming Volumes to a new Customer-ID, the new Customer-ID must have identical Media types, Repository-ID's and Zones in the same order and slot numbers</note>
  
 === Command line syntax === === Command line syntax ===
  
-<sxh plain;>+<code plain;>
 TMSS10VolumeRename -S doco:-doco@localhost -V "US04.LTO.123456L6" -N "*" -C "US03" -l TMSS10VolumeRename -S doco:-doco@localhost -V "US04.LTO.123456L6" -N "*" -C "US03" -l
-</sxh>+</code>
  
 === Output === === Output ===
  
-<sxh plain;>+<code plain;>
  
              System: TapeTrack              System: TapeTrack
Line 83: Line 88:
       1 US04.LTO.123456L6    US03.LTO.123456L6    Request OK                                 1 US04.LTO.123456L6    US03.LTO.123456L6    Request OK                          
  ------ -------------------- -------------------- -----------------------------------  ------ -------------------- -------------------- -----------------------------------
-</sxh>+</code>
  
-===== Changelog =====+--> Changelog 
  
 [filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10VolumeRename] [filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10VolumeRename]
 +<--
  
 <- ^ cli:introduction|Command Line Utilities^ -> <- ^ cli:introduction|Command Line Utilities^ ->
  
  
cli/tmss10volumerename.1576110983.txt.gz · Last modified: 2025/01/21 22:07 (external edit)