User Exits

.NET Proxy › Preparing for Execution › Configuring the .NET Proxy Runtime › User Exits

User Exits

The user exits that are invoked at runtime for a .NET Proxy are common to other C# execution environments.

Note: For more information about each user exit, see the User Exit Reference Guide.

The user exits invoked during runtime depend on the selected communication type. The communication type implies the use of a particular process for formatting the import and export message data that is exchanged with the target DPS application.

A .NET Proxy flowing to a DPS using TCP/IP invokes the following user exit entry points:

User Exit Entry Point	Purpose
CFBDynamicMessageSecurityExit	The Client Security user exit class is used to direct the runtime to incorporate the ClientID and ClientPassword Import Object attributes into the CFB. If this exit returns SECURITY_ENHANCED, it can cause an optional Security Token field to be added to the CFB.
CFBDynamicMessageDecryptionExit	The export message encryption user exit class provides the opportunity to decrypt the portion of the CFB that has been encrypted by the target DPS execution environment. This exit must implement the companion to the DPS encryption user exit for the DPS response buffer to be interpreted as a valid response CFB.
CFBDynamicMessageEncryptionExit	The import message encryption user exit class provides an opportunity to encryption algorithm implemented within this user exit to encrypt a portion of the outbound CFB. The target DPS execution environment must implement a companion decryption user exit for the CFB to be interpreted as a valid request CFB.

In addition to the above user exits, a .NET Proxy flowing to a DPS using TCP/IP invokes the following user exit entry point:

User Exit Entry Point	Purpose
TCPIPDynamicCoopFlowExit	This user exit lets certain TCP/IP communication parameters to be overridden at runtime.

A .NET Proxy flowing to a .NET Serviced Component DPS using .NET Remoting invokes the following user exit entry points:

User Exit Entry Point	Purpose
NETDynamicCoopFlowExit	This user exit class lets certain .NET Remoting communication parameters to be overridden at runtime.
NETDynamicCoopFlowSecurityExit	This user exit class lets you specify a user-defined security object to be passed to the server.

In addition to these user exits, a .NET Proxy flowing to a DPS using MQSeries invokes the following user exit entry point:

User Exit Entry Point	Purpose
MQSDynamicCoopFlowExit	This user exit lets certain MQSeries communication parameters to be overridden at runtime.
WSDynamicCoopFlowExit	This class has methods that let you manipulate the target Web Service endpoint URL by modifying the following properties: BaseURL ContextType This class has a method for handling exceptions that occur when performing a Web Service operation. This method lets the failed request to be retried.

User Exit Entry Point

Purpose

MQSDynamicCoopFlowExit

This user exit lets certain MQSeries communication parameters to be overridden at runtime.

WSDynamicCoopFlowExit

This class has methods that let you manipulate the target Web Service endpoint URL by modifying the following properties:

BaseURL

ContextType

This class has a method for handling exceptions that occur when performing a Web Service operation. This method lets the failed request to be retried.