This document provides an administrator's reference for IBM Tivoli Storage Manager Version 6.2 for Windows. It contains information on administering the server from the command-line interface, including issuing commands, entering administrative commands, and descriptions of individual administrative commands. The document contains over 1300 pages of documentation.

1. Tivoli Storage Manager
®
for Windows
Version 6.2
Administrator's Reference
SC23-9779-02

3. Tivoli Storage Manager
®
for Windows
Version 6.2
Administrator's Reference
SC23-9779-02

4. Note:
Before using this information and the product it supports, read the information in “Notices” on page 1315.
| This edition applies to Version 6.2 of IBM Tivoli Storage Manager (product numbers 5608-E01, 5608-E02, 5608-E03,
| 5608-E07, 5608-E12)), and to all subsequent releases and modifications until otherwise indicated in new editions or
| technical newsletters. This edition replaces SC23-9779-01.
© Copyright IBM Corporation 1993, 2010.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.

5. Contents
Preface . . . . . . . . . . . . . . . xi Specifying descriptions in keyword parameters 14
Who should read this publication . . . . . . . xi Controlling command processing . . . . . . . 14
Publications . . . . . . . . . . . . . . xi Server command processing . . . . . . . . 14
Tivoli Storage Manager publications . . . . . xi Cancelling commands . . . . . . . . . . 15
Related hardware publications . . . . . . . xiii Performing tasks concurrently on multiple servers 16
Support information . . . . . . . . . . . xiii Routing commands to a single server. . . . . 16
| Getting technical training . . . . . . . . xiii Routing commands to multiple servers . . . . 16
Searching knowledge bases . . . . . . . . xiv Routing commands to a server group. . . . . 17
Contacting IBM Software Support . . . . . . xv Routing commands to server groups . . . . . 17
Conventions used in this publication . . . . . xvii Routing commands to two servers and a server
group . . . . . . . . . . . . . . . 17
New for IBM Tivoli Storage Manager Routing commands inside scripts . . . . . . 17
Privilege classes for commands . . . . . . . . 18
Version 6.2. . . . . . . . . . . . . xix Commands requiring system privilege . . . . 18
New for the server in Version 6.2 . . . . . . . xix Commands requiring policy privilege . . . . 21
| Client-side data deduplication . . . . . . . xix Commands requiring storage privilege . . . . 22
| Automatic backup-archive client deployment . . xx Commands requiring operator privilege . . . . 23
| Simultaneous-write operations during storage Commands any administrator can issue . . . . 24
| pool migration . . . . . . . . . . . . xx
| In-flight data encryption using SSL . . . . . xxi
New for the Tivoli Storage Manager reporting
Chapter 2. Administrative commands 27
and monitoring feature in version 6.2 . . . . xxi ACCEPT DATE (Accepts the current system date) 28
| SCSI passthru support for Windows. . . . . xxii ACTIVATE POLICYSET (Activate a new policy set) 29
| Concurrent read-and-write access to Centera ASSIGN DEFMGMTCLASS (Assign a default
| volumes . . . . . . . . . . . . . . xxii management class) . . . . . . . . . . . . 31
| The Tivoli Integrated Portal GUI . . . . . . xxii AUDIT commands . . . . . . . . . . . . 33
| The Administration Center not installable on AUDIT LIBRARY (Audit volume inventories in
| HP-UX . . . . . . . . . . . . . . xxiii an automated library) . . . . . . . . . . 34
| Sun StorageTek T10000B drive encryption . . xxiii AUDIT LICENSES (Audit server storage usage) 36
| MOVESIZETHRESH server option . . . . . xxiii AUDIT VOLUME (Verify database information
| CHECKTAPEPOS server option to validate for a storage pool volume) . . . . . . . . 37
| data position on tape . . . . . . . . . xxiii BACKUP commands . . . . . . . . . . . 43
BACKUP DB (Back up the database) . . . . . 44
BACKUP DEVCONFIG (Create backup copies of
Chapter 1. Administering the server device configuration information) . . . . . . 47
from the command-line interface . . . . 1 BACKUP NODE (Back up a NAS node) . . . . 49
Issuing commands from the administrative client . . 1 BACKUP STGPOOL (Back up primary storage
Starting and stopping the administrative client . . 2 pool to copy storage pool) . . . . . . . . 54
Monitoring server activities from the BACKUP VOLHISTORY (Save sequential volume
administrative client . . . . . . . . . . . 2 history information) . . . . . . . . . . 58
Monitoring removable-media mounts from the BEGIN EVENTLOGGING (Begin logging events) . . 60
administrative client . . . . . . . . . . . 2 CANCEL commands . . . . . . . . . . . 62
Processing commands one at a time from the CANCEL EXPIRATION (Cancel an expiration
administrative client . . . . . . . . . . . 3 process) . . . . . . . . . . . . . . 63
Processing a series of commands from the CANCEL EXPORT (Delete a suspended export
administrative client . . . . . . . . . . . 3 operation) . . . . . . . . . . . . . . 64
Formatting output from commands . . . . . . 4 CANCEL PROCESS (Cancel an administrative
Saving command output to a specified location . . 4 process) . . . . . . . . . . . . . . 65
Administrative client options . . . . . . . . 5 CANCEL REQUEST (Cancel one or more mount
Issuing commands from the Administration Center . 7 requests) . . . . . . . . . . . . . . 67
Issuing commands from the server console . . . . 7 CANCEL RESTORE (Cancel a restartable restore
Entering administrative commands . . . . . . . 8 session). . . . . . . . . . . . . . . 68
Reading syntax diagrams . . . . . . . . . 8 CANCEL SESSION (Cancel one or more client
Entering long commands . . . . . . . . . 11 sessions) . . . . . . . . . . . . . . 69
Naming Tivoli Storage Manager objects . . . . 12 CHECKIN LIBVOLUME (Check a storage volume
Using wildcard characters to specify object into a library). . . . . . . . . . . . . . 70
names . . . . . . . . . . . . . . . 13
© Copyright IBM Corp. 1993, 2010 iii

