TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:tmss10librarymanager
 
 

TMSS10LibraryManager

TMSS10LibraryManager manages Scratch Volume levels within the Target Repository.

Metrics used to monitor Volume levels include Repository capacity, Volumes moving in and out of the Repository, minimum Scratch Volumes required, Repository Scratch levels, available Scratch Volumes from other Repositories and free slot requirements.

Synopsis

TMSS10LibraryManager [-C Customer-ID] [-M Media-ID] [-R Repository-ID] [-S logon string] [-T target repository] [-V volume filter] [-c configuration file] [-e ejection filter] [-f minimum free slots] [-r repository scratch order] [-s minimum scratch volumes]

Options

  • -S The Logon string argument sets the Server Logon Information
  • -T Target Repository for Volumes if ejection is required to make room for minimum Scratch quantity. If not specified, no Volumes will be ejected.
  • -V Volume Filter which can be used to filter the traversal of Customer, Media, Volume, Repository and Flag values.
  • -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.
  • -e Volume ejection exclusion filter
  • -f Minimum free Slots required in Repository (Repository Properties override)
  • -r Repository Scratch Order override. syntax -r “RAC1=0;RAC2=30;RAC3=20” sets Scratch Rack priority to RAC2, then RAC3, excluding RAC1.
  • -s Minimum Scratch Volumes required in Repository (Repository Properties override)

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

TMSS10LibraryManager -S user:-password@server -C US02 -M LTO -R LIBR

Output

The output of the TapeTrack Library Manager program is described in detail on the page Library Management Report

See Also

Implementing TMSS10LibraryManager

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
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
2016-06-05Fixed bug where excluded volumes were unconditionally added to the totals
2016-06-05Fixed bug where metrics were incorrectly reported
2016-05-27Changed bug where move candidates were sorted in ascending last move date orderd (rather than decending)
2016-05-27Fixed bug where non-scratch tapes were excluded from library inventory count
2016-05-27Added argument to exclude Volumes from candidate queue (i.e. Scratch Volumes)
2016-05-27Aging report will now only print if there are Volumes in the queue to move
2016-05-27Added support for automatic scratch selection and move
2015-12-26Added flags to Volume Filter syntax (customer.media.volume@repository+flags)
2015-09-19Added UNIX man page
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)
2015-02-17Upgraded development environment from Visual Studio 2012 to Visual Studio 2013
2015-02-14Changed server argument parser to allow colon in password to support z/OS DD name files
2015-02-14Initial version of the program
cli/tmss10librarymanager.txt · Last modified: 2022/05/31 01:27 by scunliffe