Table of Contents

TMSS10BatchSlotAllocation

TMSS10BatchSlotAllocation exports to file via stdout and imports Slot Allocation information via stdin.

Synopsis

TMSS10BatchSlotAllocation -C [customer-id] -M [media-id] -R [repository-id]
-S [logon string] -c [config file] -i [import]

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.

Options

Volumes must exist and be in the correct Repositories if using TMSS10BatchSlotAllocation to update Slot information as it will not add new Volumes or move them.

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 Statuses

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

Files

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

Example

Export current Volume Slot information to file current_slot.txt for Customer-ID US01, Media-ID LTO and Repository-ID OFFS.

TMSS10BatchSlotAllocation -S username:-password@serveraddress -C "US01" -M "LTO" -R "OFFS" > current_slot.txt 

Import Volume Slot information from file current_slot.txt for Customer-ID US01, Media-ID LTO and Repository-ID OFFS.

TMSS10BatchSlotAllocation -S username:-password@serveraddress -C "US01" -M "LTO" -R "OFFS" -i < current_slot.txt 

Sample File

{
"metadata":	{
	"creation_time":	"Monday, March 09, 2020 - 11:38:57 (AUS Eastern Daylight Time)",
	"genderator":	"TMSS10BatchSlotAllocation",
	"genderator_build":	"Mar  8 2020",
	"creation_host":	"GazillaByte"
},
"repository":	{
	"id":	"OFFS",
	"description":	"Offsite Vault",
	"slots":	10,
	"capacity":	0,
	"capacity_used":	4,
	"zones":	[{
			"zone":	"One",
			"description":	"Zone One",
			"slot_start":	1,
			"slot_end":	10
		}]
},
"volumes":	[{
		"id":	"100100L4",
		"source":	"LIBR",
		"slot":	1
	}, {
		"id":	"100101L4",
		"source":	"LIBR",
		"slot":	4
	}, {
		"id":	"100103L4",
		"slot":	2
	}, {
		"id":	"100104L4"
	}, {
		"id":	"100105L4",
		"target":	"LIBR",
		"slot":	6
	}, {
		"id":	"100106L4",
		"target":	"LIBR"
	}]
}
Changelog
2021-05-24Fixed bug when using TMSSLEVELNAME and TMSSNOLEVELSLOT variables (#127)
2020-11-24Added support for JSON output
2020-03-16Added fast forward code to reduce runtime
2020-03-16Added return code list to end of all command line programs that use the TapeTrack API
2020-03-16Changed server argument parser to allow colon in password to support z/OS DD name files
2020-03-16Added support for Excel output
2020-03-16Added support for HTML output