Diagnose ActiveX Connector installation problems

Summary

The information provided is to precisely identify the troubleshooting issues that arise with ArcIMS 4.0 ActiveX Connector.

Procedure

1. Download the command line ActiveX Diagnostic Scripts and extract them to their own directory. The location is not important.
2. Open a command prompt and change into the directory where the scripts are located.
3. Run the first script--diag1.js--by typing
   
   

   Code:
    cscript //nologo diag1.js 

   
   If 'Hello, JavaScript is working' displays, proceed to Step 4. If not, the diagnostic steps provided here cannot be used to identify your specific issue. However, this does not necessarily indicate that the ActiveX Connector was installed improperly.
4. Run the diag2.js script by typing
   
   

   Code:
    cscript //nologo diag2.js 

   
   If 'Worked' displays, proceed to Step 5. If not, then the ActiveX Connector was not installed on this machine or the installation failed.
5. Run the diag3.js script by typing
   
   

   Code:
    cscript //nologo diag3.js 

   
   If the following response displays, proceed to Step 6:
   
   

   Code:
   Parsed XML
   Node operations worked

   
   If not, the Microsoft XML Parser needs to be installed. It can be installed from the ArcIMS 4.0 CD by double-clicking the file: \Support\System\aimsmsxml.msi
6. Run the diag4.js script by typing
   
   

   Code:
    cscript //nologo diag4.js 

   
   If 'Worked' displays, proceed to Step 7. If not, Microsoft Transaction Server 2.0 (MTS) is not installed. MTS is installed automatically with Windows 2000 and XP. However, Windows NT 4.0 users need to install it from the Windows NT 4.0 Option Pack.
7. Run the last script--diag5.js--by typing
   
   

   Code:
    cscript diag5.js <APPSERVER_NAME> <APPSERVER_PORT>

   
   If a "Subscript out of range" error is returned, you failed to specify the ArcIMS Application Server's name or port. Make sure you substitute <APPSERVER_NAME> and <APPSERVER_PORT> in the command with the your site information.
   

   Note:
   The default port used by the Application Server is 5300.

   
   If the response is:
   

   
          Date: 12-11-2002
          Time:09:17:06
          Source:ActiveXConnector
          Class: ArcIMSConnector
          Description:XML document must have a top level element.
   

   
    
   then the ActiveX Connector failed to connect to the ArcIMS Application Server. You may have specified the machine name or port incorrectly or the ArcIMS Application Server may not be running. If you determine that these are not the cause, then you may have a networking issue. This type of issue is beyond the scope of this article.