1. Tivoli Storage Manager for Windows Version 6.2 Administrators Reference SC23-9779-02

2. Tivoli Storage Manager for Windows Version 6.2 Administrators Reference SC23-9779-02

3. 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.

4. 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

5. CHECKOUT LIBVOLUME (Check a storage volume DEFINE RECOVERYMEDIA (Define recoveryout of a library) . . . . . . . . . . . . . 78 media) . . . . . . . . . . . . . . 260CLEAN DRIVE (Clean a drive) . . . . . . . . 84 DEFINE SCHEDULE (Define a client or anCOMMIT (Control committing of commands in a administrative command schedule) . . . . . 262macro) . . . . . . . . . . . . . . . . 85 DEFINE SCRIPT (Define a Tivoli StorageCOPY 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) . . . . . . . . . . . . 343DEFINE 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) . . . . . 389iv IBM Tivoli Storage Manager for Windows: Administrators Reference

6. 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 poolDISABLE 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) . . . . . . . . . . . . . . 565DISMOUNT 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 aDISPLAY OBJNAME (Display a full object name) 421 sequential access storage pool) . . . . . . 574ENABLE 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 betweenEND EVENTLOGGING (Stop logging events) . . 428 servers) . . . . . . . . . . . . . . . 586EXPIRE INVENTORY (Manually start inventory PREPARE (Create a recovery plan file) . . . . . 587expiration processing) . . . . . . . . . . 430 QUERY commands . . . . . . . . . . . 593EXPORT 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). . . . . . . . . 606EXTEND DBSPACE (Increase space for the QUERY BACKUPSET (Query a backup set) . . 609database) . . . . . . . . . . . . . . . 481 QUERY BACKUPSETCONTENTS (QueryGENERATE commands . . . . . . . . . . 482 contents of a backup set) . . . . . . . . 614 GENERATE BACKUPSET (Generate a backup QUERY CLOPTSET (Query a client option set) 617 set of a clients 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 aGRANT 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

7. 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) . . . . 760vi IBM Tivoli Storage Manager for Windows: Administrators Reference

8. 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

9. 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 . . . . . . . . . . . 1235VALIDATE commands . . . . . . . . . . 1180 MOVESIZETHRESH . . . . . . . . . . 1236 VALIDATE LANFREE (Validate LAN-Free MSGINTERVAL . . . . . . . . . . . . 1237 paths) . . . . . . . . . . . . . . 1181 NAMEDPIPENAME . . . . . . . . . . 1238 VALIDATE POLICYSET (Verify a policy set) 1183 NDMPCONTROLPORT . . . . . . . . . 1239VARY (Bring a random access volume online or NDMPPORTRANGE . . . . . . . . . . 1240offline) . . . . . . . . . . . . . . . 1185 NDMPPREFDATAINTERFACE . . . . . . . 1241 NOPREEMPT . . . . . . . . . . . . . 1242Chapter 3. Server options . . . . . 1187 NORETRIEVEDATE. . . . . . . . . . . 1243Modifying server options . . . . . . . . . 1187 NPAUDITFAILURE . . . . . . . . . . . 1244Types of server options . . . . . . . . . . 1188 NPAUDITSUCCESS . . . . . . . . . . . 1245 Server communication options . . . . . . 1188 NPBUFFERSIZE . . . . . . . . . . . . 1246 Server storage options . . . . . . . . . 1189 NUMBERFORMAT . . . . . . . . . . . 1247 Client-server options . . . . . . . . . 1190 NUMOPENVOLSALLOWED. . . . . . . . 1248viii IBM Tivoli Storage Manager for Windows: Administrators Reference

10. 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

11. x IBM Tivoli Storage Manager for Windows: Administrators Reference

12. 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

13. | 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 Administrators Guide SC23-9769 IBM Tivoli Storage Manager for AIX Administrators Reference SC23-9775 IBM Tivoli Storage Manager for HP-UX Installation Guide GC23-9782 IBM Tivoli Storage Manager for HP-UX Administrators Guide SC23-9770 IBM Tivoli Storage Manager for HP-UX Administrators Reference SC23-9776 IBM Tivoli Storage Manager for Linux Installation Guide GC23-9783 IBM Tivoli Storage Manager for Linux Administrators Guide SC23-9771 IBM Tivoli Storage Manager for Linux Administrators Reference SC23-9777 IBM Tivoli Storage Manager for Sun Solaris Installation Guide GC23-9784 IBM Tivoli Storage Manager for Sun Solaris Administrators Guide SC23-9772 IBM Tivoli Storage Manager for Sun Solaris Administrators Reference SC23-9778 IBM Tivoli Storage Manager for Windows Installation Guide GC23-9785 IBM Tivoli Storage Manager for Windows Administrators Guide SC23-9773 IBM Tivoli Storage Manager for Windows Administrators 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 Users SC23-9797 Guide IBM Tivoli Storage Manager for SAN for HP-UX Storage Agent Users SC23-9798 Guide IBM Tivoli Storage Manager for SAN for Linux Storage Agent Users SC23-9799 Guide IBM Tivoli Storage Manager for SAN for Sun Solaris Storage Agent SC23-9800 Users Guide IBM Tivoli Storage Manager for SAN for Windows Storage Agent Users 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 Users Guide IBM Tivoli Storage Manager for Windows: Backup-Archive Clients SC23-9792 Installation and Users Guide xii IBM Tivoli Storage Manager for Windows: Administrators Reference

14. 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 Users 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 Users Guide for DB2 IBM Tivoli Storage Manager for Enterprise Resource Planning: Data SC33-6340 Protection for SAP Installation and Users 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 Users Guide GA32-0298 IBM Tape Device Drivers Installation and Users 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

15. 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: Administrators Reference

16. 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

17. 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: Administrators Reference

18. 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

19. xviii IBM Tivoli Storage Manager for Windows: Administrators Reference

20. 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

21. 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: Administrators Reference

22. 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

23. 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: Administrators Reference

24. 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|