TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • reports • tmsspdforientation • tmsslevelnames • data_cluster • db_hotbackup
cli:tmss10librarymanager

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:tmss10librarymanager [2018/03/22 22:50] – [Example] Scott Cunliffecli:tmss10librarymanager [2025/01/21 22:07] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== TMSS10LibraryManager====== ====== TMSS10LibraryManager======
  
-===== Synopsis =====+TMSS10LibraryManager manages Scratch Volume levels within the Target Repository.
  
-''TMSS10LibraryManager [-C customer ID] [-M media ID] [-R repository ID] [-S logon string] [-T target repository] [-V volume filter] [-c configuration file] [-e volume ejection] [-f minimum free slots] [-s minimum scratch volumes]''+Metrics used to monitor Volume levels include Repository capacity, Volumes moving in and out of the Repository, minimum Scratch Volumes required, Repository Scratch levels, available Scratch Volumes from other Repositories and free slot requirements.
  
-===== Description =====+===== Synopsis =====
  
-TMSS10LibraryManager will synchronize one TapeTrack Server with another.+''TMSS10LibraryManager [-C Customer-ID] [-M Media-ID] [-R Repository-ID] [-S logon string] [-T target repository] [-V volume filter] [-c configuration file] [-e ejection filter] [-f minimum free slots] [-r repository scratch order] [-s minimum scratch volumes]''
  
 ===== Options ===== ===== Options =====
  
-  * ''-C'' Customer-ID +  * ''-C'' [[object:customer|Customer-ID]] 
-  * ''-M'' Media-ID  +  * ''-M'' [[object:media|Media-ID]]  
-  * ''-R'' Repository-ID  +  * ''-R'' [[object:repository|Repository-ID]]  
-  * ''-S'' The logon string argument sets the [[cli:server_argument|Server logon information]] +  * ''-S'' The Logon string argument sets the [[cli:server_argument|Server Logon Information]] 
-  * ''-T'' Target Repository +  * ''-T'' Target [[object:repository|Repository]] for Volumes if ejection is required to make room for minimum Scratch quantity.  If not specified, no Volumes will be ejected. 
-  * ''-V''  [[cli:volume_filter|Volume Filter]] which can be used to filter the traversal of Customer, Media, Volume, repository and flag values. +  * ''-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 Customer, Media and Volumes, perform advanced barcode pre and post processing and route program output to syslogd. Configuration File capabilities vary from program to program but the syntax remains the same. In the event that logic is not supported it will simply be ignored. +  * ''-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 program output to syslogd. Configuration File capabilities vary from program to program but the syntax remains the same. In the event that logic is not supported it will simply be ignored. 
-  * ''-e'' Volume ejection exclusion filter +  * ''-e'' [[object:volume|Volume]] ejection exclusion filter 
-  * ''-f'' Minimum free slots required in Repository (override) +  * ''-f'' Minimum free Slots required in [[object:repository|Repository]] ([[object:repository|Repository]] Properties override) 
-  * ''-s'' Minimum Scratch Volumes required in Repository+  * ''-r'' Repository Scratch Order override. syntax -r "RAC1=0;RAC2=30;RAC3=20" sets Scratch Rack priority to RAC2, then RAC3, excluding RAC1. 
 +  * ''-s'' Minimum Scratch [[object:volume|Volumes]] required in [[object:repository|Repository]] ([[object:repository|Repository]] Properties override) 
 + 
 +{{page>cli:fi}}
  
          
 ==== Technical Support ==== ==== 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.+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 Statuses ==== ==== Exit Statuses ====
Line 44: Line 49:
  
 === Command line syntax === === Command line syntax ===
-<code> 
-TMSS10LibraryManager -S user:-password@server -C US02 -M LTO -R LIBR 
  
-</code> +  TMSS10LibraryManager -S user:-password@server -C US02 -M LTO -R LIBR
-=== Output === +
-<code>+
  
-             System: TapeTrack 
- Report Description: Library Management Metrics 
-       Report Notes: Customer-ID(US04) Media-ID(LTO) Repository(Library) 
-    Production Time: Friday, March 23, 2018 - 09:46:36 (AUS Eastern Daylight Time) 
-       Report Width: 84 bytes 
  
