Administrator’s Reference
Administrator’s Reference
  ″Notices″  appendix.
Edition  notice 
This  edition  applies  to  Version  5.5  of   the  IBM  Tivoli  Storage  Manager  for  AIX  (program  numbers  5608-HSM, 
5608-ISM,  5608-ISX,  5608-SAN,  5608-ARM)  and  to  any  subsequent  releases  until  otherwise  indicated  in  new  editions 
or  technical  newsletters. 
US  Government  Users  Restricted  Rights  –  Use,  duplication  or  disclosure  restricted   by  GSA  ADP  Schedule  Contract 
with   IBM
Tivoli   Storage
Conventions  used  in  this  guide  .  .  .   .   .  .  . xvii  
Accessibility  features  .  .  .   .   .  .  .   .   .  .  . xvii  
Technical changes for Version 5.5. . . xix
Chapter 1. Administering the server from the command line . . . . . . . . 1 Issuing  commands   from   the  administrative  client  .   . 1
Starting  and  stopping  the  administrative  client  .   . 2 Monitoring  server  activities  from  the 
administrative  client  .  .  .   .   .  .  .   .   .   .  . 2 Monitoring
administrative  client  .  .  .   .   .  .  .   .   .   .  . 3 Formatting  output  from   commands   .  .   .   .  .  . 4  
Saving  command  output  to  a  specified  location  .   . 4 Administrative  client  options  .   .  .  .   .   .  . . 5  
Issuing  commands   from   the  Administration  Center  . 7 Issuing
  commands
  from
  the
  server
  console
  . 11
Naming  Tivoli  Storage  Manager  objects  .   .  .  . 12 Using  wildcard  characters  to  specify  object  
names  .   .  .  .   .   .  .  .   .   .   .  .  .   .   . 12 
Server  command  processing  .   .   .  .  .   .   .  . 14 Cancelling
  commands
 
Routing  commands   to  a  server  group .   .   .   .  . 16 Routing  commands   to  server  groups  .   .   . .  . 17 
Routing  commands   to  two  servers  and  a  server 
group  .   .  .  .   .   .  .  .   .   .   .  .  .   .   . 17 Routing  commands   inside  scripts  .  .   .   .   .  . 17 
Privilege  classes  for  commands  .   .  .  .   .   .   .  . 18 
Commands  requiring  system  privilege  .   .   .  . 18 
Commands   requiring
Commands  any  administrator can  issue  .   .   .  . 23 
Chapter 2. Administrative commands 25 ACCEPT  commands  .   .  .  .   .   .  .  .   .   .   . 26 
ACCEPT  DATE  (Accepts  the  current  system  date)  27 
ACTIVATE  commands  .   .  .  .   .   . .  .   .   .   . 29 
management  class)  .   .  .  .   .   .  .  .   .   .   . 33 
AUDIT   commands   .   .   .  .  .   .   .  .  .   .   .   . 35 AUDIT  LIBRARY   (Audit  volume  inventories  in 
an  automated  library)  .  .  .   .   .  .  .   .   . . 36 AUDIT  LICENSES   (Audit  server  storage  usage)  38 
AUDIT  VOLUME  (Verify  database  information 
for   a
BACKUP   DEVCONFIG  (Create   backup  copies  of   device  configuration  information)  .  .   .   .  .  . 49 BACKUP   NODE   (Back  up  a   NAS  node)  .   .   .  . 51 
BACKUP   STGPOOL  (Back  up  primary  storage 
pool   to  copy   storage  pool)  .   .   .  .  .   .   .  . 55 BACKUP   VOLHISTORY   (Save  sequential  volume 
history   information)
process)  .  .  .   .   .  .  .   .   .   .  .  .   .   . 65 
operation)  .  .  .   .   .  .  .   .   .  .  .   .   . . 66 
process)  .  .  .   .   .  .  .   .   .   .  .  .   .   . 67 
CANCEL   REQUEST
sessions)  .  .  .   .   .  .  .   .   .   .  .   .   .   . 71 
CHECKOUT   commands  .  .  .   .   .  .  .   .   .   . 81 
COMMIT   (Control   committing  of   commands   in  a 
macro)   .   .   .  .  .   .   .  .  .   .   .   .  .  .   .   . 91 CONVERT  commands  .   .  .  .   .   .  .  .   .   .   . 93
CONVERT  ARCHIVE  (Allow  clients  to  query 
archive  files   by  description)  .   .  .  .   .   .   .  . 94 COPY
  commands
