Differences

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

--- variable:tmsscmdstring [2019/04/12 14:37] – dcumming
+++ variable:tmsscmdstring [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== TMSSCMDSTRING ======
-The [[variable:start|environmental variable]] ''TMSSCMDSTRING'' changes the behavior of [[cli:introduction|Command Line Programs]] to take the value set in  ''TMSSCMDSTRING'' and write that string, along with the variables to stdout.
+The [[variable:start|Environmental Variable]] ''TMSSCMDSTRING'' changes the behavior of [[cli:introduction|Command Line Programs]] to take the value set in  ''TMSSCMDSTRING'' and write that string, along with the variables to stdout.
 This allows you to write commands automatically using the value ''TMSSCMDSTRING'' along with the values contained in the output from the [[cli:introduction|Command Line Programs]].
@@ Line 7: / Line 7: @@
 ===== Example =====
+Using [[cli:tmss10movelist|TMSS10MoveList]] output as an example, the standard output displays [[object:volume|Volume-ID]], Current and Target [[object:repository|Repositories]] as well as move times and attributes.
-{{tag>environmental_variables reports}}
+<code>
+             System: TapeTrack
+          Report ID: 102
+ Report Description: Moving Volumes List
+       Report Notes: Customer(New York Data Center) Media Type()
+    Production Time: Monday, April 20, 2020 - 12:35:59 (AUS Eastern Standard Time)
+       Report Width: 176 bytes
+ Seq.   Barcode              Current Location               Target Location                Move Time        Time            Container            Attribute
+ ------ -------------------- ------------------------------ ------------------------------ ---------------- --------------- -------------------- ------------------------------
+US01.LTO.210498L6    OFFS [28]                     Library                        2020-04-20 09:49        H2:46:48
+US01.LTO.210701L6    OFFS [37]                     Library                        2020-04-20 09:49        H2:46:48
+US01.LTO.210959L6    OFFS [43]                     Library                        2020-04-20 09:49        H2:46:48
+US01.LTO.211049L6    OFFS [46]                     Library                        2020-04-20 09:49        H2:46:48
+ ------ -------------------- ------------------------------ ------------------------------ ---------------- --------------- -------------------- ------------------------------
+ -------------------- -------------------- ----------
+             System: TapeTrack
+          Report ID: 103
+ Report Description: Movement Directions Report
+       Report Notes: Customer(New York Data Center) Media Type()
+    Production Time: Monday, April 20, 2020 - 12:35:59 (AUS Eastern Standard Time)
+       Report Width: 54 bytes
+ Current Repository   Target Repository    Total
+ -------------------- -------------------- ----------
+ ID(OFFS)             Library                       4
+ -------------------- -------------------- ----------
+</code>
+When the [[variable:start|Variable]] ''TMSSCMDSTRING'' is set before the execution of the [[cli:introduction|Command Line Utilities]] (in this example [[cli:tmss10movelist|TMSS10MoveList]]) it modifies the output from the standard report, to that of a custom string that can include output variables.
+Setting ''TMSSCMDSTRING'' to create an ejection script for a TSM instance, listing all [[object:volume|Volume-ID's]] that need to be ejected for processing and transport to the Vault.
+<code>
+set TMSSCMDSTRING=checkout libvol DC1_LIB0 $volume-id checklabel=yes remove=yes
+</code>
+When [[cli:tmss10movelist|TMSS10MoveList]] is executed, the output will print out the assigned string, exchanging the variable $volume-id with the current [[object:volume|Volume-ID]].
+The resulting output will now be:
+<code>
+checkout libvol DC1_LIB0 210498L6 checklabel=yes remove=yes
+checkout libvol DC1_LIB0 210701L6 checklabel=yes remove=yes
+checkout libvol DC1_LIB0 210959L6 checklabel=yes remove=yes
+checkout libvol DC1_LIB0 211049L6 checklabel=yes remove=yes
+</code>
+===== Variables =====
+Variables available include:
+  * $customer-id
+  * $media-id
+  * $volume-id
+{{tag>environmental_variables reports update_doco
+}}
 <-  ^ variable:start |Introduction ^ ->