changepw

Purpose

Use the changepw command to change the password that is used by the data integrity framework.

Note: Before you issue this command, you must stop your FTM SWIFT business processes, stop all sessions, and stop all services you use.

Required access rights:	User has to be a data integrity administrator as described in Table 1
Predefined roles that provide required access rights:	None

Format

To display command help:

Note: FTM SWIFT events are not written unless the instance's remote event service DNI_R_EVENT is running.

Parameters

-Djava.security.policy=policy_file

policy_file is the policy file that was provided for the runtime system. You can omit this parameter if your system administrator has added the required policies to the JVM default security properties file. For more information, see Java Policy files.

-password password

The new password to be used by the data integrity framework.

Notes:

If you omit this parameter, the data integrity checker prompts for the password.
You must only use characters that are available in EBCDIC code page 1047.

-passphrase phrase

The passphrase that the data integrity administrator specified when issuing the vault utility command create as described in activation of the data integrity framework, step 2.a.

Notes:

If you omit this parameter, the data integrity checker prompts for the passphrase.
Instead of specifying the phrase itself, you can also provide a stash file as described in Stash File Utility, for example:
```
-passphrase @/var/ftmswift_v300/run/passphrase.stash
```

-dsn data_source_name

The data source name of the FTM SWIFT runtime database. This is also the name of the Db2® location. By default, the value of environment variable DNI_DSN is used.

-schema schema

The schema name of the tables in the FTM SWIFT runtime database. By default, the value of environment variable DNI_SN is used.

-ssid subsystem_id

Use this parameter to specify a particular Db2 subsystem to be used by the data integrity checker utility. This has to be used if the default system wide subsystem ID is different.

-commitcount (or -cc) number

The number of operations in one database transaction. The default is 50.

-instance (or -in or -i) instance

The name of the FTM SWIFT instance used to write events. If not specified, the environment variable DNI_I is used.

-qmgr qmgr

The name of the queue manager that is associated with the specified FTM SWIFT instance. If not specified the environment variable DNI_QM_instance is used.

-help or -h

Show the help text that describes the parameters.

Return codes

The changepw command terminates with one of the following return codes:

Code

Description

0

The password was successfully changed.

4

The password was not changed because an invalid parameter was specified.

8

The password was not changed because manipulated data was detected, or because an error occurred during processing. For more information, see:

Command output
FTM SWIFT event log

Example

The following command (issued on a single line) changes the password to be used by the data integrity framework for the FTM SWIFT database with data source name DSN1; it sets the new password to my_new_data_integrity_pwd, uses the stash file /var/ftmswift_v300/run/passphrase.stash to provide the vault's pass phrase and writes events for the instance that is identified by environment variable DNI_I:

dnpdic -changepw -Djava.security.policy=/var/ftmswift_v300/run/ftmswift.policy
       -passphrase @/var/ftmswift_v300/run/passphrase.stash
       -dsn DSN1 -schema DNI
       -password my_new_data_integrity_pwd