6. CHECKOUT LIBVOLUME (Check a storage volume DEFINE RECOVERYMEDIA (Define recovery
out of a library) . . . . . . . . . . . . . 78 media) . . . . . . . . . . . . . . 260
CLEAN DRIVE (Clean a drive) . . . . . . . . 84 DEFINE SCHEDULE (Define a client or an
COMMIT (Control committing of commands in a administrative command schedule) . . . . . 262
macro) . . . . . . . . . . . . . . . . 85 DEFINE SCRIPT (Define a Tivoli Storage
COPY commands . . . . . . . . . . . . 86 Manager script) . . . . . . . . . . . 285
COPY ACTIVEDATA (Copy active backup data DEFINE SERVER (Define a server for
from a primary storage pool to an active-data server-to-server communications). . . . . . 287
pool) . . . . . . . . . . . . . . . 87 DEFINE SERVERGROUP (Define a server
COPY CLOPTSET (Copy a client option set) . . 91 group). . . . . . . . . . . . . . . 292
COPY DOMAIN (Copy a policy domain) . . . 92 DEFINE SPACETRIGGER (Define the space
COPY MGMTCLASS (Copy a management class) 94 trigger) . . . . . . . . . . . . . . 293
COPY POLICYSET (Copy a policy set) . . . . 96 DEFINE STGPOOL (Define a storage pool) . . 296
COPY PROFILE (Copy a profile) . . . . . . 98 DEFINE SUBSCRIPTION (Define a profile
COPY SCHEDULE (Copy a client or an subscription) . . . . . . . . . . . . 339
administrative command schedule) . . . . . 100 DEFINE VIRTUALFSMAPPING (Define a
COPY SCRIPT (Copy a Tivoli Storage Manager virtual file space mapping) . . . . . . . . 341
script) . . . . . . . . . . . . . . . 104 DEFINE VOLUME (Define a volume in a
COPY SERVERGROUP (Copy a server group) 105 storage pool) . . . . . . . . . . . . 343
DEFINE commands . . . . . . . . . . . 106 DELETE commands . . . . . . . . . . . 349
DEFINE ASSOCIATION (Associate client nodes DELETE ASSOCIATION (Delete the node
with a schedule) . . . . . . . . . . . 107 association to a schedule) . . . . . . . . 351
DEFINE BACKUPSET (Define a backup set) . . 109 DELETE BACKUPSET (Delete a backup set) . . 353
DEFINE CLIENTACTION (Define a one-time DELETE CLIENTOPT (Delete an option in an
client action). . . . . . . . . . . . . 113 option set) . . . . . . . . . . . . . 357
DEFINE CLIENTOPT (Define an option to an DELETE CLOPTSET (Delete a client option set) 358
option set) . . . . . . . . . . . . . 119 DELETE COLLOCGROUP (Delete a collocation
DEFINE CLOPTSET (Define a client option set group). . . . . . . . . . . . . . . 359
name) . . . . . . . . . . . . . . . 122 DELETE COLLOCMEMBER (Delete collocation
DEFINE COLLOCGROUP (Define a collocation group member). . . . . . . . . . . . 360
group). . . . . . . . . . . . . . . 123 DELETE COPYGROUP (Delete a backup or
DEFINE COLLOCMEMBER (Define collocation archive copy group) . . . . . . . . . . 362
group member). . . . . . . . . . . . 125 DELETE DATAMOVER (Delete a data mover) 364
DEFINE COPYGROUP (Define a copy group) 127 DELETE DEVCLASS (Delete a device class) . . 365
DEFINE DATAMOVER (Define a data mover) 137 DELETE DOMAIN (Delete a policy domain) 366
DEFINE DEVCLASS (Define a device class) . . 140 DELETE DRIVE (Delete a drive from a library) 367
DEFINE DOMAIN (Define a new policy DELETE EVENT (Delete event records). . . . 368
domain) . . . . . . . . . . . . . . 213 DELETE EVENTSERVER (Delete the definition
DEFINE DRIVE (Define a drive to a library) . . 215 of the event server) . . . . . . . . . . 370
DEFINE EVENTSERVER (Define a server as the DELETE FILESPACE (Delete client node data
event server) . . . . . . . . . . . . 219 from the server) . . . . . . . . . . . 371
DEFINE GRPMEMBER (Add a server to a DELETE GRPMEMBER (Delete a server from a
server group) . . . . . . . . . . . . 220 server group) . . . . . . . . . . . . 375
DEFINE LIBRARY (Define a library). . . . . 221 DELETE KEYRING (Delete password
DEFINE MACHINE (Define machine information in the key database) . . . . . . 376
information for disaster recovery) . . . . . 231 DELETE LIBRARY (Delete a library). . . . . 377
DEFINE MACHNODEASSOCIATION DELETE MACHINE (Delete machine
(Associate a node with a machine) . . . . . 233 information) . . . . . . . . . . . . . 378
DEFINE MGMTCLASS (Define a management DELETE MACHNODEASSOCIATION (Delete
class) . . . . . . . . . . . . . . . 235 association between a machine and a node) . . 379
DEFINE NODEGROUP (Define a node group) 238 DELETE MGMTCLASS (Delete a management
DEFINE NODEGROUPMEMBER (Define node class) . . . . . . . . . . . . . . . 380
group member). . . . . . . . . . . . 239 DELETE NODEGROUP (Delete a node group) 381
DEFINE PATH (Define a path) . . . . . . 240 DELETE NODEGROUPMEMBER (Delete node
DEFINE POLICYSET (Define a policy set) . . . 248 group member). . . . . . . . . . . . 382
DEFINE PROFASSOCIATION (Define a profile DELETE PATH (Delete a path) . . . . . . 383
association) . . . . . . . . . . . . . 250 DELETE POLICYSET (Delete a policy set) . . . 385
DEFINE PROFILE (Define a profile) . . . . . 256 DELETE PROFASSOCIATION (Delete a profile
DEFINE RECMEDMACHASSOCIATION association) . . . . . . . . . . . . . 386
(Associate recovery media with a machine) . . 258 DELETE PROFILE (Delete a profile) . . . . . 389
iv IBM Tivoli Storage Manager for Windows: Administrator's Reference

7. DELETE RECMEDMACHASSOCIATION HALT (Shut down the server) . . . . . . . . 499
(Delete recovery media and machine HELP (Get help on commands and error messages) 501
association) . . . . . . . . . . . . . 391 IDENTIFY DUPLICATES (Identify duplicate data
DELETE RECOVERYMEDIA (Delete recovery in a storage pool) . . . . . . . . . . . . 503
media) . . . . . . . . . . . . . . 392 IMPORT commands . . . . . . . . . . . 507
DELETE SCHEDULE (Delete a client or an IMPORT ADMIN (Import administrator
administrative command schedule) . . . . . 393 information) . . . . . . . . . . . . . 508
DELETE SCRIPT (Delete command lines from a IMPORT NODE (Import client node
script or delete the entire script) . . . . . . 396 information) . . . . . . . . . . . . . 511
DELETE SERVER (Delete a server definition) 397 IMPORT POLICY (Import policy information) 517
DELETE SERVERGROUP (Delete a server IMPORT SERVER (Import server information) 520
group). . . . . . . . . . . . . . . 398 INSERT MACHINE (Insert machine characteristics
DELETE SPACETRIGGER (Delete the storage information or recovery instructions) . . . . . 525
pool space triggers) . . . . . . . . . . 399 ISSUE MESSAGE (Issue a message from a server
DELETE STGPOOL (Delete a storage pool) . . 400 script) . . . . . . . . . . . . . . . . 527
DELETE SUBSCRIBER (Delete subscriptions LABEL LIBVOLUME (Label a library volume) . . 529
from a configuration manager database) . . . 401 LOCK commands . . . . . . . . . . . . 535
DELETE SUBSCRIPTION (Delete a profile LOCK ADMIN (Lock out an administrator) . . 536
subscription) . . . . . . . . . . . . 402 LOCK NODE (Lock out a client node) . . . . 537
DELETE VIRTUALFSMAPPING (Delete a LOCK PROFILE (Lock a profile) . . . . . . 538
virtual file space mapping) . . . . . . . . 403 MACRO (Invoke a macro) . . . . . . . . . 540
DELETE VOLHISTORY (Delete sequential MIGRATE STGPOOL (Migrate storage pool to next
volume history information) . . . . . . . 404 storage pool) . . . . . . . . . . . . . 542
DELETE VOLUME (Delete a storage pool MOVE commands . . . . . . . . . . . . 545
volume) . . . . . . . . . . . . . . 409 MOVE DATA (Move files on a storage pool
DISABLE commands . . . . . . . . . . . 412 volume) . . . . . . . . . . . . . . 546
DISABLE EVENTS (Disable events for event MOVE DRMEDIA (Move disaster recovery
logging) . . . . . . . . . . . . . . 413 media offsite and back onsite) . . . . . . . 550
DISABLE SESSIONS (Temporarily prevent client MOVE GRPMEMBER (Move a server group
node access to the server) . . . . . . . . 417 member) . . . . . . . . . . . . . . 565
DISMOUNT command . . . . . . . . . . 419 MOVE MEDIA (Move sequential access storage
DISMOUNT VOLUME (Dismount a volume by pool media) . . . . . . . . . . . . . 566
volume name) . . . . . . . . . . . . 420 MOVE NODEDATA (Move data by node in a
DISPLAY OBJNAME (Display a full object name) 421 sequential access storage pool) . . . . . . 574
ENABLE commands . . . . . . . . . . . 422 NOTIFY SUBSCRIBERS (Notify managed servers
ENABLE EVENTS (Enable server or client to update profiles). . . . . . . . . . . . 583
events for logging) . . . . . . . . . . 423 PARALLEL (Run multiple commands in a script in
ENABLE SESSIONS (Resume user activity on parallel) . . . . . . . . . . . . . . . 584
the server) . . . . . . . . . . . . . 426 PING SERVER (Test the connection between
END EVENTLOGGING (Stop logging events) . . 428 servers) . . . . . . . . . . . . . . . 586
EXPIRE INVENTORY (Manually start inventory PREPARE (Create a recovery plan file) . . . . . 587
expiration processing) . . . . . . . . . . 430 QUERY commands . . . . . . . . . . . 593
EXPORT commands . . . . . . . . . . . 434 QUERY ACTLOG (Query the activity log) . . . 595
EXPORT ADMIN (Export administrator QUERY ADMIN (Display administrator
information) . . . . . . . . . . . . . 435 information) . . . . . . . . . . . . . 600
EXPORT NODE (Export client node QUERY ASSOCIATION (Query client node
information) . . . . . . . . . . . . . 441 associations with a schedule) . . . . . . . 604
EXPORT POLICY (Export policy information) 459 QUERY AUDITOCCUPANCY (Query client
EXPORT SERVER (Export server information) 465 node storage utilization). . . . . . . . . 606
EXTEND DBSPACE (Increase space for the QUERY BACKUPSET (Query a backup set) . . 609
database) . . . . . . . . . . . . . . . 481 QUERY BACKUPSETCONTENTS (Query
GENERATE commands . . . . . . . . . . 482 contents of a backup set) . . . . . . . . 614
GENERATE BACKUPSET (Generate a backup QUERY CLOPTSET (Query a client option set) 617
set of a client's data) . . . . . . . . . . 483 QUERY COLLOCGROUP (Query a collocation
GENERATE BACKUPSETTOC (Generate a table group). . . . . . . . . . . . . . . 619
of contents for a backup set) . . . . . . . 491 QUERY CONTENT (Query the contents of a
GRANT commands . . . . . . . . . . . 493 storage pool volume) . . . . . . . . . . 622
GRANT AUTHORITY (Add administrator QUERY COPYGROUP (Query copy groups) . . 630
authority) . . . . . . . . . . . . . 494 QUERY DATAMOVER (Display data mover
GRANT PROXYNODE (Grant proxy authority definitions) . . . . . . . . . . . . . 635
to a client node) . . . . . . . . . . . 498 QUERY DB (Display database information) . . 638
Contents v

