Differences

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

--- cli:tmss10confirm [2017/08/15 14:16] – dcumming
+++ cli:tmss10confirm [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-===== TMSS10Confirm =====
+====== TMSS10Confirm ======
-Confirms selected tapes that are in a move status.
+TMSS10Confirm is used to confirm [[object:volume|Volumes]] that are moving from the Current [[object:repository|Repository]] to a Target [[object:repository|Repository]] . A range of filters can be passed to the program to ensure that only the required confirmations are performed.
-==== Synopsis ====
+===== Synopsis =====
-<code > TMSS10Confirm [-o] [-S logon string] [-V volume filter] [-c config file] [-C current] [-T target] </code>
+''TMSS10Confirm [-S logon string] [-V volume filter] [-c config file] [-C current] [-T target] [-o confirm on container]''
-==== Description ====
+===== Options =====
-TMSS10Confirm is used to confirm Volumes that are moving from the Current Repository to a Target Repository. A range of filters can be passed to the program to ensure that only the required confirmations are confirmed. The optional -o argument can also be used to only confirm Volumes where the Container they are assigned to is confirmed into the same Repository as the Volume's Target Repository.
+  * ''-S'' The 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.
-==== Options ====
+  *''-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. The following example will set the default [[object:customer|Customer-ID]] and [[object:media|Media-ID]] for all scanned Barcodes:<code> barcodes =
--S
-The logon string argument sets the Server logon information in the format user:password@server:port. In the event that this argument is not passed the default will be batch:batch@localhost:5000. By default the password value will be treated as the path to a file which contains a single record representing the password, rather than the password itself. If you wish the password value to be the literal password (rather than a file) the password should be prepended with a dash (fred:-fredspassword@server). You can also have the program read the password as the first record of stdin by prepending the password with a plus symbol (fred:+@server). In the event that the password is all upper case and 32 characters in length, the password will be considered an MD5 hash of the password and passed to the server without subsequent MD5 hashing.
--V
-The volume filter argument sets the Volume Filter which can be used to filter the traversal of Customer, Media and Volume values. The format of this filter is c.m.v@r, where c is Customer-ID filter, m is Media-ID filter, v is Volume-ID filter and r is Repository-ID filter. To process only volumes not in Repository ACME, "*.*.*@!(ACME).
--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. The following example will set the default Customer-ID and Media-ID for all scanned barcodes:
-barcodes =
 {
 	defaults={ customer-id="ACME"; media-id="LTO"; };
-};
+}; </code>
--o
-This argument confirms any Volume if the Volume is in a Container and the Container is confirmed already at the Volume's Target Repository.
--T
-A filter value for the Volume's Target Repository.
--C
+  * ''-o'' This argument confirms any Volume if the Volume is in a Container and the Container is confirmed already at the Volume's Target Repository.
+  * ''-T'' A filter value for the Volume's Target Repository.
+  * ''-C'' A filter value for the Volume's Current Repository.
-A filter value for the Volume's Current Repository.
+{{page>cli:fi}}
+===== Notes =====
-==== Notes ====
+To confirm a list of [[object:volume|Volumes]] you can use the scanfile option within a Configuration file passed with the ''-c'' argument.
-To confirm a list of Volumes you can use the scanfile option within a Config file passed with the -c argument.
+==== Technical Support ====
-=== Technical Support ===
+The TapeTrack Software is commercially supported by a full time help desk staff.
-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.
+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 ====
-zero:
+  - **zero** Program has ended successfully.
+  - **non-zero** Program has not ended successfully.
-Program has ended successfully.
+==== Environment ====
-non-zero:
+[[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]].
-Program has not ended successfully.
-==== Environment ====
+[[variable:tmssapilogdir|TMSSAPILOGDIR]] If defined the program will write out a trace file to this directory.
-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.
+[[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]].
-TMSSAPILOGDIR
+[[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 being encrypted during transmission.
-If defined the program will write out a trace file to this directory.
+==== Files ====
+**stdout:** Output Reports. \\
+**stderr:** Diagnostic messages. \\
+**stdin:** Program input.
-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.
+==== Example ====
+=== Command line syntax ===
-TMSSNOMD5
+To confirm all volumes for customer US01, media LTO and volume pattern matching 00000?L6 moving from LIBR to OFFS
+<code plain;>
+TMSS10Confirm -S user:-password@server -T "OFFS" -C "LIBR" -V "US01.LTO.00000?L6"
+</code>
-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.
+=== Output ===
-==== Example ====
-<code> C:\WINDOWS\system32>tmss10confirm -S user:-password@server -T "OFFS" -C "LIBR" -V "US01.LTO.00000?L6"
+<code plain;>
 ZBT001N-12:53:25 TMSS10Confirm (c) GazillaByte 1998-2017
 ZBT002N-12:53:25 Compiled Feb 24 2017 at 15:54:00
-ZBT010I-12:53:25 this program will confirm moving Volumes into their current Target Repository
+ZBT010I-12:53:25 This program will confirm moving Volumes into their current Target Repository
 ZBT006N-12:53:25 Running Under Windows 10 (build 14393 10.00) on platform x64
 ZBT000N-12:53:25 Host is Little Endian
@@ Line 110: / Line 90: @@
 ZBT000N-12:53:25 Arguments parsed and validated with 0 errors
 ZBT000N-12:53:25 Checking for environment variable TMSSSERVERPROXY
-ZBT000N-12:53:27 Connection to server (192.241.211.124) successful
+ZBT000N-12:53:27 Connection to server successful
 ZBT000N-12:53:27 Logging on to TapeTrack Server
-ZBT000N-12:53:27 Registering Client at MACID(00:8c:fa:8e:02:f5:00:00) Result(Request OK)
+ZBT000N-12:53:27 Registering Client at MACID Result(Request OK)
-ZBT000N-12:53:27 Last Logon was at Tuesday, March 07, 2017 - 12:51:33 from 173.95.189.31 (cpe-173-95-189-31.nc.res.rr.com)
+ZBT000N-12:53:27 Last Logon was at Tuesday, March 07, 2017 - 12:51:33
 ZBT000N-12:53:27 Welcome to Server: TapeTrack
 ZBT001N-12:53:27 Volume filter interpreted as: Customer(US01) Media(LTO) Volume(00000?L6) Repository(*) Flags()
@@ Line 144: / Line 124: @@
 ZBT992N-12:53:30 Number of records written: 71
 ZBT993N-12:53:30 Number of bytes written: 3,887
-ZBT999N-12:53:30 Program ended </code>
+ZBT999N-12:53:30 Program ended
-==== Files ====
+</code>
-stdout:
-Output Reports.
+=== Command line syntax ===
+To confirm all volumes moving from LIBR to OFFS with the exception of Customer-ID US01
+<code plain;>
+TMSS10Confirm -S user:-password@server -T "OFFS" -C "LIBR" -V "!(US01).*.*"
+</code>
-stderr:
+--> Changelog
-Diagnostic messages.
+[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10Confirm]
+<--
+{{tag> update_doco}}
-stdin: Program input.
+<- ^ cli:introduction|Command Line Utilities^ ->