TMSS10VolumeRename [-S logonstring] [-V volumefilter] [-C new Customer-ID] [-M new Media-ID] [-N new Volume-ID]
[-c configfile] [-l Live mode]
TMSS10VolumeRename will rename the Volume-ID of a current Volume or list of Volumes , keeping history records associated with that Volume/s.
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.
If an argument value starts with the value FI:, the value for that attribute will be read from the file name specified immediately after it. For example, if a file named ACME_volumes has the content ACME_*.*, specifying FI:/etc/ACME_volumes will have the same effect as -V ACME.*.*. Using FI: to refer to a file for an attribute value works for all attributes.
If the pattern being matched starts with *LIST: then rather than matching the literal value, each record in the file specified as *LIST:filename will be tested. If one matches the match will succeed.
stdout Output Reports.stderr Diagnostic messages.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
TMSS10VolumeRename -S doco:-doco@localhost -V "US04.LTO.111211L6" -N "111111L6" -l
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
------ -------------------- -------------------- -----------------------------------
TMSS10VolumeRename -S doco:-doco@localhost -V "US04.LTO.123456L6" -N "*" -C "US03" -l
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
------ -------------------- -------------------- -----------------------------------
| 2021-05-24 | Fixed bug when using TMSSLEVELNAME and TMSSNOLEVELSLOT variables (#127) |
| 2020-11-24 | Added support for JSON output |
| 2019-02-25 | Added support for HTML output |
| 2019-02-09 | Added support for Excel output |
| 2019-01-06 | Added return code list to end of all command line programs that use the TapeTrack API |
| 2016-11-18 | Added fast forward code to reduce runtime |
| 2016-11-18 | Enhanced argument parser to allow arguments in format *FI:filename that allows loading of arguments from a file |
| 2015-12-26 | Added -C and -M arguments to simplify change of Customer-ID and Media-ID |
| 2015-12-26 | Added flags to Volume Filter syntax (customer.media.volume@repository+flags) |
| 2015-08-24 | Changed hascontents to contentcount and change contentcount to a filter rather than bool |
| 2015-08-24 | Added iscontainer and hascontents to the config file filter logic |
| 2015-05-16 | Added environmental varialbe TMSSCANFILEUNQUALIFIED which will load and check volumes without Customer-ID and Media-ID qualifiers |
| 2015-05-16 | Added environmental varialbe TMSSSCANFILENOPARSE which will presume scanfile items are only Volumes and not parse them, saving time |
| 2015-05-16 | When loading scanfile from import definition, added CUSTOMER and MEDIA keywords to set defaults |
| 2015-05-16 | When loading scanfile from import definition, changed keyword from VOLUME to BARCODE |
| 2015-05-16 | Added TMSSUNQUALIFIEDVOLUME environmental variable which forces all barcodes to be printed without Customer-ID and Media-ID |
| 2015-05-04 | Added support for AD passwords to all command line programs (check for environmental variable TMSSNOMD5) |
| 2015-02-13 | Upgraded development environment from Visual Studio 2012 to Visual Studio 2013 |
| 2015-02-09 | Changed server argument parser to allow colon in password to support z/OS DD name files |
| 2015-02-09 | Initial version |