Managing the import/export of connection objects


The Import/Export function (object) lets you export IBM WebSphere MQ objects to a file from a source queue manager, and import object definitions to other queue managers. It also lets you create a backup of existing object definitions.

Note that in order to import you need ADMIN permissions, and in order to EXPORT you need at least INQUIRE permissions (OPERATOR and ADMIN permissions include INQUIRE permissions).

Error

When importing objects, TrueSight Middleware Administrator calls the create method for the object, passing the replace flag set to true. This means that for any attributes not specified, the value(s) from the default object will be used. This can potentially result in attribute values for existing objects being overwritten with the default attributes.

Information

When using the Import/Export feature with z/OS or distributed export files, be aware that the syntax for z/OS objects is slightly different than that distributed in the WMQ object definitions file. This means you can import/export to and from distributed export files to another distributed queue manager, or you can import/export to and from z/OS to another z/OS queue manager but you cannot use a z/OS export to a distributed import (or vice versa) because of the WMQ syntax differences.

To import IBM WebSphere MQ objects:

  1. Expand the connection to the required IBM Websphere MQ queue manager in the Navigation Panel.
  2. Select Import/Export from the Navigation Panel.
  3. In the displayed Import/Export Object Definitions screen, select the Action as Import.
  4. From the list of Available Connections, select the relevant connection(s) and click (or click << to Add All). The selected connections are listed in the Selected Connections box.
  5. Select the file format from XML or MQSC, and then click Select File to browse to the relevant file.

    ImportExport.jpg
  6. Click the Next icon in the Import/Export Object Definitions toolbar.
  7. In the displayed confirmation screen, review the details of the file you imported and then click the Execute icon to import the file to the specified queue manager, or click the calendar icon to schedule the import for a later time (repeated imports can be automatically scheduled as required). See Scheduling-tasks for further information on scheduling.
  8. The Action Results screen is displayed, indicating the result of the actions you selected in Step 7.

To export IBM WebSphere MQ objects:

  1. In the displayed Import/Export Object Definitions screen, select Export. In the drop-down list below the Export option, select the relevant connection. In the second drop-down list select the export's target; select File to export objects into a downloadable file or select Connection(s) together with the relevant connections to export objects directly into other queue managers.
  2. In the Objects section, select the output format as XML or MQSC.
  3. Select the objects to be exporting by selecting the relevant checkboxes and entering a Name Pattern. Note that you can only use character strings followed by an asterisk * ; for example ABC*. 
    You can also select Include System Objects, but selecting it alone is not enough to apply the definition. A specific object type from the generic objects list is also required. For example, select Include System Objects and Subscriptions.
    In addition, you can select the Include Authority Records checkbox. This will collect the authority records for any objects you select in the Object Types list. The Authority Records checkbox located in the Object Types list, when selected, will gather ALL authority records for ALL objects whether they are selected in the Object Types or not. 

    ExportObjects.jpg
  4. Click the Next icon in the Import/Export toolbar.
  5. In the displayed confirmation screen, review the details of the objects you want to export and then click the Execute icon to export the file, or click the calendar icon to schedule the export for a later time (repeated exports can be automatically scheduled as required). See Scheduling-tasks for further information on scheduling. Note that you can also click the Back arrow icon to return to the previous export screen or click the Cancel icon to exit the export process.
  6. The Action Results screen is displayed, indicating the result of the actions you selected in Step 5.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC TrueSight Middleware Administrator 8.0