TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • tmss10expirefiles
cli:tmss10expirefiles

Table of Contents

 
 

TMSS10ExpireFiles

TMSS10ExpireFiles will expire and delete all files from the TapeTrack Server that match the Customer-ID filter and fit within the specified date range.

Synopsis

TMSS10ExpireFiles [-C Customer Filter] [-R Expiry Date Range] [-S logon string] [-X Exclusion File] [-t Test Mode]

Options

  • -C Customer-ID filter.
  • -R Range of dates to delete files.
  • -S The Logon string argument sets the Server Logon Information
  • -X Files to be excluded from deletion.
  • -t True to run in test 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.

Notes

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.

Examples

To delete all files with an expiry date within the year 2015 for Customer US02

Command line syntax

C:\>tmss10expirefiles -S username:-password@tapetrack.com -R "Y-2:y-2" -C "US02"

Output

ZBT001N-11:47:41 TMSS10ExpireFiles (c) GazillaByte 1998-2017
ZBT002N-11:47:41 Compiled Jul  4 2017 at 19:58:34
ZBT010I-11:47:41 this program will delete all expired files that have been uploaded to the TapeTrack Server
ZBT006N-11:47:41 Running Under Windows 10 (build 15063 10.00) on platform x64
ZBT000N-11:47:41 Host is Little Endian
ZBT000N-11:47:41 Host is ASCII
ZBT000N-11:47:41 Binary is 64 bit
ZBT000N-11:47:41 Current Working Directory is C:\
ZBT004N-11:47:41 Today is Tuesday, September 26, 2017
ZBT005N-11:47:41 Running on GazillaByte
ZBT006N-11:47:41 Process ID 16044
ZBT000N-11:47:41 Parsing and validating command arguments
ZBT001N-11:47:41 Server Interpreted as: Server(tapetrack.com) Port(5000) User(username) Password(******)
ZBT000N-11:47:41 Explicit date range requested as: Y-2:y-2
ZBT000N-11:47:41 Start date interpreted as: Thursday, January 01, 2015
ZBT000N-11:47:41 End date interpreted as:  Thursday, December 31, 2015
ZBT000N-11:47:41 Days apart: 365
ZBT000N-11:47:41 Checking for Environment Variable 'ESPDATERANGEOFFSETFILE'
ZBT002N-11:47:41 Program Options:
ZBT002N-11:47:41        (C) Customer Filter=US02
ZBT002N-11:47:41        (R) Expiry Date Range=Y-2:Y-1
ZBT002N-11:47:41        (S) Server=<VALUE HIDDEN>
ZBT002N-11:47:41        (X) Exclusion file=
ZBT002N-11:47:41        (t) Test Mode (no updates)=false
ZBT000N-11:47:41 Arguments parsed and validated with 0 errors
ZBT000N-11:47:41 Checking for environment variable TMSSSERVERPROXY
ZBT000N-11:47:41 Connection to server (192.241.211.124) successful
ZBT000N-11:47:41 Logging on to TapeTrack Server
ZBT000N-11:47:41 Registering Client at MACID(00:8c:fa:8e:02:f5:00:00) Result(Request OK)
ZBT000N-11:47:42 Last Logon was at Tuesday, September 26, 2017 - 11:47:07 from 
ZBT000N-11:47:42 Welcome to Server: Production
ZBT000N-11:47:42 Listing Customers
ZBT000N-11:47:42 Customer List successful: Customers(3) Excluded(5)
ZBT000N-11:47:42 Processing Customer: US02-Los Angeles Data Center (326/1)
ZBT000N-11:47:42 Candidate File(2015_Report.csv) Expiry(Thursday, October 01, 2015)
ZBT000N-11:47:42 Delete Result: Request OK
ZBT000N-11:47:42 Closing connection to TapeTrack Server
ZBT000N-11:47:42 Session Statistics:
ZBT000N-11:47:42        Seconds Connected: 1
ZBT000N-11:47:42        Queries Completed: 6
ZBT000N-11:47:42               Bytes Sent: 328
ZBT000N-11:47:42           Bytes Received: 1,224
ZBT900N-11:47:42 Program Complete
ZBT901N-11:47:42 Elapsed time 0 minutes and 1 seconds
ZBT991N-11:47:42 CRC values for this session: 0x22ffaf54 (0xfa48284)
ZBT992N-11:47:42 Number of records written: 44
ZBT993N-11:47:42 Number of bytes written: 2,488
ZBT999N-11:47:42 Program ended
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
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/tmss10expirefiles.txt · Last modified: 2022/05/31 02:01 by scunliffe

Page Tools