VisualAge(R) for Java(TM)

Version 3.5

Online Help

RELEASE NOTES

Table of Contents

For Windows(R) 98, Windows 2000 and Windows NT(R)

1.0 Installing to a LAN drive on Windows 98
2.0 Installing and configuring TCP/IP
3.0 Changing to a different port number
4.0 Changing to a different browser
5.0 Microsoft(R) Internet Explorer always tries to connect to ISP

For Windows 2000 

1.0 Supported browsers
2.0 Changing to a different browser
 

For Windows

1.0 Installing to a LAN drive on Windows 98

If you install to a LAN drive "X:" and you have not previously installed NetQuestion, your AUTOEXEC.BAT call to the search system "X:\IMNNQ_YY\IMNENV.BAT" -- where "YY" is "98" -- will fail. To fix this, copy "X:\IMNNQ_YY\IMNENV.BAT" to C: and edit AUTOEXEC.BAT to call "C:\IMNENV.BAT". 

2.0 Installing and configuring TCP/IP

TCP/IP must be installed and configured in order for the online help to function properly. For Windows 98, TCP/IP must be enabled as follows:

1. For a LAN Adapter configuration:
- You must have DNS enabled with a valid host and domain name.

2. For a Dial-Up Adapter configuration:
- You must have DNS disabled.
- Your TCP/IP address must be obtained automatically.

Note: These configuration options will apply to all TCP/IP adapters even though they have only been changed for this one. You will not be able to use both LAN and Dial-Up without
reconfiguring.

Dial-Up networking TCP/IP properties for your Internet service provider(s) (ISP) must be configured as documented by the ISP. The Dial-Up networking TCP/IP properties will override the properties in the Dial-Up Adapter TCP/IP properties configured via the 'Network' icon in the Windows 98 Control Panel. The overriding of the properties will take place only if the Dial-Up Adapter TCP/IP properties are configured as above.
You must not enable the DNS in the Dial-Up Adapter TCP/IP properties or set an IP address in the Dial-Up Adapter TCP/IP properties. Doing so will interfere with the Dial-Up networking configuration for the ISP.

The above configurations also apply For Windows NT 4. If you are running standalone, you can also enable the MS Loopback Adapter without the other two adapters. 

3.0 Changing to a different port number

The help system is assigned to port 49213, a number beyond the public ports assigned for TCP/IP. If you have another product that uses this port, or if you cannot connect to this port, you can change the help system port with the following steps:

1. Edit the httpd.cnf file in the IMNNQ_NT or IMNNQ_95 directory and change the port number to one you know is available, preferably above 49000.

2. In the c:\IBMJAVA\doc\ivjhlp.cfg file, where c:\IBMJAVA is the VisualAge for Java installation directory, edit the HTML_HOSTNAME value. This value reads, by default:

localhost:49213

Edit this value so that the port number you selected in step 1 replaces 49213.

3. Go to the VisualAge for Java installation directory. In the doc subdirectory, you will find the following files:

hgssrch.htm hgcsrch.htm

4. Use a text editor to edit the hgssrch.htm file to change the following line in hgssrch.htm, so that the port number you selected in step 1 replaces 49213 below:

<form action="http://localhost:49213/cgi-bin/ivjsrch.exe" METHOD="POST">

Repeat this action for the hgcsrch.htm file.

Use your zip tool to update the edited files into the file main.zip.

NOTE: PLEASE UPDATE/ADD THE NEW FILES WITH NO COMPRESSION AND NO PATH INFORMATION.
The files inside the zip file are not compressed. If you compress the file when you update it, you will see only random characters when you reload the search form.

5. Clear your browser memory and disk cache, and exit VisualAge for Java. Help and search should now connect on the new port. If they do not, check for a process named httpdl.exe in the process list. Terminate this process, exit and restart VisualAge for Java again. 

4.0 Changing to a different browser

By default, VisualAge for Java uses your system's default (Netscape Navigator or Internet Explorer) browser to display help. You must modify the help system configuration file if you would like to use a browser other than the default browse browser for your computer. Attempting to change the browser from the Help page of the Options dialog currently has no effect. You can change the browser used by the help system with the following steps:

1. Use a text editor to edit the C:\IBMVJava\doc\ivjhlp.cfg file, where C:\IBMVJava is the VisualAge for Java installation directory.

2. Remove the # character from the beginning of the line #HTML_BROWSER="H:\Programs\Netscape\Communicator\Netscape.exe"

3. Replace H:\Programs\Netscape\Communicator\Netscape.exe with the path and file name of your preferred browser.

4. Save and close the ivjhlp.cfg file.

5. Start VisualAge for Java. Help should now use your preferred browser. 

5.0 Microsoft(R)Internet Explorer always tries to connect to ISP

If, when you launch the help in Internet Explorer, it always tries to connect to your ISP, you must disable this option in Internet Explorer. Depending on what version of Explorer
you are using, you can access your Internet options from the Tools, File or View menu. 

For Windows 2000

1.0 Supported browsers

Currently, not all web browsers are supported on Windows 2000. The help system may not work correctly when using an unsupported browser. Use a browser that supports Windows 2000. 

2.0 Changing to a different browser

Using a different browser than the system default by modifying the ivjhlp.cfg file as described in section 4.0 above does not work under Windows 2000.