8. QUERY DBSPACE (Display database storage QUERY RPFILE (Query recovery plan file
space) . . . . . . . . . . . . . . . 641 information stored on a target server) . . . . 762
QUERY DEVCLASS (Display information on QUERY SAN (Query the devices on the SAN) 765
one or more device classes). . . . . . . . 642 QUERY SCHEDULE (Query schedules). . . . 768
QUERY DIRSPACE (Query storage utilization of QUERY SCRIPT (Query Tivoli Storage Manager
FILE directories) . . . . . . . . . . . 646 scripts) . . . . . . . . . . . . . . 776
QUERY DOMAIN (Query a policy domain) . . 647 QUERY SERVER (Query a server) . . . . . 779
QUERY DRIVE (Query information about a QUERY SERVERGROUP (Query a server group) 783
drive) . . . . . . . . . . . . . . . 650 QUERY SESSION (Query client sessions) . . . 785
QUERY DRMEDIA (Query disaster recovery QUERY SHREDSTATUS (Query shredding
media) . . . . . . . . . . . . . . 654 status ) . . . . . . . . . . . . . . 789
QUERY DRMSTATUS (Query disaster recovery QUERY SPACETRIGGER (Query the space
manager system parameters) . . . . . . . 663 triggers) . . . . . . . . . . . . . . 791
QUERY ENABLED (Query enabled events) . . 666 | QUERY SSLKEYRINGPW (Query SSL key
QUERY EVENT (Query scheduled and | database file password) . . . . . . . . . 793
completed events) . . . . . . . . . . . 668 QUERY STATUS (Query system parameters) 794
QUERY EVENTRULES (Query rules for server QUERY STGPOOL (Query storage pools) . . . 800
or client events) . . . . . . . . . . . 680 QUERY SUBSCRIBER (Display subscriber
QUERY EVENTSERVER (Query the event information) . . . . . . . . . . . . . 811
server). . . . . . . . . . . . . . . 683 QUERY SUBSCRIPTION (Display subscription
QUERY EXPORT (Query for active or information) . . . . . . . . . . . . . 813
suspended export operations) . . . . . . . 684 QUERY SYSTEM (Query the system
QUERY FILESPACE (Query one or more file configuration and capacity). . . . . . . . 815
spaces) . . . . . . . . . . . . . . 691 QUERY TAPEALERTMSG (Display status of
QUERY LIBRARY (Query a library) . . . . . 696 SET TAPEALERTMSG command) . . . . . 817
QUERY LIBVOLUME (Query a library volume) 699 QUERY TOC (Display table of contents for a
QUERY LICENSE (Display license information) 702 backup image) . . . . . . . . . . . . 818
QUERY LOG (Display information on the QUERY VIRTUALFSMAPPING (Query a virtual
recovery log) . . . . . . . . . . . . 703 file space mapping) . . . . . . . . . . 821
QUERY MACHINE (Query machine QUERY VOLHISTORY (Display sequential
information) . . . . . . . . . . . . . 705 volume history information) . . . . . . . 823
QUERY MEDIA (Query sequential access QUERY VOLUME (Query storage pool
storage pool media) . . . . . . . . . . 708 volumes) . . . . . . . . . . . . . . 829
QUERY MGMTCLASS (Query a management QUIT (End the interactive mode of the
class) . . . . . . . . . . . . . . . 714 administrative client) . . . . . . . . . . . 836
QUERY MOUNT (Display information on RECLAIM STGPOOL (Reclaim volumes in a
mounted sequential access volumes). . . . . 717 sequential-access storage pool) . . . . . . . 837
QUERY NASBACKUP (Query NAS backup RECONCILE VOLUMES (Reconcile differences in
images) . . . . . . . . . . . . . . 718 the virtual volume definitions) . . . . . . . 840
QUERY NODE (Query nodes) . . . . . . . 722 REGISTER commands . . . . . . . . . . 843
QUERY NODEDATA (Query client data in REGISTER ADMIN (Register an administrator) 844
volumes) . . . . . . . . . . . . . . 730 REGISTER LICENSE (Register a new license) 846
QUERY NODEGROUP (Query a node group) 733 REGISTER NODE (Register a node) . . . . . 848
QUERY OCCUPANCY (Query client file spaces REMOVE commands . . . . . . . . . . . 859
in storage pools) . . . . . . . . . . . 735 REMOVE ADMIN (Delete an administrator) . . 860
QUERY OPTION (Query server options) . . . 739 REMOVE NODE (Delete a node or an
QUERY PATH (Display a path definition) . . . 740 associated machine node) . . . . . . . . 861
QUERY POLICYSET (Query a policy set) . . . 744 RENAME commands . . . . . . . . . . . 863
QUERY PROCESS (Query one or more server RENAME ADMIN (Rename an administrator) 864
processes) . . . . . . . . . . . . . 747 RENAME FILESPACE (Rename a client file
QUERY PROFILE (Query a profile) . . . . . 749 space on the server) . . . . . . . . . . 865
QUERY PROXYNODE (Query proxy authority RENAME NODE (Rename a node) . . . . . 868
for a client node) . . . . . . . . . . . 752 RENAME SCRIPT (Rename a Tivoli Storage
QUERY RECOVERYMEDIA (Query recovery Manager script) . . . . . . . . . . . 869
media) . . . . . . . . . . . . . . 753 RENAME SERVERGROUP (Rename a server
QUERY REQUEST (Query one or more pending group). . . . . . . . . . . . . . . 870
mount requests) . . . . . . . . . . . 756 RENAME STGPOOL (Change the name of a
QUERY RESTORE (Query restartable restore storage pool) . . . . . . . . . . . . 871
sessions) . . . . . . . . . . . . . . 757 REPLY (Allow a request to continue processing) 872
QUERY RPFCONTENT (Query recovery plan RESET PASSEXP (Reset password expiration) . . 873
file contents stored on a target server) . . . . 760
vi IBM Tivoli Storage Manager for Windows: Administrator's Reference

9. RESTART EXPORT (Restart a suspended export SET DRMNOTMOUNTABLENAME (Specify the
operation) . . . . . . . . . . . . . . 875 not mountable location name) . . . . . . . 938
RESTORE commands. . . . . . . . . . . 877 SET DRMPLANPREFIX (Specify a prefix for
RESTORE NODE (Restore a NAS node) . . . 878 recovery plan file names) . . . . . . . . 939
RESTORE STGPOOL (Restore storage pool data SET DRMPLANVPOSTFIX (Specify replacement
from a copy pool or an active-data pool) . . . 883 volume names) . . . . . . . . . . . . 941
RESTORE VOLUME (Restore primary volume SET DRMPRIMSTGPOOL (Specify the primary
data from a copy pool or an active-data pool) . 887 storage pools to be managed by DRM) . . . . 942
REVOKE commands . . . . . . . . . . . 892 SET DRMRPFEXPIREDAYS (Set criteria for
REVOKE AUTHORITY (Remove administrator recovery plan file expiration) . . . . . . . 943
authority) . . . . . . . . . . . . . 893 SET DRMVAULTNAME (Specify the vault
REVOKE PROXYNODE (Revoke proxy name) . . . . . . . . . . . . . . . 945
authority for a client node) . . . . . . . . 897 SET EVENTRETENTION (Set the retention
ROLLBACK (Rollback uncommitted changes in a period for event records) . . . . . . . . 946
macro). . . . . . . . . . . . . . . . 898 SET INVALIDPWLIMIT (Set the number of
RUN (Run a Tivoli Storage Manager script) . . . 899 invalid logon attempts) . . . . . . . . . 947
SELECT (Perform an SQL query of the IBM Tivoli SET LICENSEAUDITPERIOD (Set license audit
Storage Manager database) . . . . . . . . . 902 period) . . . . . . . . . . . . . . 948
SERIAL (Run multiple commands in a script in SET MAXCMDRETRIES (Set the maximum
serial) . . . . . . . . . . . . . . . . 909 number of command retries) . . . . . . . 949
SET commands . . . . . . . . . . . . . 910 SET MAXSCHEDSESSIONS (Set maximum
SET ACCOUNTING (Set accounting records on scheduled sessions) . . . . . . . . . . 950
or off) . . . . . . . . . . . . . . . 912 SET MINPWLENGTH (Set minimum password
SET ACTLOGRETENTION (Set the retention length) . . . . . . . . . . . . . . 951
period or the size of the activity log) . . . . 913 SET PASSEXP (Set password expiration date) 952
SET ARCHIVERETENTIONPROTECTION SET QUERYSCHEDPERIOD (Set query period
(Activate data retention protection) . . . . . 915 for polling client nodes) . . . . . . . . . 954
SET AUTHENTICATION (Set password SET RANDOMIZE (Set randomization of
authentication) . . . . . . . . . . . . 917 scheduled start times) . . . . . . . . . 955
SET CLIENTACTDURATION (Set the duration SET REGISTRATION (Set open or closed
period for the client action). . . . . . . . 918 registration) . . . . . . . . . . . . . 957
SET CONFIGMANAGER (Specify a SET RETRYPERIOD (Set time between retry
configuration manager) . . . . . . . . . 919 attempts) . . . . . . . . . . . . . . 959
SET CONFIGREFRESH (Set managed server SET SCHEDMODES (Select a central scheduling
configuration refresh). . . . . . . . . . 920 mode) . . . . . . . . . . . . . . . 960
SET CONTEXTMESSAGING (Set message SET SERVERHLADDRESS (Set the high-level
context reporting on or off) . . . . . . . . 921 address of a server) . . . . . . . . . . 962
SET CROSSDEFINE (Specifies whether to SET SERVERLLADDRESS (Set the low-level
cross-define servers) . . . . . . . . . . 922 address of a server) . . . . . . . . . . 963
SET DBRECOVERY (Set the device class for SET SERVERNAME (Specify the server name) 964
automatic backups) . . . . . . . . . . 923 SET SERVERPASSWORD (Set password for
SET DBREPORTMODE (Set the level of server). . . . . . . . . . . . . . . 965
database reporting) . . . . . . . . . . 924 | SET SSLKEYRINGPW (Set the SSL key ring
| SET DEDUPVERIFICATIONLEVEL (Set the | password) . . . . . . . . . . . . . 966
| percentage of extents to verify) . . . . . . 925 SET SUBFILE (Set subfile backup for client
SET DRMACTIVEDATASTGPOOL (Specify the nodes) . . . . . . . . . . . . . . . 967
active-data pools to be managed by DRM) . . 927 SET SUMMARYRETENTION (Set number of
SET DRMCHECKLABEL (Specify label days to keep data in activity summary table) . . 968
checking) . . . . . . . . . . . . . . 929 SET TAPEALERTMSG (Set tape alert messages
SET DRMCMDFILENAME (Specify the name of on or off) . . . . . . . . . . . . . . 969
a file to contain commands) . . . . . . . 930 SET TOCLOADRETENTION (Set load retention
SET DRMCOPYSTGPOOL (Specify the copy period for table of contents) . . . . . . . 970
storage pools to be managed by DRM) . . . . 931 SETOPT (Set a server option for dynamic update) 971
SET DRMCOURIERNAME (Specify the courier SHRED DATA (Shred data). . . . . . . . . 973
name) . . . . . . . . . . . . . . . 932 SUSPEND EXPORT (Suspend a currently running
SET DRMDBBACKUPEXPIREDAYS (Specify DB export operation) . . . . . . . . . . . . 975
backup series expiration) . . . . . . . . 933 UNLOCK commands . . . . . . . . . . . 976
SET DRMFILEPROCESS (Specify file UNLOCK ADMIN (Unlock an administrator) 977
processing) . . . . . . . . . . . . . 935 UNLOCK NODE (Unlock a client node) . . . 978
SET DRMINSTRPREFIX (Specify the prefix for UNLOCK PROFILE (Unlock a profile) . . . . 979
recovery instructions file names) . . . . . . 936 UPDATE commands . . . . . . . . . . . 980
Contents vii

