TS3310 Command Line Interface

Downloadable files


Abstract

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

Download Description

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:
  1. Moving to storage
    • If currently in drive, use either unloadDrive or unloadAllDrives
  2. Moving to I/O
    • If currently in storage, then use removeDataCartridges

Supported Actions

-bulkMoveCartridgesToAnotherLogicalLibrary
Description: Assigns multiple cartridges at the same time instead of 1 at a time

-cleanDrive
Description: Cleans a drive at the given location, designated by enclosure and row.

-moveCartridgesToAnotherLogicalLibrary
Description: Assigns data cartridges to a logical library

-removeDataCartridges
Description: Removes the data cartridges (cartridges moved to the IO station)

-removeExpiredCleaningCartridges
Description: Removes all expired cleaning cartridges

-resetDrive
Description: Power cycle the drive at the given location, designated by enclosure and row.

-unloadAllDrives
Description: Unloads all full drives

-unloadDrive
Description: Unloads a cartridge from a specific drive, designated by enclosure and row.

-version
Description: Displays version information about the TS3310 CLI

-viewCleaningCartridges
Description: Views all cleaning cartridges

-viewDataCartridges
Description: Views all data cartridges

-viewDriveFirmwareLevels
Description: Views the drive VPD information and firmware levels

-viewDriveSummary
Description: Views the drive summary

-viewFibreChannelPorts
Description: Views the fibre channel settings

-viewIOStation
Description: Views the I/O station

-viewLibraryFirmwareLevel
Description: Views the library VPD information and firmware level

-viewLoggedInUsers
Description: View logged in users

-viewLogicalLibraries
Description: Views the logical library settings

-viewOperatorInterventions
Description: View operator interventions for all states

-viewSystemSummary
Description: Views the physical library system summary


Command Parameters

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

Download package

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

DESCRIPTION DOCUMENTATION LABEL Download Options
Platform Open Systems Version Independent
English
Byte Size 651623
Date 30 Jan 2013

IBM TS3310 CLI Instructions

IBM TS3310 CLI License
IBM TS3310 CLI FTP

Rate this page:

(0 users)Average rating

Document information


More support for:

Tape Libraries

Version:

Version Independent

Operating system(s):

AIX, Linux, Open Systems, UNIX, Windows

Reference #:

S4000981

Modified date:

2011-09-26

Translate my page

Machine Translation

Content navigation