ibm tivoli storage manager for aix: administrator's reference · ibm t ivoli stora ge mana ger for...

of 1778 /1778
IBM Tivoli Storage Manager for AIX Version 7.1.3 Administrator's Reference IBM

Upload: phungnhu

Post on 02-Apr-2018

245 views

Category:

Documents


7 download

TRANSCRIPT

  • IBM Tivoli Storage Managerfor AIXVersion 7.1.3

    Administrator's Reference

    IBM

  • IBM Tivoli Storage Managerfor AIXVersion 7.1.3

    Administrator's Reference

    IBM

  • Note:Before you use this information and the product it supports, read the information in Notices on page 1725.

    Third edition (September 2015)

    This edition applies to version 7, release 1, modification 3 of IBM Tivoli Storage Manager (product numbers5608-E01, 5608-E02, 5608-E03), and to all subsequent releases and modifications until otherwise indicated in neweditions.

    Copyright IBM Corporation 1993, 2015.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

  • Contents

    About this publication . . . . . . .. xiiiWho should read this guide . . . . . . .. xiiiPublications . . . . . . . . . . . . .. xiiiConventions used in this publication . . . .. xiii

    New for Tivoli Storage ManagerVersion 7.1.3 . . . . . . . . . . .. xvOperations Center updates . . . . . . . .. xvTivoli Storage Manager server updates . . . .. xvi

    Optimize a storage environment by using inlinedata deduplication. . . . . . . . . .. xviBack up data to a cloud computing system .. xviiArchive diagnostic messages by using operatingsystem tools. . . . . . . . . . . .. xviiStart the server in maintenance mode . . .. xviiDecommission a client node . . . . . .. xviiDeactivate data to free server storage space xviiiNarrow the search results when you querysessions . . . . . . . . . . . . .. xviiiSpecify an action for all client nodes . . .. xviii

    Simplified solution implementation in a reviseddocumentation set . . . . . . . . . .. xviiiTivoli Monitoring for Tivoli Storage Managerupdates . . . . . . . . . . . . . .. xix

    Chapter 1. Managing the server from thecommand line . . . . . . . . . . .. 1Issuing commands from the administrative client .. 1

    Starting and stopping the administrative client .. 2Monitoring server activities from theadministrative client . . . . . . . . . .. 2Monitoring removable-media mounts from theadministrative client . . . . . . . . . .. 3Processing individual commands from theadministrative client . . . . . . . . . .. 3Processing a series of commands from theadministrative client . . . . . . . . . .. 4Formatting output from commands. . . . .. 4Saving command output to a specified location.. 5Administrative client options . . . . . . .. 5

    Issuing commands from the Operations Center . .. 8Issuing commands from the server console . . .. 8Entering administrative commands . . . . . .. 8

    Reading syntax diagrams . . . . . . . .. 9Using continuation characters to enter longcommands. . . . . . . . . . . . .. 13Naming Tivoli Storage Manager objects . . .. 13Using wildcard characters to specify objectnames . . . . . . . . . . . . . .. 14Specifying descriptions in keyword parameters 15

    Controlling command processing . . . . . .. 16Server command processing . . . . . . .. 16Stopping background processes. . . . . .. 17

    Performing tasks concurrently on multiple servers 17Routing commands to a single server. . . .. 18

    Routing commands to multiple servers . . .. 18Routing commands to a server group. . . .. 18Routing commands to server groups . . . .. 19Routing commands to two servers and a servergroup . . . . . . . . . . . . . .. 19Routing commands inside scripts . . . . .. 19

    Privilege classes for commands . . . . . . .. 20Commands requiring system privilege . . .. 20Commands requiring policy privilege . . .. 23Commands requiring storage privilege . . .. 24Commands requiring operator privilege . . .. 25Commands any administrator can issue . . .. 26

    Chapter 2. Administrative commands 29ACCEPT DATE (Accepts the current system date) 30ACTIVATE POLICYSET (Activate a new policy set) 31ASSIGN DEFMGMTCLASS (Assign a defaultmanagement class) . . . . . . . . . . .. 33AUDIT commands . . . . . . . . . . .. 35

    AUDIT CONTAINER commands . . . . .. 36AUDIT LDAPDIRECTORY (Audit an LDAPdirectory server) . . . . . . . . . . .. 43AUDIT LIBRARY (Audit volume inventories inan automated library) . . . . . . . . .. 45AUDIT LIBVOLUME (Verify databaseinformation for a tape volume) . . . . . .. 47AUDIT LICENSES (Audit server storage usage) 49AUDIT VOLUME (Verify database informationfor a storage pool volume) . . . . . . .. 50

    BACKUP commands . . . . . . . . . .. 56BACKUP DB (Back up the database) . . . .. 57BACKUP DEVCONFIG (Create backup copies ofdevice configuration information) . . . . .. 63BACKUP NODE (Back up a NAS node) . . .. 65BACKUP STGPOOL (Back up primary storagepool data to a copy storage pool) . . . . .. 70BACKUP VOLHISTORY (Save sequential volumehistory information) . . . . . . . . .. 74

    BEGIN EVENTLOGGING (Begin logging events) .. 76CANCEL commands . . . . . . . . . .. 78

    CANCEL EXPIRATION (Cancel an expirationprocess) . . . . . . . . . . . . .. 79CANCEL EXPORT (Delete a suspended exportoperation) . . . . . . . . . . . . .. 80CANCEL PROCESS (Cancel an administrativeprocess) . . . . . . . . . . . . .. 81CANCEL REPLICATION (Cancel nodereplication processes) . . . . . . . . .. 83CANCEL REQUEST (Cancel one or more mountrequests) . . . . . . . . . . . . .. 84CANCEL RESTORE (Cancel a restartable restoresession). . . . . . . . . . . . . .. 85CANCEL SESSION (Cancel one or more clientsessions) . . . . . . . . . . . . .. 86

    Copyright IBM Corp. 1993, 2015 iii

    ||

  • CHECKIN LIBVOLUME (Check a storage volumeinto a library). . . . . . . . . . . . .. 87CHECKOUT LIBVOLUME (Check a storage volumeout of a library) . . . . . . . . . . . .. 95CLEAN DRIVE (Clean a drive) . . . . . .. 101COMMIT (Control committing of commands in amacro). . . . . . . . . . . . . . .. 102COPY commands . . . . . . . . . . .. 103

    COPY ACTIVEDATA (Copy active backup datafrom a primary storage pool to an active-datapool) . . . . . . . . . . . . . .. 104COPY CLOPTSET (Copy a client option set) .. 108COPY DOMAIN (Copy a policy domain) . .. 109COPY MGMTCLASS (Copy a managementclass) . . . . . . . . . . . . . .. 111COPY POLICYSET (Copy a policy set) . . .. 113COPY PROFILE (Copy a profile) . . . . .. 115COPY SCHEDULE (Copy a client or anadministrative command schedule) . . . .. 117COPY SCRIPT (Copy a Tivoli Storage Managerscript) . . . . . . . . . . . . . .. 121COPY SERVERGROUP (Copy a server group) 122

    DEACTIVATE DATA (Deactivate data for a clientnode) . . . . . . . . . . . . . . .. 123DECOMMISSION commands . . . . . . .. 126

    DECOMMISSION NODE (Decommission anapplication or system) . . . . . . . .. 127DECOMMISSION VM (Decommission a virtualmachine) . . . . . . . . . . . . .. 130

    DEFINE commands . . . . . . . . . .. 132DEFINE ALERTTRIGGER (Define an alerttrigger) . . . . . . . . . . . . .. 134DEFINE ASSOCIATION (Associate client nodeswith a schedule) . . . . . . . . . .. 137DEFINE BACKUPSET (Define a backup set) .. 139DEFINE CLIENTACTION (Define a one-timeclient action) . . . . . . . . . . .. 143DEFINE CLIENTOPT (Define an option to anoption set) . . . . . . . . . . . .. 149DEFINE CLOPTSET (Define a client option setname) . . . . . . . . . . . . . .. 151DEFINE COLLOCGROUP (Define a collocationgroup). . . . . . . . . . . . . .. 152DEFINE COLLOCMEMBER (Define collocationgroup member). . . . . . . . . . .. 154DEFINE COPYGROUP (Define a copy group) 158DEFINE DATAMOVER (Define a data mover) 168DEFINE DEVCLASS (Define a device class) .. 171DEFINE DEVCLASS - z/OS media server(Define device class for z/OS media server) .. 233DEFINE DOMAIN (Define a new policydomain) . . . . . . . . . . . . .. 254DEFINE DRIVE (Define a drive to a library) .. 256DEFINE EVENTSERVER (Define a server as theevent server) . . . . . . . . . . .. 261DEFINE GRPMEMBER (Add a server to aserver group) . . . . . . . . . . .. 262DEFINE LIBRARY (Define a library). . . .. 263DEFINE MACHINE (Define machineinformation for disaster recovery) . . . .. 284

    DEFINE MACHNODEASSOCIATION(Associate a node with a machine) . . . .. 286DEFINE MGMTCLASS (Define a managementclass) . . . . . . . . . . . . . .. 288DEFINE NODEGROUP (Define a node group) 291DEFINE NODEGROUPMEMBER (Define nodegroup member). . . . . . . . . . .. 292DEFINE PATH (Define a path) . . . . .. 293DEFINE POLICYSET (Define a policy set) . .. 303DEFINE PROFASSOCIATION (Define a profileassociation) . . . . . . . . . . . .. 305DEFINE PROFILE (Define a profile) . . . .. 311DEFINE RECMEDMACHASSOCIATION(Associate recovery media with a machine) .. 313DEFINE RECOVERYMEDIA (Define recoverymedia) . . . . . . . . . . . . .. 315DEFINE SCHEDULE (Define a client or anadministrative command schedule) . . . .. 317DEFINE SCRATCHPADENTRY (Define ascratch pad entry) . . . . . . . . . .. 342DEFINE SCRIPT (Define a Tivoli StorageManager script) . . . . . . . . . .. 344DEFINE SERVER (Define a server forserver-to-server communications). . . . .. 347DEFINE SERVERGROUP (Define a servergroup). . . . . . . . . . . . . .. 354DEFINE SPACETRIGGER (Define the spacetrigger) . . . . . . . . . . . . .. 355DEFINE STATUSTHRESHOLD (Define a statusmonitoring threshold) . . . . . . . .. 358DEFINE STGPOOL (Define a storage pool) .. 362DEFINE STGPOOLDIRECTORY (Define astorage pool directory) . . . . . . . .. 417DEFINE SUBSCRIPTION (Define a profilesubscription) . . . . . . . . . . .. 419DEFINE VIRTUALFSMAPPING (Define avirtual file space mapping) . . . . . . .. 421DEFINE VOLUME (Define a volume in astorage pool) . . . . . . . . . . .. 423

    DELETE commands . . . . . . . . . .. 430DELETE ALERTTRIGGER (Remove a messagefrom an alert trigger) . . . . . . . . .. 432DELETE ASSOCIATION (Delete the nodeassociation to a schedule) . . . . . . .. 433DELETE BACKUPSET (Delete a backup set) .. 435DELETE CLIENTOPT (Delete an option in anoption set) . . . . . . . . . . . .. 440DELETE CLOPTSET (Delete a client option set) 441DELETE COLLOCGROUP (Delete a collocationgroup). . . . . . . . . . . . . .. 442DELETE COLLOCMEMBER (Delete collocationgroup member). . . . . . . . . . .. 443DELETE COPYGROUP (Delete a backup orarchive copy group) . . . . . . . . .. 446DELETE DATAMOVER (Delete a data mover) 448DELETE DEDUPSTATS (Delete datadeduplication statistics) . . . . . . . .. 449DELETE DEVCLASS (Delete a device class) .. 453DELETE DOMAIN (Delete a policy domain) 454DELETE DRIVE (Delete a drive from a library) 455DELETE EVENT (Delete event records). . .. 456

    iv IBM Tivoli Storage Manager for AIX: Administrator's Reference

    |||||||||||

    |||

  • DELETE EVENTSERVER (Delete the definitionof the event server) . . . . . . . . .. 458DELETE FILESPACE (Delete client node datafrom the server) . . . . . . . . . .. 459DELETE GRPMEMBER (Delete a server from aserver group) . . . . . . . . . . .. 463DELETE KEYRING (Delete passwordinformation in the key database) . . . . .. 464DELETE LIBRARY (Delete a library). . . .. 465DELETE MACHINE (Delete machineinformation) . . . . . . . . . . . .. 466DELETE MACHNODEASSOCIATION (Deleteassociation between a machine and a node) .. 467DELETE MGMTCLASS (Delete a managementclass) . . . . . . . . . . . . . .. 468DELETE NODEGROUP (Delete a node group) 469DELETE NODEGROUPMEMBER (Delete nodegroup member). . . . . . . . . . .. 470DELETE PATH (Delete a path) . . . . .. 471DELETE POLICYSET (Delete a policy set) . .. 473DELETE PROFASSOCIATION (Delete a profileassociation) . . . . . . . . . . . .. 474DELETE PROFILE (Delete a profile) . . . .. 477DELETE RECMEDMACHASSOCIATION(Delete recovery media and machineassociation) . . . . . . . . . . . .. 479DELETE RECOVERYMEDIA (Delete recoverymedia) . . . . . . . . . . . . .. 480DELETE SCHEDULE (Delete a client or anadministrative command schedule) . . . .. 481DELETE SCRATCHPADENTRY (Delete ascratch pad entry) . . . . . . . . . .. 484DELETE SCRIPT (Delete command lines from ascript or delete the entire script) . . . . .. 485DELETE SERVER (Delete a server definition) 486DELETE SERVERGROUP (Delete a servergroup). . . . . . . . . . . . . .. 487DELETE SPACETRIGGER (Delete the storagepool space triggers) . . . . . . . . .. 488DELETE STATUSTHRESHOLD (Delete a statusmonitoring threshold) . . . . . . . .. 489DELETE STGPOOL (Delete a storage pool) .. 491DELETE STGPOOLDIRECTORY (Deleting astorage pool directory) . . . . . . . .. 492DELETE SUBSCRIBER (Delete subscriptionsfrom a configuration manager database) . .. 494DELETE SUBSCRIPTION (Delete a profilesubscription) . . . . . . . . . . .. 495DELETE VIRTUALFSMAPPING (Delete avirtual file space mapping) . . . . . . .. 496DELETE VOLHISTORY (Delete sequentialvolume history information) . . . . . .. 497DELETE VOLUME (Delete a storage poolvolume) . . . . . . . . . . . . .. 502

    DISABLE commands . . . . . . . . . .. 505DISABLE EVENTS (Disable events for eventlogging) . . . . . . . . . . . . .. 506DISABLE REPLICATION (Prevent outboundreplication processing on a server) . . . .. 510DISABLE SESSIONS (Prevent new sessions fromaccessing Tivoli Storage Manager) . . . .. 511

    DISMOUNT command . . . . . . . . .. 513DISMOUNT VOLUME (Dismount a volume byvolume name) . . . . . . . . . . .. 514

    DISPLAY OBJNAME (Display a full object name) 515ENABLE commands . . . . . . . . . .. 516

    ENABLE EVENTS (Enable server or clientevents for logging) . . . . . . . . .. 517ENABLE REPLICATION (Allow outboundreplication processing on a server) . . . .. 520ENABLE SESSIONS (Resume user activity onthe server) . . . . . . . . . . . .. 521

    END EVENTLOGGING (Stop logging events) .. 523EXPIRE INVENTORY (Manually start inventoryexpiration processing) . . . . . . . . .. 525EXPORT commands . . . . . . . . . .. 530

    EXPORT ADMIN (Export administratorinformation) . . . . . . . . . . . .. 531EXPORT NODE (Export client nodeinformation) . . . . . . . . . . . .. 538EXPORT POLICY (Export policy information) 560EXPORT SERVER (Export server information) 567

    EXTEND DBSPACE (Increase space for thedatabase) . . . . . . . . . . . . . .. 586GENERATE commands . . . . . . . . .. 589

    GENERATE BACKUPSET (Generate a backupset of Backup-Archive Client data) . . . .. 590GENERATE BACKUPSETTOC (Generate a tableof contents for a backup set) . . . . . .. 599GENERATE DEDUPSTATS (Generate datadeduplication statistics) . . . . . . . .. 601

    GRANT commands . . . . . . . . . .. 604GRANT AUTHORITY (Add administratorauthority) . . . . . . . . . . . .. 605GRANT PROXYNODE (Grant proxy authorityto a client node) . . . . . . . . . .. 609

    HALT (Shut down the server) . . . . . . .. 610HELP (Get help on commands and error messages) 612IDENTIFY DUPLICATES (Identify duplicate datain a storage pool) . . . . . . . . . . .. 614IMPORT commands . . . . . . . . . .. 618

    IMPORT ADMIN (Import administratorinformation) . . . . . . . . . . . .. 619IMPORT NODE (Import client nodeinformation) . . . . . . . . . . . .. 623IMPORT POLICY (Import policy information) 630IMPORT SERVER (Import server information) 633

    INSERT MACHINE (Insert machine characteristicsinformation or recovery instructions) . . . .. 639ISSUE MESSAGE (Issue a message from a serverscript) . . . . . . . . . . . . . . .. 640LABEL LIBVOLUME (Label a library volume) .. 642LOAD DEFALERTTRIGGERS (Load the default setof alert triggers) . . . . . . . . . . .. 649LOCK commands . . . . . . . . . . .. 651

    LOCK ADMIN (Lock out an administrator) .. 652LOCK NODE (Lock out a client node) . . .. 654LOCK PROFILE (Lock a profile) . . . . .. 656

    MACRO (Invoke a macro) . . . . . . . .. 658MIGRATE STGPOOL (Migrate storage pool to nextstorage pool) . . . . . . . . . . . .. 660MOVE commands . . . . . . . . . . .. 663

    Contents v

    |||

    |||

    |||

  • MOVE CONTAINER (Move a container) . .. 663MOVE DATA (Move files on a storage poolvolume) . . . . . . . . . . . . .. 665MOVE DRMEDIA (Move disaster recoverymedia offsite and back onsite) . . . . . .. 669MOVE GRPMEMBER (Move a server groupmember) . . . . . . . . . . . . .. 684MOVE MEDIA (Move sequential access storagepool media) . . . . . . . . . . . .. 685MOVE NODEDATA (Move data by node in asequential access storage pool) . . . . .. 693

    NOTIFY SUBSCRIBERS (Notify managed serversto update profiles). . . . . . . . . . .. 703PERFORM LIBACTION (Define or delete all drivesand paths for a library) . . . . . . . . .. 704PING SERVER (Test the connection betweenservers) . . . . . . . . . . . . . .. 708PREPARE (Create a recovery plan file) . . . .. 709PROTECT STGPOOL (Protect data that belongs toa storage pool) . . . . . . . . . . . .. 714QUERY commands . . . . . . . . . .. 717

    QUERY ACTLOG (Query the activity log) . .. 720QUERY ADMIN (Display administratorinformation) . . . . . . . . . . . .. 726QUERY ALERTTRIGGER (Query the list ofdefined alert triggers) . . . . . . . .. 731QUERY ALERTSTATUS (Query the status of analert) . . . . . . . . . . . . . .. 733QUERY ASSOCIATION (Query client nodeassociations with a schedule) . . . . . .. 738QUERY AUDITOCCUPANCY (Query clientnode storage utilization). . . . . . . .. 740QUERY BACKUPSET (Query a backup set) .. 743QUERY BACKUPSETCONTENTS (Querycontents of a backup set) . . . . . . .. 748QUERY CLOPTSET (Query a client option set) 751QUERY COLLOCGROUP (Query a collocationgroup). . . . . . . . . . . . . .. 753QUERY CONTAINER (Query a container). .. 755QUERY CONTENT (Query the contents of astorage pool volume) . . . . . . . . .. 759QUERY COPYGROUP (Query copy groups) .. 766QUERY DAMAGED (Query damaged data in adirectory-container or cloud-container storagepool) . . . . . . . . . . . . . .. 771QUERY DATAMOVER (Display data moverdefinitions) . . . . . . . . . . . .. 775QUERY DB (Display database information) .. 778QUERY DBSPACE (Display database storagespace) . . . . . . . . . . . . . .. 781QUERY DEDUPSTATS (Query datadeduplication statistics) . . . . . . . .. 783QUERY DEVCLASS (Display information onone or more device classes). . . . . . .. 789QUERY DIRSPACE (Query storage utilization ofFILE directories) . . . . . . . . . .. 794QUERY DOMAIN (Query a policy domain) .. 795QUERY DRIVE (Query information about adrive) . . . . . . . . . . . . . .. 798QUERY DRMEDIA (Query disaster recoverymedia) . . . . . . . . . . . . .. 802

    QUERY DRMSTATUS (Query disaster recoverymanager system parameters) . . . . . .. 811QUERY ENABLED (Query enabled events) .. 814QUERY EVENT (Query scheduled andcompleted events) . . . . . . . . . .. 816QUERY EVENTRULES (Query rules for serveror client events) . . . . . . . . . .. 828QUERY EVENTSERVER (Query the eventserver). . . . . . . . . . . . . .. 831QUERY EXPORT (Query for active orsuspended export operations) . . . . . .. 832QUERY EXTENTUPDATES (Query updateddata extents). . . . . . . . . . . .. 839QUERY FILESPACE (Query one or more filespaces) . . . . . . . . . . . . .. 841QUERY LIBRARY (Query a library) . . . .. 849QUERY LIBVOLUME (Query a library volume) 852QUERY LICENSE (Display license information) 855QUERY LOG (Display information about therecovery log) . . . . . . . . . . .. 857QUERY MACHINE (Query machineinformation) . . . . . . . . . . . .. 859QUERY MEDIA (Query sequential accessstorage pool media) . . . . . . . . .. 862QUERY MGMTCLASS (Query a managementclass) . . . . . . . . . . . . . .. 868QUERY MONITORSETTINGS (Query theconfiguration settings for monitoring alerts andserver status) . . . . . . . . . . .. 871QUERY MONITORSTATUS (Query themonitoring status) . . . . . . . . . .. 874QUERY MOUNT (Display information onmounted sequential access volumes). . . .. 878QUERY NASBACKUP (Query NAS backupimages) . . . . . . . . . . . . .. 880QUERY NODE (Query nodes) . . . . . .. 884QUERY NODEDATA (Query client data involumes) . . . . . . . . . . . . .. 896QUERY NODEGROUP (Query a node group) 899QUERY OCCUPANCY (Query client file spacesin storage pools) . . . . . . . . . .. 901QUERY OPTION (Query server options) . .. 905QUERY PATH (Display a path definition) . .. 907QUERY POLICYSET (Query a policy set) . .. 911QUERY PROCESS (Query one or more serverprocesses) . . . . . . . . . . . .. 914QUERY PROFILE (Query a profile) . . . .. 918QUERY PROXYNODE (Query proxy authorityfor a client node) . . . . . . . . . .. 921QUERY PVUESTIMATE (Display processorvalue unit estimate) . . . . . . . . .. 922QUERY RECOVERYMEDIA (Query recoverymedia) . . . . . . . . . . . . .. 926QUERY REPLICATION (Query node replicationprocesses) . . . . . . . . . . . .. 929QUERY REPLNODE (Display information aboutreplication status for a client node) . . . .. 940QUERY REPLRULE (Query replication rules) 944QUERY REPLSERVER (Query a replicationserver). . . . . . . . . . . . . .. 947

    vi IBM Tivoli Storage Manager for AIX: Administrator's Reference

    ||

    |||

    ||

    ||||

    |||

  • QUERY REQUEST (Query one or more pendingmount requests) . . . . . . . . . .. 949QUERY RESTORE (Query restartable restoresessions) . . . . . . . . . . . . .. 950QUERY RPFCONTENT (Query recovery planfile contents stored on a target server) . . .. 953QUERY RPFILE (Query recovery plan fileinformation stored on a target server) . . .. 955QUERY SAN (Query the devices on the SAN) 958QUERY SCHEDULE (Query schedules). . .. 961QUERY SCRATCHPADENTRY (Query a scratchpad entry) . . . . . . . . . . . .. 969QUERY SCRIPT (Query Tivoli Storage Managerscripts) . . . . . . . . . . . . .. 971QUERY SERVER (Query a server) . . . .. 974QUERY SERVERGROUP (Query a server group) 978QUERY SESSION (Query client sessions) . .. 980QUERY SHREDSTATUS (Query shreddingstatus ) . . . . . . . . . . . . .. 985QUERY SPACETRIGGER (Query the spacetriggers) . . . . . . . . . . . . .. 987QUERY SSLKEYRINGPW (Query SSL keydatabase file password) . . . . . . . .. 989QUERY STATUS (Query system parameters) 990QUERY STATUSTHRESHOLD (Query statusmonitoring thresholds) . . . . . . . .. 999QUERY STGPOOL (Query storage pools). .. 1002QUERY STGPOOLDIRECTORY (Query astorage pool directory) . . . . . . . .. 1016QUERY SUBSCRIBER (Display subscriberinformation) . . . . . . . . . . .. 1019QUERY SUBSCRIPTION (Display subscriptioninformation) . . . . . . . . . . .. 1021QUERY SYSTEM (Query the systemconfiguration and capacity) . . . . . .. 1023QUERY TAPEALERTMSG (Display status ofSET TAPEALERTMSG command) . . . .. 1025QUERY TOC (Display table of contents for abackup image) . . . . . . . . . .. 1026QUERY VIRTUALFSMAPPING (Query avirtual file space mapping) . . . . . .. 1029QUERY VOLHISTORY (Display sequentialvolume history information) . . . . . .. 1031QUERY VOLUME (Query storage poolvolumes) . . . . . . . . . . . .. 1039

    QUIT (End the interactive mode of theadministrative client) . . . . . . . . .. 1047RECLAIM STGPOOL (Reclaim volumes in asequential-access storage pool) . . . . . .. 1048RECONCILE VOLUMES (Reconcile differences inthe virtual volume definitions) . . . . . .. 1051REGISTER commands . . . . . . . . .. 1054

    REGISTER ADMIN (Register an administratorID) . . . . . . . . . . . . . .. 1055REGISTER LICENSE (Register a new license) 1059REGISTER NODE (Register a node) . . .. 1061

    REMOVE commands . . . . . . . . .. 1079REMOVE ADMIN (Delete an administratoruser ID) . . . . . . . . . . . . .. 1080REMOVE NODE (Delete a node or anassociated machine node) . . . . . . .. 1082

    REMOVE REPLNODE (Remove a client nodefrom replication) . . . . . . . . . .. 1084REMOVE REPLSERVER (Remove a replicationserver) . . . . . . . . . . . . .. 1086

    RENAME commands . . . . . . . . .. 1088RENAME ADMIN (Rename an administrator) 1089RENAME FILESPACE (Rename a client filespace on the server) . . . . . . . . .. 1091RENAME NODE (Rename a node) . . . .. 1094RENAME SCRIPT (Rename a Tivoli StorageManager script) . . . . . . . . . .. 1096RENAME SERVERGROUP (Rename a servergroup) . . . . . . . . . . . . .. 1097RENAME STGPOOL (Change the name of astorage pool) . . . . . . . . . . .. 1098

    REPAIR STGPOOL (Repair a directory-containerstorage pool) . . . . . . . . . . . .. 1099REPLICATE NODE (Replicate data in file spacesthat belong to a client node) . . . . . . .. 1101REPLY (Allow a request to continue processing) 1111RESET PASSEXP (Reset password expiration) .. 1112RESTART EXPORT (Restart a suspended exportoperation) . . . . . . . . . . . . .. 1114RESTORE commands . . . . . . . . .. 1116

    RESTORE NODE (Restore a NAS node) . .. 1117RESTORE STGPOOL (Restore storage pool datafrom a copy pool or an active-data pool) . .. 1122RESTORE VOLUME (Restore primary volumedata from a copy pool or an active-data pool) . 1126

    REVOKE commands . . . . . . . . .. 1130REVOKE AUTHORITY (Remove administratorauthority) . . . . . . . . . . . .. 1131REVOKE PROXYNODE (Revoke proxyauthority for a client node) . . . . . .. 1135

    ROLLBACK (Rollback uncommitted changes in amacro) . . . . . . . . . . . . . .. 1136RUN (Run a Tivoli Storage Manager script) . .. 1137SELECT (Perform an SQL query of the TivoliStorage Manager database) . . . . . . .. 1140SET commands . . . . . . . . . . .. 1150

    SET ACCOUNTING (Set accounting records onor off) . . . . . . . . . . . . .. 1153SET ACTLOGRETENTION (Set the retentionperiod or the size of the activity log) . . .. 1154SET ALERTACTIVEDURATION (Set theduration of an active alert) . . . . . .. 1156SET ALERTCLOSEDDURATION (Set theduration of a closed alert) . . . . . . .. 1157SET ALERTEMAIL (Set the alert monitor toemail alerts to administrators) . . . . .. 1158SET ALERTEMAILFROMADDR (Set the emailaddress of the sender) . . . . . . . .. 1159SET ALERTEMAILSMTPHOST (Set the SMTPmail server host name) . . . . . . . .. 1160SET ALERTEMAILSMTPPORT (Set the SMTPmail server host port) . . . . . . . .. 1161SET ALERTSUMMARYTOADMINS (Set the listof administrators to receive alert summaries byemail ) . . . . . . . . . . . . .. 1162SET ALERTINACTIVEDURATION (Set theduration of an inactive alert) . . . . . .. 1163

    Contents vii

    |||

    |||

  • SET ALERTMONITOR (Set the alert monitor toon or off) . . . . . . . . . . . .. 1164SET ALERTUPDATEINTERVAL (Set how oftenthe alert monitor updates and prunes alerts) . 1165SET ARCHIVERETENTIONPROTECTION(Activate data retention protection) . . . .. 1166SET ARREPLRULEDEFAULT (Set the serverreplication rule for archive data). . . . .. 1168SET AUTHENTICATION (Set passwordauthentication) . . . . . . . . . .. 1170SET BKREPLRULEDEFAULT (Set the serverreplication rule for backup data). . . . .. 1171SET CLIENTACTDURATION (Set the durationperiod for the client action) . . . . . .. 1174SET CONFIGMANAGER (Specify aconfiguration manager). . . . . . . .. 1175SET CONFIGREFRESH (Set managed serverconfiguration refresh) . . . . . . . .. 1176SET CONTEXTMESSAGING (Set messagecontext reporting on or off) . . . . . .. 1177SET CPUINFOREFRESH (Refresh interval forthe client workstation information scan) . .. 1178SET CROSSDEFINE (Specifies whether tocross-define servers) . . . . . . . . .. 1179SET DBRECOVERY (Set the device class forautomatic backups) . . . . . . . . .. 1180SET DEDUPVERIFICATIONLEVEL (Set thepercentage of extents to verify) . . . . .. 1183SET DEFAULTAUTHENTICATION (Set thedefault authentication method for REGISTERNODE and REGISTER ADMIN commands) . . .. 1185SET DISSIMILARPOLICIES (Enable the policieson the target replication server to managereplicated data) . . . . . . . . . .. 1187SET DRMACTIVEDATASTGPOOL (Specify theactive-data pools to be managed by DRM) .. 1189SET DRMCHECKLABEL (Specify labelchecking) . . . . . . . . . . . .. 1190SET DRMCMDFILENAME (Specify the nameof a file to contain commands) . . . . .. 1191SET DRMCOPYSTGPOOL (Specify the copystorage pools to be managed by DRM) . .. 1192SET DRMCOURIERNAME (Specify the couriername) . . . . . . . . . . . . .. 1193SET DRMDBBACKUPEXPIREDAYS (SpecifyDB backup series expiration) . . . . . .. 1194SET DRMFILEPROCESS (Specify fileprocessing) . . . . . . . . . . . .. 1196SET DRMINSTRPREFIX (Specify the prefix forrecovery instructions file names) . . . .. 1197SET DRMNOTMOUNTABLENAME (Specifythe not mountable location name) . . . .. 1199SET DRMPLANPREFIX (Specify a prefix forrecovery plan file names) . . . . . . .. 1200SET DRMPLANVPOSTFIX (Specifyreplacement volume names) . . . . . .. 1202SET DRMPRIMSTGPOOL (Specify the primarystorage pools to be managed by DRM) . .. 1203SET DRMRPFEXPIREDAYS (Set criteria forrecovery plan file expiration) . . . . . .. 1204

    SET DRMVAULTNAME (Specify the vaultname) . . . . . . . . . . . . .. 1206SET EVENTRETENTION (Set the retentionperiod for event records) . . . . . . .. 1207SET FAILOVERHLADDRESS (Set a failoverhigh level address) . . . . . . . . .. 1208SET INVALIDPWLIMIT (Set the number ofinvalid logon attempts). . . . . . . .. 1209SET LDAPPASSWORD (Set the LDAPpassword for the server) . . . . . . .. 1211SET LDAPUSER (Specify the user ID for theLDAP directory server). . . . . . . .. 1212SET LICENSEAUDITPERIOD (Set license auditperiod) . . . . . . . . . . . . .. 1214SET MAXCMDRETRIES (Set the maximumnumber of command retries) . . . . . .. 1215SET MAXSCHEDSESSIONS (Set maximumscheduled sessions) . . . . . . . . .. 1216SET MINPWLENGTH (Set minimum passwordlength) . . . . . . . . . . . . .. 1218SET MONITOREDSERVERGROUP (Set thegroup of monitored servers) . . . . . .. 1219SET MONITORINGADMIN (Set the name ofthe monitoring administrator) . . . . .. 1220SET NODEATRISKINTERVAL (Specifies at-riskmode for an individual node) . . . . .. 1221SET PASSEXP (Set password expiration date) 1223SET PRODUCTOFFERING (Set the productoffering that is licensed to your enterprise) .. 1225SET QUERYSCHEDPERIOD (Set query periodfor polling client nodes) . . . . . . .. 1227SET RANDOMIZE (Set randomization ofscheduled start times) . . . . . . . .. 1228SET REGISTRATION (Set open or closedregistration) . . . . . . . . . . .. 1230SET REPLRECOVERDAMAGED (Specifywhether damaged files are recovered from areplication server) . . . . . . . . .. 1232SET REPLRETENTION (Set the retentionperiod for replication records) . . . . .. 1235SET REPLSERVER (Set the target replicationserver) . . . . . . . . . . . . .. 1237SET RETRYPERIOD (Set time between retryattempts) . . . . . . . . . . . .. 1239SET SCHEDMODES (Select a centralscheduling mode) . . . . . . . . .. 1240SET SCRATCHPADRETENTION (Set scratchpad retention time) . . . . . . . . .. 1242SET SERVERHLADDRESS (Set the high-leveladdress of a server) . . . . . . . . .. 1243SET SERVERLLADDRESS (Set the low-leveladdress of a server) . . . . . . . . .. 1244SET SERVERNAME (Specify the server name) 1245SET SERVERPASSWORD (Set password forserver) . . . . . . . . . . . . .. 1246SET SPREPLRULEDEFAULT (Set the serverreplication rule for space-managed data) . .. 1247SET SSLKEYRINGPW (Set the SSL key ringpassword) . . . . . . . . . . . .. 1249

    viii IBM Tivoli Storage Manager for AIX: Administrator's Reference

    |||

    |||

  • SET STATUSATRISKINTERVAL (Specifieswhether to enable client at-risk activity intervalevaluation) . . . . . . . . . . . .. 1250SET STATUSMONITOR (Specifies whether toenable status monitoring) . . . . . . .. 1252SET STATUSREFRESHINTERVAL (Set refreshinterval for status monitoring) . . . . .. 1254SET STATUSSKIPASFAILURE (Specifieswhether to use client at-risk skipped files asfailure evaluation) . . . . . . . . .. 1256SET SUBFILE (Set subfile backup for clientnodes) . . . . . . . . . . . . .. 1258SET SUMMARYRETENTION (Set number ofdays to keep data in activity summary table) . 1259SET TAPEALERTMSG (Set tape alert messageson or off) . . . . . . . . . . . .. 1260SET TOCLOADRETENTION (Set loadretention period for table of contents) . . .. 1261SET VMATRISKINTERVAL (Specifies theat-risk mode for an individual VM filespace) . 1262

    SETOPT (Set a server option for dynamic update) 1264SHRED DATA (Shred data) . . . . . . .. 1266SUSPEND EXPORT (Suspend a currently runningexport operation) . . . . . . . . . . .. 1268UNLOCK commands . . . . . . . . .. 1269

    UNLOCK ADMIN (Unlock an administrator) 1270UNLOCK NODE (Unlock a client node) . .. 1272UNLOCK PROFILE (Unlock a profile). . .. 1274

    UPDATE commands . . . . . . . . .. 1275UPDATE ALERTTRIGGER (Update a definedalert trigger) . . . . . . . . . . .. 1276UPDATE ALERTSTATUS (Update the status ofan alert) . . . . . . . . . . . . .. 1279UPDATE ADMIN (Update an administrator) 1281UPDATE BACKUPSET (Update a retentionvalue assigned to a backup set) . . . . .. 1285UPDATE CLIENTOPT (Update a client optionsequence number) . . . . . . . . .. 1290UPDATE CLOPTSET (Update a client optionset description) . . . . . . . . . .. 1291UPDATE COLLOCGROUP (Update acollocation group) . . . . . . . . .. 1292UPDATE COPYGROUP (Update a copy group) 1293UPDATE DATAMOVER (Update a datamover) . . . . . . . . . . . . .. 1301UPDATE DEVCLASS (Update the attributes ofa device class) . . . . . . . . . . .. 1303UPDATE DEVCLASS - z/OS media server(Update device class for z/OS media server) . 1360UPDATE DOMAIN (Update a policy domain) 1379UPDATE DRIVE (Update a drive) . . . .. 1381UPDATE FILESPACE (Update file-spacenode-replication rules) . . . . . . . .. 1385UPDATE LIBRARY (Update a library) . . .. 1390UPDATE LIBVOLUME (Change the status of astorage volume) . . . . . . . . . .. 1406UPDATE MACHINE (Update machineinformation) . . . . . . . . . . .. 1408UPDATE MGMTCLASS (Update amanagement class) . . . . . . . . .. 1410UPDATE NODE (Update node attributes) .. 1413

    UPDATE NODEGROUP (Update a nodegroup) . . . . . . . . . . . . .. 1431UPDATE PATH (Change a path) . . . .. 1432UPDATE POLICYSET (Update a policy setdescription) . . . . . . . . . . .. 1441UPDATE PROFILE (Update a profiledescription) . . . . . . . . . . .. 1443UPDATE RECOVERYMEDIA (Update recoverymedia) . . . . . . . . . . . . .. 1444UPDATE REPLRULE (Update replication rules) 1446UPDATE SCHEDULE (Update a schedule) 1448UPDATE SCRATCHPADENTRY (Update ascratch pad entry) . . . . . . . . .. 1472UPDATE SCRIPT (Update a Tivoli StorageManager script) . . . . . . . . . .. 1473UPDATE SERVER (Update a server defined forserver-to-server communications) . . . .. 1476UPDATE SERVERGROUP (Update a servergroup description) . . . . . . . . .. 1480UPDATE SPACETRIGGER (Update the spacetriggers) . . . . . . . . . . . . .. 1481UPDATE STATUSTHRESHOLD (Update astatus monitoring threshold) . . . . . .. 1483UPDATE STGPOOL (Update a storage pool) 1487UPDATE STGPOOLDIRECTORY (Update astorage pool directory) . . . . . . . .. 1533UPDATE VIRTUALFSMAPPING (Update avirtual file space mapping) . . . . . .. 1535UPDATE VOLHISTORY (Update sequentialvolume history information) . . . . . .. 1537UPDATE VOLUME (Change a storage poolvolume) . . . . . . . . . . . . .. 1539

    VALIDATE commands . . . . . . . . .. 1543VALIDATE LANFREE (Validate LAN-Freepaths) . . . . . . . . . . . . .. 1544VALIDATE POLICYSET (Verify a policy set) 1546VALIDATE REPLICATION (Validatereplication for a client node) . . . . . .. 1548VALIDATE REPLPOLICY (Verify the policieson the target replication server) . . . . .. 1553

    VARY (Bring a random access volume online oroffline) . . . . . . . . . . . . . .. 1556

    Chapter 3. Server options . . . .. 1559Modifying server options . . . . . . . .. 1559Types of server options. . . . . . . . .. 1560

    Server communication options . . . . .. 1560Server storage options . . . . . . . .. 1562Client-server options . . . . . . . .. 1563Date, number, time, and language options .. 1563Database options . . . . . . . . . .. 1563Data transfer options . . . . . . . .. 1564Message options . . . . . . . . . .. 1564Event logging options . . . . . . . .. 1565Security options and licensing options. . .. 1565Miscellaneous options . . . . . . . .. 1566

    3494SHARED . . . . . . . . . . . .. 1567ACSACCESSID . . . . . . . . . . .. 1568ACSLOCKDRIVE . . . . . . . . . .. 1569ACSQUICKINIT . . . . . . . . . . .. 1570ACSTIMEOUTX . . . . . . . . . . .. 1571

    Contents ix

    |||

  • ACTIVELOGDIRECTORY . . . . . . . .. 1572ACTIVELOGSIZE . . . . . . . . . .. 1573ADMINCOMMTIMEOUT . . . . . . . .. 1574ADMINIDLETIMEOUT . . . . . . . .. 1575ADMINONCLIENTPORT . . . . . . . .. 1576ALIASHALT . . . . . . . . . . . .. 1577ALLOWREORGINDEX. . . . . . . . .. 1578ALLOWREORGTABLE . . . . . . . . .. 1579ARCHFAILOVERLOGDIRECTORY. . . . .. 1580ARCHLOGCOMPRESS. . . . . . . . .. 1581ARCHLOGDIRECTORY . . . . . . . .. 1582ARCHLOGUSEDTHRESHOLD . . . . . .. 1583ASSISTVCRRECOVERY . . . . . . . .. 1584AUDITSTORAGE . . . . . . . . . .. 1585CHECKTAPEPOS . . . . . . . . . .. 1586CLIENTDEDUPTXNLIMIT . . . . . . .. 1588COMMMETHOD . . . . . . . . . .. 1590COMMTIMEOUT . . . . . . . . . .. 1592DBDIAGLOGSIZE . . . . . . . . . .. 1593DBDIAGPATHFSTHRESHOLD . . . . . .. 1595DBMEMPERCENT . . . . . . . . . .. 1596DBMTCPPORT . . . . . . . . . . .. 1597DEDUPREQUIRESBACKUP . . . . . . .. 1598DEDUPTIER2FILESIZE. . . . . . . . .. 1599DEDUPTIER3FILESIZE. . . . . . . . .. 1600DEVCONFIG . . . . . . . . . . . .. 1601DISABLEREORGTABLE . . . . . . . .. 1602DISABLESCHEDS . . . . . . . . . .. 1603DISALLOWDES . . . . . . . . . . .. 1604DISPLAYLFINFO. . . . . . . . . . .. 1605DNSLOOKUP . . . . . . . . . . . .. 1606DRIVEACQUIRERETRY . . . . . . . .. 1607ENABLENASDEDUP . . . . . . . . .. 1608EVENTSERVER . . . . . . . . . . .. 1609EXPINTERVAL . . . . . . . . . . .. 1610EXPQUIET . . . . . . . . . . . . .. 1611FFDCLOGNAME . . . . . . . . . .. 1612FFDCMAXLOGSIZE . . . . . . . . .. 1613FFDCNUMLOGS. . . . . . . . . . .. 1614FILEEXIT . . . . . . . . . . . . .. 1615FILETEXTEXIT . . . . . . . . . . .. 1616FSUSEDTHRESHOLD . . . . . . . . .. 1617IDLETIMEOUT . . . . . . . . . . .. 1618LANGUAGE . . . . . . . . . . . .. 1619LDAPCACHEDURATION. . . . . . . .. 1621LDAPURL . . . . . . . . . . . . .. 1622MAXSESSIONS . . . . . . . . . . .. 1623MESSAGEFORMAT . . . . . . . . . .. 1624MIRRORLOGDIRECTORY . . . . . . .. 1625MOVEBATCHSIZE . . . . . . . . . .. 1626MOVESIZETHRESH . . . . . . . . .. 1627MSGINTERVAL . . . . . . . . . . .. 1628NDMPCONNECTIONTIMEOUT . . . . .. 1629NDMPCONTROLPORT . . . . . . . .. 1630NDMPENABLEKEEPALIVE . . . . . . .. 1631NDMPKEEPIDLEMINUTES . . . . . . .. 1632NDMPPORTRANGE . . . . . . . . .. 1633NDMPPREFDATAINTERFACE . . . . . .. 1634NOPREEMPT . . . . . . . . . . . .. 1635NORETRIEVEDATE. . . . . . . . . .. 1636NUMOPENVOLSALLOWED. . . . . . .. 1637

    PUSHSTATUS . . . . . . . . . . . .. 1639QUERYAUTH . . . . . . . . . . . .. 1640RECLAIMDELAY . . . . . . . . . .. 1641RECLAIMPERIOD . . . . . . . . . .. 1642REORGBEGINTIME. . . . . . . . . .. 1643REORGDURATION . . . . . . . . . .. 1644REPORTRETRIEVE . . . . . . . . . .. 1645REPLBATCHSIZE . . . . . . . . . .. 1646REPLSIZETHRESH . . . . . . . . . .. 1647REQSYSAUTHOUTFILE . . . . . . . .. 1648RESOURCETIMEOUT . . . . . . . . .. 1649RESTOREINTERVAL . . . . . . . . .. 1650RETENTIONEXTENSION . . . . . . . .. 1651SANDISCOVERY. . . . . . . . . . .. 1652SANDISCOVERYTIMEOUT . . . . . . .. 1653SANREFRESHTIME . . . . . . . . . .. 1654SEARCHMPQUEUE. . . . . . . . . .. 1655SERVERDEDUPTXNLIMIT . . . . . . .. 1656SHMPORT . . . . . . . . . . . . .. 1658SHREDDING . . . . . . . . . . . .. 1659SNMPHEARTBEATINTERVAL . . . . . .. 1660SNMPMESSAGECATEGORY. . . . . . .. 1661SNMPSUBAGENT . . . . . . . . . .. 1662SNMPSUBAGENTHOST . . . . . . . .. 1663SNMPSUBAGENTPORT . . . . . . . .. 1664SSLDISABLELEGACYTLS . . . . . . . .. 1665SSLFIPSMODE . . . . . . . . . . .. 1666SSLINITTIMEOUT . . . . . . . . . .. 1667SSLTCPADMINPORT . . . . . . . . .. 1668SSLTCPPORT . . . . . . . . . . . .. 1669SSLTLS12 . . . . . . . . . . . . .. 1670TCPADMINPORT . . . . . . . . . .. 1671TCPBUFSIZE . . . . . . . . . . . .. 1672TCPNODELAY . . . . . . . . . . .. 1673TCPPORT . . . . . . . . . . . . .. 1674TCPWINDOWSIZE . . . . . . . . . .. 1675TECBEGINEVENTLOGGING . . . . . .. 1676TECHOST . . . . . . . . . . . . .. 1677TECPORT . . . . . . . . . . . . .. 1678TECUTF8EVENT . . . . . . . . . . .. 1679THROUGHPUTDATATHRESHOLD . . . .. 1680THROUGHPUTTIMETHRESHOLD . . . .. 1681TXNGROUPMAX . . . . . . . . . .. 1682UNIQUETDPTECEVENTS . . . . . . .. 1683UNIQUETECEVENTS . . . . . . . . .. 1684USEREXIT . . . . . . . . . . . . .. 1685VERBCHECK . . . . . . . . . . . .. 1686VOLUMEHISTORY . . . . . . . . . .. 1687

    Chapter 4. Server utilities. . . . .. 1689DSMSERV (Start the server) . . . . . . .. 1690Server startup script: rc.dsmserv . . . . .. 1692DSMSERV DISPLAY DBSPACE (Displayinformation about database storage space) . .. 1693DSMSERV DISPLAY LOG (Display recovery loginformation) . . . . . . . . . . . .. 1694DSMSERV EXTEND DBSPACE (Increase space forthe database) . . . . . . . . . . . .. 1696DSMSERV FORMAT (Format the database andlog) . . . . . . . . . . . . . . .. 1698

    x IBM Tivoli Storage Manager for AIX: Administrator's Reference

    ||

  • DSMSERV INSERTDB (Move a server databaseinto an empty database) . . . . . . . .. 1701DSMSERV LOADFORMAT (Format a database) 1704DSMSERV REMOVEDB (Remove a database) 1706DSMSERV RESTORE DB (Restore the database) 1707

    DSMSERV RESTORE DB (Restore a database toits most current state) . . . . . . . .. 1708DSMSERV RESTORE DB (Restore a database toa point-in-time) . . . . . . . . . .. 1712

    DSMULOG (Capture Tivoli Storage Managerserver messages to a user log file) . . . . .. 1717

    Appendix A. Return codes for use inIBM Tivoli Storage Manager scripts . 1719

    Appendix B. Accessibility featuresfor the Tivoli Storage Managerproduct family . . . . . . . . .. 1723

    Notices . . . . . . . . . . . .. 1725

    Glossary . . . . . . . . . . . .. 1729

    Index . . . . . . . . . . . . .. 1731

    Contents xi

  • xii IBM Tivoli Storage Manager for AIX: Administrator's Reference

  • About this publication

    IBM Tivoli Storage Manager is a client/server program that provides storagemanagement solutions to customers in a multi-vendor computer environment.Tivoli Storage Manager provides an automated, centrally scheduled,policy-managed backup, archive, and space-management facility for file serversand workstations.

    This publication provides you with the commands and options that you can use tomanage the Tivoli Storage Manager server.

    Who should read this guideThis reference is intended for anyone who is registered as an administrator. Asingle administrator can manage Tivoli Storage Manager, or several people canshare administrative responsibilities.

    You should be familiar with the operating system on which the server resides andthe communication protocols required for the client/server environment. You alsoneed to understand the storage management practices of your organization, suchas how you are currently backing up workstation files and how you are usingstorage devices.

    PublicationsThe Tivoli Storage Manager product family includes IBM Tivoli StorageFlashCopy Manager, IBM Tivoli Storage Manager for Space Management, IBMTivoli Storage Manager for Databases, and several other storage managementproducts from IBM.

    To view IBM product documentation, see http://www.ibm.com/support/knowledgecenter.

    Conventions used in this publicationv Command to be entered on the AIX 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 characterscorresponds to the number of bytes available to store an item. For languages inwhich it takes a single byte to represent a displayable character, the character tobyte ratio is 1 to 1. However, for DBCS and other multi-byte languages, thereference to characters refers only to the number of bytes available for the item andmay represent fewer actual characters.

    Copyright IBM Corp. 1993, 2015 xiii

    http://www.ibm.com/support/knowledgecenterhttp://www.ibm.com/support/knowledgecenter

  • xiv IBM Tivoli Storage Manager for AIX: Administrator's Reference

  • New for Tivoli Storage Manager Version 7.1.3

    Many features in the IBM Tivoli Storage Manager Version 7.1.3 server are new forprevious Tivoli Storage Manager users.

    New and changed information in this product documentation is indicated by avertical bar (|) to the left of the change.

    Operations Center updatesNew features and other changes are available in Tivoli Storage ManagerOperations Center Version 7.1.3. By using the updated Operations Center userinterface, you can simplify the process of replicating client data, creating storagepools, decommissioning clients, and verifying license compliance.

    The following enhancements were made to the Operations Center administrativeinterface:

    ReplicationYou can complete the following tasks:v Configure source and target server pairsv Selectively enable and disable replication for one or more clientsv Monitor replication status and view historical trends for the replication

    rate and workloadv Manually start replication processing

    Storage Pools pageYou can complete the following tasks:v Create storage pools, including container storage pools, which provide

    inline data deduplication. Container storage pools store data in filesystem directories or in cloud storage.

    v View detailed information about container storage pools. You can viewproperties that are unique to this new pool type and view the storagecapacity that was saved through data deduplication.

    Decommission clients and deactivate dataYou can safely withdraw a client from service so that it is removed onlyafter its backup data expires. Decommissioning a client deletes its scheduleassociations and prevents the client from accessing the server. For TivoliStorage Manager for Databases: Data Protection for Oracle applicationclients, you can deactivate backup data that was stored before a specifieddate and time.

    Services pageYou can complete the following tasks:v Create management classesv View inactive policy settingsv Edit policy sets and activate changes

    License complianceYou can view front-end and back-end capacity usage to estimatecompliance with Tivoli Storage Manager Suite for Unified Recovery licenseentitlements.

    Copyright IBM Corp. 1993, 2015 xv

  • Command builderYou can view syntax cues and other command-completion assistance in theOperations Center command-line interface.

    REST API accessYou can enable the integration services feature to allow applications thatuse Representational State Transfer (REST) services to query and managethe storage environment by connecting to the Operations Center.

    Improvements in Tivoli Storage Manager client management servicesNew features are added to improve the collection of diagnostic informationfrom clients for basic monitoring capability in the Operations Center.

    You can complete the following tasks with the Tivoli Storage Managerclient management service:v Verify that a node definition is correctly created with the CmsConfig

    verify command.v Add a client node definition with the CmsConfig addnode command.v Add the location of client log files to an existing node definition with

    the CmsConfig addlog command.v Specify a configuration path with the CmsConfig discover command to

    discover log files that are in non-default locations.v Optionally, create REST applications to initiate client actions such as

    reading and updating configuration files, querying the status of theclient acceptor and scheduler, and backing up and restoring data on abackup-archive client.

    For more information about these enhancements, see the Operations Center help.

    To open the help, hover over the help icon ?

    on the Operations Center menubar.

    Tivoli Storage Manager server updatesNew features and other changes are available in the Tivoli Storage ManagerVersion 7.1.3 server.

    Optimize a storage environment by using inline datadeduplication

    With Tivoli Storage Manager Version 7.1.3, you can define a type of storage poolthat provides both inline and client-side data deduplication. You can use the newstorage pool, directory-container, to protect backup and archive data.

    The directory-container storage pool provides the following benefits:v Simplified storage managementv Optimized data-deduplication processingv Reduced database growth and sizev Increased server performance and scalabilityv Improved recoverability of damaged extents

    xvi IBM Tivoli Storage Manager for AIX: Administrator's Reference

  • Back up data to a cloud computing systemWith Tivoli Storage Manager Version 7.1.3, you can define a new type ofcloud-container storage pool. The cloud-container storage pool protects backup andarchive data that is integrated with data deduplication. You can back up the datato either an IBM SoftLayer or OpenStack Swift cloud computing system.

    The cloud-container storage pool provides the following benefits:v Reduced on-premises storage requirements and costv Simplified storage managementv Improved server performancev Use of public, off-premises, or private, on-premises cloud storagev Secure data through server-side encryption

    Archive diagnostic messages by using operating system toolsTivoli Storage Manager Version 7.1.3 simplifies the process of archiving diagnosticmessages by using operating system tools. To archive diagnostic messages, you donot have to reset the DBDIAGLOGSIZE server option every time that the server isstarted.

    In earlier releases, the maximum value of the DBDIAGLOGSIZE server option wasautomatically reset to 1024 each time the server was restarted, and it was notpossible to change this. This setting limited space for diagnostic log files to 1024MB. In this release, you can set the value of the DBDIAGLOGSIZE server option to 0.If you specify a value of 0, only one log file is used for all diagnostic messages. Nolimits are imposed on the size of the log file. In this way, you can archivediagnostic messages without having to reset the DBDIAGLOGSIZE value and interruptsystem operations.Related reference:DBDIAGLOGSIZE on page 1593

    Start the server in maintenance modeWith Tivoli Storage Manager Version 7.1.3, maintenance mode is the preferredmethod for starting the server before you begin maintenance or reconfigurationtasks. When you start the server in maintenance mode, operations that mightdisrupt maintenance or reconfiguration tasks are automatically disabled.

    Start the server in maintenance mode by running the DSMSERV utility with theMAINTENANCE parameter.Related reference:DSMSERV (Start the server) on page 1690

    Decommission a client nodeWith Tivoli Storage Manager Version 7.1.3, you can remove a client node from theproduction environment in a systematic way.

    When you start the decommission process, the server locks the client node toprevent it from accessing the server. Files that belong to the client node aregradually deleted, and then the client node is deleted.Related reference:DECOMMISSION NODE (Decommission an application or system) on page 127DECOMMISSION VM (Decommission a virtual machine) on page 130

    New for Tivoli Storage Manager Version 7.1.3 xvii

  • Deactivate data to free server storage spaceTivoli Storage Manager Version 7.1.3 simplifies the process of deleting activebackup data that you no longer require. You can deactivate the data to ensure thatthe file will be deleted by the inventory expiration process. In this way, you canfree storage space on the Tivoli Storage Manager server.

    The deactivation feature applies only to application clients that protect Oracledatabases.Related reference:DEACTIVATE DATA (Deactivate data for a client node) on page 123

    Narrow the search results when you query sessionsWith Tivoli Storage Manager Version 7.1.3, you can narrow the search results of theQUERY SESSION command to obtain query output for specific clients. For example, ifa Tivoli Storage Manager solution includes hundreds of clients, you can run theQUERY SESSION command with the CLIENTNAME parameter to obtain sessioninformation for a specified client or group of clients.

    In addition, you can use the TYPE parameter on the QUERY SESSION command tonarrow the search based on session type. You can set the TYPE parameter to displayinformation about administrative sessions, server-to-server sessions, or clientsessions.Related reference:QUERY SESSION (Query client sessions) on page 980

    Specify an action for all client nodesWith Tivoli Storage Manager Version 7.1.3, you can use the DEFINE CLIENTACTIONcommand to schedule one or more clients to process a command for a one-timeaction.Related reference:DEFINE CLIENTACTION (Define a one-time client action) on page 143

    Simplified solution implementation in a revised documentation setTivoli Storage Manager Version 7.1.3 introduces documentation that is designed tostreamline and simplify the process of setting up a Tivoli Storage Managersolution.

    Review the revised documentation set:v To plan, implement, monitor, and operate a single-site or multisite disk solution,

    see Tivoli Storage Manager data protection solutions (http://www.ibm.com/support/knowledgecenter/SSGSG7_7.1.3/srv.solutions/t_solutions_main.html).The solution-based documentation includes new content and some informationfrom previous releases of the Administrator's Guide.

    v To complete configuration and operations tasks that are not related to a specificsolution, see Configuring and managing the storage environment(http://www.ibm.com/support/knowledgecenter/SSGSG7_7.1.3/srv.admin/r_configuring_srv.html).

    xviii IBM Tivoli Storage Manager for AIX: Administrator's Reference

    http://www.ibm.com/support/knowledgecenter/SSGSG7_7.1.3/srv.solutions/t_solutions_main.htmlhttp://www.ibm.com/support/knowledgecenter/SSGSG7_7.1.3/srv.solutions/t_solutions_main.htmlhttp://www.ibm.com/support/knowledgecenter/SSGSG7_7.1.3/srv.admin/r_configuring_srv.htmlhttp://www.ibm.com/support/knowledgecenter/SSGSG7_7.1.3/srv.admin/r_configuring_srv.htmlhttp://www.ibm.com/support/knowledgecenter/SSGSG7_7.1.3/srv.admin/r_configuring_srv.html

  • Tivoli Monitoring for Tivoli Storage Manager updatesYou can use IBM Tivoli Monitoring for Tivoli Storage Manager Version 7.1.3 tomonitor Tivoli Storage Manager servers and to produce historical reports aboutserver and client activities.

    The documentation for Tivoli Monitoring for Tivoli Storage Manager is notupdated in this release of IBM Knowledge Center. Product documentation isavailable in Tivoli Monitoring for Tivoli Storage Manager.

    New for Tivoli Storage Manager Version 7.1.3 xix

    https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/Tivoli%20Storage%20Manager/page/Tivoli%20Monitoring%20for%20Tivoli%20Storage%20Manager

  • xx IBM Tivoli Storage Manager for AIX: Administrator's Reference

  • Chapter 1. Managing the server from the command line

    Tivoli Storage Manager provides several different command-line interfaces formanaging Tivoli Storage Manager servers.

    About this task

    The following command-line interfaces are available:

    Administrative command-line clientThe administrative command-line client is a program that runs on a fileserver, workstation, or mainframe. It is installed as part of the TivoliStorage Manager server installation process. The administrative client canbe accessed remotely.

    From the administrative client, you can issue any server commands.

    Server consoleThe server console is a command-line window on the system where theserver is installed. Therefore, to use the server console, you must be at thephysical location of the server system.

    Compared to the administrative client, the capabilities of the server consoleare limited. From the server console, you cannot issue certain commands,and you cannot route commands to other servers. Also, you cannot specifythat certain commands process before other commands can be issued.However, this limitation can be useful if, for example, you want to run twocommands in quick succession.

    Operations Center command lineFrom the Operations Center, you can access the Tivoli Storage Managercommand line. You might want to use this command line to issue servercommands to complete certain Tivoli Storage Manager tasks that are notsupported in the Operations Center.

    Server scripts provide for automation of common administrative tasks. A macro isa file that contains one or more Tivoli Storage Manager administrative commands.When you issue the MACRO command, the server processes all commands in themacro file in order, including commands that are contained in any nested macros.

    Issuing commands from the administrative clientThe administrative command-line client is a program that runs on a file server,workstation, or mainframe.

    About this task

    Ensure that your administrative client and your server are running in compatiblelanguages. See LANGUAGE on page 1619 for language and locale options. Ifyour client and server are using different languages, the messages that TivoliStorage Manager generates might not be understandable.

    Copyright IBM Corp. 1993, 2015 1

  • Note: Text strings that are sent from the client to the server do not depend on theserver language setting. The text will be displayed properly if the administrativeclient runs in the same locale when sending the string and when receiving thestring.

    For example, assume that you update a node contact field with a value thatcontains national characters (update node myNode contact=NLcontact_info), andlater query the node (query node myNode format=detailed). If the client is runningin the same locale when you update as when you query, the NLcontact_info willdisplay properly. If you update the node contact field when the client is running inone locale, and query the node when the client is running in a different locale, it ispossible that the NLcontact_info will not display properly.

    Starting and stopping the administrative clientUse the DSMADMC command to start an administrative client session.

    About this task

    The Tivoli Storage Manager server must be running before an administrative clientcan connect.

    Procedurev To start an administrative client session in command-line mode, enter this

    command on your workstation:dsmadmc -id=admin -password=admin -dataonly=yes

    By entering the DSMADMC command with the -ID and -PASSWORD options asshown, you are not prompted for a user ID and password.

    v To stop an administrative command-line client session, enter the followingcommand:quit

    v To interrupt a DSMADMC command before the Tivoli Storage Manager serverfinishes processing it, use the UNIX kill -9 command from an availablecommand line. Do not press Ctrl+C because, while it ends the session, it canlead to unexpected results.

    Monitoring server activities from the administrative clientTo monitor Tivoli Storage Manager activities, such as server migration and clientlogons, run the administrative client in console mode. You cannot enter anyadministrative commands in console mode.

    Procedurev To start an administrative client session in console mode, enter the following

    command:dsmadmc -consolemode

    You are prompted for a password if authentication is turned on for the server. Ifyou do not want to be prompted for your user ID and password, enter theDSMADMC command with the -ID and -PASSWORD options.

    v To end an administrative client session in console mode, use a keyboard breaksequence.

    Operating system Break sequence

    UNIX and Linux clients Ctrl+C

    2 IBM Tivoli Storage Manager for AIX: Administrator's Reference

  • Operating system Break sequence

    Windows clients Ctrl+C or Ctrl+Break

    Monitoring removable-media mounts from the administrativeclient

    To monitor the mounting and dismounting of removable media, run theadministrative client in mount mode. When the client is running in mount mode,you cannot enter any administrative commands.

    Procedurev To start an administrative client session in mount mode, enter the following

    command:dsmadmc -mountmode

    You are prompted for a password if authentication is turned on for the server. Ifyou do not want to be prompted for your user ID and password, enter theDSMADMC command with the -ID and -PASSWORD options.

    v To end an administrative client session in mount mode, use a keyboard breaksequence.

    Operating system Break sequence

    UNIX and Linux clients Ctrl+C

    Windows clients Ctrl+C or Ctrl+Break

    Processing individual commands from the administrativeclient

    Use batch mode to enter a single administrative command. Your administrativeclient session automatically ends when the command is processed.

    About this task

    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 enterthe DSMADMC command with the -ID and -PASSWORD options.

    In batch mode, you must enter the complete command on one line. If a commanddoes not fit on one line, enter the command by using a macro or a script. If youspecify a parameter with a string of text using batch mode, enclose the text insingle quotation marks (' ') in the macro. Do not use double quotation marks forcommands in batch mode, because your operating system might not parse thequotation marks correctly.

    Chapter 1. Managing the server from the command line 3

  • Processing a series of commands from the administrativeclient

    Use the interactive mode to process a series of administrative commands.

    About this task

    To start an administrative client session in interactive mode, a server session mustbe available. To ensure the availability of server sessions for both administrativeand client node sessions, the interactive mode of the administrative client isdisconnected 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 moreinformation, see Using continuation characters to enter long commands on page13.

    To start an administrative session in interactive mode, enter:dsmadmc

    Do not enter a server command with the DSMADMC command. Doing so willstart the administrative client in batch, not interactive, mode. For example, do notenter:dsmadmc server_command

    You can automatically restart your administrative client session by enteringanother command each time the tsm: servername > prompt appears.

    Formatting output from commandsTivoli Storage Manager formats the output processed from commands according toyour screen or window width.

    About this task

    If the width of your screen or window is not wide enough to display the outputhorizontally, Tivoli Storage Manager arranges and displays the informationvertically.

    You can format the output of QUERY commands using the DISPLAYMODE andOUTFILE administrative client options.

    4 IBM Tivoli Storage Manager for AIX: Administrator's Reference

  • Saving command output to a specified locationThe most common use for redirecting output is to save the output from querycommands to a specified file or program. You can then browse the contents of thefile or, in some cases, print the contents.

    About this task

    Some platforms support redirection of output using special characters such as >,>>, and |. You can save the output from a command by entering redirectioncharacters at the end of the command. Redirection characters direct the output of acommand to a file or program you specify instead of to your screen. To redirectoutput, leave a blank between the redirection character and the file or programname. See the following examples.

    Note: When redirecting output, follow the naming conventions of the operatingsystem running your administrative client.

    If you want to: Enter this:

    Redirect the output of aQUERY DOMAIN commandto a new file in batch orinteractive mode

    dsmadmc -id=xxx -pa=xxx query domain acctg > dominfo.acc

    A single greater-than sign (>) indicates that Tivoli StorageManager redirects the output to a new file or writes over anexisting file.

    Append the output of aQUERY DOMAIN commandto the end of an existingfile in batch orinteractive mode

    dsmadmc -id=xxx -pa=xxx query domain acctg >> dominfo.acc

    Double greater-than signs (>>) indicates that Tivoli StorageManager appends the output to the end of an existing file.

    Redirect all output froman administrative clientsession in console modeto a program calledfilter.exe

    dsmadmc -console -id=admin -password=xxx | filter.exe

    The program can be set up to monitor the output for individualmessages as they occur and take appropriate action, such assending mail to another user.

    You can also redirect all output to a specified file by specifying the -OUTFILEoption with a destination file name. For example, enter:dsmadmc -id=sullivan -password=secret -consolemode -outfile=save.out

    Administrative client optionsIn all administrative client modes, you can use options to modify administrativeclient session responses.

    DSMADMC

    DSMADMC

    admin_client_option server_command

    Here is an example of a task and how to use the administrative client options: Youcan enter the DSMADMC command with your user ID and password by using the -IDand -PASSWORD options so that you are not prompted for that information. To haveTivoli Storage Manager redirect all output to a file, specify the -OUTFILE option

    Chapter 1. Managing the server from the command line 5

  • with a destination file name. For example, to issue the QUERY NODE command inbatch mode with the output redirected to the SAVE.OUT file, enter:dsmadmc -id=sullivan -password=secret -outfile=save.out query node

    Options

    Administrative client options can be specified with the DSMADMC command and arevalid from an administrative client session only. You can type an option inuppercase letters, lowercase letters, or any combination. Uppercase letters denotethe shortest acceptable abbreviation. If an option appears entirely in uppercaseletters, you cannot abbreviate it.

    -ALWAYSPromptSpecifies that a command prompt is displayed if the input is from thekeyboard or if it is redirected (for example, from a file). If this option is notspecified and the input is redirected, the command prompt is not written.

    If the input is redirected, only the command output is displayed. If this optionis specified, the command prompt and the command output are displayed.

    -CHECKAliashaltAllows the administrative client to recognize an alias for the HALT command asset in the ALIASHALT server option. See ALIASHALT on page 1577 fordetails.

    -COMMAdelimitedSpecifies that any tabular output from a server query is to be formatted ascomma-separated strings rather than in readable format. This option isintended to be used primarily when redirecting the output of an SQL query(SELECT command). The comma-separated value format is a standard dataformat, which can be processed by many common programs, includingspreadsheets, databases, and report generators.

    -CONsolemodeSpecifies that Tivoli Storage Manager runs in console mode. Most serverconsole output is echoed to your screen. The exception are items such asresponses to query commands that are issued from the console, trace output,or any system messages that displayed on the console.

    -DATAONLY=NO or YESSpecifies whether product version information and output headers displaywith the output. The default is NO.

    NO Specifies that the product version information and output column headersdisplay.

    YESSuppresses the product version information and output column headers.

    -DISPLaymode=LISt or TABleYou can force the QUERY output to tabular or list format regardless of thecommand-line window column width.

    If you are using the -DISPLAYMODE option and you want the output to go to afile, do not specify the -OUTFILE option. Use redirection to write to the file.

    -ID=useridSpecifies the administrator's user ID.

    -ItemcommitSpecifies that Tivoli Storage Manager commits commands inside a script or amacro as each command is processed.

    6 IBM Tivoli Storage Manager for AIX: Administrator's Reference

  • -MOUNTmodeSpecifies that Tivoli Storage Manager runs in mount mode. All serverremovable-media mount messages are echoed to your screen.

    -NEWLINEAFTERPromptSpecifies that a newline character is written after the command prompt andcommands that are entered from the keyboard are displayed underneath theprompt. If this option is not specified, commands entered from the keyboardare displayed to the right side of the prompt.

    -NOConfirmSpecifies that you do not want Tivoli Storage Manager to request confirmationbefore processing commands that affect the availability of the server or datathat is managed by the server.

    -OUTfileSpecifies that output from a server query is displayed in one row. If the outputin a row exceeds the column width that is defined by the server, the output isdisplayed on multiple lines in that row. This option is available in batch modeonly.

    -OUTfile=filenameSpecifies that output from a server query is redirected to a specified file. Inbatch mode, output is redirected to a file you specify and the format of theoutput matches the format of the output on your screen.

    In interactive, console, or mount mode sessions, output displays on yourscreen.

    -PAssword=passwordSpecifies the administrator's password.

    -QuietSpecifies that Tivoli Storage Manager does not display standard outputmessages to your screen. However, when you use this option, certain errormessages still appear.

    -SErveraddressSpecifies the server stanza in the dsm.sys file. The client uses the server stanzato determine the server it connects to. The SERVERADDRESS option is supportedby administrative clients that are running on UNIX, Linux, and Macintoshoperating systems only.

    -TABdelimitedSpecifies that any tabular output from a server query is to be formatted astab-separated strings rather than in readable format. This option is intended tobe used primarily when redirecting the output of an SQL query (SELECTcommand). The tab-separated value format is a standard data format, whichcan be processed by many common programs, including spreadsheets,databases, and report generators.

    -TCPPortSpecifies a TCP/IP port address for a Tivoli Storage Manager server. TheTCPPORT option is only supported by administrative clients that are running onWindows operating systems and is valid on the Windows administrative clientcommand line.

    -TCPServeraddressSpecifies a TCP/IP server address for a Tivoli Storage Manager server. The

    Chapter 1. Managing the server from the command line 7

  • TCPSERVERADDRESS option is only supported by administrative clients that arerunning on Windows operating systems and is valid on the Windowsadministrative client command line.

    In addition to the options that are listed here, you can also specify any option thatis in the client options file. Each option must be preceded with a hyphen anddelimited with a space.

    Issuing commands from the Operations CenterFrom the Operations Center command-line interface, you can issue commands tomanage Tivoli Storage Manager servers that are configured as hub or spokeservers.

    Procedure

    To open the command-line interface, hover over the globe icon

    in theOperations Center menu bar, and click Command Builder.

    Issuing commands from the server consoleTivoli Storage Manager provides a user ID named SERVER_CONSOLE that allowsyou to issue commands and administer the server from the server console afterTivoli Storage Manager is installed. At installation, SERVER_CONSOLE isautomatically registered as an administrator and is given system authority.

    About this task

    If you have system privilege, you can revoke or grant new privileges to theSERVER_CONSOLE user ID. You cannot take any of the following actions:v Register or update the SERVER_CONSOLE user IDv Lock or unlock the SERVER_CONSOLE user IDv Rename the SERVER_CONSOLE user IDv Remove SERVER_CONSOLE user IDv Route commands from the SERVER_CONSOLE user ID

    Not all Tivoli Storage Manager commands are supported by the server console.You cannot specify the WAIT parameter from the server console.

    Entering administrative commandsCommands consist of command names and usually parameters and variables.Syntax diagrams depict the rules to follow when entering commands.

    About this task

    To display command-line help for server commands that have unique names, youcan type help commandName, where commandName is the name of the servercommand for which you want information. For example, to display help for theREGISTER NODE command, type help register node. Command syntax andparameter descriptions are displayed in the output.

    You can also type help followed by the topic number for the command. Topicnumbers are listed in the table of contents for command-line help, for example:

    8 IBM Tivoli Storage Manager for AIX: Administrator's Reference

  • 3.0 Administrative commands3.46 REGISTER

    3.46.1 REGISTER ADMIN (Register an administrator)3.46.2 REGISTER LICENSE (Register a new license)3.46.3 REGISTER NODE (Register a node)

    To display help about the REGISTER NODE command, type:help 3.46.3

    Use topic numbers to display command-line help for subcommands. DEFINEDEVCLASS is an example of a command that has subcommands. For example, youcan specify the DEFINE DEVCLASS command for 3590 device classes and for 3592device classes:3.0 Administrative commands

    ...3.13.10 DEFINE DEVCLASS (Define a device class)

    3.13.10.1 DEFINE DEVCLASS (Define a 3590 device class)3.13.10.2 DEFINE DEVCLASS (Define a 3592 device class)...

    To display help for the DEFINE DEVCLASS command for 3590 device classes, type:help 3.13.10.1

    Reading syntax diagramsTo read a syntax diagram for entering a command, follow the path of the line.Read from left to right and from top to bottom.v The symbol indicates the beginning of a syntax diagram.v The symbol at the end of a line indicates that the syntax diagram continues

    onto the next line.v The symbol at the beginning of a line indicates that a syntax diagram

    continues from the previous line.v The symbol indicates the end of a syntax diagram.

    Command names

    The command name can consist of a single action word, such as HALT, or it canconsist of an action word and an object for the action, such as DEFINE DOMAIN.You can enter the command in any column of the input line.

    Enter the entire command name or the abbreviation that is specified in the syntaxdiagram for the command. Uppercase letters denote the shortest acceptableabbreviation. If a command appears entirely in uppercase letters, you cannotabbreviate it. You can enter the command in uppercase letters, lowercase letters, orany combination. In this example, you can enter CMDNA, CMDNAM, orCMDNAME in any combination of uppercase and lowercase letters.

    CMDNAme

    Note: Command names in descriptive text are always capitalized.

    Chapter 1. Managing the server from the command line 9

  • Required parameters

    When a parameter is on the same line as the command name, the parameter isrequired. When two or more parameter values are in a stack and one of them is onthe line, you must specify one value.

    In this example, you must enter PARMNAME=A, PARMNAME=B, orPARMNAME=C. Do not include any blanks immediately before or after the equalsign (=).

    PARMName = ABC

    Optional parameters

    When a parameter is below the line, the parameter is optional. In this example,you can enter PARMNAME=A or nothing at all. Do not include any blanksimmediately before or after the equal sign (=).

    PARMName = A

    When two or more parameter values are in a stack below the line, all of them areoptional. In this example, you can enter PARMNAME=A, PARMNAME=B,PARMNAME=C, or nothing at all. Do not include any blanks immediately beforeor after the equal sign (=).

    PARMNAme = A

    BC

    Defaults

    Defaults are above the line. The system uses the default unless you override it. Youcan override the default by entering an option from the stack below the line.

    In this example, PARMNAME=A is the default. You can also enterPARMNAME=A, PARMNAME=B, or PARMNAME=C. Do not include any blanksbefore or after the equal sign (=).

    PARMNAme = A

    PARMName = ABC

    Variables

    Highlighted lowercase items (like this) denote variables. In these examples,var_name represents variables::

    10 IBM Tivoli Storage Manager for AIX: Administrator's Reference

  • CMDNAme var_name

    PARMname = var_name

    Special characters

    You must code these symbols exactly as they appear in the syntax diagram.

    * Asterisk

    : Colon

    , Comma

    = Equal sign

    - Hyphen

    ( ) Parentheses

    . Period

    Repeating values

    An arrow returning to the left means that the item can be repeated. A characterwithin the arrow means that you must separate repeated items with that character.

    ,

    file_name

    Repeatable choices

    A stack of values followed by an arrow returning to the left means that you canselect more than one value or, when permitted, repeat a single item. In thisexample, you can choose more than one value, with each name delimited with acomma. Do not include any blanks before or after the equal sign (=).

    ,

    PARMNAme = value1value2value3

    Footnotes

    Footnotes are enclosed in parentheses.

    ,(1)

    file_name

    Notes:

    1 You can specify up to five file names.

    Chapter 1. Managing the server from the command line 11

  • Entering parameters

    The order in which you enter parameters can be important. The following exampleshows a portion of the command for defining a copy storage pool:

    DEFine STGpool pool_name device_class_name POoltype = COpy

    DESCription = description

    REClaim = 100

    REClaim = percent

    The first two parameters in this command (pool_name and device_class_name arerequired parameters. pool_name and device_class_name are also positional. That is,they must be entered in the order shown, immediately after the command name.The POOLTYPE parameter is a required keyword parameter. DESCRIPTION andRECLAIM, are optional keyword parameters. Keyword parameters are identified byan equal sign that specifies a specific value or a variable. Keyword parametersmust follow any positional parameters in a command.

    The following command entries, in which the keyword parameters are ordereddifferently, are both acceptable:define stgpool mycopypool mydeviceclass pooltype=copy description=engineering

    reclaim=50define stgpool mycopypool mydeviceclass description=engineering pooltype=copy

    reclaim=50

    The following example, in which one of the positional parameters follows akeyword parameter, is not acceptable:define stgpool mycopypool pooltype=copy mydeviceclass description=engineering

    reclaim=50

    Syntax fragments

    Some diagrams, because of their length, must display parts of the syntax withfragments. The fragment name appears between vertical bars in the diagram.

    The expanded fragment appears in the diagram after all other parameters or at thebottom of the diagram. A heading with the fragment name identifies the expandedfragment. Commands appearing directly on the line are required.

    In this example, the fragment is named Fragment.

    Fragment

    Fragment:

    A

    BC

    12 IBM Tivoli Storage Manager for AIX: Administrator's Reference

  • Using continuation characters to enter long commandsContinuation characters are useful when you want to process a command that islonger than your screen or window width. You can use continuation characters inthe interactive mode of the administrative client.

    About this task

    Without continuation characters, you can enter up to 256 characters. Withcontinuation characters, you can enter up to 1500 characters.

    Note: In the MACRO command, the maximums apply after any substitution variableshave been applied.

    With continuation characters, you can do the following:v Enter a dash at the end of the line you want to continue.

    For example:register admin pease mypasswd -contact="david, ext1234"

    v Continue a list of values by entering a dash or a back slash, with no precedingblank spaces, after the last comma of the list that you enter on the first line.Then, enter the remaining items in the list on the next line with no precedingblank spaces. For example:stgpools=stg1,stg2,stg3,-stg4,stg5,stg6

    v Continue a string of values that are enclosed in quotation marks by entering thefirst part of the string that is enclosed in quotation marks, followed by a dash ora back slash at the end of the line. Then, enter the remainder of the string on thenext line, enclosed in the same type of quotation marks.For example:contact="david pease, bldg. 100, room 2b, san jose,"-"ext. 1234, alternate contact-norm pass,ext 2345"

    Tivoli Storage Manager concatenates the two strings with no intervening blanks.You must use only this method to continue a quoted string of values acrossmore than one line.

    Naming Tivoli Storage Manager objectsIBM Tivoli Storage Manager restricts the number and type of characters that youcan use to name objects.

    About this task

    The following characters are available for defining object names.

    Character Description

    AZ Any letter, A through Z

    09 Any number, 0 through 9

    _ Underscore

    . Period

    - Hyphen

    + Plus

    & Ampersand

    Chapter 1. Managing the server from the command line 13

  • The following table shows the maximum length of characters permitted for namingobjects.

    Type of Name Maximum Length

    Administrators, client option sets, client nodes,passwords, server groups, server, names, virtual filespace names

    64

    Restartable export identifiers 64

    High-level and low-level TCP/IP (IPv4 or IPv6)addresses

    64

    Device classes, drives, libraries, management classes,policy domains, profiles, schedules scripts, backupsets, storage pools

    30

    The following characters are available for defining password names:a b c d e f g h i j k l m n o p q r s t u v w x y zA B C D E F G H I J K L M N O P Q R S T U V W X Y Z0 1 2 3 4 5 6 7 8 9~ ! @ # $ % ^ & * _ - + = ` | ( ) { } [ ] : ; < > , . ? /

    Passwords considered LOCAL are those passwords that authenticate with theTivoli Storage Manager server and are not case-sensitive. Passwords consideredLDAP are those passwords that authenticate with an LDAP directory server andare case-sensitive.

    When you use DEFINE commands to define database, recovery log, and storagepool volumes, the naming convention for the volume name is dependent on thetype of sequential access media or random access media that you are using. Referto the specific VOLUME command for details.

    Using wildcard characters to specify object namesIn some commands, such as the query commands, you can use wildcard charactersto create a pattern-matching expression that specifies more than one object. Usingwildcard characters makes it easier to tailor a command to your needs.

    About this task

    The wildcard characters you use depend on the operating system from which youissue commands. For example, you can use wildcard characters such as an asterisk(*) to match any (0 or more) characters, or you can use a question mark (?) or apercent sign (%) to match exactly one character.

    Table 1 provides references to wildcard characters for some operating systems. Usewildcard characters appropriate for your system.

    Table 1. Wildcard characters by operating system

    Operating system Match any Match exactly one

    AIX, HP-UX, Linux, OS/2, OracleSolaris, Windows

    * ?

    TSO * %

    14 IBM Tivoli Storage Manager for AIX: Administrator's Reference

  • For example, if you want to query all the management classes whose names beginwith DEV in all the policy sets in DOMAIN1, and your system uses an asterisk asthe match-any character, you can enter:query mgmtclass domain1 * dev*

    If your system uses a question mark as the match-exactly-one character, and youwant to query the management classes in POLICYSET1 in DOMAIN1, you canenter:query mgmtclass domain1 policyset1 mc?

    Tivoli Storage Manager displays information about management classes withnames MC.

    Table 2 shows additional examples of using wildcard characters to match anycharacters.

    Table 2. Match-any character

    Pattern Matches Does not match

    ab* ab, abb, abxxx a, b, aa, bb

    ab*rs abrs, abtrs, abrsrs ars, aabrs, abrss

    ab*ef*rs abefrs, abefghrs abefr, abers

    Table 3 shows additional examples of using wildcard characters to match exactlyone character. The question mark (?) can be replaced by a percent sign (%) if yourplatform uses that character instead of (?).

    Table 3. Match-exactly-one character

    Pattern Matches Does not match

    ab? abc ab, abab, abzzzz

    ab?rs abfrs abrs, abllrs

    ab?ef?rs abdefjrs abefrs, abdefrs, abefjrs

    ab??rs abcdrs, abzzrs abrs, abjrs, abkkkrs

    Specifying descriptions in keyword parametersIf a description (a string of text) for a parameter begins with a single or doublequotation mark, or contains any embedded blanks or equal signs, you mustsurround the value with either single (') or double (") quotation marks.

    About this task

    The opening and closing quotation marks must be the same type of quotationmarks. For example, if the opening quotation is a single quotation mark, theclosing quotation mark must also be a single quotation mark.

    For example, to register a new client node named Louie, with a password of secret,and with his title included as contact information, enter:register node louie secret contact="manager of dept. 61f"

    The following table presents ways of entering a description for the CONTACTparameter. The value can contain quotation marks, embedded blanks, or equalsigns.

    Chapter 1. Managing the server from the command line 15

  • For this description Enter this

    manager contact=manager

    manager's contact="manager's" or contact='manager"s'

    "manager" contact='"manager"' or contact="""manager"""

    manager's report contact="manager's report" or contact='manager''sreport'

    manager's "report" contact='manager''s "report"'

    manager=dept. 61f contact='manager=dept. 61f'

    manager reports to dept. 61f contact='manager reports to dept. 61f' orcontact="manager reports to dept. 61f"

    Controlling command processingYou can run some Tivoli Storage Manager commands sequentially or concurrentlywith other commands. You can also route commands from one server to otherservers for processing.

    About this task

    Server command processingTivoli Storage Manager processes administrator commands either in the foregroundor in the background. Commands that process in the foreground must completebefore you can issue another command. When commands are processing in thebackground, you can issue additional commands at any time.

    Most Tivoli Storage Manager commands process in the foreground. For somecommands that normally process in the background (for example, BACKUP DB),you can specify the WAIT parameter (WAIT=YES) with the command so that thecommand processes in the foreground. You might want to process a command inthe foreground rather than in the background for any of the following reasons:v To quickly determine whether a command completed successfully. When you

    issue a command that processes in the foreground, Tivoli Storage Manager sendsa confirmation message indicating that the command completed successfully. Ifyou process the command in the background, you need to open operationalreporting or query the activity log to determine whether the commandcompleted successfully.

    v To monitor server activities (for example, messages) on the administrative clientas a command is being processed. This might be preferable to searching a longactivity log after the command has completed.

    v To be able to start another process immediately after a command has completed.For example, you might specify WAIT=YES for a command that takes a shorttime to process so that, when the processing completes, you can immediatelystart processing another command.

    v To serialize commands in an administrative script when it is important that onecommand completes before another begins.

    Check the individual command description to determine whether a command hasa WAIT parameter.

    You can cancel commands that are processed in the foreground from the serverconsole or from another administrative client session.

    16 IBM Tivoli Storage Manager for AIX: Administrator's Reference

  • Each background process is assigned a process number. Use the QUERY PROCESScommand to obtain the status and process number of a background process.

    Note:

    v If you are defining a sched