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
-CCustomer-ID filter.-MMedia-ID filter.-RRepository-ID filter.-SThe Logon string argument sets the Server Logon Information-cThe config file argument specifies the path to the Batch Configuration File. The Batch Configuration File allows you to perform advanced traversal of Customer, Media and 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.-iImport (otherwise export) default = false (export)
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-24 Fixed bug when using TMSSLEVELNAME and TMSSNOLEVELSLOT variables (#127) 2020-11-24 Added support for JSON output 2020-03-16 Added fast forward code to reduce runtime 2020-03-16 Added return code list to end of all command line programs that use the TapeTrack API 2020-03-16 Changed server argument parser to allow colon in password to support z/OS DD name files 2020-03-16 Added support for Excel output 2020-03-16 Added support for HTML output