TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • tmss10listusage • remove-volume-history • remove_volume_container_inventory • gui • journal_history • password • installing • tmss10inventory • warnings_and_oversight • container_add_volume_inventory
cli:tmss10movelist

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
cli:tmss10movelist [2017/06/07 22:29] – [Exit Status] Gerard Nicolcli:tmss10movelist [2025/07/04 04:41] (current) – [Examples] Scott Cunliffe
Line 1: Line 1:
 ====== TMSS10MoveList ====== ====== TMSS10MoveList ======
-This program produces a report of all Volumes that have a 'Move' status. +This program produces a report of all [[object:volume|Volumes]] that are in a Move Status. 
-====== Synopsis ====== +===== Synopsis ===== 
-''TMSS10MoveList [-S logonstring] [-V volumefilter] [-C option-C] [-T option-T] [-v] +''TMSS10MoveList [-S logonstring] [-V volume filter] [-C current repository] [-T target repository] [-v print virtual location] [-c configfile]'' 
-[-c configfile]'' +===== Description ===== 
-====== Description ======+''TMSS10MoveList'' produces a report listing all tape [[object:volume|Volumes]] that are in a "Move Status", i.e. they have a different Current and Target [[object:repository|Repository]]. 
 +===== Options ===== 
 +The options which apply to the TMSS10MoveList command are:
  
-TMSS10MoveList produces a report listing all tape Volumes that are in a "Move Status", i.e. they have a different Current and Target Repository. +  * ''-S'' The logonstring argument sets the Server logon information (see [[cli:server_argument|Command Line Server Argument]]). 
-====== Options ======+  * ''-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'' Current [[object:repository|Repository]] Filter. 
 +  * ''-T'' Target [[object:repository|Repository]] Filter. 
 +  * ''-v'' Print [[primer:virtual_physical_slot|Virtual Slot]] Locations (default = false). 
 +  * ''-c'' The config file argument specifies the path to the Batch Configuration File.
  
-The options which apply to the TMSS10MoveList command are:+{{page>cli:fi}} 
 +===== Notes =====
  
-  * ''-S'' The logonstring argument sets the Server logon information in the format +Moving Volumes List \\ 
-  * ''-V'' The volumefilter argument sets the Volume Filter which can be used to filter the traversal of Customer, Media and Volume values. +Report-ID: 102
-  * ''-C'' Current Repository Filter. +
-  * ''-T'' Target Repository Filter. +
-  * ''-v'' Print Virtual Locations. +
-  * ''-c'' The configfile argument specifies the path to the Batch Configuration File.+
  
-====== Exit Status ======+Moving Directions List \\ 
 +Report-ID: 103
  
 +===== Exit Status =====
   - **zero** Program has ended successfully.   - **zero** Program has ended successfully.
   - **non-zero** Program has not ended successfully.   - **non-zero** Program has not ended successfully.
