TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:tmss10reconcile
 
 

TMSS10Reconcile

TMSS10Reconcile performs a batch reconciliation on a Repository.

Synopsis

TMSS10Reconcile [-B bypass confirmation] [-C certify] [-F don't fix surplus volumes] [-R Subject repository] [-S logon string] [-V volume filter] [-a add fully qualified volumes] [-c configuration file] [-d certificate description] [-e csv error file location] [-l input scan list] [-m minimum loaded volumes to continue]

Options

  • -A Attribute Index (default=0)
  • -B Bypass confirming Volume at Target Repository.
  • -C Certify Volumes (default = false).
  • -F Don't fix surplus Volumes by moving them to the Scan Repository and back (default = false).
  • -G Number of grace hours on confirmed Volumes before audit flag added (default = 24 hours)
  • -R Subject Repository for reconciliation.
  • -S The Logon string argument sets the Server Logon Information.
  • -V Volume Filter which can be used to filter the traversal of Customer, Media, Volume, Repository and flag values.
  • -a Add any fully qualified Volume in the scanfile not in TapeTrack (default = false).
  • -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.
  • -d Certificate description.
  • -e CSV error file location.
  • -l Input scan file list to reconcile against.
  • -m Minimum loaded Volumes to continue to execute process (default = 10).

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

TMSS10Reconcile -S user:-password@server -R "OFFS" -l "C:\Users\GazillaByte\reconcile_2017-11-29.txt" -V "US04.LTO.*"

Output

The output of the TapeTrack Reconciliation program is described in detail on the page Reconciliation Report

Changelog
2021-05-24Fixed bug when using TMSSLEVELNAME and TMSSNOLEVELSLOT variables (#127)
2020-11-24Added support for JSON output
2020-03-19Fixed bug that would cause crash with truncated attribute suffixes
2019-09-11Added report IDs
2019-04-14Added -G argument to specify grace period for tapes returning from offsite
2019-03-30Added TMSSPRINTRAWINPUT variable
2019-02-25Added support for HTML output
2019-02-09Added support for Excel output
2019-01-25Added -A argument to specify Attribibute Index
2019-01-25Added Attribute Column to output report
2019-01-25Added environment variable TMSSRECONCILETEXTn to override condition text
2019-01-06Added return code list to end of all command line programs that use the TapeTrack API
2017-01-14Fixed bug when loading relaxed barcode
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-08-23Fixed bug when processing raw records
2016-08-03Fixed bug where last confirming user was being displayed in report, rather than last moving user
2016-08-03Fixed bug that failed to confirm tapes coming from a slotted repository
2016-06-18Fixed bug in minimum scan-map safeguard
2016-03-02Added Hashing functionality to AddTranslation (template of '#' will return X-FFFFFFFF)
2016-01-16Fixed bug where duplicates were not being written to error CSV file
2016-01-15Added 3rd argument to AddAttributeResolution to match attributes only against specific repositories
2016-01-08Added Bypass Confirmation option
2016-01-08Added Moving Aging section to Phase 4 report
2016-01-08Added Phase 3 errors to output CSV file
2016-01-08Added Record number column to Phase 1 report
2016-01-08Added Status column to Phase 1 report
2016-01-08Added messaging to display name of extended attribute being used
2016-01-08Changed "Missing from subject repository" text to "Absent from Scan-Map"
2016-01-08Changed "Should not be in subject repository text to "Unexpected in Scan-Map"
2016-01-08Changed Phase 1 title to reflect load of Scan-Map
2016-01-08Phase 1 now reports duplicates as errors
2015-12-26Added flags to Volume Filter syntax (customer.media.volume@repository+flags)
2015-12-26Added INCLUSION support for AddString
2015-12-26Added error message when using AddTranslation type directives reference a field that has not been referenced
2015-10-01Added CSV extract option
2015-10-01Added Move User to reconciliation report
2015-10-01Added movedate, moveduration and userid to CSV extract
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-06-06Fixed bug where AddTranslation2 would cause crash when using comparison field that has not been previously set
2015-06-05Fixed bug where AddTranlation2 would cause crash when using comparison field that has not been previously set
2015-05-20Added ADDTRANSLATIONFROMSQL instruction
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-24Added Move Time column to reconciliation report
2014-11-30Changed behavior of Extract instruction in Import engine so that when the offset is zero CSV mode processing will process the raw text record
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
2014-09-17Added ConditionalEmbed option to INI engine to allow conditional embed of INI code
2014-08-09Added SeCSVDelimiter option to import engine to allow direct CSV field selection
2014-08-09Added SetODBC and SETSQL options to import engine to allow ODBC field selection
cli/tmss10reconcile.txt · Last modified: 2022/05/31 03:10 by scunliffe