TSM cheat sheet

TSM cheat sheet

The syntax for TSM commands is a verb followed by an object, which is then usually followed by flags and conditions (both required and optional). The commands do not have to be typed out completely; if you type the capitalized portions of the commands listed below, that is sufficient to run the command. For example, the
Query STGpool
command can be typed as
q stg

[from a system prompt] dsmadmc
This opens the administrative command line interface to the TSM server. It can be run from any computer that has the administrative client loaded and has a configuration file (dsm.opt or dsm.sys) that contains pointers to a TSM server. On UNIX computers, the TSM client installation process paths the directory that contains dsmadmc; on Windows computers, you must cd to the proper directory (default: c:\program files\tivoli\tsm\baclient) before running this command. In order to view a ‘live’ window of the TSM activity log, use dsmadmc with this flag:
dsmadmc -console
Note that the directory that dsmadmc resides in is pathed for UNIX boxes, but it is not for Windows machines.

[from a web browser session] http://:1580
This opens the web-based administrative interface to the TSM server. It can be run from any computer that has a sufficiently recent version of a web browser. 1580 is the default TCP port used by TSM for web communication; it can be configured to any desired, non-reserved TCP port in the TSM server’s configuration file:
dsmserv.opt


Help
When you prefix 'help' to the beginning of any command, TSM will display the help file for that command. The help file contains an explanation of the command, its syntax, examples of the command, and related commands.


Help
When you type 'help' followed by a message ID found at the beginning of each activity log entry, you get an explanation of what the message ID refers, and other related information.


Query STGpool
This command will show a detailed list of all storage pools in the following format:

Storage Pool Name Device Class Name Est. capacity Pct Util Pct Migr High Mig Low Mig Next Pool
AOFFSITE2 IBM3590 1,220,636.0 0.5
ARCHPOOL2 IBM3590 1,220,636.0 0.5 1.0 85 70
ARDISK2 DISK 808.0 98.9 6.3 35 0 ARCHPOOL2
BUPOOL1 DISK 69,530.0 9.2 9.2 40 0 TAPEPOOL1
BUPOOL2 DISK 108,385.0 1.3 1.3 40 0 TAPEPOOL2
BUPOOL3 DISK 85,890.0 2.7 0.0 40 0 TAPEPOOL3
OFFSITE1 IBM3590 4,326,864.0 12.4


Query EVent
This command will list information concerning the results of scheduled events for both clients and administration. The syntax of the command for examining client backups for the current 24-hour time slice is

Query EVent * *

For examining the outcome of scheduled client events for other days is

Query EVent * * BEGINDate=MM/DD/YYYY

The output of the command appears in the following format:

Scheduled Start Actual Start Schedule Name Node Name Status
07/19/2001 00:00:00 07/19/2001 00:25:44 AM000 LAWSONP1 Completed
07/19/2001 00:00:00 07/19/2001 00:03:07 AM000 DOMINO1 Completed
07/19/2001 00:00:00 07/19/2001 00:47:31 AM000 LAWSOND1 Failed
07/19/2001 00:00:00 07/19/2001 00:11:45 AM000 BINC_MSN Completed
07/19/2001 00:00:00 07/19/2001 00:05:17 AM000 BINCDOM_BDC Missed
07/19/2001 00:00:00 07/19/2001 00:12:10 AM000 MSNLS8B Completed

Similarly, the command to show the success or failure of scheduled administrative events is

Query EVent * type=admin

'Missed' events never commenced. 'Failed' events began, but for some reason had a non-zero status returned at completion. 'Future' events have yet to occur in the time slice requested.


Query DB
This command will show the current state of the TSM internal database. The output shows:

Available Assigned Maximum Maximum Page Total Used Pct Max.
Space Capacity Extension Reduction Size Usable Pages Util Pct
(MB) (MB) (MB) (MB) (bytes) Pages Util
28,616 26,572 2,044 8,296 4,096 6,802,432 4,171,891 61.3 61.8


Query PRocess
This command will show currently running processes, such inventory expiration, library audits, data migration, etc.


Query SEssion
This command will show all currently connected clients. The output looks like this:

Sess Comm. Sess Wait Bytes Bytes Sess Platform Client Name
Number Method State Time Sent Recvd Type
48,449 Tcp/Ip Run 0 S 262.3 K 735 Admin WinNT ADMIN
48,535 Tcp/Ip MediaW 59 S 1.3 G 2.0 K Node Linux86 SWISSWEB


Query ACTlog
This command will show a listing of the TSM activity log. The default command will show the previous hour's worth of log entries. The syntax for specific blocks of time is

Query ACTlog BEGINDate=mm/dd/yyyy BEGINtime=hh:mm ENDDate=mm/dd/yyyy ENDTime=hh:mm


Query DRive
This command will show the existence and state of all tape drives defined within TSM. The output looks like this:

Library Name Drive Name Device Type Device On Line
IBM3494 DRIVE1 3590 /dev/rmt1 Yes
IBM3494 DRIVE2 3590 /dev/rmt2 Yes
IBM3494 DRIVE3 3590 /dev/rmt3 Yes
IBM3494 DRIVE4 3590 /dev/rmt4 Yes
IBM3494 DRIVE5 3590 /dev/rmt5 Yes
IBM3494 DRIVE6 3590 /dev/rmt6 Yes
MANUAL4MM IBM1 4MM /dev/mt7 Yes


Query LIBRary
This command will show the existence and state of all tape libraries defined within TSM. The output looks like this:

Library Name: IBM3494
Library Type: 349X
Device: /dev/alcatraz
Private Category: 300
Scratch Category: 301
External Manager:
Shared: No

Library Name: MANUAL4MM
Library Type: MANUAL
Device:
Private Category:
Scratch Category:
External Manager:
Shared: No


Query LIBVolume
This command will list the tape volumes currently contained in all tape libraries and recognized by TSM as either scratch or private tapes. The output looks like this:

Library Name Volume Name Status Owner Last Use Home Element
IBM3494 016001 Scratch
IBM3494 016002 Scratch
IBM3494 016003 Scratch
IBM3494 016004 Private Data
IBM3494 016005 Scratch
IBM3494 016006 Scratch
IBM3494 016007 Private Data
IBM3494 016008 Private Data
IBM3494 016009 Private Data
IBM3494 016011 Private Data
IBM3494 016013 Private DbBackup
IBM3494 016015 Private DbBackup


Query SYStem
This command will echo all server settings. This command generates quite a bit of information about the settings and configuration of the TSM server.


Query NODe
This command will echo back the names and other information concerning the clients that have been registered with the TSM server.


EXPIre Inventory
This command will purge the TSM database of all entries that have been deleted due to retention rule enforcement or manual deletion. This should be run on a daily basis, preferably scheduled as an administrative event.


BAckup DB
This command will backup the internal TSM database to the designated device class (tape, file, etc.). This command should be run on a daily basis, preferably scheduled as an administrative event.


Many of the Query commands have counterparts to define new entities or update existing ones. To define most new entities, substitute

DEFine

for Query. To update existing entities, substitute

UPDate

for Query. For instance, to update an existing storage pool, the command syntax is

UPDate STGpool ...

Use the Help prefix to obtain complete information about such commands, or refer to the TSM Administrator's Reference.

Many of the Query commands allow for an optional flag Format=Detailed. This gives more detailed information in the query results.