- Metric                                                       Calculation  Count     +=== Output ===
- ------------------------------------------------------------ ------------ --------  +
- (a) Repository Capacity                                                          0  +
- (b) Volumes in Repository                                                        3  +
- (c) Volumes already incoming                                                     0  +
- (d) Volumes already outgoing                                                     0  +
- (e) Net total                                                (b+c-d)             3  +
- +
- (f) Volumes excluded from ejection                                               0  +
- +
- (g) Minimum Scratch Volumes required                                             6  +
- (h) Scratch Volumes already in Repository                                        0  +
- (i) Repository Scratch deficit                               (g-h)               6  +
- (j) Scratch availability (elsewhere)                                             8  +
- (k) Scratch surplus                                          (j-i)               2  +
- +
- (l) Minimum free slots required                                                  0  +
- (m) Pre-Scratch input free slots                             (a-e)              -3  +
- (n) Post-Scratch input free slots                            (n-i)              -9  +
- (o) Free slot deficit                                        (l-m-i)             9  +
- ------------------------------------------------------------ ------------ --------  +
- +
-             System: TapeTrack +
- Report Description: Candidate Volumes to be ejected from the Managed Repository +
-    Production Time: Friday, March 23, 2018 - 09:46:36 (AUS Eastern Daylight Time) +
-       Report Width: 74 bytes +
- +
- Seq.   Volume-ID  Current Repositry    Scan-In Time         Days   Move   +
- ------ ---------- -------------------- -------------------- ------ -----  +
-      1 000006L6   Library              2018-03-19 09:44:09       4 true   +
-      2 000001L3   Library              2018-03-19 09:45:56       4 true   +
-      3 000007L6   Library              2018-03-19 09:46:12       4 true   +
- ------ ---------- -------------------- -------------------- ------ -----  +
- +
-             System: TapeTrack +
- Report Description: Library Aging Report (Extract) +
-    Production Time: Friday, March 23, 2018 - 09:46:36 (AUS Eastern Daylight Time) +
-       Report Width: 39 bytes +
- +
- Age                            Count   +
- ------------------------------ ------  +
- 1 day or less                       0  +
- 2 days                              0  +
- 3 days                              0  +
- 4 days                              3  +
- 5 days                              0  +
- 6 days                              0  +
- 7 days                              0  +
- 2 weeks                             0  +
- 4 weeks                             0  +
- 3 months                            0  +
- 6 months                            0  +
- 1 year                              0  +
- 2 years                             0  +
- 3 years                             0  +
- 4 years                             0  +
- 5 years or more                     0  +
- ------------------------------ ------  +
- +
-             System: TapeTrack +
- Report Description: Candidate Volumes to be entered into the Managed Repository +
-    Production Time: Friday, March 23, 2018 - 09:46:36 (AUS Eastern Daylight Time) +
-       Report Width: 74 bytes +
- +
- Seq.   Volume-ID  Current Repositry    Scan-In Time         Days   Move   +
- ------ ---------- -------------------- -------------------- ------ -----  +
-      1 000012L5   Scratch Volumes      2018-03-23 09:37:15       0 true   +
-      2 000011L5   Scratch Volumes      2018-03-23 09:37:15       0 true   +
-      3 000013L5   Scratch Volumes      2018-03-23 09:37:16       0 true   +
-      4 000014L5   Scratch Volumes      2018-03-23 09:37:16       0 true   +
-      5 000010L6   Scratch Volumes      2018-03-23 09:38:22       0 true   +
-      6 000005L6   Scratch Volumes      2018-03-23 09:46:17       0 true   +
-      7 000004L6   Scratch Volumes      2018-03-23 09:46:17       0 false  +
-      8 000003L5   Scratch Volumes      2018-03-23 09:46:17       0 false  +
- ------ ---------- -------------------- -------------------- ------ -----  +
- +
-             System: TapeTrack +
- Report Description: Library Aging Report (Extract) +
-    Production Time: Friday, March 23, 2018 - 09:46:36 (AUS Eastern Daylight Time) +
-       Report Width: 39 bytes +
- +
- Age                            Count   +
- ------------------------------ ------  +
- 1 day or less                       8  +
- 2 days                              0  +
- 3 days                              0  +
- 4 days                              0  +
- 5 days                              0  +
- 6 days                              0  +
- 7 days                              0  +
- 2 weeks                             0  +
- 4 weeks                             0  +
- 3 months                            0  +
- 6 months                            0  +
- 1 year                              0  +
- 2 years                             0  +
- 3 years                             0  +
- 4 years                             0  +
- 5 years or more                     0  +
- ------------------------------ ------  +
- +
-             System: TapeTrack +
- Report Description: Library Move Report +
-       Report Notes: Moving to Repository Library +
-    Production Time: Friday, March 23, 2018 - 09:46:36 (AUS Eastern Daylight Time) +
-       Report Width: 120 bytes+
  
- Seq.   Volume-ID  Message                                                                                      +The output of the TapeTrack Library Manager program is described in detail on the page [[reports:library_manager|Library Management Report]] 
- ------ ---------- ----------------------------------------------------------------------------------------------- +
-      1 000012L5   Request OK                                                                            +
-      2 000011L5   Request OK                                                                                +
-      3 000013L5   Request OK                                                                               +
-      4 000014L5   Request OK                                                                             +
-      5 000010L6   Request OK                                                                                 +
-      6 000005L6   Request OK                                                                                +
- ------ ---------- -----------------------------------------------------------------------------------------------+
  
 +==== See Also ====
  
-</code>+[[cookbook:library_manager|Implementing TMSS10LibraryManager]]
  
 +--> Changelog
  
-<- cli:introduction|Command Line Utilities^ master:starting|Getting Started ^ ->+[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10LibraryManager] 
 +<-- 
 +<- ^ cli:introduction|Command Line Utilities^ ->
cli/tmss10librarymanager.1521759029.txt.gz · Last modified: 2025/01/21 22:07 (external edit)