At installation, ADSM provides a server options file named dsmserv.opt with a set of default options to start the server. The dsmserv.smp file (also provided at installation) contains the format of the options file and all the default settings. You can change any options in the dsmserv.smp file. If you do so, you must rename the file to dsmserv.opt. To activate an option within the server options file, remove the *>>> that precedes the option. The server ignores any options preceded by *>>>.
At server initialization, the server reads the server options file. If you update a server option by editing the file, you must stop and start the server to activate the updated server options file. You can change some options dynamically by issuing the SETOPT command. See SETOPT (Set a Server Option for Dynamic Update) for details.
use the options described in Table 253 to specify the server communication methods and their
characteristics.
Table 253. Communication Options
| Option | Description | Reference |
|---|---|---|
| COMMMETHOD | The server communication method | Page COMMMethod |
| HTTPPORT | The port number for the HTTP communication method | Page HTTPPort |
| IPXBUFFERSIZE | The IPX send buffer size | Page IPXBuffersize |
| IPXSOCKET | The IPX socket of an ADSM server | Page IPXSocket |
| LANADAPTER | The network adapter number on which the server communicates under the NetBIOS communication method | Page LANAdapter |
| LUNAME | The name ADSM uses for APPC communications on the network | Page LUname |
| NETBIOSBUFFERSIZE | The size of the NetBIOS send and receive buffers | Page NETBIOSBuffersize |
| NETBIOSNAME | The NetBIOS session name of an ADSM server | Page NETBiosname |
| NETBIOSSESSION | The NetBIOS session available on an ADSM server | Page NETBIOSSession |
| SHMPORT | The TCP/IP port address of a server when using shared memory | Page SHMPort |
| SNMPHEARTBEATINTERVAL | The interval in minutes between queries of the ADSM server | Page SNMPHEARTBEATINTERVAL |
| SNMPMESSAGECATEGORY | Specifies the trap types used when messages are forwarded from the server | Page SNMPMESSAGECATEGORY |
| SNMPSUBAGENT | The parameters needed for the ADSM subagent to communicate with the SNMP daemon | Page SNMPSUBAGENT |
| SNMPSUBAGENTHOST | The location of the ADSM SNMP subagent | Page SNMPSUBAGENTHOST |
| SNMPSUBAGENTPORT | The port address of the ADSM SNMP subagent | Page SNMPSUBAGENTPORT |
| TCPBUFSIZE | The size of the buffer used for TCP/IP send requests | Page TCPBufsize |
| TCPNODELAY | Allows TCP/IP to buffer data | Page TCPNodelay |
| TCPPORT | The TCP/IP port number | Page TCPPort |
| TCPWINDOWSIZE | The client node TCP/IP sliding window | Page TCPWindowsize |
| TPNPROFILENAME | The size of the transaction program profile name | Page TPNProfilename |
Use the options described in Table 254 to control client-server communication processing.
Table 254. Client-Server Options
| Option | Description | Reference |
|---|---|---|
| COMMTIMEOUT | The number of seconds the server waits for a response from a client before timing out the client session | Page COMMTimeout |
| IDLETIMEOUT | The number of minutes the server allows a client session to remain idle before timing out the client session | Page IDLETimeout |
| MAXSESSIONS | The maximum number of simultaneous client sessions with the server | Page MAXSessions |
Use the options described in Table 255 to specify display formats for the dates, times, numbers,
and national language.
Table 255. Date, Number, Time, and Language Options
| Option | Description | Reference |
|---|---|---|
| DATEFORMAT | The format by which dates are displayed | Page DATEformat |
| LANGUAGE | The national language is used to present client messages | Page LANGuage |
| NUMBERFORMAT | The format for displaying numbers | Page NUMberformat |
| TIMEFORMAT | The format displaying times | Page TIMEformat |
Use the options described in Table 256 to control some aspects of database and recovery log processing.
Table 256. Database and Recovery Log Options
| Option | Description | Reference |
|---|---|---|
| BUFPOOLSIZE | The size of database buffer pool | Page BUFPoolsize |
| LOGPOOLSIZE | The size of recovery log buffer pool | Page LOGPoolsize |
| MIRRORREAD | How mirrored volumes are to be accessed when the server reads pages to the recovery log or database during normal processing | Page MIRRORRead |
| MIRRORWRITE | How mirrored volumes are to be accessed when the server writes pages to the recovery log or database during normal processing | Page MIRRORWrite |
Use the options described in Table 257 to control how ADSM groups and transfers data.
| Option | Description | Reference |
|---|---|---|
| MOVEBATCHSIZE | The number of files that are to be moved and grouped in a batch, within a transaction | Page MOVEBatchsize |
| MOVESIZETHRESH | The threshold for the amount of data moved as a batch, within the same server transaction | Page MOVESizethresh |
| TXNGROUPMAX | The number of files that are transferred as a group between a client and the server between transaction commit points | Page TXNGroupmax |
Use the options described in Table 258 to give you more flexibility in the way ADSM issues
messages.
| Option | Description | Reference |
|---|---|---|
| EXPQUIET | Whether or not ADSM sends detailed informational messages | Page |
| MESSAGEFORMAT | Whether or not a message number is displayed in all lines of a multi-line message. | Page MESsageformat |
| MSGINTERVAL | The length in time, in minutes, that the server sends a message to mount a tape to a tape operator | Page MSGINTerval |
| STATUSMSGCNT | The number of records processed between messages during DSMSERV DUMPDB and DSMSERV LOADDB commands. | Page STAtusmsgcnt |
Use the following options described in Table 259 to manage event logging receivers.
Table 259. Event Logging Options
| Option | Description | Reference |
|---|---|---|
| FILEEXIT | A file to which enable events are routed | Page FILEEXIT |
| USEREXIT | A user-defined exit that will be given control to handle an event. | Page USEREXIT |
| TECBEGINEVENTLOGGING | Whether or not event logging for the Tivoli receiver should begin when the server starts up | Page TECBegineventlogging |
| TECHOSTNAME | The host name or IP address for the Tivoli event server | Page TECHostname |
| TECPORT | The TCP/IP port address on which the Tivoli event server is listening. | Page TECPort |
Use the following miscellaneous options described in Table 260 to customize information provided to ADSM.
Table 260. Miscellaneous Options
| Option | Description | Reference |
|---|---|---|
| DEVCONFIG | The a file in ADSM stores backup copies of device configuration information | Page DEVCONFig |
| ENABLE3590LIBRARY | Support for IBM 3590 tape drives in an IBM 349x automated library | Page ENABLE3590LIBrary |
| EXPINTERVAL | The interval between automatic inventory expiration runs | Page EXPINterval |
| NOAUDITSTORAGE | Specifies that during a license audit operation, the server calculates, by node, the amount of backup, archive, and space management storage in use. | Page NOAUDITStorage |
| NOPREEMPT | Specifies that no operation can preempt another for access to a volume and that only a database backup operation can preempt another operation for access to a device. | Page NOAUDITStorage |
| RESTORE INTERVAL | How long a restartable restore can be saved in the server database | Page RESTOREINTERVAL |
| VOLUMEHISTORY | Files to be automatically updated whenever server sequential volume history information is changed | Page VOLUMEHistory |