Differences

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

--- cli:tmss10assigncontainer [2017/11/13 17:15] – [Options] dcumming
+++ cli:tmss10assigncontainer [2025/12/16 01:43] (current) – [Example] Scott Cunliffe
@@ Line 1: / Line 1: @@
-===== TMSS10AssignContainer =====
+====== TMSS10AssignContainer ======
+TMSS10AssignContainer, using a configuration file, allocates [[object:volume|Volumes]] to a Container for storage or transportation.
 ===== Synopsis =====
@@ Line 6: / Line 7: @@
 ''TMSS10AssignContainer [-N Do not allocate when already in a container] [-S logon string] [-V volume filter] [-c Configuration file]''
-===== Description =====
+===== Options =====
-Using a configuration file volume are allocated or assigned to a container for storage or transportation.
+  * ''-N'' When true stops the allocation of a Container when the [[object:volume|Volume]] is already assigned to another Container.
+  * ''-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.
-===== Options =====
+{{page>cli:fi}}
-  * ''-N'' when true stops the allocation of a container when the volume is already assigned to another container.
+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 [[cli:server_argument|Server logon information]].
-  * ''-V''  [[cli:volume_filter|Volume Filter]] which can be used to filter the traversal of Customer, Media, Volume, repository and 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. 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"; };
@@ Line 25: / Line 26: @@
 ==== 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 Status ====
@@ Line 34: / Line 37: @@
 ==== Environment ====
