Handling incompatible features in the queue manager
You must check that the queue manager that you are moving to the IBM® MQ Appliance is compatible with the appliance.
The dmpmqcfg command that you run on your source platform produces a series of MQSC commands that you run to re-create the queue manager on the target IBM MQ Appliance. Certain features are incompatible with the appliance, and you must check the dmpmqcfg output, and amend it if necessary, to deal with incompatible features.
The output from the dmpmqcfg command contains lines that are commented out by the asterisk (*) character. Many of these values are read-only values that are set when the queue manager is created. They cannot be affected by the commands in the dmpmqcfg output.
You must also check the configuration file (qm.ini) for the source queue manager and make a note of any non-default attributes that cannot be set by the ALTER QMGR command, and so are not recorded in the output from dmpmqcfg.
Substitute appropriate values for masked values
The output from the dmpmqcfg command might include one or more masked values. If these values were replayed in commands, they would not correctly re-create the objects configuration. The values are masked to prevent sensitive data, such as passwords, from being included in clear text in the configuration dump.
Before you replay the configuration, first check the output for masked parameters such as SSLCRYP, PASSWORD, or LDAPPWD that are commented. You must use additional commands to substitute valid values.
Remove definitions of queue manager services
Queue manager services are not supported by IBM MQ Appliance. You must search the dmpmqcfg output for any DEFINE SERVICE or ALTER SERVICE commands and remove service definitions. Services can be replaced by code in client applications.
Remove changes to the CCSID
Remove any change to the queue manager CCSID in the ALTER QMGR command. The default CCSID for IBM MQ Appliance is 819. If you must change the CCSID, use a separate command and then restart the queue manager to ensure that all processes switch to the new CCSID.
Verify user IDs
Ensure that any user IDs specified in the commands are correctly defined on the IBM MQ Appliance. On Windows source systems, the user and group names might be in the form name@domain. This format is not supported on the appliance, so any such user IDs must be mapped to new user IDs on the appliance.
Remove changes to the SSLKEYR queue manager attribute
The SSLKEYR queue manager attribute is managed by the appliance, and should not be overwritten when you replay the commands to create the queue manager configuration.
Removing listeners from Windows queue managers
Where you are moving a queue manager from a source Windows system, you must remove any definitions for NETBIOS, SPX, and LU62 listeners from the dmpmqcfg output.