Differences

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

--- cli:tmss10batchslotallocation [2020/03/08 23:27] – created Scott Cunliffe
+++ cli:tmss10batchslotallocation [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== TMSS10BatchSlotAllocation ======
-TMSS10BatchSlotAllocation exports and imports Slot Allocation information using JSON file structure.
+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]''
+''TMSS10BatchSlotAllocation -C [customer-id] -M [media-id] -R [repository-id] \\ -S [logon string] -c [config file] -i [import]''
+{{page>cli:fi}}
+===== Options =====
+  * ''-C'' Customer-ID filter.
+  * ''-M'' Media-ID filter.
+  * ''-R'' Repository-ID filter.
+  * ''-S'' The Logon string argument sets the [[cli:server_argument|Server Logon Information]]
+  * ''-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.
+  * ''-i'' Import (otherwise export) default = false (export)
+<note important>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.</note>
+==== 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.
+==== Files ====
+**stdout:** Output Reports. \\
+**stderr:** Diagnostic messages. \\
+**stdin:** Program input.
+===== Example =====
+Export current [[object:volume|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 [[object:volume|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
+[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10BatchSlotAllocation]
+<--
+<- ^ cli:introduction|Command Line Utilities^ ->