HOWTO: How To Troubleshoot RPC Errors

ID: Q197814

The information in this article applies to:

Microsoft Transaction Server, versions 1.0, 2.0

SUMMARY

When trying to invoke a method in a Microsoft Transaction Server (MTS) component, a remote procedure call (RPC) error occurs. A number is received that is less than descriptive. The steps in the MORE INFORMATION section describe how to find the error message associated with the error number. In addition, the article includes several troubleshooting steps that may help to resolve a RPC connectivity issue.

MORE INFORMATION

Decoding Error Message

You can use the Error Lookup tool or the C:\Program Files\DevStudio\VC\include\Winerror.h file to get the associated error message. If the error number is in decimal form, convert the error to hex using the Calculator in the Accessories group (make sure that under the view menu of the Calculator select Scientific).

Start Visual C++ 5.0.

From the Tools menu, choose Error Lookup.

Enter an error number. For example: 800706BE

The following text returns:

The remote procedure call failed.

If the Error Lookup tool fails to find the error, Open the Winerror.h file that comes with Visual C++ 5.0. The top of the Winerror.h file explains how to translate the error number.

In this example, the error number is 800706BE. Translate this value to binary which is:
10000000000001110000011010111110.

The binary value is broken into parts that yields the following information:


      10  - The error is actually a Warning.

       0  - Customer Code Flag.

       0  - Reserve Bit

   111 binary = 7 decimal - Facility Code is a FACILITY_WIN32 code.
   0000011010111110 binary= 1726 decimal – Code

Search the Winerror.h on the error code of 1726 and you will find the following information:


      // 
      // MessageId: RPC_S_CALL_FAILED
      // 
      // MessageText:
      // 
      //  The remote procedure call failed.
      // 
      #define RPC_S_CALL_FAILED                1726L

Troubleshooting RPC

Make sure that the remote procedure call (RPC) services are started on the server computer. You can do this by opening Control Panel, double- clicking Services, and checking to make sure the Remote Procedure Call (RPC) Service and Remote Procedure Call (RPC) Locator services are running and set to start automatically.

If the operating system is Windows 95, Distributed Component Object Model (DCOM) must be installed. You can downloaded this file from the following Web site:
http://www.microsoft.com/
NOTE: DCOM is not included in the released version of Windows 95.

Make sure that DCOM is configured properly on the MTS server and the client machine. Follow these steps:
1. Run Dcomcnfg.exe.
2. Select the Default Property tab.
3. Select the Enable Distributed COM on this computer check box.
4. From the Default Authentication Level, select None for testing. Normally this should be set to a level that is equal to or higher than the packages authentication level.
5. From the Default Impersonation drop-down list box, select Impersonate. MTS requires Identify or Impersonate for this setting.

For testing, change the package authentication to match the DCOMCNFG settings on the MTS Server by using the following steps:
1. Run Transaction Server Explorer.
2. Right-click the Package that is being used for testing.
3. Select Properties from the drop-down menu.
4. Select the Security tab.
5. Clear the Enable authorization checking check box.
6. Click OK.

Try using the component used for testing again. If the RPC error still occurs proceed with step 6.

Use the information in the following Microsoft Knowledge Base Exchange article to test the RPC communication:
Q167260 XCLN: How to Use RPCPing to Test RPC Communication

Additional query words:

Keywords : kbCOMPlus kbMTS kbMTS100 kbMTS200 kbVC600 kbDSupport
Version : winnt:1.0,2.0
Platform : winnt
Issue type : kbhowto