10. UPDATE ADMIN (Update an administrator) 981 Date, number, time, and language options . . 1190
UPDATE BACKUPSET (Update a retention Database options . . . . . . . . . . . 1191
value assigned to a backup set) . . . . . . 983 Data transfer options . . . . . . . . . 1191
UPDATE CLIENTOPT (Update a client option Message options . . . . . . . . . . . 1191
sequence number) . . . . . . . . . . . 988 Event logging options . . . . . . . . . 1192
UPDATE CLOPTSET (Update a client option set Security options and licensing options. . . . 1192
description) . . . . . . . . . . . . . 989 Miscellaneous options . . . . . . . . . 1193
UPDATE COLLOCGROUP (Update a 3494SHARED . . . . . . . . . . . . . 1194
collocation group) . . . . . . . . . . . 990 ACSACCESSID . . . . . . . . . . . . 1195
UPDATE COPYGROUP (Update a copy group) 991 ACSLOCKDRIVE. . . . . . . . . . . . 1196
UPDATE DATAMOVER (Update a data mover) 999 ACSQUICKINIT . . . . . . . . . . . . 1197
UPDATE DEVCLASS (Update the attributes of ACSTIMEOUTX . . . . . . . . . . . . 1198
a device class) . . . . . . . . . . . . 1001 ACTIVELOGDIR . . . . . . . . . . . . 1199
UPDATE DOMAIN (Update a policy domain) 1066 ACTIVELOGSIZE . . . . . . . . . . . 1200
UPDATE DRIVE (Update a drive) . . . . . 1068 ADMINONCLIENTPORT . . . . . . . . . 1201
UPDATE LIBRARY (Update a library) . . . . 1072 ADREGISTER . . . . . . . . . . . . . 1202
UPDATE LIBVOLUME (Change the status of a ADSETDC . . . . . . . . . . . . . . 1203
storage volume) . . . . . . . . . . . 1077 ADSMGROUPNAME . . . . . . . . . . 1204
UPDATE MACHINE (Update machine ADUNREGISTER . . . . . . . . . . . 1205
information) . . . . . . . . . . . . 1079 ALIASHALT . . . . . . . . . . . . . 1206
UPDATE MGMTCLASS (Update a ARCHFAILOVERLOGDIR . . . . . . . . 1207
management class) . . . . . . . . . . 1081 ARCHLOGDIR . . . . . . . . . . . . 1208
UPDATE NODE (Update node attributes) . . 1084 ASSISTVCRRECOVERY . . . . . . . . . 1209
UPDATE NODEGROUP (Update a node AUDITSTORAGE . . . . . . . . . . . 1210
group) . . . . . . . . . . . . . . 1093 | CHECKTAPEPOS . . . . . . . . . . . 1211
UPDATE PATH (Change a path) . . . . . 1094 | CLIENTDEDUPTXNLIMIT . . . . . . . . 1212
UPDATE POLICYSET (Update a policy set COMMMETHOD . . . . . . . . . . . 1214
description) . . . . . . . . . . . . 1100 COMMTIMEOUT . . . . . . . . . . . 1215
UPDATE PROFILE (Update a profile DATEFORMAT . . . . . . . . . . . . 1216
description) . . . . . . . . . . . . 1102 DBMEMPERCENT . . . . . . . . . . . 1217
UPDATE RECOVERYMEDIA (Update recovery DEDUPREQUIRESBACKUP . . . . . . . . 1218
media) . . . . . . . . . . . . . . 1103 DEVCONFIG . . . . . . . . . . . . . 1219
UPDATE SCHEDULE (Update a schedule) 1105 DISABLESCHEDS . . . . . . . . . . . 1220
UPDATE SCRIPT (Update a Tivoli Storage DISKSTGPOOLMEMSIZE . . . . . . . . . 1220
Manager script) . . . . . . . . . . . 1127 DISPLAYLFINFO. . . . . . . . . . . . 1221
UPDATE SERVER (Update a server defined for DNSLOOKUP . . . . . . . . . . . . . 1222
server-to-server communications) . . . . . 1129 DRIVEACQUIRERETRY . . . . . . . . . 1223
UPDATE SERVERGROUP (Update a server EVENTSERVER . . . . . . . . . . . . 1224
group description) . . . . . . . . . . 1133 EXPINTERVAL . . . . . . . . . . . . 1225
UPDATE SPACETRIGGER (Update the space EXPQUIET . . . . . . . . . . . . . . 1226
triggers) . . . . . . . . . . . . . . 1134 FILEEXIT . . . . . . . . . . . . . . 1227
UPDATE STGPOOL (Update a storage pool) 1136 FILETEXTEXIT . . . . . . . . . . . . 1228
UPDATE VIRTUALFSMAPPING (Update a IDLETIMEOUT . . . . . . . . . . . . 1229
virtual file space mapping) . . . . . . . 1172 LANGUAGE . . . . . . . . . . . . . 1230
UPDATE VOLHISTORY (Update sequential MAXSESSIONS . . . . . . . . . . . . 1232
volume history information) . . . . . . . 1174 MESSAGEFORMAT . . . . . . . . . . . 1233
UPDATE VOLUME (Change a storage pool MIRRORLOGDIR . . . . . . . . . . . 1234
volume) . . . . . . . . . . . . . . 1176 MOVEBATCHSIZE . . . . . . . . . . . 1235
VALIDATE commands . . . . . . . . . . 1180 MOVESIZETHRESH . . . . . . . . . . 1236
VALIDATE LANFREE (Validate LAN-Free MSGINTERVAL . . . . . . . . . . . . 1237
paths) . . . . . . . . . . . . . . 1181 NAMEDPIPENAME . . . . . . . . . . 1238
VALIDATE POLICYSET (Verify a policy set) 1183 NDMPCONTROLPORT . . . . . . . . . 1239
VARY (Bring a random access volume online or NDMPPORTRANGE . . . . . . . . . . 1240
offline) . . . . . . . . . . . . . . . 1185 NDMPPREFDATAINTERFACE . . . . . . . 1241
NOPREEMPT . . . . . . . . . . . . . 1242
Chapter 3. Server options . . . . . 1187 NORETRIEVEDATE. . . . . . . . . . . 1243
Modifying server options . . . . . . . . . 1187 NPAUDITFAILURE . . . . . . . . . . . 1244
Types of server options . . . . . . . . . . 1188 NPAUDITSUCCESS . . . . . . . . . . . 1245
Server communication options . . . . . . 1188 NPBUFFERSIZE . . . . . . . . . . . . 1246
Server storage options . . . . . . . . . 1189 NUMBERFORMAT . . . . . . . . . . . 1247
Client-server options . . . . . . . . . 1190 NUMOPENVOLSALLOWED. . . . . . . . 1248
viii IBM Tivoli Storage Manager for Windows: Administrator's Reference