from  a   primary  storage  pool   to  an  active-data 
pool)  .   .   .  .  .   .   .  .  .   .   .   .  .   .   . 97 
COPY  DOMAIN   (Copy  a  policy  domain)  .   .   . 102 
COPY   MGMTCLASS
COPY  SCHEDULE   (Copy  a  client  or  an 
administrative  command  schedule)  .   .  .  .   . 110 COPY  SCRIPT  (Copy  a  Tivoli   Storage  Manager 
script)  .  .  .   .   .  .  .   .   .  .  .   .   .  .  . 114 
DEFINE   commands   .  .   .   .   .  .  .   .   .  .  . 116 DEFINE
option  set)  .  .  .   .   .  .  .   .   .   .  .  .   . 130 
name)  .   .   .   .  .   .   .   .  .  .   .   .  .  .   . 134 
group)   .
DEFINE   DBBACKUPTRIGGER  (Define  the 
database   backup  trigger)  .  .   .   .  .  .   .   . 152 DEFINE   DBCOPY  (Define  a  volume  copy   of   a 
database  volume)  .   .   .  .  .   .   .  .  .   .   . 154 
DEFINE   EVENTSERVER   (Define  a  server  as  the 
event  server)  .  .   .   .  .  .   .   .   .  .   .   . 240 
server  group)  .  .   .   .  .  .   .   .   .  .  .   . 241 
information)  .  .  . . .  .  .   .   .  .  .   .   . 256 
DEFINE   MACHNODEASSOCIATION  
DEFINE   MGMTCLASS
DEFINE   POLICYSET  (Define  a  policy  set)  .   .   . 272 
DEFINE   PROFASSOCIATION  (Define  a  profile 
association)  .  .  .   .   .  .  .   .   .   .  .  .   . 274 
DEFINE   RECMEDMACHASSOCIATION  
DEFINE   RECOVERYMEDIA
Manager  script)  .   .   .   .  .  .   .   .  .  .   . 308 
server-to-server  communications)  .   .   .  .  .   . 311 
group)   .   .   .   .  .  . . . . . .   .  .  .   . 316 DEFINE
subscription)  .  . .   .  .  .   .   .   .  .  .   . 360 DEFINE   VIRTUALFSMAPPING   (Define  a 
virtual  file  space  mapping)  .  .   .   .  .  .   .   . 362 
DEFINE   VOLUME   (Define  a  volume  in  a 
storage  pool)  .  .   .   .   .  .   .   .   .  .  .   . 364 
option  set)  .  . .   .   .   .  .   .   .   .  .  .   . 379 
DELETE   COLLOCGROUP   (Delete  a  collocation 
group)   .   .   .   .  .  . . . . . .   .  .  .   . 381 DELETE   COLLOCMEMBER  (Delete  collocation 
group   member)
DELETE   DOMAIN   (Delete  a  policy  domain)  391 
DELETE   DRIVE  (Delete  a  drive  from  a  library)  392 
DELETE   EVENT
DELETE   FILESPACE  (Delete  client  node   data 
from  the  server)  .   .   .  .  .   .   .   .  . . . 396 DELETE   GRPMEMBER  (Delete  a  server  from   a 
server  group)  .  .   .   .   .  .  .   .   .  . .   . 400 
DELETE   LIBRARY
iv IBM   Tivoli
class)  .   .  .  .   .   .   .  .  .   .   .  .  .   .   . 406 
DELETE   NODEGROUPMEMBER   (Delete  node  
DELETE   RECMEDMACHASSOCIATION  
association)  .  .   .   .  .  .   .   .   .  .   .   .   . 418 
DELETE   SERVERGROUP  (Delete  a  server 
group)  .   .  .  .   .   .   .  .  .   .   .  .  .   .   . 425 
or  recovery  log  space  triggers) .   .  .  .   .   .  . 426 
DELETE   STGPOOL
virtual  file  space  mapping)  .   .   .  .  .   .   .  . 432 
DELETE   VOLHISTORY  (Delete  sequential 
volume  history  information)  .   .  .  .   .   .  . 433 
volume)  
node   access  to  the  server)  .   .   .  .  .   .   .  . 446 
DISMOUNT   command  .  .  .   .   .  .  .   .   .   . 448 DISMOUNT   VOLUME   (Dismount  a  volume   by 
volume  name)  .   .   .  .  .   .   .   .  .  .   .   . 449 
DISPLAY   commands   .   .  .  .   .   .  .  .   .   .   . 450 
events  for  logging)  .  .  .   .   .  .  .   .   .  . 453 
the  server)  .  .   .   .  .  .   .   .   .  .  .   .   . 456 
END  commands   .   .   .  .  .   .   .   .  .  .   .   . 458 
ESTIMATE   DBREORGSTATS
information)  .  .   .   .  .  .   .   .  .  .   .   .   . 468 
information)  .  .   .   .  .  .   .   . .  .  .   .   . 474 
EXTEND   commands   .   .  .  .   .   .   .  .  .   .   . 513 
  database)
set  of   a  client’s  data)  .  . .   .   .  .  .   .   .   . 519 
GENERATE  BACKUPSETTOC   (Generate  a  table 
of   contents  for  a   backup  set)  .   .  .  .   .   .  . 527 
GRANT   commands   .   .   .  .   .   .   .  .  .   .   . 530 
 
to  a  client  node)   .   .  .  .   .   .  .  .   .   . . 535 HALT (Shut  down   the  server)  .   .   .  .  .   .   .  . 537 
HELP   (Get  help  on  commands  and  error  messages)  539 
IMPORT  commands  .   .   .  .   .   .   .  .  .   .   . 542 
information)   .
instructions)  .  .   .   .  .  .   .   .   .  .  .   . . 561 ISSUE  MESSAGE  (Issue  a  message  from  a  server 
script)  .   .   .   .  .   .   .   .  .  .   .   .  .  .   .   . 563 
LOCK   NODE  (Lock  out  a  client  node)  .   .   .  . 574 
LOCK   PROFILE   (Lock  a  profile)  .  .  .   .   . . 575 MACRO  (Invoke  a  macro)   .  .   . . .  . .   . . 577 
MIGRATE  STGPOOL  (Migrate  storage  pool   to  next  
storage  pool)  . . .   .   .  .   .   .   .  .  .   .   . 579 
MOVE   commands   .   .   .   .  .  .   .   .  .  .   . . 582 
volume)  
member)  .   .  .   .   .   .  .  .   .   .  .  .   .   . 601 
pool   media)  .  .   .   .   .  .  .   .   .  .  .   .   . 602 
sequential  access  storage  pool)  .  .  .   .   .  . 610 
NOTIFY   commands
PING   command  .   .   .   .  .   .   .   . . . . . 623  
servers)  .   .  .  .   .   .   .  .  .   .   .  .  .   . 624 PREPARE  (Create  a  recovery  plan  file)  .  .  .   .   . 625 
QUERY  commands  .   .   .  .  .   .   .   .  .  .   . 631 
QUERY  ACTLOG  (Query  the  activity  log)  .   .   . 633 QUERY  ADMIN  (Display  administrator 
information)   .
QUERY  BACKUPSETCONTENTS   (Query 
QUERY  CLOPTSET  (Query  a  client  option  set)  656 
QUERY   COLLOCGROUP
 
storage  pool   volume)  .   .  .  .   .   .  .  .   .   . 660 QUERY  COPYGROUP   (Query  copy  groups)  .   . 667 QUERY  DATAMOVER   (Display  data  mover 
definitions)  .  .  .   .   .  .  .   .   .  .  .   .   . 672 QUERY  DB  (Display  information  on  the 
database)  .   .  .  .   .   .   .  .  .   .   .  .  .   . 675 
one  or  more  device  classes)  .  .   .   .  .  .   .   . 684 
QUERY  DIRSPACE  (Query  storage  utilization  of   FILE   directories)  .   .   .  .  .   .   .  .  .   .   . 688 
QUERY  DOMAIN   (Query  a  policy  domain)  .   . 689 
QUERY  DRIVE   (Query  information  about  a 
drive)   .
manager  system  parameters)  .   .   .  .  .   .   . 705 QUERY  ENABLED   (Query  enabled  events)  .   . 708 
QUERY  EVENT   (Query  scheduled  and 
completed  events)  .   .   .  .  .   .   .  .  .   .   . 710 
or  client  events)  .   .   .  .  .   .   .  .  .   .   . 722 
spaces)  .   .   .  .   .   .   .  .  .   .   .  .  .   . 732 QUERY  LIBRARY  (Query  a  library)  .  .  .   .   . 738 
QUERY  LIBVOLUME   (Query  a  library  volume)  741 
QUERY  LICENSE   (Display  license  information)  744 
QUERY   LOG
storage  pool   media)  .   .  .  .   .   .  .  .   .   . 755 
class)  .   .   .   .  .  .   .   .  .  .   .   .  .  .   . 762 
images)  
QUERY  OCCUPANCY  (Query  client  file  spaces 
in  storage  pools)  .   .   .  .  .   .   .   .  .  .   . 782 
QUERY  PATH (Display  a  path  definition)  .   .   . 788 
QUERY  POLICYSET  (Query  a  policy  set)  .   .   . 792 
QUERY   PROCESS
QUERY  RECOVERYMEDIA   (Query  recovery 
mount  requests)  .   .   .  .  .   .   . .  .  .   . 805 
sessions)  
information  stored   on  a  target  server)  .  .  .   . 811 
QUERY  SAN  (Query  the  devices  on  the  SAN)   814 
QUERY  SCHEDULE   (Query  schedules) .  .   .   . 817 
QUERY  SCRIPT  (Query  Tivoli  Storage  Manager 
scripts)  .   .   .  .   .   .   .  .  . .   .  .  .   . 825 
QUERY   SERVER
triggers)  .   .  .  .   .   .   .  .  .   .   .  .  .   . 840 
value)  .   .   .   .  .   .   .   .  .  .   .   .  .  .   . 843 
QUERY   STGPOOL
configuration  and  capacity)  .  .   .   .  .  .   .   . 864 
QUERY  TOC  (Display  table  of   contents   for  a 
 backup   image)
