TapeTrack Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== TMSS10Confirm ======

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 =====

''TMSS10Confirm [-S logon string] [-V volume filter] [-c config file] [-C current] [-T target] [-o confirm on container]''

===== Options =====

  * ''-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.
  *''-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 = 
{ 
	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'' A filter value for the Volume's Current Repository.

{{page>cli:fi}}
===== Notes =====

To confirm a list of [[object:volume|Volumes]] you can use the scanfile option within a Configuration file passed with the ''-c'' argument.

==== 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 Statuses ====

  - **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 being encrypted during transmission.

==== Files ====

**stdout:** Output Reports. \\
**stderr:** Diagnostic messages. \\
**stdin:** Program input.


==== Example ====

=== Command line syntax ===

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>

=== Output ===

<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
ZBT006N-12:53:25 Running Under Windows 10 (build 14393 10.00) on platform x64
ZBT000N-12:53:25 Host is Little Endian
ZBT000N-12:53:25 Host is ASCII
ZBT000N-12:53:25 Binary is 64 bit
ZBT000N-12:53:25 Current Working Directory is C:\WINDOWS\system32
ZBT004N-12:53:25 Today is Tuesday, March 07, 2017
ZBT005N-12:53:25 Running on local
ZBT006N-12:53:25 Process ID 10068
ZBT000N-12:53:25 Parsing and validating command arguments
ZBT001N-12:53:25 Server Interpreted as: Server(*********) Port(5000) User(******) Password(******)
ZBT002N-12:53:25 Program Options:
ZBT002N-12:53:25        (C) Current Repository Filter=LIBR
ZBT002N-12:53:25        (S) Server=<VALUE HIDDEN>
ZBT002N-12:53:25        (T) Target Repository Filter=OFFS
ZBT002N-12:53:25        (V) Volume Filter=US01.LTO.00000?L6
ZBT002N-12:53:25        (c) Configuration File=
ZBT002N-12:53:25        (o) Only confirm if assigned container is confirmed into same location=false
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 successful
ZBT000N-12:53:27 Logging on to TapeTrack Server
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 
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()
ZBT000N-12:53:27 Listing Customers
ZBT000N-12:53:27 Customer List successful: Customers(6) Excluded(0)
ZBT000N-12:53:27 Processing Customer: US01-New York Data Center (2278/29)
ZBT000N-12:53:27 Listing Media
ZBT000N-12:53:28 Media List successful: Media(2) Excluded(0)
ZBT000N-12:53:28 Processing Media: LTO-LTO Cartridge
ZBT000N-12:53:28 Listing Volumes
ZBT000N-12:53:28 Volume List successful: Volumes(27) Excluded(182)
ZBT000N-12:53:28 Considering candidate volume 000001L6
ZBT000N-12:53:28 Confirming volume: 000001L6
ZBT000N-12:53:28 Volume (US01.LTO.000001L6) updated OK
ZBT000N-12:53:28 Considering candidate volume 000002L6
ZBT000N-12:53:28 Confirming volume: 000002L6
ZBT000N-12:53:29 Volume (US01.LTO.000002L6) updated OK
ZBT000N-12:53:29 Considering candidate volume 000003L6
ZBT000N-12:53:29 Confirming volume: 000003L6
ZBT000N-12:53:29 Volume (US01.LTO.000003L6) updated OK
ZBT000N-12:53:30 Closing connection to TapeTrack Server
ZBT000N-12:53:30 Session Statistics:
ZBT000N-12:53:30        Seconds Connected: 3
ZBT000N-12:53:30        Queries Completed: 24
ZBT000N-12:53:30               Bytes Sent: 2,272
ZBT000N-12:53:30           Bytes Received: 3,712
ZBT900N-12:53:30 Program Complete
ZBT901N-12:53:30 Elapsed time 0 minutes and 5 seconds
ZBT991N-12:53:30 CRC values for this session: 0xd547cc35 (0xcddb20be)
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>


=== 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>

===== See Also=====

[[technote/command_line_diagnosis|Command Line Utility Troubleshooting and Diagnosis]]

--> Changelog

[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10Confirm]
<--
{{tag> update_doco}}

<- ^ cli:introduction|Command Line Utilities^ ->