11. QUERYAUTH . . . . . . . . . . . . . 1250 VOLUMEHISTORY . . . . . . . . . . . 1290
RECLAIMDELAY . . . . . . . . . . . 1251
RECLAIMPERIOD . . . . . . . . . . . 1252 Chapter 4. Server utilities. . . . . . 1291
REPORTRETRIEVE . . . . . . . . . . . 1253 DSMMAXSG (Increase the block size for writing
REQSYSAUTHOUTFILE . . . . . . . . . 1254 data) . . . . . . . . . . . . . . . . 1292
RESOURCETIMEOUT . . . . . . . . . . 1255 DSMSERV (Start the server) . . . . . . . . 1293
RESTOREINTERVAL . . . . . . . . . . 1256 DSMSERV DISPLAY DBSPACE (Display
RETENTIONEXTENSION . . . . . . . . . 1257 information about database storage space) . . . 1294
SANDISCOVERY. . . . . . . . . . . . 1258 DSMSERV DISPLAY LOG (Display recovery log
SANDISCOVERYTIMEOUT . . . . . . . . 1259 information) . . . . . . . . . . . . . 1295
SANREFRESHTIME . . . . . . . . . . . 1260 DSMSERV FORMAT (Format the database and
SEARCHMPQUEUE. . . . . . . . . . . 1261 log) . . . . . . . . . . . . . . . . 1297
SECUREPIPES. . . . . . . . . . . . . 1262 DSMSERV INSERTDB (Move a server database
| SERVERDEDUPTXNLIMIT . . . . . . . . 1263 into an empty database) . . . . . . . . . 1299
SHMPORT . . . . . . . . . . . . . . 1265 DSMSERV LOADFORMAT (Format a database) 1301
SHREDDING . . . . . . . . . . . . . 1266 DSMSERV REMOVEDB (Remove a database) 1303
SNMPHEARTBEATINTERVAL . . . . . . . 1267 DSMSERV RESTORE DB (Restore the database) 1304
SNMPMESSAGECATEGORY . . . . . . . . 1268 DSMSERV RESTORE DB (Restore a database to
SNMPSUBAGENT . . . . . . . . . . . 1269 its most current state) . . . . . . . . . 1305
SNMPSUBAGENTHOST . . . . . . . . . 1270 DSMSERV RESTORE DB (Restore a database to
SNMPSUBAGENTPORT . . . . . . . . . 1271 a point-in-time) . . . . . . . . . . . 1307
SSLTCPADMINPORT . . . . . . . . . . 1272 DSMSERV UPDATE (Create registry entries for a
SSLTCPPORT . . . . . . . . . . . . . 1273 server instance) . . . . . . . . . . . . 1310
TCPADMINPORT . . . . . . . . . . . 1274
TCPNODELAY . . . . . . . . . . . . 1275
Appendix A. Return codes for use in
TCPPORT . . . . . . . . . . . . . . 1276
TCPWINDOWSIZE . . . . . . . . . . . 1277 IBM Tivoli Storage Manager scripts . 1311
TECBEGINEVENTLOGGING . . . . . . . 1278
TECHOST . . . . . . . . . . . . . . 1279 Appendix B. Accessibility features
TECPORT . . . . . . . . . . . . . . 1280 for Tivoli Storage Manager . . . . . 1313
TECUTF8EVENT . . . . . . . . . . . . 1281
THROUGHPUTDATATHRESHOLD . . . . . 1282 Notices . . . . . . . . . . . . . 1315
THROUGHPUTTIMETHRESHOLD . . . . . 1283
Trademarks . . . . . . . . . . . . . 1317
TIMEFORMAT . . . . . . . . . . . . 1284
TXNGROUPMAX . . . . . . . . . . . 1285
UNIQUETDPTECEVENTS . . . . . . . . 1286 Glossary . . . . . . . . . . . . . 1319
UNIQUETECEVENTS . . . . . . . . . . 1287
USEREXIT . . . . . . . . . . . . . . 1288 Index . . . . . . . . . . . . . . 1341
VERBCHECK . . . . . . . . . . . . . 1289
Contents ix

12. x IBM Tivoli Storage Manager for Windows: Administrator's Reference

13. Preface
IBM® Tivoli® Storage Manager is a client/server program that provides storage
management solutions to customers in a multi-vendor computer environment. IBM
Tivoli Storage Manager provides an automated, centrally scheduled,
policy-managed backup, archive, and space-management facility for file servers
and workstations.
Who should read this publication
This reference is intended for anyone who is registered as an administrator. A
single administrator can manage Tivoli Storage Manager, or several people can
share administrative responsibilities.
You should be familiar with the operating system on which the server resides and
the communication protocols required for the client/server environment. You also
need to understand the storage management practices of your organization, such
as how you are currently backing up workstation files and how you are using
storage devices.
Publications
IBM Tivoli Storage Manager publications and other related publications are
available online.
You can search all publications in the Tivoli Storage Manager Information Center:
http://publib.boulder.ibm.com/infocenter/tsminfo/v6r2.
You can download PDF versions of publications from the Tivoli Storage Manager
Information Center or from the IBM Publications Center at http://www.ibm.com/
shop/publications/order/.
| Go to Tivoli Documentation Central to find information centers that contain official
| product documentation for current and previous versions of Tivoli products,
| including Tivoli Storage Manager products at http://www.ibm.com/
| developerworks/wikis/display/tivolidoccentral/Tivoli+Storage+Manager.
| You can also order some related publications from the IBM Publications Center
| Web site. The Web site provides information about ordering publications from
| countries other than the United States. In the United States, you can order
| publications by calling 1-800-879-2755.
Tivoli Storage Manager publications
Publications are available for the server, storage agent, client, and Data Protection.
| Table 1. IBM Tivoli Storage Manager troubleshooting and tuning publications
| Publication title Order number
| IBM Tivoli Storage Manager Client Messages and Application SC27-2877
| Programming Interface Return Codes
| IBM Tivoli Storage Manager Server Messages and Error Codes SC27-2878
© Copyright IBM Corp. 1993, 2010 xi

14. | Table 1. IBM Tivoli Storage Manager troubleshooting and tuning publications (continued)
| Publication title Order number
| IBM Tivoli Storage Manager Performance Tuning Guide GC23-9788
| IBM Tivoli Storage Manager Problem Determination Guide GC23-9789
|
Table 2. Tivoli Storage Manager server publications
Publication title Order number
IBM Tivoli Storage Manager for AIX Installation Guide GC23-9781
IBM Tivoli Storage Manager for AIX Administrator's Guide SC23-9769
IBM Tivoli Storage Manager for AIX Administrator's Reference SC23-9775
IBM Tivoli Storage Manager for HP-UX Installation Guide GC23-9782
IBM Tivoli Storage Manager for HP-UX Administrator's Guide SC23-9770
IBM Tivoli Storage Manager for HP-UX Administrator's Reference SC23-9776
IBM Tivoli Storage Manager for Linux Installation Guide GC23-9783
IBM Tivoli Storage Manager for Linux Administrator's Guide SC23-9771
IBM Tivoli Storage Manager for Linux Administrator's Reference SC23-9777
IBM Tivoli Storage Manager for Sun Solaris Installation Guide GC23-9784
IBM Tivoli Storage Manager for Sun Solaris Administrator's Guide SC23-9772
IBM Tivoli Storage Manager for Sun Solaris Administrator's Reference SC23-9778
IBM Tivoli Storage Manager for Windows Installation Guide GC23-9785
IBM Tivoli Storage Manager for Windows Administrator's Guide SC23-9773
IBM Tivoli Storage Manager for Windows Administrator's Reference SC23-9779
IBM Tivoli Storage Manager Server Upgrade Guide SC23-9554
IBM Tivoli Storage Manager Integration Guide for Tivoli Storage SC27-2828
Manager FastBack
Table 3. Tivoli Storage Manager storage agent publications
Publication title Order number
IBM Tivoli Storage Manager for SAN for AIX Storage Agent User's SC23-9797
Guide
IBM Tivoli Storage Manager for SAN for HP-UX Storage Agent User's SC23-9798
Guide
IBM Tivoli Storage Manager for SAN for Linux Storage Agent User's SC23-9799
Guide
IBM Tivoli Storage Manager for SAN for Sun Solaris Storage Agent SC23-9800
User's Guide
IBM Tivoli Storage Manager for SAN for Windows Storage Agent User's SC23-9553
Guide
Table 4. Tivoli Storage Manager client publications
Publication title Order number
IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive SC23-9791
Clients Installation and User's Guide
IBM Tivoli Storage Manager for Windows: Backup-Archive Clients SC23-9792
Installation and User's Guide
xii IBM Tivoli Storage Manager for Windows: Administrator's Reference

