Pattern notes and interactions
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.*" |