volumes)  .   .  .  .   .   .   .  .  .   .   .  .  .   . 880 
administrative  client)  .   .  .  .   .   .  .  .   .   .  . 887 
RECLAIM  commands  .  .  .   .   .   .  .   .   .   . 888 
REDUCE   DB  (Decrease  the  assigned  capacity  of   the  database)  .   .   .  .  .   .   .   .  .  .   .   . 897 
REDUCE   LOG  (Decrease  the  assigned  capacity 
of   the  recovery  log)  .  .  .   .   .  .  .   .   .  . 898 REGISTER   commands  .  .  .   .   .  .  .   .   .   . 900 
REGISTER   ADMIN  (Register  an  administrator)  901 
REGISTER   LICENSE
RENAME   ADMIN  (Rename  an  administrator)  920 
RENAME   FILESPACE  (Rename  a client  file 
space  on  the  server)  .  .  .   .   .  .  .   . .   . 921 
RENAME   NODE
storage  pool)  .   .   .  .  .   .   .   .  .  .   .   . 927 
RESET  commands  .   .   .  .  .   .   .   .  .  .   .   . 929 
pool   statistics)
RESET  LOGMAXUTILIZATION   (Reset  the 
operation)  
RESTORE   VOLUME   (Restore  primary  volume 
data  from   a  copy   pool   or  an  active-data  pool)  . 947 
REVOKE   commands   .   .  .  .   .   .   .  .   .   .   . 952 
SELECT  (Perform  an  SQL  query  of   the  IBM  Tivoli  
Storage  Manager  Database)  .  .   .   .  .  .   .   .  . 962 
performance  .  .   .   .   .  .  .   .   .  .  .   .   . 970 
command  .  .   .   .   .  .  .   .   .  .  .   .   . 971 
period  or  the  size  of   the  activity  log)  .   .   .  . 977 
SET  ARCHIVERETENTIONPROTECTION  
SET  AUTHENTICATION   (Set  password 
configuration  refresh) .  .  .   .   .  .  .   .   .  . 985 SET  CONTEXTMESSAGING   (Set  message 
context  reporting  on  or  off)   .   .   .  .  .   .   .  . 987 
SET   CROSSDEFINE
 
SET  DRMCMDFILENAME   (Specify  the  name  of   a  file  to  contain  commands)  .   .  .  .   .   .  . 990 
SET  DRMCOPYSTGPOOL   (Specify  the  copy 
storage  pools  to   be  managed   by   DRM)   .   .   .  . 991 
SET  DRMCOURIERNAME   (Specify  the  courier 
name)  .   .   .  .  .   .   .  .  .   .   .  .  .   .   . 992 
SET   DRMDBBACKUPEXPIREDAYS
recovery  instructions  file  names)  .  .  .   .   .  . 996 
SET  DRMNOTMOUNTABLENAME   (Specify  the 
not  mountable  location  name)  .   .  .  .   .   .  . 998 SET  DRMPLANPREFIX  (Specify  a   prefix  for 
recovery   plan
SET  DRMRPFEXPIREDAYS  (Set  criteria  for 
recovery  plan  file  expiration)  . .  .  .   .   .   . 1004 
SET  DRMVAULTNAME   (Specify  the  vault 
name)  .   .  .  .   .   .  .  . .   .  .  .   .   . 1006 
period   for
period)  .   .  .  .   .   .  .  . .   .  .  .   .   . 1010 
log  records)   .  .  .   .   .  .  .   .   .   .  .  . 1011
SET  MAXSCHEDSESSIONS   (Set  maximum 
length)  
SET  REGISTRATION  (Set  open  or  closed 
registration)  .  .   .   .   .  .  .   .   .  .  .   . 1021 
attempts)  .   .  .  .   .   .  .  .   .   .  .  .   . 1023 
SET   SCHEDMODES
SET  SERVERNAME  (Specify  the  server  name)  1028 
SET  SERVERPASSWORD  (Set  password  for 
server)  .   .   .  .  .   .   .  .  .   .   .  .  .   . 1030 
SET   SQLDATETIMEFORMAT
arithmetic)  .  .  .   .   .   .  .  .   .   .  .  .   . 1034 
nodes)  .   .   .  .  .   .   .  .  .   .   .  .  .   . 1035 
SET   TAPEALERTMSG
SETOPT   (Set  a  server  option  for  dynamic  update)  1039 
SHRED   commands  .   .   .   .  .  .   .   .  .  .   . 1040 
running  export  operation)  .  .  .   .   .  .  .   .   . 1043 
UNLOCK   NODE   (Unlock  a  client  node)  .   .   . 1049 
UNLOCK   PROFILE  (Unlock  a  profile) .  .   .   . 1050 UPDATE  commands   .   .   .  .  .   .   .  .  .   . 1051 
UPDATE  ADMIN   (Update  an  administrator)  1052 
UPDATE  ARCHIVE  (Manage  archive  usage 
and   performance)
set  description)  .   .   .   .  .   .   .   .  .  .   . 1062 
UPDATE  DATAMOVER   (Update  a  data 
mover)  .   .   .  .  .   .   .  .  . .   .  .  .   . 1073 
UPDATE   DBBACKUPTRIGGER
UPDATE  DRIVE  (Update  a  drive)  .   .   .  .  . 1145 
UPDATE  LIBRARY   (Update  a  library)  .   .  .  . 1149 
UPDATE  LIBVOLUME  (Change  the  status  of   a 
storage  volume)  .  .  .   .   .  .  .   .   .   .  . 1155 
 