15. Table 4. Tivoli Storage Manager client publications (continued)
Publication title Order number
IBM Tivoli Storage Manager for Space Management for UNIX and Linux: SC23-9794
User's Guide
| IBM Tivoli Storage Manager Using the Application Programming SC23-9793
| Interface
Table 5. Tivoli Storage Manager Data Protection publications
Publication title Order number
IBM Tivoli Storage Manager for Enterprise Resource Planning: Data SC33-6341
Protection for SAP Installation and User's Guide for DB2
IBM Tivoli Storage Manager for Enterprise Resource Planning: Data SC33-6340
Protection for SAP Installation and User's Guide for Oracle
Related hardware publications
The following table lists related IBM hardware products publications.
For additional information on hardware, see the resource library for tape products
at http://www.ibm.com/systems/storage/tape/library.html.
Title Order Number
IBM TotalStorage 3494 Tape Library Introduction and Planning Guide GA32-0448
IBM TotalStorage 3494 Tape Library Operator Guide GA32-0449
IBM 3490E Model E01 and E11 User’s Guide GA32-0298
IBM Tape Device Drivers Installation and User’s Guide GC27-2130
IBM TotalStorage Enterprise Tape System 3590 Operator Guide GA32-0330
IBM TotalStorage Enterprise Tape System 3592 Operator Guide GA32-0465
Support information
You can find support information for IBM products from various sources.
Start at the IBM Support Portal: http://www.ibm.com/support/entry/portal/. You
can select the products that you are interested in, and search for a wide variety of
relevant information.
| Getting technical training
| Information about Tivoli technical training courses is available online.
| Go to these Web sites for training information:
| Tivoli software training and certification
| Choose from instructor led, online classroom training, self-paced Web
| classes, Tivoli certification preparation, and other training options at this
| site: http://www.ibm.com/software/tivoli/education/
| Tivoli Support Technical Exchange
| Technical experts share their knowledge and answer your questions in
| these webcasts: http://www.ibm.com/software/sysmgmt/products/
| support/supp_tech_exch.html
Preface xiii

16. Searching knowledge bases
If you have a problem with IBM Tivoli Storage Manager, there are several
knowledge bases that you can search.
Begin by searching the Tivoli Storage Manager Information Center at
http://publib.boulder.ibm.com/infocenter/tsminfo/v6r2. From this Web site, you
can search the current Tivoli Storage Manager documentation.
Searching the Internet
If you cannot find an answer to your question in the Tivoli Storage Manager
Information Center, search the Internet for the information that might help you
resolve your problem.
| To search multiple Internet resources, go to the support Web site for Tivoli Storage
| Manager at http://www.ibm.com/support/entry/portal/Overview/Software/
| Tivoli/Tivoli_Storage_Manager.
| You can search for information without signing in. Sign in using your IBM ID and
| password, if you want to customize the site based on your product usage and
| information needs. If you do not already have an IBM ID and password, click Sign
| in at the top of the page and follow the instructions to register.
From the Support Web site, you can search various resources including:
| v IBM technotes
| v IBM downloads
| v IBM Redbooks® publications
| v IBM Authorized Program Analysis Reports (APARs)
Select the product and click Downloads to search the APAR list.
If you still cannot find a solution to the problem, you can search forums and
newsgroups on the Internet for the latest information that might help you resolve
your problem.
| An independent user discussion list, ADSM-L, is hosted by Marist College. You can
| subscribe by sending an e-mail to listserv@vm.marist.edu. The body of the message
| must contain the following text: SUBSCRIBE ADSM-L your_first_name
| your_family_name.
| To share your experiences and learn from others in the Tivoli Storage Manager
| user community, go to the Tivoli Storage Manager wiki at http://www.ibm.com/
| developerworks/wikis/display/tivolistoragemanager.
Using IBM Support Assistant
| IBM Support Assistant is a complimentary software product that helps you with
| problem determination. You can install the stand-alone IBM Support Assistant
| application on any workstation. You can then enhance the application by installing
| product-specific plug-in modules for the IBM products that you use.
IBM Support Assistant helps you gather support information when you need to
open a problem management record (PMR), which you can then use to track the
problem. For more information, see the IBM Support Assistant Web site at
http://www.ibm.com/software/support/isa/.
xiv IBM Tivoli Storage Manager for Windows: Administrator's Reference

17. The product-specific plug-in modules provide you with the following resources:
v Support links
v Education links
v Ability to submit problem management reports
| Find add-ons for specific products here: http://www.ibm.com/support/
| docview.wss?&uid=swg27012689.
Finding product fixes
A product fix to resolve your problem might be available from the IBM Software
Support Web site.
| You can determine what fixes are available by checking the IBM Software Support
| Web site at http://www.ibm.com/support/entry/portal/.
| v If you previously customized the site based on your product usage:
| 1. Click the link for your Tivoli Storage Manager product, or one of the other
| Tivoli Storage Manager components that you want to find a fix for.
| 2. Click Downloads, and then click Fixes by version.
| v If you have not customized the site based on your product usage, click
| Downloads and search for your product.
| Receiving notification of product fixes
| You can receive notifications about fixes, flashes, upgrades, and other news about
| IBM products.
| To sign up to receive notifications about IBM products, follow these steps:
| 1. From the support page at http://www.ibm.com/support/entry/portal/, click
| My notifications in the notifications module.
| 2. Sign in using your IBM ID and password. If you do not have an ID and
| password, click register now above the IBM ID and password.
| 3. Click the Subscribe tab to select your product family and click Continue.
| 4. Select the type of information that you want to receive, and add your personal
| preferences. You can specify how you want to be notified, how often, and you
| can also optionally select a folder for the notifications.
| 5. Click Submit.
| 6. For notifications for other products, repeat steps 4 and 5.
| Tip: You can also pick a product first, from the main support portal site, and
| then click in the Notifications section to create or update your subscription for
| that product.
| Contacting IBM Software Support
| You can contact IBM Software Support if you have an active IBM subscription and
| support contract and if you are authorized to submit problems to IBM.
Before you contact IBM Software Support, follow these steps:
1. Set up a subscription and support contract.
2. Determine the business impact of your problem.
3. Describe your problem and gather background information.
Preface xv

18. Then see “Submitting the problem to IBM Software Support” on page xvii for
information on contacting IBM Software Support.
Setting up a subscription and support contract
| Set up a subscription and support contract. The type of contract that you need
| depends on the type of product you have.
| For IBM distributed software products (including, but not limited to, IBM Tivoli,
| Lotus®, and Rational® products, as well as IBM DB2® and IBM WebSphere®
| products that run on Microsoft® Windows® or UNIX® operating systems), enroll in
| IBM Passport Advantage® in one of the following ways:
| v Online: Go to the Passport Advantage Web page at http://www.ibm.com/
| software/lotus/passportadvantage/, click How to enroll, and follow the
| instructions.
| v By Phone: You can call 1-800-IBMSERV (1-800-426-7378) in the United States, or
| for the phone number to call in your country, go to the IBM Software Support
| Handbook Web page at http://www14.software.ibm.com/webapp/set2/sas/f/
| handbook/home.html and click Contacts.
Determining the business impact
When you report a problem to IBM, you are asked to supply a severity level.
Therefore, you must understand and assess the business impact of the problem
you are reporting.
Severity 1 Critical business impact: You are unable to use the program,
resulting in a critical impact on operations. This condition
requires an immediate solution.
Severity 2 Significant business impact: The program is usable but is
severely limited.
Severity 3 Some business impact: The program is usable with less
significant features (not critical to operations) unavailable.
Severity 4 Minimal business impact: The problem causes little impact on
operations, or a reasonable circumvention to the problem has
been implemented.
Describing the problem and gather background information
When explaining a problem to IBM, it is helpful to be as specific as possible.
Include all relevant background information so that IBM Software Support
specialists can help you solve the problem efficiently.
To save time, know the answers to these questions:
v What software versions were you running when the problem occurred?
v Do you have logs, traces, and messages that are related to the problem
symptoms? IBM Software Support is likely to ask for this information.
v Can the problem be recreated? If so, what steps led to the failure?
v Have any changes been made to the system? For example, hardware, operating
system, networking software, and so on.
| v Are you using a workaround for this problem? If so, be prepared to explain it
| when you report the problem.
xvi IBM Tivoli Storage Manager for Windows: Administrator's Reference

