====== TMSS10ExpireByDate ====== TMS10ExpirebyDate searches the [[object:volume|Volumes]] and adds a Move Pending [[common:volume_flags|Flag]] (''p'') to all [[object:volume|Volumes]] that match the [[object:volume|Volume]] and Date Range filters. ===== 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]'' ===== Options ===== TMSS10ExpireByDate command options: * ''-O'' Expiry date range offset file location * ''-R'' Expiry date range * ''-S'' Logon string argument sets the [[cli:server_argument|Server Logon Information]]. * ''-V'' [[cli:volume_filter|Volume Filter]] which can be used to filter the traversal of [[object:customer|Customer]], [[object:media|Media]], [[object:volume|Volume]], [[object:repository|Repository]] and [[common:volume_flags|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 [[object:customer|Customer]], [[object:media|Media]] and [[object:volume|Volumes]], perform advanced Barcode pre and post processing and route the program output to syslogd. * ''-f'' Forces expiry * ''-r'' Target [[object:repository|Repository]] * ''-t'' Test mode, **true** performs task without applying updates {{page>cli:fi}} ===== 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 [[common:support_details|Accessing Technical Support]] page ===== Exit Status ===== - **zero** Program has ended successfully. - **non-zero** Program has not ended successfully. ===== Environment ===== [[variable:tmssserverproxy|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 [[variable:tmssapilogdir|TMSSAPILOGDIR]]. [[variable:tmssapilogdir|TMSSAPILOGDIR]] If defined the program will write out a trace file to this directory. [[variable:tmsspwpath|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 [[variable:tmsspwpath|TMSSPWPATH]]. [[variable:tmssnomd5|TMSSNOMD5]] If defined the program will not MD5 hash passwords before sending them to the TapeTrack Server. This is required when relying on [[https://en.wikipedia.org/wiki/Active_Directory|Windows Active Directory]] authentication. It should be noted that although the password is not being hashed, it is still encrypted during transmission. ===== Examples ===== ==== Command Line Syntax ==== TMSS10ExpireByDate -S username:-password@localhost -V "US01.*.*" -R "*-5:*" ==== Output ==== 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 ZT000N-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=