UPDATE  NODE   (Update  node   attributes)  .   . 1162 UPDATE  NODEGROUP   (Update  a  node  
group)   .  .   .   .   .  .   .   .   .  .  .   .   .  . 1170 UPDATE  PATH (Change  a  path)  .   .   .  .  . 1171 
UPDATE  POLICYSET  (Update  a  policy  set 
description)  .   .  .  .   .   .  .  .   .   .   .  . 1177 
description)  
Manager  script)  .  .   .   .  .  . .   .  .  .   . 1203 
server-to-server  communications)  .  .  .   .   . 1205 
group   description)
UPDATE  VOLHISTORY   (Update  sequential 
volume  history  information)  .   . .  .  .   .   . 1250 
volume)  .   .   .  .  .   .   .  .  . .   .  .  . . 1252 
VALIDATE   commands
VARY  (Bring  a  random  access  volume  online  or 
offline)  .   .   .   . .  .   .   .  .  . .   .  .  .   . 1262 
Types  of   server  options  .   .   .  .  . .   .  .  .   . 1265 
Communication   options
Database  and  recovery  log  options  . .  .   .   . 1267 Data  transfer  options  .   . . . . .   .  .   . 1268 
Message  options  .  .   .   .  .  . .   .  .  .   . 1268 
viii IBM   Tivoli
About  this  publication 
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   guide 
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. 
Tivoli   Storage  Manager  publications  and  other  related  publications  are  available 
online. 
You  can  search  all  the  Tivoli   Storage  Manager publications  in  the  Information 
Center:  http://publib.boulder.ibm.com/infocenter/tivihelp/v1r1/index.jsp 
You  can  download  PDF  versions  of   publications  from   the  IBM  Publications  Center: 
http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/ pbi.cgi
You  can  also  order  some  related  publications  from  this  Web  site.  The  Web  site 
provides  information  for  ordering  publications  from  countries  other  than  the 
United  States.  In  the  United  States,  you  can   order  publications   by  calling 
800-879-2755. 
Publication  Title  Order  Number 
IBM  
Tivoli  
Storage  
 Manager  
Problem  
Determination  
IBM  Tivoli  Storage    Manager   for   AIX    Administrator’s  Guide  SC32-0117 
IBM  
Tivoli  
Storage  
 Manager  
 for  
 AIX   
Publication  Title  Order  Number 
IBM  Tivoli  Storage   Manager   for   HP-UX    Administrator’s  Guide  SC32-0118 
IBM  Tivoli  Storage   Manager   for   HP-UX    Administrator’s  Reference  SC32-0124 
IBM  
Tivoli  
Storage  
 Manager  
 for  
Linux  
Installation  
Guide  
GC23-5971  
IBM  Tivoli  Storage   Manager   for  Linux   Administrator’s  Guide  SC32-0119 
IBM  Tivoli  Storage   Manager   for  Linux   Administrator’s  Reference  SC32-0125 
IBM  
Tivoli  
Storage  
 Manager  
 for  
Sun  
Solaris  
Installation  
Guide  
GC23-5972  
IBM  Tivoli  Storage   Manager   for  Sun  Solaris   Administrator’s  Guide  SC32-0120 
IBM  
Tivoli  
Storage  
 Manager  
 for  
Sun  
Solaris  
IBM  Tivoli  Storage   Manager   for  Windows   Administrator’s  Guide  SC32-0121 
IBM  
Tivoli  
Storage  
 Manager  
 for  
Windows  
IBM  Tivoli  Storage   Manager   for   z/OS  Administrator’s  Guide  SC32-0122 
IBM  
Tivoli  
Storage  
 Manager  
 for  
IBM  Tivoli  Storage   Manager   for  System  Backup  and   Recovery  Installation 
and  User’s  Guide 
Publication  Title  Order  Number 
Guide  
SC32-0129 
IBM  Tivoli  Storage   Manager   for  SAN    for   HP-UX   Storage    Agent  User’s 
Guide 
SC32-0130 
IBM  
Tivoli  
Storage  
 Manager  
 for  
SAN   
 for  
Linux  
Storage  
 Agent  
Guide  
SC32-0131 
IBM  Tivoli  Storage   Manager   for  SAN    for  Sun   Solaris  Storage    Agent 
User’s  Guide 
Publication  Title  Order  Number 
Installation  and  User’s  Guide 
SC32-0143 
IBM  
Tivoli  
Storage  
 Manager  
 for  
NetWare:  
Backup-Archive  
Clients  
Installation  
and  
Clients  Installation  and  User’s  Guide 
SC32-0145 
IBM  
Tivoli  
Storage  
 Manager  
 for  
Windows:  
Backup-Archive  
Clients  
Installation  
and  
Guide  
SC32-0146 
IBM  Tivoli  Storage   Manager   for  Space   Management   for  UNIX   and  Linux: 
User’s  Guide 
Publication  Title  Order  Number 
 
Publication  Title 
Guide  
 for  
Oracle  
SC33-8207  
IBM  Tivoli  Storage    Manager   for   Advanced  Copy  Services:  Data  Protection   for 
Snapshot  Devices   for  DB2  Installation  and  User’s  Guide 
SC33-8330 
IBM  
Tivoli  
Storage  
 Manager  
 for  
 Advanced  
Copy  
Services:  
Data  
Protection  
 for  
WebSphere  
 Application  
Server  
Installation  
and  
IBM  Tivoli  Storage    Manager   for  Databases:  Data  Protection   for  Informix  
Installation  and  User’s  Guide 
SH26-4095 
IBM  
Tivoli  
Storage  
 Manager  
 for  
Databases:  
Data  
Protection  
 for  
 Microsoft  
SQL  
Server  
Installation  
and  
Guide  
SC32-9059 
IBM  Tivoli  Storage    Manager   for  Databases:  Data  Protection   for  Oracle    for  UNIX   and  Linux  Installation  and  User’s  Guide 
SC32-9064 
IBM  
Tivoli  
Storage  
 Manager  
 for  
Databases:  
Data  
Protection  
 for  
Oracle  
 for  