-====== Environment ======+===== Environment ===== 
 +  * [[variable:tmssapilogdir|TMSSAPILOGDIR]]  
 +  * [[variable:tmssbeep|TMSSBEEP]]  
 +  * [[variable:tmssnomd5|TMSSNOMD5]]  
 +  * [[variable:tmsspwpath|TMSSPWPATH]]  
 +  * [[variable:tmssserverproxy|TMSSSERVERPROXY]]  
 +  * [[variable:tmssapilogdir|TMSSAPILOGDIR]] 
 + 
 +===== Files ===== 
 +  * ''stdout'' Output Reports. 
 +  * ''stderr'' Diagnostic messages. 
 +  * ''stdin'' Program input. 
 + 
 +===== Examples ===== 
 + 
 +=== Command line syntax === 
 + 
 +<code> 
 +TMSS10MoveList -S user:-password@server 
 +</code> 
 + 
 +=== Output === 
 + 
 +<code> 
 +             System: TapeTrack 
 +          Report ID: 102 
 + Report Description: Moving Volumes List 
 +       Report Notes: Customer(New York Data Center) Media Type(LTO Cartridge) 
 +    Production Time: Thursday, July 18, 2019 - 09:30:39 (AUS Eastern Standard Time) 
 +       Report Width: 190 bytes 
 + 
 + Seq.   Barcode              Current Location               Target Location                Move Time        Time            Container            Attribute 
 + ------ -------------------- ------------------------------ ------------------------------ ---------------- --------------- -------------------- -------------------------------------------- 
 + 
 +      1 US01.LTO.300300L5    Offsite Vault                  Library                        2019-07-18 09:04          M25:56 
 +      2 US01.LTO.500500L5    Offsite Vault                  Library                        2019-07-16 11:23     D1:22:07:38 
 +      3 US01.LTO.600600L5    Offsite Vault                  Library                        2019-07-16 11:23     D1:22:07:38 
 +      4 US01.LTO.100100L5    Library                        Offsite Vault                  2019-07-18 09:21           M9:03 
 +      5 US01.LTO.200200L5    Library                        Offsite Vault                  2019-07-18 09:21           M9:03 
 +      6 US01.LTO.900900L5    Library                        Offsite Vault                  2019-07-18 09:17          M12:42 
 + ------ -------------------- ------------------------------ ------------------------------ ---------------- --------------- -------------------- -------------------------------------------- 
 + 
 +             System: TapeTrack 
 +          Report ID: 103 
 + Report Description: Movement Directions Report 
 +       Report Notes: Customer(New York Data Center) Media Type(LTO Cartridge) 
 +    Production Time: Thursday, July 18, 2019 - 09:30:39 (AUS Eastern Standard Time) 
 +       Report Width: 54 bytes 
 + 
 + Current Repository   Target Repository    Total 
 + -------------------- -------------------- ---------- 
 + Library              Offsite Vault                 3 
 + Offsite Vault        Library                       3 
 + -------------------- -------------------- ---------- 
 +</code> 
 + 
 +---- 
 + 
 +Create a move list of all US01 LTO Scratch Volumes, with a custom report heading. 
 +Drop Movement Directions report (Report ID 103). 
 + 
 +=== Command line syntax === 
 + 
 +<code> 
 +set TMSS10REPORTS102=New York Data Center - LTO - Scratch Movement Report  
 +set TMSSDROPREPORT103=true 
 +TMSS10MoveList -S user:-password@server -V US01.LTO.*@*+Z 
 +</code> 
 + 
 +=== Output === 
 + 
 +<code> 
 +             System: TapeTrack 
 +          Report ID: 102 
 + Report Description: New York Data Center - LTO - Scratch Movement Report 
 +       Report Notes: Customer(New York Data Center) Media Type(LTO Cartridge) 
 +    Production Time: Thursday, July 18, 2019 - 09:30:39 (AUS Eastern Standard Time) 
 +       Report Width: 190 bytes 
 + 
 + Seq.   Barcode              Current Location               Target Location                Move Time        Time            Container            Attribute 
 + ------ -------------------- ------------------------------ ------------------------------ ---------------- --------------- -------------------- --------------------------------------------
  
-TMSSAPILOGDIR If defined the program will write out a trace file to this directory. +      1 US01.LTO.300300L5    Offsite Vault                  Library                        2019-07-18 09:04          M25:56 
-TMSSBEEP If defined the program will beep whenever an error occurs. +      2 US01.LTO.500500L5    Offsite Vault                  Library                        2019-07-16 11:23     D1:22:07:38 
-TMSSNOMD5 If defined the program will not MD5 hash passwords before sending them to the +      3 US01.LTO.600600L5    Offsite Vault                  Library                        2019-07-16 11:23     D1:22:07:38 
-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. +
-TMSSPWPATH When no password value is passed in the logon string the program will look for +
-the password in file \etc\tapetrack\user, 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. +
-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.+
  
-====== Files ======+</code>
  
-stdout Output Reports. +===== See Also=====
-stderr Diagnostic messages. +
-stdin Program input.+
  
-====== Examples ======+[[technote/command_line_diagnosis|Command Line Utility Troubleshooting and Diagnosis]]
  
-Example 1. TMSS10MoveList: ..... +--> Changelog 
-.....+
  
 +[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10MoveList]
 +<--
 +<- ^ cli:introduction|Command Line Utilities^ ->
  
cli/tmss10movelist.1496874581.txt.gz · Last modified: 2025/01/21 22:07 (external edit)