TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:tmss10expirebydate

This is an old revision of the document!


 
 

TMSS10ExpireByDate

Synopsis

TMSS10ExpireByDate [-O Expiry Date Range Offset File] [-R Expiry Date Range] [-S logonstring] [-V volumefilter] [-c Configuration File] [-f Force Expiry] [-r Repository Filter] [-t Test Mode]

Description

TMS10ExpirebyDate searches the volumes and adds a Move Pending Flag (p) to all volumes that match the volume and date range filters.

Options

TMSS10ExpireByDate command options:

  • -O Expiry date range offset file location
  • -R Expiry date range
  • -S 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.
  • -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 the program output to syslogd.
  • -f Forces expiry
  • -r Target repository
  • -t Test mode, true performs task without applying updates

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

Exit Status

  1. zero Program has ended successfully.
  2. non-zero Program has not ended successfully.

Environment

TMSSSERVERPROXY If defined the program will route all TapeTrack TCP/IP traffic through a HTTPS proxy. The value of the variable should be in the format user:password@host:port. To debug the proxy connection use variable TMSSAPILOGDIR.

TMSSAPILOGDIR If defined the program will write out a trace file to this directory.

TMSSPWPATH When no password value is passed in the logon string the program will look for the password in file C:/tapetrack/pw/batch, where user is the user value passed in the logonstring. If you wish to change this default path, you can set the path in TMSSPWPATH.

TMSSNOMD5 If defined the program will not MD5 hash passwords before sending them to the TapeTrack Server. This is required when relying on Windows Active Directory authentication. It should be noted that although the password is not being hashed, it is still being encrypted during transmission.

Examples

C:\WINDOWS\system32>TMSS10ExpireByDate -S username:-password@localhost -V "US01.*.*" -R "*-5:*"
ZBT001N-19:41:07 TMSS10ExpireByDate (c) GazillaByte 1998-2017
ZBT002N-19:41:07 Compiled Jul 28 2017 at 09:52:50
ZBT010I-19:41:07 This program adds a 'Move Pending flag' to Volumes which have a 'Next Move Date' within the specified range
ZBT006N-19:41:07 Running Under Windows 10 (build 15063 10.00) on platform x64
ZBT000N-19:41:07 Host is Little Endian
ZBT000N-19:41:07 Host is ASCII
ZBT000N-19:41:07 Binary is 64 bit
ZBT000N-19:41:07 Current Working Directory is C:\WINDOWS\system32
ZBT004N-19:41:07 Today is Wednesday, September 20, 2017
ZBT005N-19:41:07 Running on GazillaByte
ZBT006N-19:41:07 Process ID 20036
ZBT000N-19:41:07 Parsing and validating command arguments
ZBT001N-19:41:07 Server Interpreted as: Server(localhost) Port(5000) User(username) Password(******)
ZBT000N-19:41:07 Explicit date range requested as: *-5:*
ZBT000N-19:41:07 Start date interpreted as: Friday, September 15, 2017
ZBT000N-19:41:07 End date interpreted as: Wednesday, September 20, 2017
ZBT000N-19:41:07 Days apart: 6
ZBT000N-19:41:07 Checking for Environment Variable 'ESPDATERANGEOFFSETFILE'
ZBT002N-19:41:07 Program Options:
ZBT002N-19:41:07        (O) Expiry Date Range Offset File=
ZBT002N-19:41:07        (R) Expiry Date Range=*-5:*
ZBT002N-19:41:07        (S) Server=<VALUE HIDDEN>
ZBT002N-19:41:07        (V) Volume Filter=US01.*.*
ZBT002N-19:41:07        (c) Configuration File=
ZBT002N-19:41:07        (f) Force Expiry=false
ZBT002N-19:41:07        (r) Repository Filter=*
ZBT002N-19:41:07        (t) Test Mode (no updates)=false
ZBT000N-19:41:07 Arguments parsed and validated with 0 errors
ZBT000N-19:41:07 Checking for environment variable TMSSSERVERPROXY
ZBT000N-19:41:07 Connection to server (127.0.0.1) successful
ZBT000N-19:41:07 Logging on to TapeTrack Server
ZBT000N-19:41:07 Registering Client at MACID(00:8c:fa:8e:02:f5:00:00) Result(Request OK)
ZBT000N-19:41:07 Last Logon was at Wednesday, September 20, 2017 - 19:40:38 from 127.0.0.1 (Laptop_Senior)
ZBT000N-19:41:07 Welcome to Server: Production

             System: TapeTrack
 Report Description: Volume Expiry Report
       Report Notes: Volumes expiring between 2017-09-15 and 2017-09-20
    Production Time: Wednesday, September 20, 2017 - 19:41:07 (AUS Eastern Standard Time)
       Report Width: 153 bytes

 Seq.   Customer             Media                Barcode              Next Move                      Result            
 ------ -------------------- -------------------- -------------------- ------------------------------ --------------------------------------------------
