TMSS10ExpireByDate

From TapeTrack Wiki

Jump to: navigation, search

[edit] Overview

TMSS10ExpireByDate will cause volumes under date management within the TapeTrack Framework Server to flag as being expired. Volumes that expire in the manner will receive a "p" flag. TMSS10ExpireByDate needs to run with a parameter to define the date range of the expiry process.


TMSS0001N-08:00:11 TMSS10ExpireByDate (c) TapeTrack Pty Ltd 1999-2008

TMSS0002N-08:00:11 Compiled May 25 2008

TMSS0006N-08:00:11 Running Under Linux (2.6.24.5-85.fc8) on platform i686 TMSS0000N-08:00:11 Host is Little Endian TMSS0004N-08:00:11 Today is Sunday, November 02, 2008 TMSS0005N-08:00:11 Running on tms.tapetrack.com TMSS0006N-08:00:11 Process ID 16761 TMSS0002N-08:00:11 Program Options: TMSS0002N-08:00:11 (O) Expiry Date Range Offset File= TMSS0002N-08:00:11 (R) Expiry Date Range= TMSS0002N-08:00:11 (S) Server=batch@127.0.0.1:5000 TMSS0002N-08:00:11 (V) Volume Filter=*.*.* TMSS0002N-08:00:11 (X) Exclusion file= TMSS0002N-08:00:11 (d) DataCluster Filter= TMSS0002N-08:00:11 (f) Force Expiry=false TMSS0002N-08:00:11 (r) Repository Filter=* TMSS0002N-08:00:11 (t) Test Mode (no updates)=false TMSS0000E-08:00:11 Empty Date Range String passed TMSS9997N-08:00:11 Program Complete TMSS9998N-08:00:11 Elapsed time 0 minutes and 0 seconds


Program Options

  • (O) Expiry Date Range Offset File=

This option will reset the default offste range defined in the running of the program and increase it by an amount within a specified file. An entry of 0:1 within the file will add 1 to the expiry range.


  • (R) Expiry Date Range=

Defines the period of expiry for volumes within the TapeTrack Framework Server Data Base. See below for an example. TMSS10ExpireByDate -R "*-100:*+1" A breakdown of the range filter would be:


  • = Today

-100 = One hundred days ago

= Date Range Seperator
  • = Today

+1 = One Day in the Future.


In the example above the program will run with an expiry range of 100 days into the past and 1 day into the future. Every tape within the database that has a date within these ranges will expire. (Be flagged with a "p" flag).


  • (S) Server=batch@127.0.0.1:5000

The Default location of the running TapeTrack Service is 127.0.0.1 (localhost) on port 5000. If you wish to run TMSS10ExpireByDate on another server the -S option can be defined. See below for an example. TMSS10ExpireByDate -S "192.168.1.10:5001" In the example above TMSS10ExpireByDate will run the machine with an IP address of 192.168.1.10 on Port 5001.


  • (V) Volume Filter=*.*.*

This option is more that just a volume filter as the name suggests. The volume filter is actually broken down into three components as you can see from the filter format of "*.*.*".

  • = Customer
  • = Media
  • = Volume

An few examples of the use are listed below. TMSS10ExpireByDate -V "ACME.LT.*" - ExpireBy Date will run for Customer "ACME", Media "LT", Volumes - All TMSS10ExpireByDate -V "ACME.*.*" - ExpireBy Date will run for Customer "ACME", Media - All, Volumes - All TMSS10ExpireByDate -V "*.*.*MON*" - ExpireBy Date will run for Customer - All Media - All, Volumes - With MON anywhere in the volume string.


  • (X) Exclusion file=

Allows for the exclusion of customers based on there entry in a defined file. CACME entry into the file would exclude customer "ACME" from the expiry process.


  • (d) DataCluster Filter=

Will allow the expiry of volumes only from within the defined data cluster.


  • (f) Force Expiry=false

Forces expiry to run even if it has been disabled at a media level within the TapeMaster client GUI.


  • (r) Repository Filter=*

Will allows expiry to run on volumes within a specified repository (location) only.


  • (t) Test Mode (no updates)=false

Will run the program will all options but will not update volumes within the TapeTack Framework Servers Data Base.

Retrieved from "http://wiki.tapetrack.com/index.php/TMSS10ExpireByDate"
Personal tools