![]() |
![]() |
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:
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 |