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.*"

 

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