19. Submitting the problem to IBM Software Support
You can submit the problem to IBM Software Support online or by phone.
Online
| Go to the IBM Software Support Web site at http://www.ibm.com/
| support/entry/portal/Open_service_request/Software/
| Software_support_(general). Sign in to access IBM Service Requests, and
| enter your information into the problem submission tool.
By phone
For the phone number to call in your country, go to the contacts page of
the IBM Software Support Handbook at http://www14.software.ibm.com/
webapp/set2/sas/f/handbook/home.html.
Conventions used in this publication
v Command to be entered on the Windows command line:
> dsmadmc
v Command to be entered on the command line of an administrative client:
query devclass
In the usage and descriptions for administrative commands, the term characters
corresponds to the number of bytes available to store an item. For languages in
which it takes a single byte to represent a displayable character, the character to
byte ratio is 1 to 1. However, for DBCS and other multi-byte languages, the
reference to characters refers only to the number of bytes available for the item and
may represent fewer actual characters.
Preface xvii

20. xviii IBM Tivoli Storage Manager for Windows: Administrator's Reference

21. New for IBM Tivoli Storage Manager Version 6.2
Many features in the Tivoli Storage Manager Version 6.2 server are new for
previous Tivoli Storage Manager users.
New for the server in Version 6.2
Tivoli Storage Manager server Version 6.2 contains many new features and
changes. Any updates that have been made to the information since the previous
edition are marked with a vertical bar ( | ) in the left margin.
| Client-side data deduplication
| In client-side data deduplication, the Tivoli Storage Manager backup-archive client
| and the server work together to identify duplicate data.
| Data deduplication is a method of reducing storage needs by eliminating
| redundant data. In Tivoli Storage Manager V6.1, only the server could identify and
| remove redundant data. In V6.2, you have the option of identifying and removing
| redundant data during backup and archive processing before data is sent to the
| server. This method of data deduplication is called client-side data deduplication. It is
| available with V6.2 backup-archive clients and the V6.2 Tivoli Storage Manager
| application programming interface (API).
| Client-side data deduplication provides several advantages to server-side data
| deduplication. Client-side data deduplication reduces the amount of data sent over
| the local area network (LAN). In addition, the processing power that is required to
| identify duplicate data is offloaded from the server to client nodes. The processing
| that is required to remove duplicate data on the server is eliminated. Space savings
| occur immediately.
| If you used server-side data deduplication, V6.2 client nodes can access existing
| deduplicated data and storage pools that are already set up for data deduplication.
| When restoring or retrieving files, the client node queries for and displays files as
| it normally does. If a user selects a file that exists in a deduplicated storage pool,
| the server manages the work of reconstructing the file.
| You enable client-side data deduplication using a combination of settings on the
| client node and the server. The primary storage pool that is specified by the copy
| group of the management class associated with the client data must be a
| sequential-access disk (FILE) storage pool that is enabled for data deduplication.
© Copyright IBM Corp. 1993, 2010 xix

22. Client-side data deduplication: Changes for V6.2
| Related reference
| “CLIENTDEDUPTXNLIMIT” on page 1212
| Use this option to specify the maximum size of a transaction when client-side
| deduplicated data is backed up or archived.
| “QUERY CONTENT (Query the contents of a storage pool volume)” on page 622
| Use this command to identify files that are linked to files on other volumes in a
| deduplicated storage pool.
| “REGISTER NODE (Register a node)” on page 848
| Use this command to register a node to the server.
| “SERVERDEDUPTXNLIMIT” on page 1263
| Use this option to specify the maximum size of objects that can be deduplicated on
| the server.
| “SET DEDUPVERIFICATIONLEVEL (Set the percentage of extents to verify)” on
| page 925
| Use this command to verify extents sent to the server during client-side
| deduplication.
| “UPDATE NODE (Update node attributes)” on page 1084
| Use this command to modify the attributes of a registered node.
| Automatic backup-archive client deployment
| IBM Tivoli Storage Manager V6.2 can deploy backup-archive client code to
| workstations that already have the backup-archive client installed.
| You can now deploy backup-archive client code to candidate client workstations
| from the Tivoli Storage Manager V6.2 Administration Center. From the
| Administration Center, you can coordinate the client updates to each workstation
| that is at release 5.4 and later to V6.2. You are helped through the process by
| wizards that configure your workstation and schedule the deployments. The
| backup-archive client deployment feature is available for Windows backup-archive
| clients only.
| Simultaneous-write operations during storage pool migration
| With Tivoli Storage Manager, you can now write data simultaneously to copy
| storage pools and active-data pools during server data-migration processes.
| The simultaneous-write function during migration can reduce the amount of time
| required to back up storage pools or copy active data. Data that is simultaneously
| written to copy storage pools or active-data pools during migration is not copied
| again to the copy storage pools or active-data pools. For example, suppose that
| you migrate all the data in your primary random-access disk storage pool nightly
| and then back up your primary storage pools. By using the simultaneous-write
| function during migration, you can significantly reduce the amount of time
| required for backup operations.
| You can also use the simultaneous-write function during migration if you have
| many client nodes and the number of mount points that are required to perform
| the simultaneous-write function during client store operations is unacceptable. If
| mounting and demounting tapes when writing data simultaneously during client
| store operations is taking too much time, consider writing data simultaneously
| during migration.
xx IBM Tivoli Storage Manager for Windows: Administrator's Reference

23. Client-side data deduplication: Changes for V6.2
| With Tivoli Storage Manager V6.2, you can specify the simultaneous-write function
| for a primary storage pool if it is the target for any of the eligible operations (client
| store sessions, server import processes, and server data-migration processes).
| Related reference
| “DEFINE STGPOOL (Define a primary storage pool assigned to random access
| devices)” on page 298
| Use this command to define a primary storage pool assigned to a random-access
| device.
| “UPDATE STGPOOL (Update a primary random access storage pool)” on page
| 1137
| Use this command to update the definition of a storage pool assigned to a
| random-access device.
| “DEFINE STGPOOL (Define a primary storage pool assigned to sequential access
| devices)” on page 307
| Use this command to define a storage pool defined to a sequential-access storage
| device.
| “UPDATE STGPOOL (Update a primary sequential access pool)” on page 1146
| Use this command to update the definition of a storage pool assigned to
| sequential-access storage device.
| In-flight data encryption using SSL
| Support for Secure Sockets Layer (SSL) is available on HP-UX, Linux®, Solaris,
| AIX®, and Windows platforms.
| With SSL industry-standard communications, you can encrypt all traffic between
| the backup-archive client, the administrative command-line clients, and the IBM
| Tivoli Storage Manager server. You can use either self-signed or vendor-acquired
| SSL certificates.
New for the Tivoli Storage Manager reporting and monitoring
feature in version 6.2
The Tivoli Storage Manager reporting and monitoring feature, Version 6.2 has a
few new changes.
The Tivoli Storage Manager reporting and monitoring feature, Version 6.2, has been
integrated into a new user interface called the Tivoli Integrated Portal. This move
affects the reporting and monitoring reports that are run from the Administration
Center. The Administration Center moved from the Integrated Solutions Console to
the Tivoli Integrated Portal. The Tivoli Integrated Portal provides all the functions
that were available in the Integrated Solutions Console, but with a new
look-and-feel.
The Administration Center is installed separately and is not included in the
reporting and monitoring installation.
There is a new information roadmap for the Tivoli Storage Manager reporting and
monitoring feature on theTivoli Storage Manager Wiki. This roadmap has detailed
information on planning, installing, configuring, customizing, and trouble
shooting.Reporting and monitoring feature information roadmap
New for IBM Tivoli Storage Manager Version 6.2 xxi

24. IBM Tivoli Integrated Portal and the Tivoli Storage Manager reporting and monitoring
feature updated in version 6.2
| SCSI passthru support for Windows
| SCSI passthru support is available for Windows in Tivoli Storage Manager Version
| 6.2.
| With this support, you can choose to use a Windows Hardware Qualification Lab
| certified native device driver instead of the Tivoli Storage Manager device driver to
| control devices. Devices currently controlled by the Tivoli Storage Manager device
| driver can be switched to a native driver without updating drive or device class
| definitions.
| Concurrent read-and-write access to Centera volumes
| In previous versions of Tivoli Storage Manager, a client session or server process
| had to wait for a Centera volume if the volume was in use by another session or
| process. In V6.2, server read-access and write-access to a Centera volume are
| available concurrently.
| Concurrent access improves restore performance. Two or more clients can read the
| same volume at the same time. One client can also write to the volume while it is
| being read. In addition, multiple client sessions and server processes (for example,
| a client restore operation and an export node operation) can read the same volume
| concurrently.
| The following server processes can share read access to Centera volumes:
| v Exporting client node definitions or file data to sequential media or directly to
| another server for immediate import
| v Exporting all or part of server control information and client file data (if
| specified) from the server to sequential media
| v Generating a backup set for a backup-archive client node
| The following server processes cannot share read access to Centera volumes:
| v Checking for inconsistencies between a storage pool volume and database
| information
| v Deleting a storage pool volume and, optionally, the files stored in the volume
| A Centera volume can appear as the current volume for more than one session and
| as the target of concurrent read and write operations. There are no command
| changes associated with this feature.
| The Tivoli Integrated Portal GUI
| The IBM Tivoli Integrated Portal is a graphical user interface (GUI) that is included
| with Tivoli Storage Manager V6.2. The Tivoli Integrated Portal provides all the
| functions that were available in the Integrated Solutions Console.
| The Administration Center, Tivoli Storage Manager reporting and monitoring
| feature, and other applications are integrated into this new graphical user interface.
| The Administration Center can be moved to the Tivoli Integrated Portal if the
| servers being managed are at version 5.5 or later. By deploying the Tivoli
| Integrated Portal early, you can prepare your system for an upgrade to Tivoli
| Storage Manager V6.2. Servers at versions earlier than 6.2 that are managed using
| the V6.2 Administration Center cannot use the version V6.2 features.
xxii IBM Tivoli Storage Manager for Windows: Administrator's Reference

