See the below sections for information on how to import or export remote queue managers in bulk using the nsqmigr utility.
Export (get) remote queue managers
Perform the following to bulk export remote queue managers:
- Run a command similar to the following to create a .info file containing a list of all remote queue managers. Use the -C parameter (must be uppercase) to only include remote queue managers which are managed by a connection manager. For a full list of commands, enter the command:
nsqmigr -?nsqmigr -mworkgroup -g -C -ffilename.info
NOTE: The CM nodes are included in the .info file created when all nodes are exported, by using commands –g without –n,-C or -E.
The following command will generate the file, remote_qmgrs.info, and will write all remote queue managers from the WGS38 workgroup server to it. The file will be created in: C:\nastel\apwmq\config\groups\.
C:\nastel\apwmq\bin>nsqmigr -mWGS38 -g -C -fC:\nastel\apwmq\config\groups\remote_qmgrs.info
- The .info file is now created. For each remote queue manager exported, the following two messages will appear on the console:
Creating Remote Queue Manager qmgr_name...
The default export directory is [APWMQ_HOME]/config/groups and the default output info file is workgroup_name.info. Both can be overridden by using the –f parameter.
Remote Queue Manager created successfully!
Exported fields
All remote queue managers and their associated fields will be written to the .info file created. The fields are as follows:
RemoteQmgrName
ParentNode
ConnectionName
ChannelName
SSLKeyRepos
SSLCrypHrdw
SSLCipherSpec
ConvertMsg
SecExit
SecExitData
Username
PW
Example file
The following is an example of a .info file.
Import (put) remote queue managers
Perform the following to bulk import remote queue managers:
- You will need to create a .info file to define each remote queue manager being imported. To create this file, either:
- manually create this file to define each remote queue manager being imported. Add the fields listed in the Exported fields section above for each remote queue manager. See Example file above for a sample; or
- follow the steps in the Export (get) remote queue managers section above to export the remote queue managers from one or more workgroup servers, update accordingly and then merge the files into one.
- Place the file in:
[APWMQ_HOME]/config/groups
- Run a command similar to the following to import the file, perhaps into another workgroup. The -C parameter must be uppercase.
nsqmigr –mworkgroup -p -C -ffilename.info
Example:
The following command will import the remote queue managers from the remote_qmgrs.info file located in C:\nastel\apwmq\config\groups\ into the WGS38 workgroup server.
C:\nastel\apwmq\bin>nsqmigr -mWGS38 -p -C -fC:\nastel\apwmq\config\groups\remote_qmgrs.info
- The remote queue managers are now imported in to the workgroup server database. After they are imported, the .info import file is backed up in the following directory and is not deleted:[APWMQ_HOME]/config/groups/workgroup/history