Changetsmpassword optional parameters

Edit online

Optional parameters follow the changetsmpassword command and positional parameters.

/CONFIGfile=configfilename
The /configfile parameter specifies the name of the Data Protection for SQL Server configuration file, which contains the values for the Data Protection for SQL Server configurable options.
Considerations:
  • configfilename can include a fully qualified path. If configfilename does not include a path, it uses the directory where Data Protection for SQL Server is installed.
  • If configfilename includes spaces, place it in double quotes.
  • If you do not specify /configfile, the default value is tdpsql.cfg.
  • If you specify /configfile but not configfilename, the default value tdpsql.cfg is used.
/LOGPrune=numdays|No

When you prune log data, you can discard some of the generated logs according to detailed filtering criteria that you set. Depending on the option that you set for the /LOGPrune parameter, a certain number of days of data are saved. By default, 60 days of log entries are saved. The option No can be entered to disable log pruning.

Regardless of the option that you set for this parameter, you can explicitly request log pruning at any time.

Considerations:
  • For numdays, the range is 0 to 9999. A value of 0 deletes all entries in the activity log file except for the current command entries.
  • If you specify no, the log file is not pruned.
  • If you do not specify /LOGPrune, the default value is that specified by the logprune configurable option in the configuration file. The default value is 60.
  • If you specify /LOGPrune, its value is used instead of the value that is stored in the configuration file. Specifying this parameter does not change the value in the configuration file.
  • You can specify /LOGPrune without specifying numdays or no; in this case, the default value, 60, is used.
  • Changes to the value of the TIMEformat or DATEformat parameter can result in an unwanted pruning of the log file. If you are running a command that might prune the log file, and the value of the TIMEformat or DATEformat parameter is changed, complete one of the following to prevent unintentional pruning of the log file:
    • Make a copy of the existing log file.
    • Specify a new log file with the /LOGFile parameter or logfile setting.
/TSMNODe=tsmnodename
The /tsmnode parameter specifies the IBM Storage® Protect node name that Data Protection for SQL Server uses to log on to the IBM Storage Protect server. This identifies which IBM Storage Protect client is requesting services. You can also store the node name in the options file. The command line parameter overrides the value in the options file.
Considerations:
  • You cannot use the /tsmnode parameter if PASSWORDACCESS GENERATE is specified in the IBM Storage Protect options file. You must specify the nodename in the options file. Otherwise, you can change PASSWORDACCESS to PROMPT to utilize the /tsmnode parameter. For more information about the IBM Storage Protect options file, see Creating and modifying the client system-options file .
  • If you do not specify /tsmnode, the default value is that specified by the nodename option in the IBM Storage Protect options file. Specifying this parameter does not change the value in the options file.
/TSMOPTFile=dsmoptfilename
The /tsmoptfile parameter specifies the IBM Storage Protect options file to use. This is similar to selecting an IBM Storage Protect server from the server list in the GUI. The IBM Storage Protect options file contains the configuration values for the IBM Storage Protect API. For more information about the IBM Storage Protect options file, see Creating and modifying the client system-options file .
Considerations:
  • The tsmoptfilename variable can include a fully qualified path. If you do not include a path, the directory where Data Protection for SQL Server is installed is used.
  • If tsmoptfilename includes spaces, you must enclose it in double quotes.
  • If you do not specify /tsmoptfile, the default value is dsm.opt.
  • If you specify /tsmoptfile but not tsmoptfilename, the default is also dsm.opt.