TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:tmss10assigncontainer
 
 

TMSS10AssignContainer

TMSS10AssignContainer, using a configuration file, allocates Volumes to a Container for storage or transportation.

Synopsis

TMSS10AssignContainer [-N Do not allocate when already in a container] [-S logon string] [-V volume filter] [-c Configuration file]

Options

  • -N When true stops the allocation of a Container when the Volume is already assigned to another Container.
  • -S The Logon string argument sets the Server Logon Information.
  • -V 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.

If an argument value starts with the value FI:, the value for that attribute will be read from the file name specified immediately after it. For example, if a file named ACME_volumes has the content ACME_*.*, specifying FI:/etc/ACME_volumes will have the same effect as -V ACME.*.*. Using FI: to refer to a file for an attribute value works for all attributes.

If the pattern being matched starts with *LIST: then rather than matching the literal value, each record in the file specified as *LIST:filename will be tested. If one matches the match will succeed.

2021/06/16 02:14 · Scott Cunliffe

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"; };
}; 

Notes

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 Accessing Technical Support page.

Exit Status

  1. zero Program has ended successfully.
  2. non-zero Program has not ended successfully.

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.

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.

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

Assigning Volumes from US01.LTO to containers US01.CONT

TMSS10AssignContainer -S user:-pass@serveraddress -V US01.*.* -c map.cfg < volumelist.txt > container_assigned_US01.txt

Output

ontainer_assigned_US01.txt

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)

See Also

cli/tmss10assigncontainer.txt · Last modified: 2025/12/16 01:43 by Scott Cunliffe