Web Server--Serving Files from Logical Directories on an SFS Directory

	Select where you want to go:

System Administrator Tasks - Advanced

Serving Files Using Alias Names

Serving Files from Logical Directories

	On a Minidisk
	On an SFS Directory
	On a BFS Directory
	When Using CMS Search Order

Serving CGI Programs

Dynamically Including Information in Files

Creating Clickable Images

Filtering Static Files

Summary of Setting Up Access Control

Determining How to Control Access

	Authenticating Web Browser Users
	Determining Group Membership

Setting Up Access Control for the Server Root Domain

Setting Up Access Control for All User Pages

Analyzing Your Server Log

Serving Files from Logical Directories on an SFS Directory

Steps | How a URL Relates to Subdirectories and DIRMAP Files |
URLs for Files Served From Logical Directories | When URLs Identify Directories

Steps

Place the DIRMAP files for logical directories on the SFS directory or subdirectory for which you want to create logical directories.

Note: To determine the file to serve, VM:Webgateway always reads the VMWEBSRV DIRMAP file first.
Place the files identified in the logical directories on the same SFS directory or subdirectory as the DIRMAP file.

How a URL Relates to Subdirectories and DIRMAP Files

In the following illustration, the files are stored in VM userid DAN's user page:

The user page is defined as the directory, VMSYSU:DAN.VMWEBGATEWAY.
The subdirectory VMSYSU:DAN.VMWEBGATEWAY.SPORTS contains the following DIRMAP structure:

         VMWEBSRV DIRMAP                 
         ----------------------          
   +---- DIR FOOTBALL  FOOTBALL          
   |                                     
   +---->FOOTBALL DIRMAP              
         --------------------------------
   +---- DIR COLLEGE  COLLEGE            
   |     FILE OVERVIEW.HTML FTBLOVER HTML
   |     FILE RULES.HTML    FTBLRULE HTML
   |                                     
   +---->COLLEGE DIRMAP               
         --------------------------------
         FILE CHANGES.HTML  CHANGES  HTML
         FILE SCORES        SCORES   HTML

Note: In the following example, if the files were stored in the server root domain rather than a user page, the web browser user would omit the ~dan element from the URL.

When mapping a URL to a file, VM:Webgateway first attempts to match a URL element to an entry in a VMWEBSRV DIRMAP file. If a VMWEBSRV DIRMAP file does not exist on the current directory or the VMWEBSRV DIRMAP file does not contain a matching entry, VM:Webgateway looks at the SFS directory structure to find a match.

          +-- No VMWEBSRV DIRMAP file on       
          |   VMYSYSU:DAN.VMWEBSERVER       
          |   directory; VM:Webgateway finds the   
          |   SPORTS subdirectory              
          |                                    
          |                                    
          |      +-- Look for this element     
          |      |   in the SPORTS subdirectory
          |      |                             
          v      v                             
 /~dan/sports/football/overview.html

If the element identifies a subdirectory, VM:Webgateway starts looking for information in the subdirectory. VM:Webgateway first looks for a VMWEBSRV DIRMAP file. If a VMWEBSRV DIRMAP file exists, VM:Webgateway attempts to match the next element to an entry in a VMWEBSRV DIRMAP file. If a matching entry does not exist, VM:Webgateway looks at the SFS directory structure to find a match.

              +-- Found in the VMWEBSRV DIRMAP
              |   file on the current directory;
              |   switch to FOOTBALL DIRMAP file
              |                                 
              |        +-- Look for this element
              |        |   in FOOTBALL DIRMAP
              |        |   file only          
              |        |                      
              v        v                      
 /~dan/sports/football/overview.html

If the element identifies an entry in a DIRMAP file, VM:Webgateway looks for the next element in the specified DIRMAP. The DIRMAP file must be located on the current directory. Once VM:Webgateway finds a match in a DIRMAP file, it only looks in DIRMAP files on the current directory to determine what file to serve. VM:Webgateway no longer matches elements in the URL to SFS subdirectories or files.

                       +-- Found in the       
                       |   FOOTBALL DIRMAP file
                       v                      
 /~dan/sports/football/overview.html

URLs for Files Served From Logical Directories

A web browser user views a file by identifying the subdirectories, logical directories, and the file in the path portion of the URL as described above.

Examples

In the following examples, the files are stored in VM userid DAN's user page. The user page is defined as the VMSYSU:DAN.VMWEBGATEWAY directory. The subdirectory, VMSYSU:DAN.VMWEBGATEWAY.SPORTS, contains the DIRMAP structure displayed above.

To view the CMS file FTBLRULE HTML in the FOOTBALL logical directory on the SPORTS subdirectory, enter the following URL:
http://comp.com/~dan/sports/football/rules.html
To view the CMS file SCORES HTML in the COLLEGE logical directory on the SPORTS subdirectory, enter the following URL:
http://comp.com/~dan/sports/football/college/scores

When URLs Identify Directories

When a web browser user enters a URL that identifies a directory rather than a file, VM:Webgateway generates and serves an automatic directory. The automatic directory contains a list of:

Items specified on the FILE and DIR records in the current DIRMAP file, if one exists
Files on the current directory that VM:Webgateway can serve (files VM:Webgateway has the SFS authority to read)
Subdirectories of the current directory

VM:Webgateway creates a hyperlink to each item in the list to allow a web browser user to easily select and view an item.

Examples

The following examples use the DIRMAP structure displayed above.

A web browser user enters the following URL:
http://comp.com/~dan/

VM:Webgateway serves an automatic directory containing a list of all the files and subdirectories contained on the directory VMSYSU:DAN.VMWEBGATEWAY.
A web browser user enters the following URL:
http://comp.com/~dan/sports/

VM:Webgateway serves an automatic directory containing a list of all the files and subdirectories contained on the directory VMSYSU:DAN.VMWEBGATEWAY.SPORTS. In addition, the list contains the items in the VMWEBSRV DIRMAP file:
```
 Dir: FOOTBALL 
```
A web browser user enters the following URL:
http://comp.com/~dan/sports/football/

VM:Webgateway serves an automatic directory containing a list of all the files and subdirectories contained on the directory VMSYSU:DAN.VMWEBGATEWAY.SPORTS. In addition, the list contains the items in the FOOTBALL DIRMAP file:
```
 Dir: COLLEGE          
 File: OVERVIEW.HTML   
 File: RULES.HTML 
```
A web browser user enters the following URL:
http://comp.com/~dan/sports/football/college/

VM:Webgateway serves an automatic directory containing a list of all the files and subdirectories contained on the directory VMSYSU:DAN.VMWEBGATEWAY.SPORTS. In addition, the list contains the items in the COLLEGE DIRMAP file:
```
 File: CHANGES.HTML   
 File: SCORES 
```

Note: To prevent VM:Webgateway from generating and serving an automatic directory, define a file you want VM:Webgateway to display when a URL identifies a directory.


				Select where you want to go: