- Modifying server options
The server reads the server options file at server initialization. When you update a server option by editing the file, you must stop and start the server to activate the updated server options file. - Types of server options
Server options let you customize how some functions and processes work. - 3494SHARED
The 3494SHARED option specifies whether an IBM 3494 library can share applications other than Tivoli Storage Manager. - ACSACCESSID
The ACSACCESSID option specifies the ID for the ACS access control for an ACSLS library. - ACSLOCKDRIVE
The ACSLOCKDRIVE option specifies if the drives within the ACSLS libraries are locked. Drive locking ensures the exclusive use of the drive in the ACSLS library in a shared environment. However, there is some performance gain if libraries are not locked. When other applications do not share the Tivoli Storage Manager drives, drive locking is not required. - ACSQUICKINIT
The ACSQUICKINIT option specifies whether, at server startup, the initialization of the ACSLS library is a quick or full initialization. The default is Yes. A quick initialization avoids the overhead associated with synchronizing the Tivoli Storage Manager server inventory with the ACSLS library inventory (through an audit of the library). - ACSTIMEOUTX
The ACSTIMEOUTX option specifies the multiple for the built-in timeout value for ACSLS APIs. The built-in timeout value for the ENTER, EJECT, and AUDIT ACS API is 1800 seconds; for all other ACSLS APIs it is 600 seconds. For example, if the multiple value specified is 5, the timeout value for audit API becomes 9000 seconds, and all other APIs become 3000 seconds. - ACTIVELOGDIRECTORY
The ACTIVELOGDIRECTORY option specifies the name of the directory where all active logs are stored. - ACTIVELOGSIZE
The ACTIVELOGSIZE option sets the total log size. - ADMINCOMMTIMEOUT
The ADMINCOMMTIMEOUT option specifies how long the server waits for an expected administrative client message during an operation that causes a database update. - ADMINIDLETIMEOUT
The ADMINIDLETIMEOUT option specifies the amount of time, in minutes, that an administrative client session can be idle before the server cancels the session. - ADMINONCLIENTPORT
The ADMINONCLIENTPORT option defines whether or not the TCPPORT can be used by administrative sessions. The default is YES. 
ADREGISTER
The ADREGISTER option specifies whether to register the server with Active Directory at server startup. The default is NO.- ADSETDC
The ADSETDC option specifies the TCP/IP address of the domain controller. If no address is set, the server searches for the Active Directory. - ADSMGROUPNAME
The ADSMGROUPNAME option specifies the name of a Windows group. A client node must be a member of this group to use the Tivoli Storage Manager server through NT Unified Logon. The client node must also be a registered Tivoli Storage Manager client node. - ADUNREGISTER
The ADUNREGISTER option specifies whether to unregister the server with Active Directory at server shutdown. The default is NO. 
AIXASYNCIO
The AIXASYNCIO option allows the Tivoli Storage Manager server to use the asynchronous input/output (AIO) support provided on AIX®. AIO enhances system performance by allowing individual non-contiguous I/O requests to be gathered together into one request and written to disk in parallel. The default for AIXASYNCIO is NO.- ALIASHALT
The ALIASHALT option allows administrators to give the Tivoli Storage Manager HALT command a different name. - ALLOWREORGINDEX
The ALLOWREORGINDEX option specifies whether server-initiated index reorganization is enabled or disabled. - ALLOWREORGTABLE
The ALLOWREORGTABLE option specifies whether server-initiated table reorganization is enabled or disabled. - ARCHFAILOVERLOGDIRECTORY
The ARCHFAILOVERLOGDIRECTORY option specifies the directory which the server uses to store archive log files that cannot be stored in the archive log directory. - ARCHLOGDIRECTORY
The ARCHLOGDIRECTORY option specifies a directory that the database manager can archive a log file into after all the transactions represented in that log file are completed. - ARCHLOGUSEDTHRESHOLD
The ARCHLOGUSEDTHRESHOLD option specifies when to start an automatic database backup in relation to the percentage of archive log file space used. The default is 80 percent. - ASSISTVCRRECOVERY
The ASSISTVCRRECOVERY option specifies whether Tivoli Storage Manager assists an IBM 3590 drive in recovering from a lost or corrupted Vital Cartridge Records (VCR) condition. If you specify YES (the default) and if Tivoli Storage Manager detects an error during the mount processing, it locates to the end-of-data during the dismount processing to allow the drives to restore the VCR. During the tape operation, there might be some small effect on performance because the drive cannot complete a fast locate with a lost or corrupted VCR. However, there is no loss of data. - AUDITSTORAGE
As part of a license audit operation, the server calculates, by node, the amount of server storage used for backup, archive, and space–managed files. For servers managing large amounts of data, this calculation can take a great deal of CPU time and can stall other server activity. You can use the AUDITSTORAGE option to specify that storage is not to be calculated as part of a license audit. - CHECKTAPEPOS
The CHECKTAPEPOS option specifies whether the Tivoli Storage Manager server validates the position of data blocks on tape. - CLIENTDEDUPTXNLIMIT
The CLIENTDEDUPTXNLIMIT option specifies the maximum size of a transaction when client-side deduplicated data is backed up or archived. - COMMMETHOD
The COMMMETHOD option specifies a communication method to be used by the server. - COMMTIMEOUT
The COMMTIMEOUT option specifies how long the server waits for an expected client message during an operation that causes a database update. If the length of time exceeds this time-out, the server ends the session with the client. You may want to increase the time-out value to prevent clients from timing out. Clients may time out if there is a heavy network load in your environment or they are backing up large files. - DATEFORMAT
The DATEFORMAT option specifies the format in which dates are displayed by the server. - DBDIAGLOGSIZE
This option helps to control the maximum size of the diagnostic log files. - DBDIAGPATHFSTHRESHOLD (Specify a threshold for free space)
The DBDIAGPATHFSTHRESHOLD option specifies the threshold for free space on the file system or disk that contains the db2diag.log file. - DBMEMPERCENT
Use this option to specify the percentage of the virtual address space that is dedicated to the database manager processes. - DBMTCPPORT
The DBMTCPPORT option specifies the port number on which the TCP/IP communication driver for the database manager waits for requests for client sessions. - DEDUPREQUIRESBACKUP
The DEDUPREQUIRESBACKUP option specifies whether volumes in primary sequential-access storage pools that are set up for data deduplication can be reclaimed and whether duplicate data can be discarded before the storage pools are backed up. - DEDUPTIER2FILESIZE
The DEDUPTIER2FILESIZE option specifies at what file size Tivoli Storage Manager begins to use Tier 2 data deduplication. - DEDUPTIER3FILESIZE
The DEDUPTIER3FILESIZE option specifies at what file size Tivoli Storage Manager begins to use Tier 3 data deduplication. - DEVCONFIG
The DEVCONFIG option specifies the name of a file in which you want Tivoli Storage Manager to store a backup copy of device configuration information. - DISABLESCHEDS
The DISABLESCHEDS option specifies whether administrative and client schedules are disabled during Tivoli Storage Manager server recovery. 
DISKMAP
The DISKMAP option specifies how the server performs I/O to a disk storage pool.- DISPLAYLFINFO
The DISPLAYLFINFO option specifies how the accounting records and summary table entries report the node name. - DNSLOOKUP
The DNSLOOKUP option specifies whether the server uses system API calls to determine the domain name server (DNS) names of systems that contact the server. - DRIVEACQUIRERETRY
The DRIVEACQUIRERETRY option lets you specify how many times the server retries the acquisition of a drive in an IBM 349x library. If the library is shared among multiple applications, its drives may appear to be available to the server (through the use of a background polling process) when they are not. - ENABLENASDEDUP
The ENABLENASDEDUP server option specifies whether the server deduplicates data that is stored by a network-attached storage (NAS) file server. This option applies only to NetApp file servers. - EVENTSERVER
The EVENTSERVER option specifies whether at startup the server should try to contact the event server. - EXPINTERVAL
The EXPINTERVAL option specifies the interval, in hours, between automatic inventory expiration processes by Tivoli Storage Manager. Inventory expiration removes client backup and archive file copies from the server as specified by the management classes to which the client files are bound. If expiration is not run periodically, storage pool space is not reclaimed from expired client files, and the server requires more storage space than required by policy. - EXPQUIET
The EXPQUIET option specifies whether Tivoli Storage Manager sends detailed messages during expiration processing. - FFDCLOGNAME
The FFDCLOGNAME option specifies a name for the first failure data capture (FFDC) log. - FFDCMAXLOGSIZE
The FFDCMAXLOGSIZE option specifies the size for the first failure data capture (FFDC) log file. - FFDCNUMLOGS
The FFDCNUMLOGS option specifies the number of log files that can be used for circular logging. The default value is 10. - FILEEXIT
The FILEEXIT option specifies a file to which enabled events are routed. Each logged event is a record in the file. - FILETEXTEXIT
The FILETEXTEXIT option specifies a file to which enabled events are routed. Each logged event is a fixed-size, readable line. - FSUSEDTHRESHOLD
The FSUSEDTHRESHOLD option specifies what percentage of the file system can be filled up by the database before an alert message is issued. - IDLETIMEOUT
The IDLETIMEOUT option specifies the amount of time, in minutes, that a client session can be idle before the server cancels the session. You may want to increase the time-out value to prevent clients from timing out if there is a heavy network load in your environment. Note, however, that a large number of idle sessions could prevent other users from connecting to the server. - LANGUAGE
The LANGUAGE option controls the initialization of locales. A locale includes the language and the date, time, and number formats to be used for the console and server. - LDAPCACHEDURATION
The LDAPCACHEDURATION option determines the amount of time that the IBM Tivoli Storage Manager server caches LDAP password authentication information. - LDAPURL
The LDAPURL option specifies the location of your LDAP directory server. Set the LDAPURL option after you configure the LDAP directory server. - MAXSESSIONS
The MAXSESSIONS option specifies the maximum number of simultaneous client sessions that can connect with the server. - MESSAGEFORMAT
The MESSAGEFORMAT option specifies whether a message number is displayed in all lines of a multi-line message. - MIRRORLOGDIRECTORY
The MIRRORLOGDIRECTORY option specifies the directory for mirroring the active log path. - MOVEBATCHSIZE
The MOVEBATCHSIZE option specifies the number of client files that are to be moved and grouped together in a batch, within the same server transaction. This data movement results from storage pool backups and restores, migration, reclamation, and MOVE DATA operations. This option works with the MOVESIZETHRESH option. - MOVESIZETHRESH
The MOVESIZETHRESH option specifies, in megabytes, a threshold for the amount of data moved as a batch, within the same server transaction. When this threshold is reached, no more files are added to the current batch, and a new transaction is started after the current batch is moved. - MSGINTERVAL
The MSGINTERVAL option specifies the time, in minutes, between messages prompting an operator to mount a tape for the server. - NAMEDPIPENAME
The NAMEDPIPENAME option specifies a communication method that allows processes to communicate with one another without having to know where the sender and receiver processes are located. The name acts like an alias, connecting the two processes regardless of whether they are on the same computer or across connected domains. - NDMPCONTROLPORT
The NDMPCONTROLPORT option specifies the port number to be used for internal communications for certain Network Data Management Protocol (NDMP) operations. The Tivoli Storage Manager server does not function as a general purpose NDMP tape server. - NDMPENABLEKEEPALIVE
The NDMPENABLEKEEPALIVE server option specifies whether the Tivoli Storage Manager server enables Transmission Control Protocol (TCP) keepalive on network data-management protocol (NDMP) control connections to network-attached storage (NAS) devices. The default is NO. -
NDMPKEEPIDLEMINUTES
The NDMPKEEPIDLEMINUTES server option specifies the amount of time, in minutes, before the operating system transmits the first Transmission Control Protocol (TCP) keepalive packet on a network data-management protocol (NDMP) control connection. The default is 120 minutes. - NDMPPORTRANGE
The NDMPPORTRANGE option specifies the range of port numbers through which Tivoli Storage Manager cycles to obtain a port number for accepting a session from a network-attached storage (NAS) device for data transfer. The default is 0,0 which means that Tivoli Storage Manager lets the operating system provide a port (ephemeral port). - NDMPPREFDATAINTERFACE
This option specifies the IP address associated with the interface in which you want the server to receive all Network Data Management Protocol (NDMP) backup data. - NOPREEMPT
The server allows certain operations to preempt other operations for access to volumes and devices. You can specify the NOPREEMPT option to disable preemption. When preemption is disabled, no operation can preempt another for access to a volume, and only a database backup operation can preempt another operation for access to a device. - NORETRIEVEDATE
The NORETRIEVEDATE option specifies that the server does not update the retrieve date of a file in a disk storage pool when a client restores or retrieves the file. This option and the MIGDELAY storage pool parameter control when the server migrates files. - NPAUDITFAILURE
The NPAUDITFAILURE option specifies whether an event is sent to the event log when a node logs in to the server using a name that is in the Windows group but does not match the Windows account login name. To ensure that a node can access only its own data, the node name and the Windows account name must match. - NPAUDITSUCCESS
The NPAUDITSUCCESS option specifies that an event is sent to the event log when a client node user is authenticated for access to the server through SECUREPIPE. - NPBUFFERSIZE
The NPBUFFERSIZE option specifies the size of the Named Pipes communication buffer. - NUMBERFORMAT
The NUMBERFORMAT option specifies the format in which the server displays numbers. - NUMOPENVOLSALLOWED
The NUMOPENVOLSALLOWED option specifies the number of input FILE volumes in a deduplicated storage pool that can be open at one time. - QUERYAUTH
The QUERYAUTH option specifies the administrative authority level required to issue QUERY or SQL SELECT commands. By default any administrator can issue QUERY and SELECT commands. You can use this option to restrict the use of these commands. - RECLAIMDELAY
This option delays the reclamation of a SnapLock volume, allowing remaining data to expire so that there is no need to reclaim the volume. - RECLAIMPERIOD
This option allows you to set the number of days for the reclamation period of a SnapLock volume. - REORGBEGINTIME
The REORGBEGINTIME option specifies the earliest time that the Tivoli Storage Manager server can start a table or index reorganization. - REORGDURATION
The REORGDURATION option specifies an interval during which server-initiated table or index reorganization can start. - REPORTRETRIEVE
The REPORTRETRIEVE option reports on restore or retrieve operations that are performed by client nodes or administrators. The default is NO. - REPLBATCHSIZE
The REPLBATCHSIZE option specifies the number of client files that are to be replicated in a batch, within the same server transaction. This option affects only the node replication processes and works with the REPLSIZETHRESH option to improve node replication processing. - REPLSIZETHRESH
The REPLSIZETHRESH option specifies, in megabytes, a threshold for the amount of data replicated, within the same server transaction. - REQSYSAUTHOUTFILE
The REQSYSAUTHOUTFILE option specifies if system authority is required for administrative commands that cause Tivoli Storage Manager to write to an external file. - RESOURCETIMEOUT
The RESOURCETIMEOUT option specifies how long the server waits for a resource before canceling the pending acquisition of a resource. When a timeout occurs the request for the resource will be canceled. - RESTOREINTERVAL
The RESTOREINTERVAL option specifies how long a restartable restore session can be saved in the server database. As long as the restore session is saved in the database, it can be restarted from the point at which it stopped. - RETENTIONEXTENSION
The RETENTIONEXTENSION option specifies the number of days to extend the retention date of a SnapLock volume. This option allows the server to extend the retention date of a SnapLock volume in order to avoid excessive reclamation. - SANDISCOVERY
The SANDISCOVERY option specifies whether the Tivoli Storage Manager SAN discovery function is enabled. - SANDISCOVERYTIMEOUT
The SANDISCOVERYTIMEOUT option specifies the amount of time allowed for host bus adapters to respond when they are queried by the SAN discovery process. Once the time specified for the SANDISCOVERYTIMEOUT is reached, the process times out. - SANREFRESHTIME
The SANREFRESHTIME option specifies the amount of time that elapses before the cached SAN discovery information is refreshed. The SANREFRESHTIME option has a default value of 0, which means that there is no SAN discovery cache. The information is obtained directly from the host bus adapter (HBA) every time the server performs a SAN discovery operation. - SEARCHMPQUEUE
The SEARCHMPQUEUE option specifies the order in which the server satisfies requests in the mount queue. If the option is specified, the server first tries to satisfy requests for volumes that are already mounted. These requests may be satisfied before other requests, even if the others have been waiting longer for the mount point. If this option is not specified, the server satisfies requests in the order in which they are received. - SECUREPIPES
When using the named pipes protocol, enabling SECUREPIPES forces the server to check the Windows group designated by ADSMGROUPNAME in order to authenticate a client node/user. - SERVERDEDUPTXNLIMIT
The SERVERDEDUPTXNLIMIT option specifies the maximum size of objects that can be deduplicated on the server. - SHMPORT
The SHMPORT option
specifies the TCP/IP port address of a server when using shared memory.
All shared memory communications start with a TCP/IP connection. The SHMPORT option specifies the port that the
server listens on for shared memory connections. - SHREDDING
The SHREDDING option specifies whether shredding of deleted sensitive data is performed automatically or manually. Shredding applies only to data in storage pools that have been explicitly configured to support shredding. - SNMPHEARTBEATINTERVAL
The SNMPHEARTBEATINTERVAL option specifies the interval in minutes between queries of the Tivoli Storage Manager server. - SNMPMESSAGECATEGORY
The SNMPMESSAGECATEGORY option specifies the trap types used when messages are forwarded from the server, through the Simple Network Management Protocol (SNMP) subagent, to the SNMP manager. - SNMPSUBAGENT
The SNMPSUBAGENT option specifies the parameters needed for the Tivoli Storage Manager subagent to communicate with the Simple Network Management Protocol (SNMP) daemon. This option is only to configure the SNMP subagent for communicating with the SNMP agent; it is ignored by the server. - SNMPSUBAGENTHOST
The SNMPSUBAGENTHOST option specifies the location of the Tivoli Storage Manager Simple Network Management Protocol (SNMP) subagent. The default for this option is 127.0.0.1. - SNMPSUBAGENTPORT
The SNMPSUBAGENTPORT option specifies the port number of the Tivoli Storage Manager Simple Network Management Protocol (SNMP) subagent. - SSLFIPSMODE
The SSLFIPSMODE option specifies whether the Federal Information Processing Standards (FIPS) mode is in effect for Secure Sockets Layer (SSL). The default is NO. - SSLTCPADMINPORT
The SSLTCPADMINPORT option specifies the port address on which the server TCP/IP communication driver waits for requests for SSL-enabled sessions. The sessions are for the command-line administrative client. - SSLTCPPORT
The SSLTCPPORT option specifies the SSL (Secure Sockets Layer) port number. The server TCP/IP communication driver waits for requests on this port for SSL-enabled sessions from the client. - SSLTLS12
Transport Layer Security (TLS) 1.2 is a Secure Sockets Layer (SSL) protocol that is available for use with Tivoli Storage Manager V6.3. TLS 1.2 can be used only with version 6.3 clients. The SSLTLS12 option controls TLS 1.2 for Version 6.3 clients. - TCPADMINPORT
The TCPADMINPORT option specifies the port number on which the server TCP/IP communication driver is to wait for requests for sessions other than client sessions. This includes administrative sessions, server-to-server sessions, Simple Network Management Protocol (SNMP) subagent sessions, storage agent sessions, library client sessions, managed server sessions, and event server sessions. - TCPBUFSIZE
The TCPBUFSIZE option specifies the size of the buffer used for TCP/IP send requests. During a restore, client data moves from the Tivoli Storage Manager session component to a TCP communication driver. The TCPBUFSIZE option determines if the server sends the data directly from the session buffer or copies the data to the TCP buffer. A 32 KB buffer size forces the server to copy data to its communication buffer and flush the buffer when it fills. - TCPNODELAY
The TCPNODELAY option specifies whether the server disables the delay of sending successive small packets on the network. - TCPPORT
The TCPPORT option specifies the port number on which the server TCP/IP communication driver is to wait for requests for client sessions. - TCPWINDOWSIZE
The TCPWINDOWSIZE option specifies, in kilobytes, the amount of receive data that can be buffered at one time on a TCP/IP connection. The sending host cannot send more data until it receives an acknowledgment and a TCP receive window update. Each TCP packet contains the advertised TCP receive window on the connection. A larger window lets the sender continue sending data, and may improve communication performance, especially on fast networks with high latency. - TECBEGINEVENTLOGGING
The TECBEGINEVENTLOGGING option specifies whether event logging for the Tivoli receiver should begin when the server starts up. If the TECHOST option is specified, TECBEGINEVENTLOGGING defaults to YES. - TECHOST
The TECHOST option specifies the host name or IP address for the Tivoli event server. - TECPORT
The TECPORT option specifies the TCP/IP port address on which the Tivoli event server is listening. This option is only required if the Tivoli event server is on a system that does not have a Port Mapper service running. - TECUTF8EVENT
The TECUTF8EVENT option allows the Tivoli Storage Manager administrator to send information to the Tivoli Enterprise Console® (TEC) server in UTF–8 data format. The default is No. You can display whether or not this option is enabled by issuing the QUERY OPTION command. - THROUGHPUTDATATHRESHOLD
The THROUGHPUTDATATHRESHOLD option specifies a throughput threshold that a client session must reach to prevent being cancelled after the time threshold is reached. - THROUGHPUTTIMETHRESHOLD
The THROUGHPUTTIMETHRESHOLD option specifies the time threshold for a session after which it may be cancelled for low throughput. - TIMEFORMAT
The TIMEFORMAT option specifies the format in which time is displayed by the server. - TXNGROUPMAX
The TXNGROUPMAX option specifies the number of objects that are transferred as a group between a client and the server between transaction commit points. The minimum value is 4 objects and the maximum value is 65000 objects. The default value is 4096 objects. The objects transferred are actual files, directories, or both. The server counts each file or directory as one object. - UNIQUETDPTECEVENTS
The UNIQUETDPTECEVENTS option generates a unique Tivoli Enterprise Console (TEC) event class for each individual Tivoli Storage Manager message, including client, server, and Tivoli Data Protection (TDP) agent messages. The default is No. - UNIQUETECEVENTS
The UNIQUETECEVENTS option generates a unique Tivoli Enterprise Console (TEC) event class for each individual Tivoli Storage Manager message. The default is No. - USEREXIT
The USEREXIT option specifies a user-defined exit that will be given control to manage an event. - VERBCHECK
The VERBCHECK option specifies that the server will do additional error checking on the structure of commands sent by the client. This option should only be enabled when the client sends incorrectly formed requests to the server, causing the server to crash. When this option is enabled, you will get a protocol error instead of a server crash. - VOLUMEHISTORY
The VOLUMEHISTORY option specifies the name of files to be automatically updated whenever server sequential volume history information is changed. There is no default for this option.
Parent topic: Server commands, options, and utilities