Windows  
Installation  
and  
Guide  
SC32-9065 
IBM  Tivoli  Storage    Manager   for  Enterprise  Resource  Planning:   Data  Protection   for 
SAP  Installation  and  User’s  Guide   for  DB2 
SC33-6341 
IBM  
Tivoli  
Storage  
 Manager  
 for  
Enterprise  
Resource  
Planning:  
Data  
Protection  
 for  
SAP  
Installation  
and  
Guide  
 for  
Oracle  
SC33-6340 
IBM  Tivoli  Storage    Manager   for   Hardware:  Data   Protection   for  Enterprise   Storage 
Server®  for  DB2  UDB  Installation  and  User’s  Guide 
SC32-9060 
IBM  
Tivoli  
Storage  
 Manager  
 for  
 Hardware:  
Data  
Protection  
 for  
Snapshot  
Devices  
 for  
Oracle  
Installation  
and  
Guide  
GC32-1772 
IBM  Tivoli  Storage    Manager   for   Mail:  Data  Protection   for  Lotus  Domino   for 
UNIX,  Linux,   and  OS/400® Installation  and  User’s  Guide 
SC32-9056 
IBM  
Tivoli  
Storage  
 Manager  
 for  
 Mail:  
Data  
Protection  
 for  
Lotus  
Domino  
 for  
Windows  
Installation  
and  
Guide  
SC32-9057 
IBM  Tivoli  Storage    Manager   for   Mail:  Data  Protection   for   Microsoft  Exchange 
Server  Installation  and  User’s  Guide 
SC32-9058
Related   hardware  publications 
Put  your  short  description  here;  used for  first  paragraph  and  abstract. 
Title  Order  Number 
IBM   Magstar  3494  Tape  Library   Introduction  and  Planning  Guide  GA32-0279 
IBM  
3490E  
 Model  
E01  
and  
E11  
IBM   Magstar   MP  3570  Tape  Subsystem  Operator’s  Guide  GA32-0345 
IBM  TotalStorage  Tape  Device  Drivers  Installation  and  User’s  Guide  GC35-0154 
IBM  
TotalStorage  
Enterprise  
Tape  
System  
3590  
Operator  
Guide  
GA32-0330  
IBM  
TotalStorage  
Enterprise  
Tape  
System  
3592  
Operator  
Support  information 
You  can  find  support  information  for  IBM  products  from  a  number  of   different 
sources: 
Getting   technical  training 
http://www.ibm.com/software/tivoli/education/ 
Searching  knowledge  bases 
If   you have  a  problem  with  Tivoli   Storage  Manager,   there  is  a  variety  of   knowledge   bases  you  can   search. 
You  can   begin  with  the  Information  Center,   from   which  you  can  search  all  the 
Tivoli   Storage  Manager  publications:  http://publib.boulder.ibm.com/infocenter/ tivihelp/v1r1/index.jsp 
Searching the Internet If   you cannot  find  an  answer  to  your  question  in  the  information  center,  search  the 
Internet  for  the  latest,  most  complete  information  that  might  help  you  resolve  your 
problem. 
To search  multiple  Internet  resources,  go  to  the  support  web  site  for  Tivoli   Storage 
Manager:  http://www.ibm.com/software/sysmgmt/products/support/ IBMTivoliStorageManager.html.  From  this  section,  you  can  search  a  variety  of   resources  including: 
v   IBM  technotes 
v  IBM  downloads 
v  IBM  Redbooks™
If   you still   cannot  find  the  solution  to  your  problem,  you  can  search  forums  and 
newsgroups  on  the  Internet  for  the  latest  information  that  might  help  you  resolve 
your  problem. 
Using IBM Support Assistant The  IBM  Support  Assistant  is   a  free,  stand-alone  application  that  you  can  install  on 
any  workstation.  You  can  then  enhance  the  application   by  installing 
product-specific  plug-in  modules  for  the  IBM  products  you  use. 
The  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.  The  product-specific  plug-in  modules  provide  you  with  the  following 
resources: 
 
