Using CORBA Request-Level Interceptors

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Deploying CORBA Request-Level Interceptors

There are three administrative tasks associated with managing the registration of CORBA request-level interceptors:

This section explains these three tasks.

Notes: The BEA Tuxedo CORBA Java client and BEA Tuxedo CORBA Java client ORB were deprecated in Tuxedo 8.1 and are no longer supported. All BEA Tuxedo CORBA Java client and BEA Tuxedo CORBA Java client ORB text references, associated code samples, should only be used to help implement/run third party Java ORB libraries, and for programmer reference only.
Note: Technical support for third party CORBA Java ORBs should be provided by their respective vendors. BEA Tuxedo does not provide any technical support or documentation for third party CORBA Java ORBs.


Registering an Interceptor

You use the epifreg command to register your interceptors with an ORB. When you register an interceptor, the interceptor is added to the end of the list of interceptors already registered with the ORB. This is important when you have multiple interceptors registered with an ORB.

The syntax of the epifreg command for registering interceptors is the following:

epifreg -t bea/wle -i AppRequestInterceptor \
-p <InterceptorName> -f <FileName> -e <EntryPoint> \
-u "DisplayName=<Administrative Name>" -v 1.0

In the preceding command line:

Note: When you register an interceptor on a machine on which BEA Tuxedo CORBA server processes are already running, those processes will not be subject to interception. Only those processes that are started after an interceptor is registered are subject to interception. If you want to make sure that all CORBA server processes are subject to interception, make sure that you register you interceptors before you boot any CORBA server processes.


Unregistering an Interceptor

Use the epifunreg command to unregister an interceptor from an ORB. This command has the following syntax:

epifunreg -t bea/wle -p <InterceptorName>

The argument <InterceptorName> is the same case-insensitive name specified in the epifreg command. Unregistering an interceptor takes it out of the interceptor order.


Changing the Order in Which Interceptors Are Called

You can see the order in which interceptors are registered, and thus called, by using the following command:

epifregedt -t bea/wle -g -k SYSTEM/interfaces/AppRequestInterceptor

The epifregedit displays the order in which interceptors are executed when the ORB receives a request.

You can change the order in which the interceptors are executed using the following command:

epifregedt -t bea/wle -s -k SYSTEM/interfaces/AppRequestInterceptor \
-a Selector=Order -a Order=<InterceptorName1>,<InterceptorName2>,...

Each <InterceptorName> is the case-insensitive name of the interceptor that must have been previously registered. This command replaces the order currently in the registry. The epifregedt command must specify every interceptor that you want to have loaded and executed by the ORB. If an interceptor is still registered and if you do not specify its name using epifregedt command, the interceptor is not loaded.

  Back to Top       Previous  Next