Pattern notes and interactions

The following table lists the patterns, related patterns, and special notes about the pattern. Related patterns mean that if you are not exporting all of the related items, the associations on the new system might not be intact. 

Example

When you export the user pattern, there might also be user information in the group and user-tab pattern that affects the user.

The patterns and regular expressions listed in the following table are valid for the mqsimport and mqsexport commands.

Pattern name

Related patterns

Description and special notes

--event-action-pipeline

event-contact

event-format

event-rule

event-template

Exports event action pipelines. Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

To export a specific action: "actionname"

--event-contact

event-action-pipeline

event-rule

event-template

Exports event contacts. Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

To export a specific contact: "contactname"

--event-format

event-action-pipeline

event-rule

event-template

Exports event formats. Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

To export a specific format: "formatname"

--event-rule

event-action-pipeline

event-contact

event-format

event-trigger

logical-instance

logical-type

Exports event rules. Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

To export a specific rule: "rulename"

--event-template

event-action-pipeline

event-contact

event-format

event-trigger

logical-instance

logical-type

Exports event templates. This includes the event template's associations. Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

To export a specific template: "templatename"

--event-suppression

See examples in the Search for --event-suppression table.

--event-trigger

event-rule

event-template

logical-type

Exports event triggers. Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

To export a specific trigger: "triggername"

--group

group-tab

user

logical-type

logical-instance

Exports user groups. Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

To export a specific group: "groupname"

--group-tab

group

Exports group navigation tabs and settings.

This pattern controls the User Navigation Tabs. The filter operates on the name of the tab. When you export these patterns, any associated values (such as security) are also exported with them.

Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

To export a specific tab: "tabname"

--history-rule

Exports history rules. See examples in the Search for --history-rule table.

--history-template

Exports history templates. This includes the history template's associations. See examples in the Search for --history-template table.

--image

logical_type

physical_view

view_group

Imports or exports user-specified images that have been placed on physical or logical views in TrueSight Middleware and Transaction Monitor.

Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

To export a specific image: "imagename"

--logical-instance

event-rule

event-template

logical-type

Exports logical instances. Examples:

To export ALL: ".*:.*"

To export all with warnings: ".*"

To export a specific instance: "instancename:logicaltypename"

To export all instances of a type: ".*:logicaltypename"

--logical-type

event-rule

event-template

event-trigger

logical instance

image

Exports logical types. Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*" 

--model

profile

Exports all objects associated with a transaction pathway. Because a transaction pathway with the same name can appear in several profiles, you must specify --profile when using --model.

--physical-view

image

Exports physical views, including any graphics on the view. Exports only views that are associated with an object type.

This pattern works well to move views from one database to another. If your view is corrupted, contact BMC Customer Support for information about restoring previous versions of the view.

Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

To export a specific view: "viewname"

--profile

model

Exports all objects associated with a BTM profile, including message formats, models, activity implementations, and profiles. If you specify --model, only the transaction pathway that you specify is exported.

--user

group

user-tab

Exports user profiles. Passwords are not included in the export for security reasons, so when users are imported, they are de-activated and have no passwords. To activate imported users, use the Security tab of the Monitor Console.

Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

To export a specific user: "username"

--user-tab

user

Exports user navigation tabs and settings.

This pattern controls the User Navigation Tabs. The filter operates on the name of the tab. When you export these patterns, any associated values (such as security) are also exported with them.

Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

To export a specific tab: "tabname"

--viewgroup

image

Exports saved view groups, even if they are not placed on a view. Examples:

To export ALL: ".*"

To export all with warnings: ".*:.*"

 To export a specific viewgroup: "viewgroupname"

Search for --event-suppression

Export ALL

".*:.*"

Export all with warnings

".*"

Export a specific object

"hostname!qmgrname!objectname!:.*"

or replace .* with a specific path (all on one line): "hostname!qmgrname!objectname!:ComMQSoftwareNetworkHost! ComMQSoftwareWebSphereMQQueueManager! ComMQSoftwareWebSphereMQLocalQueue!"

Export all suppression for a specific type of object

".*:ComMQSoftwareNetworkHost! ComMQSoftwareWebSphereMQQueueManager! ComMQSoftwareWebSphereMQQueue"

Export all suppression for a queue manager

"hostname!qmgrname.*:.*"

Search for --history-rule

Export ALL

".*:.*"

Export all with warnings

".*"

Export a specific attribute for an object

"hostname!qmgrname!object!attribute:.*"

or replace .* with a specific path (all on one line): "hostname!qmgrname!object!attribute:ComMQSoftwareNetworkHost! ComMQSoftwareWebSphereMQQueueManager! ComMQSoftwareWebSphereObject! ComMQSoftwareAttribute"

Export a specific object

"hostname!qmgrname!object!.*:.*"

Export all of a queue manager

"hostname!qmgrname.*:.*"

Export all queues (all on one line)

".*:ComMQSoftwareNetworkHost! ComMQSoftwareWebSphereMQQueueManager! ComMQSoftwareWebSphereMQLocalQueue! ComMQSoftwareAttribute"

Search for --history-template

Export ALL

".*:.*"

Export all with warnings

".*"

Export a specific template

"templatename:.*"

or replace .* with a specific object type (all on one line): "templatename:ComMQSoftwareWebSphereMQLocalQueue"

Export templates for a specific type

".*:objectype"

".*:ComMQSoftwareWebSphereMQLocalQueue"

Export all of a queue manager

"hostname!qmgrname.*:.*"

Export all MQ Objects

".*:ComMQSoftwareWebSphereMQ.*"

Was this page helpful? Yes No Submitting... Thank you

Comments