25. IBM Tivoli Integrated Portal and the Tivoli Storage Manager reporting and monitoring
feature updated in version 6.2
| The Administration Center not installable on HP-UX
| The Administration Center, a Web-based interface for centrally configuring and
| managing Tivoli Storage Manager servers, cannot be installed on an HP-UX server.
| In IBM Tivoli Storage Manager Version 6.2, the Administration Center cannot be
| installed on an HP-UX server. However, when installed on a supported server
| platform, the Administration Center can be used to manage HP-UX servers. For
| Administration Center system requirements, see the following Web site:
| http://www.ibm.com/support/docview.wss?uid=swg21410467
| Sun StorageTek T10000B drive encryption
| You can now use tape device encryption with Sun StorageTek T10000B drives.
| Encryption provides security for data on individual tapes and protects sensitive
| information that is transported off-site. When enabled, Tivoli Storage Manager
| handles encrypting and decrypting data on tapes according to specifications set
| when defining an ECARTRIDGE device class.
| Related reference
| “DEFINE DEVCLASS (Define an ECARTRIDGE device class)” on page 174
| Use the ECARTRIDGE device class when you are using StorageTek drive T10000B.
| “UPDATE DEVCLASS (Update an ECARTRIDGE device class)” on page 1032
| Use the ECARTRIDGE device class when you are using StorageTek drive T10000B.
| MOVESIZETHRESH server option
| The MOVESIZETHRESH server option default and maximum values have been
| increased.
| The MOVESIZETHRESH option specifies, in megabytes, a threshold for the
| amount of data moved as a batch, within the same server transaction. When this
| threshold is reached, no more files are added to the current batch, and a new
| transaction is started after the current batch is moved. The default value for
| MOVESIZETHRESH has been increased from 2048 to 4096; and the maximum
| value has also been increased from 2048 to 32768.
| Related reference
| MOVESIZETHRESH
| Use this command to specify a threshold for the amount of data moved as a batch
| within the same server transaction.
| CHECKTAPEPOS server option to validate data position on
| tape
| With the new CHECKTAPEPOS server option, you can determine the validity and
| consistency of the position of data blocks on tape.
| The CHECKTAPEPOS option applies to only operations using tape drives. It does
| not apply to non-tape, sequential-access device classes such as FILE or OPTICAL.
| If the server information about position does not match the position detected by
| the drive, an error message is displayed, the transaction is rolled back, and the
| data is not committed to the database.
| Related reference
| “CHECKTAPEPOS” on page 1211
| The CHECKTAPEPOS option specifies whether the Tivoli Storage Manager
| validates data position on tape. Use this option to determine the validity and
| consistency of data on tape.
New for IBM Tivoli Storage Manager Version 6.2 xxiii

26. IBM Tivoli Integrated Portal and the Tivoli Storage Manager reporting and monitoring
feature updated in version 6.2
xxiv IBM Tivoli Storage Manager for Windows: Administrator's Reference

27. Chapter 1. Administering the server from the command-line
interface
Tivoli Storage Manager provides several different command line interfaces. The
interface you choose depends on the tasks that you want to perform and
accessibility.
Tivoli Storage Manager provides three command line interfaces:
v Administrative command-line client
v Server console
v Administration Center command line
The administrative command-line client is a program that runs on a file server,
workstation, or mainframe. It is installed as part of the Tivoli Storage Manager
server installation process. With the administrative client, you can issue any and all
server commands.
Compared to the administrative client, the capabilities of the server console are
somewhat limited. For example, you cannot issue certain commands from the
server console, and you cannot specify that certain commands process before other
commands can be issued. (This procedure can be useful if, for example, you want
to run two commands in quick succession.) Furthermore, because the server
console is a DOS window on the machine on which the server is installed, you
must be physically located at the server machine to use the console. The
administrative client, on the other hand, can be accessed remotely from a different
location. You cannot route commands to other servers from the server console.
The Administration Center is a Web-based, task-oriented interface for centrally
configuring and managing Tivoli Storage Manager servers. The Administration
Center provides a command line interface that you can use if necessary. For
example, you might want to use the command line interface to perform Tivoli
Storage Manager functions that are limited or not supported in the Administration
Center. Using the command line in the Administration Center, you can issue any
and all server commands.
Issuing commands from the administrative client
The administrative command-line client is a program that runs on a file server,
workstation, or mainframe.
Ensure that your administrative client and your server are running in compatible
languages. See “LANGUAGE” on page 1230 for language and locale options. If
your client and server are using different languages, the messages that Tivoli
Storage Manager generates might not be understandable.
© Copyright IBM Corp. 1993, 2010 1

28. Starting and stopping the administrative client
Use the DSMADMC command to start an administrative client session.
The Tivoli Storage Manager server must be running before an administrative client
can connect. For instructions about starting the server, see the Installation Guide.
To start an administrative client session in command-line mode, enter this
command on your workstation:
dsmadmc -id=admin -password=admin -dataonly=yes
Note: If you do not want to be prompted for a user ID and password, enter the
DSMADMC command using the -ID and -PASSWORD options as shown.
Stop an administrative command-line client session by entering the following
command on your workstation:
quit
Monitoring server activities from the administrative client
To monitor Tivoli Storage Manager activities, such as server migration and client
logons, run the administrative client in console mode. You cannot enter any
administrative commands in console mode.
To start an administrative client session in console mode, enter:
dsmadmc -consolemode
You are prompted for a password if authentication is turned on for the server. If
you do not want to be prompted for your user ID and password, enter the
DSMADMC command with the -ID and -PASSWORD options.
To end an administrative client session in console mode, see Table 6.
Table 6. Keyboard break sequences
Environment Break Sequence
UNIX-based and Linux clients Ctrl+C
Windows Ctrl+C, Ctrl+Break
TSO ATTN
Monitoring removable-media mounts from the administrative
client
To monitor the mounting and dismounting of removable media, run the
administrative client in mount mode. When the client is running in mount mode,
you cannot enter any administrative commands.
To start an administrative client session in mount mode, enter:
dsmadmc -mountmode
You are prompted for a password if authentication is turned on for the server. If
you do not want to be prompted for your user ID and password, enter the
DSMADMC command with the -ID and -PASSWORD options.
To end an administrative client session in mount mode, see Table 6.
2 IBM Tivoli Storage Manager for Windows: Administrator's Reference

29. Processing commands one at a time from the administrative
client
Use batch mode to enter a single administrative command. Your administrative
client session automatically ends when the command has processed.
To start an administrative client session in batch mode, enter:
dsmadmc server_command
If you do not want to be prompted for your user ID and password, you can enter
the DSMADMC command with the -ID and -PASSWORD options.
In batch mode, you must enter the complete command on one line. If a command
does not fit on one line, enter the command by using a macro or a script. If you
specify a parameter with a string of text using batch mode, enclose the text in
single quotation marks (' ') in the macro. Do not use double quotation marks for
commands in batch mode, because your operating system might not parse the
quotation marks correctly.
You can bypass this batch mode double quotation mark restriction for Windows
clients by using the back slash () escape character. For example, on the OBJECTS
parameter of the DEFINE CLIENTACTION command, you could enter the string
with the character preceding the double quotation marks in the command.
dsmadmc -id=admin -password=admin define clientaction test_node domain=test_dom
action=restore objects='"C:program filestest*"'
Processing a series of commands from the administrative
client
Use the interactive mode to process a series of administrative commands.
To start an administrative client session in interactive mode, a server session must
be available. To ensure the availability of server sessions for both administrative
and client node sessions, the interactive mode of the administrative client is
disconnected if one or more of the following conditions is true:
v The server was stopped using the HALT command.
v Commands were not issued from the administrative client session for the length
of time specified with the IDLETIMEOUT server option.
v The administrative client session was canceled with the CANCEL SESSION
command.
You can use continuation characters when using interactive mode. For more
information, see “Entering long commands” on page 11.
To start an administrative session in interactive mode, enter:
dsmadmc
Do not enter a server command with the DSMADMC command. Doing so will
start the administrative client in batch, not interactive, mode. For example, do not
enter:
dsmadmc server_command
You can automatically restart your administrative client session by entering
another command each time the tsm: servername > prompt appears.
Chapter 1. Administering the server from the command-line interface 3