-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: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]].
-TMSSAPILOGDIR If defined the program will write out a trace file to this directory.
+[[variable:tmssapilogdir|TMSSAPILOGDIR]] If defined the program will write out a trace file to this directory.
-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.
+[[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]].
-TMSSNOMD5 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.
+[[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 Windows Active Directory authentication. It should be noted that although the password is not being hashed, it is still encrypted during transmission.
 ==== Example ====
-<- cli:introduction|Command Line Utilities^ master:starting|Getting Started ^ ->
+Assigning Volumes from US01.LTO to containers US01.CONT
+<code plain;>
+TMSS10AssignContainer -S user:-pass@serveraddress -V US01.*.* -c map.cfg < volumelist.txt > container_assigned_US01.txt
+</code>
+==== Output ====
+ontainer_assigned_US01.txt
+<code plain;>
+ZBT001N-12:23:30 TMSS10AssignContainer (c) GazillaByte 1998-2025
+ZBT002N-12:23:30 Compiled Sep 11 2025 at 11:25:28
+ZBT010I-12:23:30 this program will assign Volumes to a Container
+ZBT006N-12:23:30 Running Under Microsoft Windows (10.0.26100.7309 Desktop)
+ZBT000N-12:23:30 Host is Little Endian
+ZBT000N-12:23:30 Host is ASCII
+ZBT000N-12:23:30 Binary is 64 bit
+ZBT000N-12:23:30 Current Working Directory is C:\Users\diffl\OneDrive\Desktop\temp\Assign Containers
+ZBT000N-12:23:30 Executing Module is C:\Program Files\TapeTrack\TapeTrack Server Utilities\bin\tapetrack\TMSS10AssignContainer.exe
+ZBT004N-12:23:30 Today is Tuesday, December 16, 2025
+ZBT005N-12:23:30 Running on GazillaByte
+ZBT006N-12:23:30 Process ID 1564
+ZBT000N-12:23:30 Parsing and validating command arguments
+ZBT001N-12:23:30 Server Interpreted as: Server(localhost) Port(5000) User(tapemaster) Password(******)
+ZBT002N-12:23:30 Program Options:
+ZBT002N-12:23:30 	(N) Do not allocate when already in a Container=false
+ZBT002N-12:23:30 	(S) Server=<VALUE HIDDEN>
+ZBT002N-12:23:30 	(V) Volume Filter=US01.*.*
+ZBT002N-12:23:30 	(c) Configuration File=map.cfg
+ZBT000N-12:23:30 Arguments parsed and validated with 0 errors
+ZBT000N-12:23:30 Reading Config File map.cfg
+ZBT000N-12:23:30 Checking for environment variable TMSSSERVERPROXY
+ZBT000N-12:23:30 Connection to server (127.0.0.1) successful
+ZBT000N-12:23:30 Logging on to TapeTrack Server
+ZBT000N-12:23:30 Registering Client at MACID(d8:43:ae:c7:0d:15:00:00) Result(Request OK)
+ZBT000N-12:23:30 Last Logon was at Tuesday, December 16, 2025 - 12:21:09 from 127.0.0.1 (kubernetes.docker.internal)
+ZBT000N-12:23:30 Welcome to Server: Free License
+ZBT000I-12:23:30 Initializaing Attribute Control: Index[0]
+ZBT001N-12:23:30 Volume filter interpreted as: Customer(US01) Media(*) Volume(*) Repository(*) Flags()
+ZBT000N-12:23:30 Listing Customers
+ZBT000N-12:23:30 Customer List successful: Customers(3) Excluded(0)
+ZBT000N-12:23:30 Processing Customer: US01-London (6/3)
+ZBT000N-12:23:30 Listing Media
+ZBT000N-12:23:30 Media List successful: Media(2) Excluded(0)
+ZBT000N-12:23:30 Processing Media: CONT-Container
+ZBT000N-12:23:30 Listing Volumes
+ZBT000N-12:23:30 Volume List successful: Volumes(3) Excluded(0)
+ZBT000N-12:23:30 Processing Media: LTO-LTO Cartridge
+ZBT000N-12:23:30 Listing Volumes
+ZBT000N-12:23:30 Volume List successful: Volumes(3) Excluded(0)
+ZBT000N-12:23:30 Allocating Containers for 3 Volumes
+ZBT000I-12:23:30 Refreshing Container Cache
+ZBT000N-12:23:30 Container Cache refreshed with 3 entries
+ZBT000N-12:23:30 Found 6 free slots across 3 Containers
+ZBT000N-12:23:30 Assigning Volume-ID(US01.LTO.003100L6) to Container(US01.CONT.CONT102)
+ZBT000N-12:23:30 Volume (US01.LTO.003100L6) updated OK
+ZBT000N-12:23:30 Assigning Volume-ID(US01.LTO.002100L6) to Container(US01.CONT.CONT102)
+ZBT000N-12:23:30 Volume (US01.LTO.002100L6) updated OK
+ZBT000N-12:23:30 Assigning Volume-ID(US01.LTO.001100L6) to Container(US01.CONT.CONT101)
+ZBT000N-12:23:30 Volume (US01.LTO.001100L6) updated OK
+ZBT000N-12:23:30 Closing connection to TapeTrack Server
+ZBT000N-12:23:30 Session Statistics:
+ZBT000N-12:23:30 	Seconds Connected: 0
+ZBT000N-12:23:30 	Queries Completed: 17
+ZBT000N-12:23:30 	       Bytes Sent: 1,244
+ZBT000N-12:23:30 	   Bytes Received: 2,348
+ZBT000N-12:23:30 -
+ZBT000N-12:23:30 Return Code Statistics ------------------------------------------------
+ZBT000N-12:23:30 Message                                                           Total
+ZBT000N-12:23:30 Request OK                                                           17
+ZBT000N-12:23:30 -----------------------------------------------------------------------
+ZBT000N-12:23:30 -
+ZBT900N-12:23:30 Program Complete
+ZBT901N-12:23:30 Elapsed time 0 minutes and 0 seconds
+ZBT000N-12:23:30 Total Read Operations 4 (189 bytes)
+ZBT000N-12:23:30 Total Write Operations 65 (3,932 bytes)
+ZBT991N-12:23:30 CRC values for this session: 0x1d4d603f (0x222bbf5b)
+ZBT992N-12:23:30 Number of records written: 66
+ZBT993N-12:23:30 Number of bytes written: 3,818
+ZBT999N-12:23:30 Program ended with RC=0 (Success)
+</code>
+===== See Also=====
+[[technote/command_line_diagnosis|Command Line Utility Troubleshooting and Diagnosis]]
+--> Changelog
+[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10AssignContainer]
+<--
+<- ^ cli:introduction|Command Line Utilities^ ->
+{{tag>update_doco cli container}}