SETOPT (Set a server option for dynamic update)

You can use the SETOPT command to update most server options dynamically without stopping and restarting the server. For the DBDIAGLOGSIZE option, you must stop and start the server. A SETOPT command contained in a macro or a script cannot be rolled back.

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagramSETOPToption_nameoption_value

Parameters

option_name (Required)
Specifies a text string of information identifying the server option to be updated. The maximum length of the text string is 255 characters. The following options are available:
  • ADMINCOMMTimeout
  • ADMINIDLETIMEOUT
  • ALLOWREORGINDEX
  • ALLOWREORGTABLE
  • ARCHLOGCOMPress
  • BACKUPINITIATIONROOT
  • CHECKTAPEPOS
  • CLIENTDEDUPTXNlimit
  • CLIENTDEPLOYCATALOGURL
  • CLIENTDEPLOYUSELOCALCATALOG
  • COMMTimeout
  • Windows operating systemsDATEFORMAT
  • DBDIAGLOGSize
  • DBDIAGPATHFSTHreshold
  • DEDUPTIER2FILESIZE
  • DEDUPTIER3FILESIZE
  • DEDUPREQUIRESBACKUP
  • DNSLOOKUP
  • EXPINterval
  • EXPQUiet
  • FSUSEDTHreshold
  • IDLETimeout
  • LDAPCACHEDURATION
  • MAXSessions
  • MOVEBatchsize
  • MOVESizethresh
  • NDMPPREFDATAINTERFACE
  • Windows operating systemsNUMBERFORMAT
  • NUMOPENVOLSallowed
  • RECLAIMDELAY
  • RECLAIMPERIOD
  • REORGBEGINTime
  • REORGDURation
  • RESOURCETimeout
  • RESTOREINTERVAL
  • RETENTIONEXTENSION
  • Linux operating systemsWindows operating systemsAIX operating systemsSANDISCOVERY
  • Linux operating systemsWindows operating systemsAIX operating systemsSANREFRESHTIME
  • SERVERDEDUPTXNlimit
  • SHREDding
  • Windows operating systemsTCPPORT
  • THROUGHPUTDatathreshold
  • THROUGHPUTTimethreshold
  • Windows operating systemsTIMEFORMAT
  • TXNGroupmax
option_value (Required)
Specifies the value for the server option.

Example: Set the maximum number of client sessions

Update the server option for the maximum number of client sessions to a value of 40.
setopt maxsessions 40

Related commands

Table 1. Commands related to SETOPT
Command Description
QUERY OPTION Displays information about server options.
QUERY SYSTEM Displays details about the IBM Spectrum Protect server system.