Editar

Partilhar via


Interceptor Management Commands

To support the new BAM interceptor functionality, four new commands have been added to the BAM Management utility.

These commands support the deployment, retrieval, and removal of interceptors. A command is also provided to list the configured interceptors.

  • deploy-interceptor: Deploys an interceptor configuration.

  • get-interceptorlist: Gets a list of activities on which interception is deployed.

  • get-interceptor: Gets the interceptor configuration.

  • remove-interceptor: Removes an interceptor configuration.

Note

You can enable tracing on any BM utility command by including the -Trace:on|off parameter switch. Using the Trace switch overrides the tracing settings in the configuration file. The switch can be used in conjunction with any normal BM command.

Note

On a system that supports User Account Control (UAC), you may need to run the tool with Administrative privileges.

deploy-interceptor Command

Usage

bm.exe deploy-interceptor -FileName:<Configuration XML Filename> [-Force:True ] [-Server:<server>] [-Database:<database>]

Parameters

Parameter Description
FileName:<Configuration XML Filename> The name of the XML file containing the interceptor configuration.
Force:True Optional: Forces deployment of the interceptor configuration when event source name collisions are detected.
Server:<server> Optional: The name of the server on which to deploy the interceptor. The server must be in the same domain as the computer from which you are running bm.exe.
Database:<database> Optional: The name of the BAM Primary Import database on which to configure the interceptor.

This command deploys the interceptor configuration to the specified server and database. During deployment, the BAM Management utility performs the following validations:

  • XSD validation: The interceptor configuration is validated against the common interceptor configuration schema.

  • Validation that the activity exists (is deployed in the Primary Import database) and that checkpoints are valid (exist and have a matching data type).

    If a collision is detected in the event source name, a warning is thrown describing the collision. In the case of a collision, the deployment will fail unless the –Force:True parameter flag is used.

Note

The –Force:True parameter potentially removes interceptor configurations that reference event sources with the same name. You should use the get-interceptor command to create a backup of existing interceptor configurations before using the –Force:True parameter.

Examples

bm.exe deploy-interceptor  -FileName:myInceptor.xml  
bm.exe deploy-interceptor  -FileName:myInceptor.xml -Force:True  

get-interceptorlist Command

Usage

bm.exe get-interceptorlist [-Server:<server>] [-Database:<database>]

Parameters

Parameter Description
Server:<server> Optional: The name of the server from which to return a list of deployed interceptors. The server must be in the same domain as the computer from which you are running bm.exe.
Database:<database> Optional: The name of the BAM Primary Import database from which to retrieve the deployed interceptors.

This command returns a list of the activities, and their associated event sources, for which interception is enabled.

Example

bm.exe get-interceptorlist   

get-interceptor Command

Usage

bm.exe get-interceptor [-Server:<server>] [-Database:<database>] -FileName: <Configuration XML Filename> [ -Activity: <Activity Name>] [-EventSource: <Event Source Name>]

Parameters

Parameter Description
Server:<server> Optional: The name of the server from which to retrieve the deployed interceptor. The server must be in the same domain as the computer from which you are running bm.exe.
Database:<database> Optional: The name of the BAM Primary Import database from which to retrieve deployed interceptor.
FileName:<Configuration XML Filename> The name of the XML file to which to write the interceptor configuration.
Activity:<Activity Name> Optional: Specifies the activity for which to return the configured interceptor. Can be used in conjunction with the EventSource parameter to further specify the configuration to return.
EventSource:<Event Source Name> Optional: Specifies the event source for which to return the configured interceptor. Can be used in conjunction with the Activity parameter to further specify the configuration to return.

If no activity name or event source name is provided, the command returns a valid configuration file containing the interceptor configurations for all event sources and activities.

If only an activity name is provided, the command returns a valid interceptor configuration file for all event sources for that activity.

If only an event source name is provided, the command returns a valid interceptor configuration file for that event source across all activities.

If both an activity name and an event source name are provided, then the command returns a valid interceptor configuration file for that event source for that activity.

Examples

bm.exe get-interceptor   
bm.exe get-interceptor  -Activity:ShippingPO  

remove-interceptor Command

Usage

bm.exe remove-interceptor [-Server:<server>] [-Database:<database>] [ -Activity: <Activity Name>][-EventSource: <Event Source Name>]

Parameters

Parameter Description
Server:<server> Optional: The name of the server on which the interceptor is configured. The server must be in the same domain as the computer from which you are running bm.exe.
Database:<database> Optional: The name of the database on which the interceptor is configured.
Activity: <Activity Name> Optional: Specifies the activity for which to remove the specified interceptor. Can be used in conjunction with the EventSource parameter to further specify the configuration to return.
EventSource: <Event Source Name> Optional: Specifies the event source for which to remove the specified interceptor. Can be used in conjunction with the Activity parameter to further specify the configuration to return.

If only an activity name is provided, the command removes the interceptor for all event sources for that activity.

If only an event source name is provided, the command removes only that event source portion for all activities.

Example

bm.exe remove-interceptor   

See Also

BAM Management Utility