The BizTalk Server Accelerator for Financial Services 1.0 SR1 Adapter Feature Pack (831811)


The information in this article applies to:

  • Microsoft BizTalk Accelerator for Financial Services 1.0 SR1

SUMMARY

This article discusses the new tracing features that are available when you install the Microsoft BizTalk Server Accelerator for Financial Services 1.0 Service Release 1 (SR1) Adapter Feature Pack. It also discusses how to install the Adapter Feature Pack, how to configure tracing, and how to remove the Adapter Feature Pack.

INTRODUCTION

You can use tracing in Microsoft BizTalk Server Accelerator for Financial Services 1.0 Service Release 1 (SR1) to configure and to view the messages that are submitted to the SWIFT network and from the SWIFT network. The BizTalk Server Accelerator for Financial Services 1.0 SR1 Adapter Feature Pack enables logging of information about the SWCall SWIFT API calls and the SWCallback SWIFT API calls.

Every log includes context information and the actual message that was passed. Context information includes the SWIFT API name, the time that the SWIFT API call was logged, and the function signature in the component where the SWIFT API call was made.

back to the top

Prerequisites

The following list outlines the recommended hardware, software, network infrastructure, and service packs that you need:
  • Microsoft Windows 2000 Advanced Server Service Pack 4 (SP4) or Microsoft Windows
  • BizTalk Server Accelerator for Financial Services 1.0 SR1 Standard Edition or Enterprise Edition
  • BizTalk Server 2002 Service Pack 1

    For more information about BizTalk Server 2002 Service Pack 1, visit the following Microsoft Web site:

    http://www.microsoft.com/downloads/details.aspx?FamilyId=24B736BA-611E-41E5-9551-45EB5450296B&displaylang=en

  • Financial Services Accelerator Update for BizTalk Server 2002 SP1

    For additional information, click the following article number to view the article in the Microsoft Knowledge Base:

    826456 FIX: Financial Services Accelerator Update for BizTalk Server 2002 Service Pack 1

back to the top

Important pre-installation and pre-removal instructions

Before you install or remove the Microsoft BizTalk Server Accelerator for Financial Services 1.0 SR1 Adapter Feature Pack, follow these steps:
  1. Verify that your Microsoft Windows 2000 logon account is a member of the Administrators group and the BizTalk Server Administrators group.

    For more information about Windows 2000 logon accounts, see Windows 2000 Help.
  2. Shut down the Financial Services SWIFTNetLink (SNL) BizTalk application integration component (AIC) COM+ package. To do this, follow these steps:
    1. Click Start, click Administrative Tools, and then click Component Services.
    2. In Component Services Administrator, expand Component Services, expand My Computer, and then expand COM+ Applications.
    3. Right-click the Financial Services SNL BizTalk AIC, and then click Properties.
    4. Click the Advanced tab.
    5. Under Permission, click to clear the Disable Changes check box, and then click OK.
    6. Right-click the Financial Services SNL BizTalk AIC, and then click Shut Down.
  3. Shut down the SNL Receiver. For more information, see the SWIFT documentation.
Note The Adapter Feature Pack makes changes to the existing assemblies that were installed as part of Microsoft BizTalk Server Accelerator for Financial Services 1.0 SR1.

back to the top

Installation instructions

To install BizTalk Accelerator for Financial Services 1.0 SR1 Adapter Feature Pack, follow these steps:
  1. Follow the steps in the "Important pre-installation and pre-removal instructions" section.
  2. Run the A4FSv1SR1_831811_EN.exe file.
  3. When the installation process has completed, click OK.
The following file is available for download from the Microsoft Download Center:

DownloadA4FSv1SR1_831811_EN.exe

Release Date: April 7, 2004

For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:

119591 How to Obtain Microsoft Support Files from Online Services

Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file.

back to the top

MORE INFORMATION

Installing the Adapter Feature Pack alone will not enable tracing because the installation process does not create the required configuration name-value pairs. For a list of the required configuration parameters, see the "Tracing configuration" section.

To enable tracing, write a custom trace listener that implements the interface as defined in the "Tracing implementation notes" section. The accelerator components call this custom trace listener so that the context information and the SWIFT message can be logged.

back to the top

Tracing configuration

  1. In BizTalk Messaging Manager, double-click the BizTalk channel that is bound to the BizTalk port that uses the SWIFTNetLink Adapter (SNLA) AIC as a transport. The Channel Properties wizard appears.

    Note This article discusses the SNL AIC and the SNLA AIC. However, these are two names for the same component. The Component Services snap-in refers to this component as the SNL AIC. The BizTalk Messaging Manager refers to this component as the SNLA AIC.

  2. In the Channel Properties wizard, click Next until the Advanced Configuration dialog box appears.
  3. In the Advanced Configuration dialog box, click Advanced. The Override Messaging Port Defaults dialog box appears.
  4. In the Override Messaging Port Defaults dialog box, click Properties. The SNLA SnlGlobalConfigAIC Properties dialog box appears.
  5. In the SNLA SnlGlobalConfigAIC Properties dialog box, you must configure the following fields under Custom Fields:
    • TraceToggle - Set this value to On or to Off.
    • RefreshInterval - Set this value between 1 and 86400. This value contains the interval time in seconds that the configuration information will be refreshed. Any value outside less than 1 or greater than 86400 disables tracing. If this behavior occurs, you must restart the components.
    • AssemblyName - Set this value to the fully qualified strong assembly name of the trace listener that you want to use. This value includes the version, the culture, and the publickeytoken information. You must install this assembly in the global assembly cache.
back to the top

Tracing implementation notes

The following list contains important notes about tracing:
  • A trace listener must reference the Microsoft.Solutions.FinancialServices.Tools.TraceInterface.dll file. The Microsoft.Solutions.FinancialServices.Tools.TraceInterface.dll file is installed as part of the Adapter Feature Pack.
  • The listener must implement the following interface:
    namespace Microsoft.Solutions.FinancialServices.Tool
{
    public interface TraceInterface
   {
        void RaiseEvent(string msg, string ctx) 
    }
}
    In this interface, msg contains the SWIFT message or the response, and ctx contains the context information of the message, such as the date, the time, and the SWIFT API call.
  • To trace messages, you must install the custom trace listener in the global assembly cache.
  • If tracing is set to Off when the receiver and the SNL AIC components are started for the first time, you must restart the receiver and the SNL AIC package to enable tracing again.
  • If null values are entered for TraceToggle or AssemblyName, tracing is disabled.
  • If TraceToggle is set to any value other than On or Off, tracing is disabled.
  • If TraceToggle is set to On, and a strongly named assembly is not provided or an inaccurate assembly name is provided, tracing is disabled.
  • If the custom trace listener is not installed in the global assembly cache, or if the custom trace listener does not load successfully, tracing is disabled.
back to the top

Removal instructions

To remove the Adapter Feature Pack, follow these steps:
  1. Follow the steps in the "Important pre-installation and pre-removal instructions" section.
  2. Click Start, point to Settings, and then click Control Panel.
  3. In Control Panel, double-click Add or Remove Programs.
  4. In the list of installed programs, click Microsoft BizTalk Accelerator for Financial Services 1.0 SR1 Post-RTM [See KB831811 for more details], and then click Remove.
back to the top
Modification Type:MinorLast Reviewed:8/4/2004
Keywords:kbdownload kbfile kbinfo KB831811 kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.