For  more  information,  see  the  IBM  Support  Assistant  Web  site  at 
http://www.ibm.com/software/support/isa/ 
Finding product fixes A  product  fix  might   be  available  to  resolve  your  problem.  You can  determine  what 
fixes  are  available   by  checking  the  product  support  Web  site. 
1.  Go   to  the  IBM  Software  Support  Web  site:  http://www.ibm.com/software/ tivoli/products/storage-mgr/product-links.html 
2.   Click  the 
Pages   link  for  your  Tivoli   Storage  Manager  product. 
3.  Click  Fixes  for  a  list  of   fixes  for  your  product. 
4.  Click  the  name  of   a  fix  to  read  the  description  and  optionally  download  the  fix.
Getting E-mail notification of product fixes You  can  sign  up  to  receive  weekly  E-mail  notifications  about  fixes  and  other  news 
about  IBM  products. 
1.  From  the  support  page  for  any  IBM  product,  click  My   support  in  the 
upper-right  corner  of   the  page. 
2.   If   you  have  already  registered,  skip  to   the  next  step.  If   you  have  not  registered, 
click  register  in  the  upper-right  corner  of   the  support  page  to  establish  your 
user  ID  and  password. 
4.   On  the  My  support  page,  click 
Edit  
profiles   in  the  left  navigation  pane,  and 
scroll  to  Select  Mail   Preferences. Select  a  product  family  and  check  the 
appropriate   boxes  for  the  type  of   information  you  want. 
5.  Click  Submit.  
6.  For  E-mail  notification  for  other  products,  repeat  steps  4  and  5.
Contacting  IBM  Software   Support 
Before  you  contact  IBM  Software  Support,  you  must  have  an  active  IBM  software 
maintenance  contract,  and  you  must   be  authorized  to  submit  problems  to  IBM.  The 
type  of   software  maintenance  contract  that  you  need  depends  on  the  type  of   product  you  have. 
v   For   IBM  distributed  software  products  (including,   but  not  limited  to, Tivoli, 
Lotus®,  and  Rational®  products,  as  well  as  DB2® and  WebSphere®  products  that 
run on  Windows® or   UNIX®  operating  systems),  enroll  in   Passport  Advantage®
in   one  of   the  following  ways: 
Online Go  to  the  Passport  Advantage  Web  page  (http://www.ibm.com/ software/sw-lotus/services/cwepassport.nsf/wdocs/passporthome)  and 
click  How  to  Enroll  
By  
phone  
For  the  phone  number  to  call  in  your  country,  go  to  the  IBM  Contacts 
Web  page  (http://techsupport.services.ibm.com/guides/contacts.html) 
and  click  the  name  of   your  geographic  region.
v   For   IBM  eServer™ software  products  (including,   but  not  limited  to,  DB2  and 
WebSphere  products  that  run in  zSeries®,  pSeries®,   and  iSeries™ environments), 
you  can   purchase  a  software  maintenance  agreement   by  working  directly  with 
an  IBM  sales  representative  or  an  IBM  Business  Partner.   For  more   information 
about  support  for  eServer  software products,  go  to  the  IBM  Technical  Support 
Advantage  Web  page:  http://www.ibm.com/servers/eserver/techsupport.html.
 
If   you are  not  sure   what  type  of   software  maintenance  contract  you  need,  call 
1-800-IBMSERV   (1-800-426-7378)  in  the  United  States.  For  a  list  of  telephone 
numbers  of   people  who  provide  support  for  your  location,  go   to  the  IBM  Contacts 
Web  page,  http://techsupport.services.ibm.com/guides/contacts.html,  and  click 
the  name  of   your  geographic  region. 
Perform  these  actions  to  contact  IBM  Software  Support: 
1.   Determine  the   business  impact  of   your  problem. 
2.  Describe  your  problem  and  gather   background  information. 
3.  Submit  your  problem  to  IBM  Software  Support.
Determine the business impact When  you  report  a  problem  to  IBM,  you  are  asked  to   supply  a  severity  level. 
Therefore,  you  need  to  understand  and  assess  the   business  impact  of   the  problem 
you  are  reporting. 
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
Describe your problem and gather background information When  explaining  a  problem  to  IBM,   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  re-created?  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  currently  using  a  workaround  for  this  problem?  If   so,   be  prepared  to  
explain  it   when  you  report  the  problem.
 
 
Submit your problem to IBM Software Support You  can  submit  your  problem  to  IBM  Software  Support  online  or   by  phone. 
Online 
Go  to  the  ″Submit  and  track  problems″ page  on  the  IBM  Software  Support 
site  http://www.ibm.com/software/support/probsub.html  .  Enter  your 
By  phone 
For  the  phone  number  to  call   in  your  country,  go  to  the  contacts  page  of   the  IBM  Software  Support  Handbook  on  the  Web  and  click  the  name  of   your  geographic  region.
If   the  problem  you  submit  is  for  a  software  defect  or   for  missing  or  inaccurate 
documentation,  IBM  Software  Support  creates  an  Authorized  Program  Analysis 
Report  (APAR).  The  APAR  describes  the  problem  in  detail.  Whenever  possible, 
IBM  Software  Support  provides  a  workaround  for  you  to  implement  until  the 
APAR  is  resolved  and  a  fix  is   delivered.  IBM  publishes  resolved  APARs  on  the 
IBM  product  support  Web  pages  daily,   so  that  other  users  who  experience  the 
same  problem  can   benefit  from  the  same  resolutions. 
Conventions  used   in  this guide 
v  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  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. 
Accessibility   features  
Accessibility  features  help  a  user  who  has  a  physical  disability,   such  as  restricted 
mobility  or  limited  vision,  to  use  software  products  successfully.   The  major 
accessibility  features  of   Tivoli   Storage  Manager  are  described  in  this  topic. 
v  Server  and  client  command-line  interfaces  provide  comprehensive  control  of   Tivoli   Storage  Manager  using  a  keyboard. 
v  The   Windows  client-graphical  interface  can   be  navigated  and  operated  using  a 
keyboard. 
v  The   Web   backup-archive  client  interface  is  HTML  4.0  compliant,  and  accessibility 
is   limited  only   by  the  choice  of   Internet   browser. 
v  All  user  documentation  is  provided  in   HTML  and  PDF  format.  Descriptive  text 
is   provided  for  all   documentation  images. 
v  The   Tivoli   Storage  Manager  for  Windows   Console  follows  Microsoft®
conventions  for  all  keyboard  navigation  and  access.  Drag  and  Drop  support  is  
handled  using  the  Microsoft  Windows  Accessibility  option  known  as 
MouseKeys.  For   more  information  about  MouseKeys  and  other  Windows 
accessibility  options,  please  refer  to  the  Windows  Online  Help  (keyword: 
MouseKeys).
Technical  changes  for  Version  5.5 
The  following  changes  have   been  made  to  the  product  for  this  edition: 
New  method  for  calculating  migration  thresholds  for  storage  pools  associated 
with  sequential-access  disk  (FILE)   devices 
In  previous  releases  of   Tivoli   Storage  Manager,   migration  thresholds  for storage  pools  associated  with  sequential-access  disk  (FILE)  devices  were  
 based  on  the  percentage  of   volumes  utilized.  In  this  release,  migration 
thresholds  are   based  on  a  percentage  of   the  storage  pool’s  total  data 
capacity.  Migration  thresholds  for  other  types  of   sequential-access  storage 
pools  are  still    based  on  the  percentage  of   volumes  utilized. 
For  example,  a  sequential-access  disk  storage  pool  with  a  total  capacity  of   100  TB  and  a  high  migration  threshold  of   70%  will   be  migrated  when  the 
pool  contains  70   TB  of   data.  This  method  of   calculating  migration 
thresholds  provides  a  potentially  more  efficient  use  of   large, 
sequential-access  disk  storage  pools.  The  server  continues  to  migrate  files 
 by  volume;  after  each  volume  is   migrated,  the  server  checks  to  determine 
if   the  low  migration  threshold  has   been  reached. 
When  you  start  the  version  5.5  server,   the  percentage  of   data  in  a 
FILE-type  storage  pool  that  can    be  migrated  is   immediately  recalculated 
using  the  new  metric.  If   you  are  upgrading  from   a  previous  version  of   Tivoli   Storage  Manager,   you  will  discover  that  more  data  must   be  stored 
 before  migration  starts.  Be   sure   to  adjust  your  migration  thresholds  so  that 
you  do   not  run out   of   space  for  routine  storage  operations  such  as  client 
 backups. 
v   DEFINE  STGPOOL—Primary  Sequential  Access 
v  UPDATE  STGPOOL—Primary  Sequential  Access
Concurrent  access  to  volumes  in   storage  pools  with  a  device  type  of   FILE  
In  previous  versions  of   Tivoli   Storage  Manager,   a  client  session  or  server 
process  had  to   wait  for  a  FILE  volume  if   the  volume  was  in  use   by  another 
session  or  process.  In  this  version,  the  Tivoli   Storage  Manager  server 
allows  concurrent  read  access  and  write  access  to  the  volume. 
Concurrent  access  improves  restore  performance   by  allowing  two  or  more 
clients  to  access  the  same  volume  at  the  same  time.  Multiple  client  sessions 
(archive,  retrieve,   backup,  and  restore)  or  server  processes  (for   example, 
storage  pool   backup)  can  read  the  volume  concurrently.  In  addition,  one 
client  session  can  write  to  the  volume  while  it  is   being  read. 
The  following  server  processes  are  allowed  shared  read   access  to  FILE 
volumes: 
v   RESTORE  VOLUME
The  following  server  processes  are  not  allowed  shared  read   access  to  FILE 
volumes: 
v   RECLAMATION
A   FILE  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. 
Restartable  server-to-server  export 
You  can  now  suspend  and  later  restart  an  export  operation  if   it   is   a 
server-to-server  export  that  is   designated  with  a  FILEDATA   value  other 
than  NONE.  If   an  export  operation  was  suspended   because  of   errors  or 
 because  the  SUSPEND  EXPORT   command  was  issued,  you  can  restart  the 
export  at  the  point  where  it  was  suspended.  To find  those  export 
operations  that  can   be  restarted,  issue  the  QUERY  EXPORT   command. 
You  can  also  specify  the  TODATE/TOTIME   parameter  when  issuing  an 
EXPORT   NODE  or  EXPORT   SERVER  command.  The  following  commands 
were  added  to  support  restartable  exports: 
v   CANCEL  EXPORT  
v   QUERY  EXPORT  
v   RESTART  EXPORT  
v   SUSPEND  EXPORT
IBM and HP LTO-4 Drive Support and Encryption Tivoli   Storage  Manager  now  supports  IBM  and  HP  LTO-4   tape  drives.  New 
recording  formats  are  available  for  the  LTO  device  class.  Tape  device 
encryption  is   also  supported.  Encryption  provides  security  for  data  on 
individual  tapes  and  protects  sensitive  information  that  might   be 
transported  off-site.  When  enabled,  Tivoli   Storage  Manager  handles 
encrypting  and  decrypting  data  on  tapes,  according  to  specifications  set 
when  defining  the  LTO  device  class.  To enable  drive  encryption  with  IBM 
LTO-4,  you  must  have  the  IBM  RMSS  Ultrium  device  driver  installed.  SCSI 
drives  do  not  support  IBM  LTO-4   encryption. 
For  details  about  encryption,  see  the   Administrator’s   Guide.
See  the  following  changed  commands: 
v   DEFINE  DEVCLASS—LTO  
v   UPDATE  DEVCLASS—LTO
New  support  for  Plasmon  and  IBM  UDO2  optical  disk  drives  and  media 
Tivoli   Storage  Manager  now  supports  Plasmon  and  IBM  UDO2  optical  disk 
drives  and  media.  A  new  recording  format  is  available  for  the  OPTICAL 
device  type.  You  cannot  mix  UDO1  and  UDO2  drives  in   a  single  library. 
See  the  following  changed  commands: 
v   DEFINE  DEVCLASS—Optical  and  WORM  types 
v   UPDATE  DEVCLASS—Optical  and  WORM  types
 
Support  for  long  file   names 
Tivoli   Storage  Manager  now  supports  up  to  8704   bytes  in  length  for  fully 
qualified  file  names  (a  file  name  and  file  path  combined).  This  support  is  
available  for  backup  and  restore  functions,  and  is   dependent  on  whether  or 
not  the  client  also  supports  the   byte  length.  Fully  qualified  file  names 
might   be  truncated  in  message  or  query  output.  To display  the  full  name, 
use  the  DISPLAY  OBJNAME  command. 
See  the  following  new  command: 
v  DISPLAY  OBJNAME
TCP/IP  Version   6 
Tivoli   Storage  Manager  is  now  able  to  use  TCP/IP  Version  6  (IPv6)  as  its 
communications  protocol.  IPv6  is   interoperable  with  TCP/IP  Version  4.  You 
can  specify  either  IPv4  or   both  IPv4   and  IPv6   in  the  COMMMETHOD 
option  when  you  start  the  server,  storage  agent,  client,  or   API  application. 
The  same  port  numbers  are  used   by  the  server,  storage  agent,  client,  or   API 
application  for   both  IPv4  and  IPv6. 
IPv6   address  formats  are  acceptable  for  all   functions  that  support  IPv6. 
However,  if   you  use  IPv6  addresses  for  functions  that  do  not  support  IPv6, 
communications  will  fail.  The  following  functions  do   not  support  IPv6: 
v  NDMP:   backing  up  and  restoring  storage  pools,  copying  and  moving 
data  (continue  to   use  IPv4)
v  ACLS  (continue  to  use  IPv4) 
v  SNMP  (continue  to  use  IPv4) 
v  Centera  device  support  (continue  to  use  IPv4) 
v   Shared  Memory  Protocol  (continue  to   use  IPv4) 
v  Windows  Microsoft  Management  Console  functions  (continue  to  use 
IPv4) 
v  Administration  Center  (continue  to  use  IPv4)
See  the  following  changed  server  option: 
v  “COMMMETHOD”  on  page  1282
Client  and  Server  authentication  using  Secure  Socket  Layer  (SSL) 
Tivoli   Storage  Manager  now  supports  the  use  of   Secure  Socket  Layer  (SSL) 
for  authentication  of   passwords   between  the  server  and  clients. 
See  the  following  new  command:  DELETE  KEYRING 
See  the  following  new  server  options: 
v  “SSLTCPPORT”   on  page  1330 
v   “SSLTCPADMINPORT”  on  page   1329
Running  SAN  Discovery  for  non-root  users 
You  can  run SAN   discovery  to  obtain  information  about  devices  on  a 
storage  area  network  for  LAN-free  configuration  or  to  automatically  correct 
device  special  file  names  if   they  have  changed.  SAN  discovery  on  AIX 
requires  root  user  authority.  To allow   both  root  and  non-root  users  to 
perform  SAN  discovery,  a  special  utility  module,  dsmqsan,  is   invoked 
when  a  SAN-discovery  function  is   launched.  The  module  performs  as  root, 
giving  SAN-discovery  authority  to  non-root  users.  The  dsmqsan  module 
Technical   changes
works  only  for  SAN-discovery  functions,  and  does  not  provide  root 
privileges  for  any  other Tivoli   Storage  Manager  functions. 
See  the   Administrator’s   Guide  for  more  information.
 
Tivoli   Storage  Manager  provides  several  different  command  line  interfaces.  The 
interface  you  choose  depends  on  the  tasks  that  you  want   to  perform  and 
accessibility.  
v  Administrative  command-line  client 
v   Administration  Center  command  line
The  administrative  command-line  client  is   a  program  that  runs   on  a  file  server, 
workstation,  or   mainframe.  It  is  installed  as  part  of   the  Tivoli   Storage  Manager 
server  installation  process.  With  the  administrative  client,  you  can  issue  any  and  all  
server  commands. 
Compared  to   the  administrative  client,  the  capabilities  of   the  server  console  are 
somewhat  limited.  For  example,  you  cannot  issue  certain  commands  from  the 
server  console,  and  you  cannot  specify  that  certain  commands  process   before  other 
commands  can   be  issued.  (This  procedure  can   be  useful  if,   for  example,  you  want 
to  run two   commands  in   quick  succession.)  Furthermore,   because  the  server 
console  is   a  DOS  window  on  the  machine  on  which  the  server  is   installed,  you 
must   be  physically  located  at  the  server  machine  to  use  the  console.  The 
administrative  client,  on  the  other  hand,  can   be  accessed  remotely  from   a  different 
location.  You  cannot  route  commands  to  other  servers  from   the  server  console. 
The  Administration  Center  is   a  Web-based,   task-oriented  interface  for  centrally 
configuring  and  managing  Tivoli   Storage  Manager  servers.  The  Administration 
Center  provides  a  command  line  interface  that  you  can  use  if   necessary.  For 
example,  you  might  want  to  use  the  command  line  interface  to   perform  Tivoli 
Storage  Manager  functions  that  are  limited  or  not  supported  in  the  Administration 
Center.  Using  the  command  line  in  the  Administration  Center,  you  can  issue  any 
and  all  server  commands. 
Issuing  commands  from  the  administrative  client 
The  administrative  command-line  client  is   a  program  that  runs   on  a  file  server, 
workstation,  or   mainframe. 
Ensure  that  your  administrative  client  and  your  server  are  running  in  compatible 
languages.  See  “LANGUAGE”  on  page  1297  for  language  and  locale  options.  If   your  client  and  server  are  using  different  languages,  the  messages  that  Tivoli  
Storage  Manager  generates  might  not   be  understandable. 
“Administrative  client  options”  on  page  5 In  all   administrative  client  modes,  you  can  use  options  to   modify 
administrative  client  session  responses. 
“Saving  command  output  to  a  specified  location”  on  page  4 The  most  common  use  for  redirecting  output  is  to  save  the  output  from   query 
 
Use  the  DSMADMC  command  to  start  an  administrative  client  session. 
The  Tivoli   Storage  Manager  server  must   be  running   before  an  administrative  client 
can  connect.  For   instructions  about  starting  the  server,  see  the  Installation  Guide.
To start  an  administrative  client  session  in   command-line  mode,  enter  this 
command  on  your  workstation: 
Note: 
1.   If   you  do  not  want  to   be  prompted  for  a  user  ID  and  password,  enter  the 
DSMADMC  command  using  the  -ID  and  -PASSWORD  options  as  shown. 
2.   The  -DATAONLY  option  specifies  whether  product  version  information 
and  output  headers  display  with  the  output.  The  default  is   NO. 
v  NO  specifies  that  the  product  version  information  and  output  column 
headers  display. 
v  YES  suppresses  the  product  version  information  and  output  column 
headers.
Stop  an  administrative  command-line  client  session   by  entering  the  following 
command  on  your  workstation: 
quit 
“Administrative  client  options”  on  page  5 In  all   administrative  client  modes,  you  can  use  options  to  modify 
administrative  client  session responses.
Monitoring  server activities   from  the administrative   client 
To monitor  Tivoli   Storage  Manager  activities,  such  as  server  migration  and  client 
logons,  run the  administrative  client  in   console  mode.  You  cannot  enter  any 
administrative  commands  in  console  mode. 
To start  an  administrative  client  session  in   console  mode,  enter: 
dsmadmc  -consolemode 
You  are  prompted  for  a  password  if   authentication  is   turned  on  for  the  server.  If   you  do  not  want   to   be  prompted  for  your  user  ID  and  password,  enter  the 
DSMADMC  command  with  the  -ID  and  -PASSWORD  options. 
To end  an  administrative  client  session  in   console  mode,  see  Table   1. 
Table    1.
Windows  
client 
To monitor  the  mounting  and  dismounting  of   removable  media,  run the  
administrative  client  in  mount  mode.  When  the  client  is   running  in   mount  mode, 
you  cannot  enter  any  administrative  commands. 
To start  an  administrative  client  session  in  mount  mode,  enter: 
dsmadmc  -mountmode 
You  are  prompted  for  a  password  if   authentication  is   turned  on  for  the  server.   If   you  do  not  want  to   be  prompted  for  your  user  ID  and  password,  enter  the 
DSMADMC  command  with  the  -ID   and  -PASSWORD  options. 
To end  an  administrative  client  session  in  mount  mode,  see  Table   1  on  page  2. 
Processing  commands  one  at  a time   from  the  administrative 
client 
Use   batch  mode  to  enter  a  single  administrative  command.  Your   administrative 
client  session  automatically  ends  when  the  command  has  processed. 
To start  an  administrative  client  session  in   batch  mode,  enter: 
dsmadmc  server_command 
If   you  do  not  want  to   be  prompted  for  your  user  ID  and  password,  you  can  enter 
the  DSMADMC  command  with  the  -ID  and  -PASSWORD  options. 
In   batch  mode,  you  must  enter  the  complete  command  on  one  line.   If   a  command 
does  not  fit  on  one  line,  enter  the  command   by  using  a  macro  or  a  script.  If   you 
specify a parameter with a string of  text using  batch mode, enclose the text in single  quotation  marks  (’  ’)  in  the  macro.  Do  not  use  double  quotes  for  commands 
in   batch  mode,   because  your  operating  system  might  not  parse  the  quotes  correctly. 
Processing  a series   of  commands  from  the administrative 
client 
Use  the  interactive  mode  to  process  a  series  of   administrative  commands. 
To start  an  administrative  client  session  in  interactive  mode,  a  server  session  must 
 be  available.  To ensure  the  availability  of   server  sessions  for   both  administrative 
and  client  node  sessions,  the  interactive  mode  of   the  administrative  client  is 
disconnected  if   one  or   more  of   the  following  conditions  is   true: 
v  The   server  was  stopped  using  the  HALT  command. 
v  Commands  were   not  issued  from   the  administrative  client  session  for  the  length 
of   time  specified  with  the  IDLETIMEOUT  server  option. 
v  The   administrative  client  session  was  canceled  with  the  CANCEL  SESSION 
command.
You can  use  co