| Previous Contents Index Next |
| iPlanet Web Server, Enterprise Edition Administrator's Guide |
The Programs Tab
The Programs tab allows you to run server-side applications. The Programs tab contains the following pages:
The CGI Directory Page
The CGI Directory Page
The CGI Directory page allows you to specify the directory where CGI programs are stored.For more information, see Installing CGI Programs.
The following elements are displayed:
URL Prefix. Specifies the URL prefix for the CGI directory. The text you type in this field appears as the directory for the CGI programs in URLs.
For example, if you type cgi-bin as the URL prefix, then all URLs to these CGI programs have the following structure:
http://yourserver.domain.com/cgi-bin/program-name
Note The URL prefix you specify can be different from the real CGI directory you specify in the CGI directory field.
CGI Directory. Specifies the absolute path of the CGI directory. This directory does not have to be under the document root.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Current CGI Directories. Lists all CGI directories currently defined for the server. To modify a CGI directory, click Edit in the directory row. To remove a CGI directory from the list, click Remove in the directory row.
Edit. Allows you to edit an existing CGI directory. The URL prefix and directory path appear in the upper portion of the page, ready to be edited. After making the changes, click OK.
Remove. Removes a directory from the list of registered CGI directories. The directory itself is not deleted.
The CGI as a File Type Page
The CGI as a File Type page allows you to associate a file extension with the shell CGI feature. This is different from creating an association in Windows NT.For more information, see Installing CGI Programs.
The following elements are displayed:
Editing. Specifies the resource you want to specify as a shell CGI type. If you choose a directory, all the files in that directory will be treated as a shell CGI script.
Browse. Allows you to browse your file system.
Wildcard. Specifies a wildcard pattern. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.
Activate CGI as a File Type. Activates CGI as a file type and associates a file extension with the shell CGI feature in the server, such as an association for files with the .pl extension. When the server gets a request for a file with that extension, the server knows to treat the file as a shell CGI file by calling the executable associated in Windows NT with that file extension. If you activated CGI, WinCGI, and shell CGI file types, you must specify a unique suffix for each type of CGI. For example, you cannot use the suffix .exe for both a CGI program and a shell CGI program.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
The Query Handler Page
A query handler processes text sent to it via the ISINDEX tag in an HTML file. ISINDEX is similar to a text field on a page in that it creates a text field in the HTML page that can accept typed input. Unlike the information in a page text field, however, the information in the ISINDEX field is immediately submitted when the user presses Return. When you specify your default query handler, you tell the server to which program to direct the input. For an in-depth discussion of the ISINDEX tag, see an HTML reference manual.The Query Handler page allows you to specify a default query handler CGI program.
For more information, see Using the Query Handler.
The following elements are displayed:
Editing. Specifies a resource to edit. If you choose a directory, the query handler you specify runs only when the server receives a URL for that directory or any file in that directory.
Browse. Allows you to browse your file system.
Wildcard. Specifies a wildcard pattern. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.
Default Query Handler. Specifies the absolute path for the CGI program used as the default for the resource you chose.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
The WINCGI Directory Page
The WINCGI Directory page allows you to create a directory that contains only Windows CGI programs.For more information, see the following sections:
Installing Windows NT CGI Programs
The following elements are displayed:URL Prefix. Specifies the URL prefix you want to use for the WINCGI directory. That is, the text you type appears as the directory for the Windows CGI programs in URLs.
For example, if you type wcgi-programs as the URL prefix, then all URLs to these Windows CGI programs have the following structure:
http://yourserver.domain.com/cgi-bin/program-name
The URL prefix can be different from the real Windows CGI directory you specify in the WINCGI Directory field.
WINCGI directory. Specifies the location of the CGI directory as an absolute path. This directory does not have to be under the document root.
Enable Script Tracing. Specifies whether your server will use script tracing. CGI parameters are passed from the server to Windows CGI programs through files, which the server normally deletes after the Windows CGI program finishes execution. If you enable script tracing, these files are retained in a /temp directory or wherever the environment variables TMP and TEMP are pointing. Also, any window that the Windows CGI program brings up is shown when script tracing is enabled.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Current WINCGI Directories. Lists all Windows CGI directories currently defined for the server. To modify a directory, click Edit in the directory row. To remove a directory from the list, click Remove in the directory row.
Edit. Allows you to edit an existing Windows CGI directory. The URL prefix and directory path appear in the upper portion of the page, ready to be edited. After making the changes, click OK.
Remove. Removes a directory from the list of registered Windows CGI directories. The directory itself is not deleted.
The Shell CGI Directory Page
The Shell CGI Directory page allows you to create a directory in your server's document root that contains only shell CGI files.For more information, see Installing Shell CGI Programs for Windows NT.
The following elements are displayed:
URL Prefix. Specifies the URL prefix associated with your shell CGI directory. For example, suppose you store all shell CGI files in a directory called C:/docs/programs/cgi/shell-cgi, but you want users to see the directory as http://www.yourserver.com/shell/. In this case, you would type shell as the URL prefix.
Shell CGI directory. Specifies the absolute path to the directory you created to store the shell CGI files. Make sure that any files in the shell CGI directory also have file associations set in Windows NT. The server returns an error if it attempts to run a file that has no file-extension association.
Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.
Current Shell CGI Directories. Lists all shell CGI directories currently defined for the server. To modify a directory, click Edit in the directory row. To remove a directory from the list, click Remove in the directory row.
Edit. Allows you to edit an existing shell CGI directory. The URL prefix and directory path appear in the upper portion of the page, ready to be edited. After making the changes, click OK.
Remove. Removes a directory from the list of registered shell CGI directories. The directory itself is not deleted.
Previous Contents Index Next
Copyright © 2001 Sun Microsystems, Inc. Some preexisting portions Copyright © 2001 Netscape Communications Corp. All rights reserved.
Last Updated May 09, 2002