Differences

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

--- cli:tmss10modifyflags [2017/10/06 20:18] – created dcumming
+++ cli:tmss10modifyflags [2025/07/04 04:47] (current) – [Example] Scott Cunliffe
@@ Line 1: / Line 1: @@
-The program for changing flags in batch is TMSS10ModifyFlags.
+====== TMSS10ModifyFlags ======
-<code>
-ZBT001N-10:13:47 TMSS10ModifyFlags (c) GazillaByte 1998-2016
+TMSS10ModifyFlags adds and removes editable [[:common:volume_flags|Flags]] through the Command Line interface.
-ZBT002N-10:13:47 Compiled Apr  6 2016 at 10:08:49
-ZBT010I-10:13:47 this program allows you to set or unset volume flags
-ZBT006N-10:13:47 Running Under Windows 10 (build 10586 10.00) on platform x64
-ZBT000N-10:13:47 Host is Little Endian
-ZBT000N-10:13:47 Host is ASCII
-ZBT000N-10:13:47 Binary is 64 bit
-ZBT000N-10:13:47 Current Working Directory is R:\bin\Win64
-ZBT004N-10:13:47 Today is Wednesday, April 06, 2016
-ZBT005N-10:13:47 Running on Gerard-Surface
-ZBT006N-10:13:47 Process ID 13488
-ZBT000N-10:13:47 Parsing and validating command arguments
-ZBT000E-10:13:47 Value for argument -F is blank and a value is required
-ZBT002N-10:13:47 Program Options:
-ZBT002E-10:13:47        (F) New Flags=
-ZBT002N-10:13:47        (S) Server=batch@127.0.0.1:5000
-ZBT002N-10:13:47        (V) Volume Filter=*.*.*
-ZBT002N-10:13:47        (c) Configuration File=
-ZBT000E-10:13:47 Arguments parsed and validated with 1 errors
-</code>
-You will need the -F argument to tell it what flags to add/remove and the -S argument to point to your server.
-So, to remove the Warning flag (W) you would use:
+===== Synopsis =====
-TMSS10ModifyFlags -S tapemaster:-password@localhost -F "!W"
+''TMSS10ModifyFlags [-F new flags] [-S logon string] [-V volume filter] [-c configuration file]''
-Don't forget to substitute your password for the password value.
-A ! means remove the flag. Without an ! it will be added.
+===== Options =====
-So to set the encrypted flag on all LTO tapes:
+  * ''-F'' Adds or removes [[common:volume_flags|Flags]] from [[object:volume|Volumes]].
+  * ''-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.
-TMSS10ModifyFlags -S tapemaster:-password@localhost -F "E" -V "*.LTO.*"
+{{page>cli:fi}}
+==== 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. \\
+===== Example =====
+=== Command line syntax ===
+  TMSS10ModifyFlags -S user:-password@server -V "*US04.LTO.*@OFFS" -F "E"
+=== Output ===
+              System: TapeTrack
+  Report Description: Flag Modification Report
+     Production Time: Friday, April 20, 2018 - 09:43:19 (AUS Eastern Standard Time)
+        Report Width: 156 bytes
+   Seq.   Barcode              Old Flags                        New Flags                        Message
+   ------ -------------------- -------------------------------- -------------------------------- --------------
+US04.LTO.000005L6    CnNOtZ                           CEnNOtZ                          Request OK
+US04.LTO.000006L5    CnNOt                            CEnNOt                           Request OK
+US04.LTO.000006L6    CnNOt                            CEnNOt                           Request OK
+US04.LTO.000007L5    CnNOt                            CEnNOt                           Request OK
+US04.LTO.000007L6    CMnNt                            CEMnNt                           Request OK
+US04.LTO.000008L5    CMnNt                            CEMnNt                           Request OK
+US04.LTO.000009L5    CnNOt                            CEnNOt                           Request OK
+US04.LTO.000009L6    CnNOt                            CEnNOt                           Request OK
+   ------ -------------------- -------------------------------- -------------------------------- --------------
+===== Example =====
+<note tip>Use [[common:volume_flags|Flag]] values to add to [[object:volume|Volumes]] (eg. E)  \\
+Prefix [[common:volume_flags|Flag]] values with **!** to remove from [[object:volume|Volumes]] (eg. !E)</note>
+To set the ''E'' (Encrypted) [[common:volume_flags|Flag]] on all LTO tapes:
+  TMSS10ModifyFlags -S tapemaster:-password@localhost -F "E" -V "*.LTO.*"
+Removing the W (Warning) [[common:volume_flags|Flag]] from all [[object:volume|Volumes]] in Customer-ID 1001.
+  TMSS10ModifyFlags -S tapemaster:-password@localhost -F "!W" -V "1001.*.*"
+===== See Also=====
+[[technote/command_line_diagnosis|Command Line Utility Troubleshooting and Diagnosis]]
+--> Changelog
+[filterrss http://www.tapetrack.com/cgi/changelog.cgi?module=TMSS10ModifyFlags]
+<--
+<- ^ cli:introduction|Command Line Utilities^ ->