The IBM TS3310 Command Line Interface (CLI) program can be used to access the TS3310 library from a CLI. This is in addition to the TS3310’s Web User Interface
The IBM TS3310 CLI provides the ability to access library functions through a command line interface. All view commands create a comma-separated value (csv) style output. The output is directed to the command prompt window by default, but can also be redirected to a file. To redirect the output to a file, you can add "> output_filename" to the end of the command.
In order to use the TS3310 Tape Library CLI, the following prerequisites apply:
- The TS3310 Tape Library must be at a firmware level 587G.GS003 (or higher)
- Java 5.0 or later must be installed
Cartridge movement using the TS3310 CLI is generally performed based on the current cartridge location:
- Moving to storage
- If currently in drive, use either unloadDrive or unloadAllDrives
- Moving to I/O
- If currently in storage, then use removeDataCartridges
Description: Assigns multiple cartridges at the same time instead of 1 at a time
Description: Downloads the library log file directly to the local directory
Description: Cleans a drive at the given location, designated by enclosure and row.
Description: Assigns data cartridges to a logical library
Description: Removes the data cartridges (cartridges moved to the IO station)
Description: Removes all expired cleaning cartridges
Description: Power cycle the drive at the given location, designated by enclosure and row
Description: Restarts the tape library
Description: Powers down the tape library
Description: Unloads all full drives
Description: Unloads a cartridge from a specific drive, designated by enclosure and row.
Description: Displays version information about the TS3310 CLI
Description: Views all cleaning cartridges
Description: Views all data cartridges
Description: Views the drive VPD information and firmware levels
Description: Views the drive summary
Description: Views the fibre channel settings
Description: Views the I/O station
Description: Views the library VPD information and firmware level
Description: View logged in users
Description: Views the logical library settings
Description: View operator interventions for all states
Description: Views the physical library system summary
Description: Views all of the user IDs, and roles
The following CLI parameters are supported.
-? : Shows help
- : -Action, REQUIRED
-a : Tape library DNS name or ip address, REQUIRED
-d : Turns on extra debug tracing and stores in local file named "TS3310CLI.log" accordingly (used for problem determination)
-e : Specified enclosure #
-h : Shows help
-p : TS3310 Password, REQUIRED
-r : Drive row #
-t : Sets timeout value in milliseconds (default is to never timeout which may cause CLI to appear hung)
-u : Tape Library User ID, REQUIRED
-v or –verbose : The default mode for the CLI is “quiet”. In quiet mode, progress messages are not included in the output. When the –v or --verbose parameters is added, the progress messages are included in the output. When using the CLI with scripting, you probably will not want the progress messages included in the output
The TS3310 CLI tool is provided on an "as is" basis, without warranties or conditions of any kind.
The TS3310 CLI is licensed under the IBM License Agreement for Machine Code
(IBM TS3310 CLI License (pdf) see below). Your use of this code indicates your acceptance of that agreement.
DOWNLOAD TERMS & CONDITIONS:
AS A PRECONDITION TO DOWNLOADING THE PROGRAM CODE, SAMPLES, UPDATES, AND FIXES ("CODE") BELOW, YOU MUST AGREE THAT (1) THE CODE IS SUBJECT TO THE TERMS OF THE LICENSE AGREEMENT WHICH ACCOMPANIED, OR IS CONTAINED IN, THE PROGRAM FOR WHICH YOU ARE OBTAINING THE CODE AND (2) YOU READ AND ACCEPTED THOSE TERMS WHEN YOU OBTAINED THE PROGRAM. YOU ARE NOT AUTHORIZED TO INSTALL OR USE THE CODE, EXCEPT AS PART OF A PROGRAM FOR WHICH YOU HAVE A VALID PROOF OF ENTITLEMENT. SUBJECT TO ANY STATUTORY WARRANTIES THAT CANNOT BY LAW BE EXCLUDED, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT, REGARDING THE CODE OR TECHNICAL SUPPORT PROVIDED IN CONNECTION WITH THE CODE, IF ANY.
BY CLICKING ON THE LINKS BELOW, YOU INDICATE YOUR ACCEPTANCE OF THESE TERMS & CONDITIONS.
TS3310 CLI Downloads
|Platform Open Systems Version Independent
Byte Size 1018750
Date 14 Oct 2014
|IBM TS3310 CLI Instructions
IBM TS3310 CLI License
|IBM TS3310 CLI||FTP|