TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools


cli:tmss10modifyflags
 
 

TMSS10ModifyFlags

TMSS10ModifyFlags adds and removes editable Flags through the Command Line interface.

Synopsis

TMSS10ModifyFlags [-F new flags] [-S logon string] [-V volume filter] [-c configuration file]

Options

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.

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

  1. zero Program has ended successfully.
  2. 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     
 ------ -------------------- -------------------------------- -------------------------------- --------------
      1 US04.LTO.000005L6    CnNOtZ                           CEnNOtZ                          Request OK   
      2 US04.LTO.000006L5    CnNOt                            CEnNOt                           Request OK 
      3 US04.LTO.000006L6    CnNOt                            CEnNOt                           Request OK  
      4 US04.LTO.000007L5    CnNOt                            CEnNOt                           Request OK 
      5 US04.LTO.000007L6    CMnNt                            CEMnNt                           Request OK 
      6 US04.LTO.000008L5    CMnNt                            CEMnNt                           Request OK   
      7 US04.LTO.000009L5    CnNOt                            CEnNOt                           Request OK  
      8 US04.LTO.000009L6    CnNOt                            CEnNOt                           Request OK    
 ------ -------------------- -------------------------------- -------------------------------- --------------

Example

Use Flag values to add to Volumes (eg. E)
Prefix Flag values with ! to remove from Volumes (eg. !E)

To set the E (Encrypted) Flag on all LTO tapes:

TMSS10ModifyFlags -S tapemaster:-password@localhost -F "E" -V "*.LTO.*"

Removing the W (Warning) Flag from all Volumes in Customer-ID 1001.

TMSS10ModifyFlags -S tapemaster:-password@localhost -F "!W" -V "1001.*.*"
Changelog
2021-05-24Fixed bug when using TMSSLEVELNAME and TMSSNOLEVELSLOT variables (#127)
2020-11-24Added support for JSON output
2019-02-25Added support for HTML output
2019-02-09Added support for Excel output
2019-01-06Added return code list to end of all command line programs that use the TapeTrack API
2016-11-18Added fast forward code to reduce runtime
2016-11-18Enhanced argument parser to allow arguments in format *FI:filename that allows loading of arguments from a file
2016-04-07Changed server argument parser to allow colon in password to support z/OS DD name files
cli/tmss10modifyflags.txt · Last modified: 2022/05/31 01:03 by scunliffe