ZBT001N-19:41:07 Volume filter interpreted as: Customer(US01) Media(*) Volume(*) Repository(*) Flags()
ZBT000N-19:41:07 Listing Customers
ZBT000N-19:41:07 Customer List successful: Customers(7) Excluded(0)
ZBT000N-19:41:07 Processing Customer: US01-New York Data Center (2287/730)
ZBT000N-19:41:07 Listing Media
ZBT000N-19:41:07 Media List successful: Media(3) Excluded(0)
ZBT000N-19:41:07 Processing Media: 359X-IBM 359x Cartridge
ZBT000N-19:41:07 Listing Volumes
ZBT000N-19:41:07 Volume List successful: Volumes(0) Excluded(2069)
ZBT000N-19:41:07 Processing Media: CONT-Media Containers
ZBT000N-19:41:07 Listing Volumes
ZBT000N-19:41:07 Volume List successful: Volumes(0) Excluded(5)
ZBT000N-19:41:07 Processing Media: LTO-LTO Cartridge
ZBT000N-19:41:07 Listing Volumes
ZBT000N-19:41:07 Volume List successful: Volumes(28) Excluded(185)
ZBT000N-19:41:07 Volume 000003L6 has Move Date of Tuesday, September 19, 2017
      1 New York Data Center LTO Cartridge        US01.LTO.000003L6    Tuesday, September 19, 2017     Request OK       
ZBT000N-19:41:07 Volume 000004L6 has Move Date of Tuesday, September 19, 2017
      2 New York Data Center LTO Cartridge        US01.LTO.000004L6    Tuesday, September 19, 2017     Request OK       
ZBT000N-19:41:07 Volume 000005L6 has Move Date of Tuesday, September 19, 2017
      3 New York Data Center LTO Cartridge        US01.LTO.000005L6    Tuesday, September 19, 2017     Request OK       
ZBT000N-19:41:08 Volume 000006L6 has Move Date of Tuesday, September 19, 2017
      4 New York Data Center LTO Cartridge        US01.LTO.000006L6    Tuesday, September 19, 2017     Request OK       
ZBT000N-19:41:08 Volume 000007L6 has Move Date of Tuesday, September 19, 2017
      5 New York Data Center LTO Cartridge        US01.LTO.000007L6    Tuesday, September 19, 2017     Request OK       
ZBT000N-19:41:08 Volume 000008L6 has Move Date of Tuesday, September 19, 2017
      6 New York Data Center LTO Cartridge        US01.LTO.000008L6    Tuesday, September 19, 2017     Request OK       
ZBT000N-19:41:08 Volume 000009L6 has Move Date of Tuesday, September 19, 2017
      7 New York Data Center LTO Cartridge        US01.LTO.000009L6    Tuesday, September 19, 2017     Request OK       
ZBT000N-19:41:08 Volume 000010L6 has Move Date of Tuesday, September 19, 2017
      8 New York Data Center LTO Cartridge        US01.LTO.000010L6    Tuesday, September 19, 2017     Request OK       
ZBT000N-19:41:08 Volume 000011L6 has Move Date of Tuesday, September 19, 2017
      9 New York Data Center LTO Cartridge        US01.LTO.000011L6    Tuesday, September 19, 2017     Request OK       
ZBT000N-19:41:08 Volume 000012L6 has Move Date of Tuesday, September 19, 2017
     10 New York Data Center LTO Cartridge        US01.LTO.000012L6    Tuesday, September 19, 2017     Request OK          
ZBT000N-19:41:08 Volume AI0003 has Move Date of Friday, January 01, 2038
ZBT000N-19:41:08 Volume AI0004 has Move Date of Friday, January 01, 2038
 ------ -------------------- -------------------- -------------------- ------------------------------ --------------------------------------------------
ZBT000N-19:41:08 Closing connection to TapeTrack Server
ZBT000N-19:41:08 Session Statistics:
ZBT000N-19:41:08        Seconds Connected: 1
ZBT000N-19:41:08        Queries Completed: 34
ZBT000N-19:41:08               Bytes Sent: 3,544
ZBT000N-19:41:08           Bytes Received: 5,144
ZBT900N-19:41:08 Program Complete
ZBT901N-19:41:08 Elapsed time 0 minutes and 1 seconds
ZBT991N-19:41:08 CRC values for this session: 0xe7588cf9 (0x281f0d58)
ZBT992N-19:41:08 Number of records written: 85
ZBT993N-19:41:08 Number of bytes written: 5,258
ZBT999N-19:41:08 Program ended
cli/tmss10expirebydate.1506391894.txt.gz · Last modified: 2025/01/21 22:07 (external edit)