What's New

Enabling the Web Control Center Remote Documentation Searches

The Web Control Center allows users to view and search DB2 information (online books and help) that may be stored on a remote system. Viewing information uses a browser and the Web server, while enabling search requires some changes to your local HTML search form and IBM Internet Connection Server (ICS) Lite configuration file. To enable remote searching of the product documentation:

Edit the HTML search form.

On a Windows or OS/2 operating system
This file is x:\sqllib\doc\html\db2srch.htm, where x: is the drive where DB2 is installed.
On an AIX operating system
This file is /usr/lpp/db2_05_00/doc/%L/html/db2srch.htm, where %L is your locale.
On other UNIX operating systems
This file is /opt/IBMdb2/V5.0/doc/%L/html/db2srch.htm, where %L is your locale.

Note: These paths are the defaults and can vary depending on paths set during the installation of DB2.
Change the action= attribute of the <form> tag. Replace localhost:49213 with hostname:49214, where hostname represents the machine where the documentation files are installed.
Edit your ICS Lite configuration file.
On a Windows or OS/2 operating system, this file is httpd.cnf in the directory netqos2, imnnq_nt, or imnnq95, depending on the operating system. On Windows 98, the directory is imnnq_95.
On a UNIX operating system, this file is httpdlite.conf. For AIX operating systems, this file is in the /etc/IMNSearch directory. For Solaris and HP-UX operating systems, it is in the /opt/IMNSearch directory.
- Copy the original ICS Lite configuration file to another file name in the same directory as the original (db2webcc.cnf is recommended as the new file name).
  Note: By creating a copy of this configuration file, you can avoid affecting other products installed on your system that rely on the search server.
- Replace the value of the Hostname line in db2webcc.cnf (or whatever you named the copy of the ICS Lite configuration file) with the same hostname:49214 as you did in the HTML search form.
- Add the following line to db2webcc.cnf:
```
  MaxActiveThreads 40
```
  This setting will increase ICS Lite's performance when multiple requests are arriving over the network. You can set the value of MaxActiveThreads to greater than 40, but as this value increases more memory is consumed.
- Edit your Start HTML Search Server icon's properties so that it calls the new db2webcc.cnf file. Add the name
```
  db2webcc.cnf
```
  as the last argument in the icon's target field. If you put the new configuration file in a directory that was different from the original, you must specify the full path name.
  On Windows NT and OS/2 operating systems, if you you have Start HTML Search Server icons in your Startup folder and your DB2 program folder, you should edit the properties for both icons. For information on editing an icon's properties consult your operating system's documentation.
- For each index that is installed on the machine, run the nqmap command to set the base location for the documentation files. The exact directory to use depends on your hostname. On a UNIX operating system, it also depends on the locale of the HTML files for that particular language.
  For example, if your server was named yourserver, the index you were mapping was Administration (DB2ADM), and your locale (%L) was set to English (EN):
  
  OS/2 and Windows:
  nqmap DB2ADMEN "http://yourserver/doc/html/" DB2ADMEN
  AIX:
  /usr/IMNSearch/cli/imnmap DB2ADMEN "http://yourserver/doc/%L/html/" DB2ADMEN
  Note: For double-byte character (DBCS) indexes, replace imnmap with imqmap.
  
  Solaris and HP-UX:
  /opt/IMNSearch/cli/nqmap DB2ADMEN "http://yourserver/doc/%L/html/" DB2ADMEN
- Repeat these commands for each installed index.
  - For the Application Development index, substitute DB2APDXX
  - For the DB2 Connect index, substitute DB2CONXX
  - For the Web Control Center Help, substitute DB2HLPXX
  XX is the index's locale.
- Stop the search server and start it again.
  - On Windows NT or OS/2 operating systems, select the appropriate icon in your DB2 program folder.

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]

[ DB2 List of Books | Search the DB2 Books ]