TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • tmss10movelocation
cli:tmss10movelocation

Table of Contents

 
 

TMSS10MoveLocation

TMSS10MoveLocation puts selected Volumes in a move from one Repository to another.

Synopsis

TMSS10MoveLocation [-C check if volume is assigned to a container] [-M move only if container moving] [-S logon string] [-T move only if assigned container target matches] [-V volume] [-X skip volumes assigned to a container] [-c configuration file] [-e exclude volumes already moving] [-f from repository] [-l apply move lock during move] [-t to repository]

Options

  • -C Move Volume only when assigned Container is moving and matches move requirements.
  • -M Move only if the assigned Container is moving (requires -C) (default = false).
  • -S The Logon string argument sets the Server Logon Information.
  • -T Move only if the assigned Container Target matches (requires -C) (default = false).
  • -V Volume Filter which can be used to filter the traversal of Customer, Media, Volume, Repository and Flag values.
  • -X Skip any volumes already assigned to a container.
  • -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.
  • -e Exclude any Volumes that are already in a Move Status.
  • -f Repository to Move Volumes from.
  • -l Apply a move-lock to Volumes during move.
  • -t Repository to move Volumes to.

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.

Technical Support

The TapeTrack Software is commercially supported by a full time help desk staff.

If you are experiencing problems or want some advice on how to configure or use the product please see the Accessing Technical Support page.

Exit Statuses

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

Environment

Files

stdout: Output Reports.
stderr: Diagnostic messages.
stdin: Program input.

Example

Command line syntax

Move all US02 LTO Volumes with a Barcode ending in 5L6. 

TMSS10MoveLocation -S user:-password@server -V "US02.LTO.*5L6" -f "LIBR" -t "OFFS"

Output

             System: TapeTrack
 Report Description: Volumes Moved
       Report Notes: From(LIBR) To(OFFS)
    Production Time: Monday, November 27, 2017 - 12:56:38 (AUS Eastern Daylight Time)
       Report Width: 92 bytes

 Seq.   Barcode              From                 To                   Container            
 ------ -------------------- -------------------- -------------------- -------------------- 
      1 US02.LTO.000015L6    Library              Offsite Vault                             
      2 US02.LTO.000035L6    Library              Offsite Vault                             
      3 US02.LTO.000065L6    Library              Offsite Vault                             
      4 US02.LTO.000075L6    Library              Offsite Vault                             
      5 US02.LTO.000085L6    Library              Offsite Vault                             
      6 US02.LTO.000095L6    Library              Offsite Vault                             
      7 US02.LTO.000105L6    Library              Offsite Vault                             
      8 US02.LTO.000115L6    Library              Offsite Vault                             
      9 US02.LTO.000125L6    Library              Offsite Vault                             
     10 US02.LTO.000135L6    Library              Offsite Vault                             
     11 US02.LTO.000145L6    Library              Offsite Vault                             
     12 US02.LTO.000155L6    Library              Offsite Vault                             
     13 US02.LTO.000165L6    Library              Offsite Vault                             
     14 US02.LTO.000175L6    Library              Offsite Vault                             
     15 US02.LTO.000185L6    Library              Offsite Vault                             
     16 US02.LTO.000195L6    Library              Offsite Vault                             
     17 US02.LTO.000205L6    Library              Offsite Vault                             
     18 US02.LTO.000215L6    Library              Offsite Vault                             
     19 US02.LTO.000225L6    Library              Offsite Vault                             
     20 US02.LTO.000235L6    Library              Offsite Vault                             
     21 US02.LTO.000245L6    Library              Offsite Vault                             
     22 US02.LTO.000255L6    Library              Offsite Vault                             
     23 US02.LTO.000265L6    Library              Offsite Vault                             
     24 US02.LTO.000275L6    Library              Offsite Vault                             
     25 US02.LTO.000285L6    Library              Offsite Vault                             
     26 US02.LTO.000295L6    Library              Offsite Vault                             
     27 US02.LTO.000305L6    Library              Offsite Vault                             
     28 US02.LTO.000315L6    Library              Offsite Vault                             
 ------ -------------------- -------------------- -------------------- --------------------
Changelog
2021-05-24Fixed bug when using TMSSLEVELNAME and TMSSNOLEVELSLOT variables (#127)
2020-11-24Added support for JSON output
2019-02-25Added support for HTML output
2019-02-09Added support for Excel output
2019-01-06Added return code list to end of all command line programs that use the TapeTrack API
2017-06-02Added -X argument to only move Volumes not assigned to a container
2016-11-18Added fast forward code to reduce runtime
2016-11-18Enhanced argument parser to allow arguments in format *FI:filename that allows loading of arguments from a file
2015-12-26Added flags to Volume Filter syntax (customer.media.volume@repository+flags)
2015-08-24Changed hascontents to contentcount and change contentcount to a filter rather than bool
2015-08-24Added iscontainer and hascontents to the config file filter logic
2015-05-16Added environmental varialbe TMSSCANFILEUNQUALIFIED which will load and check volumes without Customer-ID and Media-ID qualifiers
2015-05-16Added environmental varialbe TMSSSCANFILENOPARSE which will presume scanfile items are only Volumes and not parse them, saving time
2015-05-16When loading scanfile from import definition, added CUSTOMER and MEDIA keywords to set defaults
2015-05-16When loading scanfile from import definition, changed keyword from VOLUME to BARCODE
2015-05-16Added TMSSUNQUALIFIEDVOLUME environmental variable which forces all barcodes to be printed without Customer-ID and Media-ID
2015-05-04Added support for AD passwords to all command line programs (check for environmental variable TMSSNOMD5)
2014-11-19Changed server argument parser to allow colon in password to support z/OS DD name files
2014-10-26Upgraded development environment from Visual Studio 2012 to Visual Studio 2013
 
Command Line Utilities 
 
cli/tmss10movelocation.txt · Last modified: 2022/05/31 01:02 by scunliffe

Page Tools