Listing all volumes added to TapeTrack within a defined range of dates and currently located within a selected repository is a two step process.

You must first extract an inventory listing of all volumes added between the specified range of dates. Then use that file to compare against a listing of all volumes located in the selected repository and extract all volumes that appear in both inventories and export to file.

The comparison of the volumes within the files also requires the use of a configuration file and a definition file to extract the data in the correct format.

Using the command line program TMSS10ListHistory, along with the attributes:

• -S user:-password@server for logon access
• -R “YYYY-MM-DD:YYYY-MM-DD” to specify the date range
• -t “*Added*” to only extract volume added records
• -V “CUST.MEDIA.*” to limit customer and media types extracted if required

Output from this process needs to be captured and written to file using stdout.

To extract all volumes added between the start of the year 2000 and the end of 2010 and write to file historyOut.txt

TMSS10ListHistory -S user:-password@server -R "2000-01-01:2010-12-31" -t "*Added*" -V "*.*.*" > historyOut.txt

The configuration file is used for traversal of the history (volumes added) file for comparison of volumes currently in the selected repository.

The following example instructs TapeTrack to compare each volume ID to the scanfile, if it is present include it in, otherwise skip it and move to the next volume.

traversal 
{
   scanfile= { file="scanfile.ttidef"; };
   customer =
   (
      {
         id="*";
         media =
         (
            {
               id="*";

               volume =
               (
                   {
                      id="*";
                      scanfile = true;
                      skip=false;
                   },
                   {
                      id="*";
                      skip=true;
                   }
               );
            }
         );
      }
   );
};

The definition file (default.ttidef) is used to instuct TapeTrack how the data is formatted in the extracted file.

# input file for volume comparison (TMSS10ListHistory output)
SetFile("historyOut.txt");

# extract volume ID
Extract(BARCODE, 1, 15, 0);

# skip header (9 lines)
SetHeaderCount(9); 

# exclude any line starting with -
AddString(Exclusion, 0, " -*");

Using the list of volumes added between the defined date range, we now compare that list to the inventory located at the specified repository and output the volumes to file.

TMSS10Inventory -S tapemaster:-@localhost -V "*.*.*@OFFS" -c "inventory.cfg" > inventoryout.txt 2> inventoryErr.txt

or if you prefer CSV output with unqualifed volume ID's, set the environmental variables TMSSREPORTFORMAT and TMSSUNQUALIFIEDVOLUME.

set TMSSUNQUALIFIEDVOLUME=1
set TMSSREPORTFORMAT=CSV 

TMSS10Inventory -S tapemaster:-@localhost -V "*.*.*@OFFS" -c "inventory.cfg" > inventoryout.txt 2> inventoryErr.txt