Tivoli Header

Tivoli Space Manager for UNIX Using the Hierarchical Storage Management Clients


Using Options

Attention: You must have root user authority to set the options in your dsm.sys file.

The HSM client provides system and space management options that you can set either in your dsm.sys file or in your dsm.opt file. The values that you set for space management options determine which server your client node contacts for space management services, and they affect automatic migration, reconciliation, and recall. In your dsm.sys file, group your options into stanzas for each server that your client node contacts for backup, archive, and space management services.

Options are processed following this order:

  1. Options that are defined on the server with server-enforced client options. The client cannot override the value.
  2. Options that are entered locally on the command line.
  3. Options that are defined on the server for a schedule using the options parameters.
  4. Options that you enter locally in your options file.
  5. Options that are received from the server with client options that the server does not enforce. The client can override the value.
  6. Default option values.

With the exception of the errorprog option, place all space management options before the stanzas for each server that you define in your dsm.sys file. For example, if you want to specify a default server for backup and archive services, a migration server, and new values for other space management options, place the options in your dsm.sys file. The following is an example of a server stanza containing options for a server that you want to contact.

DEFAULTServer                 server1
MIGRATEServer                 server2
CHECKThresholds               2
CANDIDATESInterval            12
MAXCANDProcs                   5
RECOncileinterval             12
MAXRECOncileproc              5
MAXThresholdproc              5
MINMIGFILESize                8192
MIGFILEEXPiration             10
MINRECAlldaemons              5
MAXRecalldaemons              15
CHECKFororphans               no
MAXMIGRators                  1
KERNelmessages                no
 
Servername     server1
  COMMmethod                  TCPip
  TCPPort                     1500
  TCPServeraddress            almvmd.almaden.ibm.com
  Passwordaccess              generate
  Mailprog                    /usr/bin/xsend root
  Groups                      system adsm
  Users                       steiner chron wang nguyen
  Inclexcl                    /adm/adsm/backup.excl
  ERRORProg                   /bin/cat
 
Servername     server2
  COMMmethod                  SNAlu6.2
  PARtnerluname               raptor
  TPname                      appcdel
  CPICMOdename                appc
  Passwordaccess              generate
  Mailprog                    /usr/bin/xsend root
  Groups                      system adsm
  Users                       sullivan tang stewart
  Inclexcl                    /adm/adsm/migrate.excl
  ERRORProg                   /bin/cat

Table 17. Space Management Options in Your Options Files

Option Description Page
candidatesinterval Specifies how often the dsmscoutd daemon searches for migration candidates in file systems to which you added space management. The range of values is zero through 9999. The default is one. Candidatesinterval
checkfororphans Specifies whether or not the dsmreconcile command checks for orphans. Specify yes or no. The default is no. Checkfororphans
checkthresholds Determines how frequently the space monitor daemon checks space usage on the file systems to which you add space management. The range of values is one through 9999. The default is five. Checkthresholds
compression Compresses files before you send them to the TSM server. Specify yes or no. The default is no. Compression
defaultserver Specifies the name of the default TSM server to contact for space management services if you do not specify a server name on the migrateserver option.

You cannot override the default server for space management services in your dsm.opt file.

Defaultserver
errorprog Specifies a program to which you want to send a message if a severe error occurs during space management processing. Place this option after all space management options for each server that you define in your dsm.sys file. Errorprog
kernelmessages Valid for AIX JFS file systems only

Displays HSM-related messages during processing. If you change the value, it will not take effect until you restart your system. Specify yes or no. The default is yes.

Kernelmessages
maxcandprocs Specifies the number of slave scout daemons that can scan for migration candidates in parallel on a system. The range of values is two through 20. The default is five. Maxcandprocs
maxmigrators Specifies the number of parallel migration sessions that you can perform. The range of values is one through 20. The default is one. Maxmigrators
maxrecalldaemons Specifies the maximum number of recall daemons that you can run at one time. The range of values is two through 99. The default is 20. Maxrecalldaemons
maxreconcileproc Specifies the maximum number of automatic reconciliation processes that you can start at one time. The range of values is one through 99. The default is three. Maxreconcileproc
maxthresholdproc Specifies the maximum number of automatic threshold migration processes that you can start at one time. The range of values is one through 99. The default is three. Maxthresholdproc
migfileexpiration Specifies the number of days that copies of migrated or premigrated files remain on the TSM server after they are modified on, or erased from, your local file system. The range of values is zero through 9999. The default is seven days. Migfileexpiration
migrateserver Specifies the TSM server to which you want to migrate files from your client node. Specify only one migration server for each client node.

You cannot override the migration server in your dsm.opt file.

Migrateserver
minmigfilesize Specifies the minimum file size for a file to be eligible for automatic migration. The range of values is zero through 2147483647. The default is zero. Minmigfilesize
minrecalldaemons Specifies the minimum number of recall daemons that you want to run at the same time to perform recalls for your client node. The range of values is one through 99. The default is three. Minrecalldaemons
optionformat Specifies the format to use (either standard or short) when you specify HSM client commands. If you change the value, the new value is effective immediately. Select standard or short format. The default is standard. Optionformat
reconcileinterval Specifies how often automatic reconciliation of file systems occurs to which you add space management. The range of values is zero through 9999. The default is 24. Reconcileinterval
restoremigstate Restores a file if it is backed up after migration. You cannot restore a stub file if you back up a file before migration because a server stub file copy does not exist. Specify yes or no. The default is yes. Restoremigstate


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]