How to use the domdsmc updatedb2pwd command
is described.
Purpose
The domdsmc updatedb2pwd parameter
updates the DB2® user password.
The password is required to access the DB2 instance
where the Domino® DB2 database resides. Data Protection for IBM® Domino prompts
the user for the password the first time and saves the password encrypted
in a file. The password is read from this file when access to DB2 is required. The command allows
the user to change the password in the file in case the DB2 user password is changed. If you do not enter
the old and new passwords on the command, you are prompted for them.
When Data Protection for IBM Domino prompts
you for the passwords, the password is not displayed on the screen.
>>-DOMDSMC--UPDATEDB2Pwd--+--------------------------------+---->
'-oldpw--+---------------------+-'
'-newpw--+----------+-'
'-verifypw-'
>--+-------------------------------+---------------------------->
| .-domdsm.cfg--. |
'-/CONFIGfile=--+-cfgfilename-+-'
>--+----------------------------+--+--------------------+------><
| .-domdsm.log--. | | .-60-. |
'-/LOGFile=--+-logfilename-+-' '-/LOGPRUne=--+-n--+-'
'-No-'
Parameters
- oldpw
- The current password to change. You are prompted for this value
if omitted.
- newpw
- The new password. You are prompted for this value if omitted.
When you choose a new password, you can use 1 - 64 characters.
Valid
password characters are as follows:
- A-Z
- Any letter, A through Z, upper-case, or lower-case
- 0–9
- Any number, 0 - 9
- +
- Plus
- .
- Period
- _
- Underscore
- -
- Hyphen
- &
- Ampersand
A password is not case-sensitive.
- verifypw
- The verify password is used to validate the password that is entered
for newpw. You are prompted for this value if
omitted.
- /CONFIGfile=cfgfilename
- Specifies the name of the Data Protection for IBM Domino preferences
file. The file name can include a fully qualified path. If you do
not specify a path, it is assumed the preferences file in the directory
where Data Protection for IBM Domino is
installed.
The
default preferences file is domdsm.cfg.
- /LOGFile=logfilename
- Specifies the name of the activity log that is generated by Data Protection for IBM Domino.
The log file name is used for the current command and does not update
the default log file that is stored in the preferences file. You can
use the set command to change the default log file
name that is stored in the preferences file. The command-line parameter
can be used to override the default for one command run. If the specified
file does not exist, it is created. If it does exist, new log entries
are appended to the file. The file name can include a fully qualified
path. If you do not specify a path, the file is written to the directory
where Data Protection for IBM Domino is
installed.
The
default log file is domdsm.log.
When you
are using multiple simultaneous instances of Data Protection for IBM Domino to
run operations, use the /logfile parameter to
specify a different log file for each instance. Using this parameter
directs logging for each instance to a different log file and prevents
interspersed log file records. Failure to specify a different log
file for each instance can result in unreadable log files.
- /LOGPRUne=60|n|No
- Specifies whether to prune log entries. By default, log pruning
is enabled and done daily. You can use the set command
to do one of the following actions:
- Change the defaults so that log pruning is disabled
- Change the number of days log entries are saved
You can use the /logprune option to override
these defaults for one command run. Note, when the value of /logprune is
a number, the prune is done even if one is complete for the day. You
can specify:
- 60
- Specifies that log entries are saved for 60 days before pruning.
- n
- Specifies the number of days to save log entries. The range of
values is 0 - 9999. A value of 0 deletes all entries in the log except
for the current command run entries.
- No
- Do not prune the log.
Changes to the value of the
timeformat or
dateformat parameter
can result in an undesired pruning of the log file. If you are running
a command that prunes the log file and the value of the
timeformat or
dateformat parameter
changes, run one of the following to prevent 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.
Example
The following example changes the DB2 user password to
secret:
domdsmc updatedb2pwd oldpassword secret secret
Output
example:
ACD0260I Password successfully changed.