Differences

This shows you the differences between two versions of the page.

--- cli:tmss10expirebydate [2017/09/20 08:55] – [Options] Scott Cunliffe
+++ cli:tmss10expirebydate [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-===== TMSS10ExpireByDate =====
+====== TMSS10ExpireByDate ======
-Locates Volumes with a Move Date of today or greater and adds a **Move Pending [[common:volume_flags|Flag]]**.
+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]''
-===== Description =====
 ===== Options =====
@@ Line 14: / Line 12: @@
 TMSS10ExpireByDate command options:
-  * ''-S'' The logon string argument sets the Server logon information (see [[cli:server_argument|Command Line Server Argument]]).
+  * ''-O'' Expiry date range offset file location
-  * ''-V'' The volume filter argument sets the Volume Filter which can be used to filter the traversal of Customer, Media and Volume values.
+  * ''-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.
@@ Line 24: / Line 39: @@
 ===== 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=<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
+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
+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
+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
+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
+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
+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
+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
+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
+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
+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
+--> Changelog
+[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10ExpireByDate]
+<--
+<- ^ cli:introduction|Command Line Utilities^ ->