Differences

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

--- cli:tmss10volumerename [2018/04/19 23:20] – Scott Cunliffe
+++ cli:tmss10volumerename [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== TMSS10VolumeRename ======
-This program renames a volume or list of volumes===== Synopsis =====
+This program renames, or assigns a new [[object:volume|Volume-ID]], a [[object:volume|Volume]] or list of [[object:volume|Volumes]]
-''TMSS10VolumeRename [-S logonstring] [-V volumefilter] [-C new Customer ID] [-M new Media ID] [-N new Volume ID]
+===== 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.
+TMSS10VolumeRename will rename the [[object:volume|Volume-ID]] of a current [[object:volume|Volume]] or list of [[object:volume|Volumes]] , keeping history records associated with that [[object:volume|Volume/s]].
 ===== 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 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).
+  * ''-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.
-  * ''-N'' New Volume 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.
+  * ''-c'' The config file argument specifies the path to the Batch Configuration File. The Batch Configuration File allows you to perform advanced traversal of [[object:customer|Customer]], [[object:media|Media]] and [[object:volume|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.
+{{page>cli:fi}}
 ===== Exit Status =====
   - **zero** Program has ended successfully.
@@ Line 29: / Line 32: @@
 ===== Examples =====
-==== Renaming Volume - New Volume ID ====
+<note tip>Run TMSS10VolumeRename in test mode (no -l attribute) to check the results are correct before committing the changes.</note>
-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.
+==== Renaming Volume - New Volume-ID ====
-To rename volume US04.LTO.111211L6 to US04.LTO.111111L6
+Renaming a single [[object:volume|Volume]] to assign a new [[object:volume|Volume-ID]], for example if you have a typo in the [[object:volume|Volume-ID]] you want to fix without losing the historical records accumulated.
+To rename [[object:volume|Volume]] ''US04.LTO.111211L6'' to ''US04.LTO.111111L6''
 === Command line syntax ===
-<sxh plain;>
+<code plain;>
 TMSS10VolumeRename -S doco:-doco@localhost -V "US04.LTO.111211L6" -N "111111L6"  -l
-</sxh>
+</code>
 === Output ===
-<sxh plain;>
+<code plain;>
              System: TapeTrack
@@ Line 53: / Line 58: @@
 US04.LTO.111211L6    US04.LTO.111111L6    Request OK
  ------ -------------------- -------------------- -----------------------------------
-</sxh>
+</code>
@@ Line 60: / Line 65: @@
-==== 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 ===
-<sxh plain;>
+<code plain;>
 TMSS10VolumeRename -S doco:-doco@localhost -V "US04.LTO.123456L6" -N "*" -C "US03" -l
-</sxh>
+</code>
 === Output ===
-<sxh plain;>
+<code plain;>
              System: TapeTrack
@@ Line 81: / Line 88: @@
 US04.LTO.123456L6    US03.LTO.123456L6    Request OK
  ------ -------------------- -------------------- -----------------------------------
-</sxh>
+</code>
+--> Changelog
+[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10VolumeRename]
+<--
+<- ^ cli:introduction|Command Line Utilities^ ->