Serving Files from Logical Directories on a Minidisk

Steps

1. Place the DIRMAP files for logical directories on the minidisk you defined as the server root domain.

   ---

   Note: To determine the file to serve, VM:Webgateway always reads the VMWEBSRV DIRMAP file first.

   ---

2. Place the files identified in the logical directories on the minidisk you defined as the server root domain.

URLs for Files Served Using Logical Directories

A web browser user views a file by identifying the logical directories and the file in the path portion of the URL.

VM:Webgateway matches each element in the path portion of a URL to a record in a DIRMAP file. VM:Webgateway always starts by reading the VMWEBSRV DIRMAP file. If a match is found on a DIR record, VM:Webgateway continues matching elements, but switches to use the DIRMAP file specified on the DIR record.

Examples

The examples show how to view files stored in a user page for VM userid DAN. If the files were stored in the server root domain, the web browser user would omit the ~dan element from the URL. The examples use 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 
 

• To view the CMS file FTBLRULE HTML in the FOOTBALL logical directory, enter the following URL:

  http://www.comp.com/~dan/football/rules.html

• To view the CMS file SCORES HTML in the COLLEGE logical directory, enter the following URL:

  http://www.comp.com/~dan/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 the items specified on FILE and DIR records in the current DIRMAP file. VM:Webgateway creates a hyperlink to each item in the list to allow a 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://www.comp.com/~dan/

  VM:Webgateway serves an automatic directory containing the following items:

   Dir: FOOTBALL 

• A web browser user enters the following URL:

  http://www.comp.com/~dan/football/

  VM:Webgateway serves an automatic directory containing the following items:

   Dir: COLLEGE          
   File: OVERVIEW.HTML   
   File: RULES.HTML 

• A web browser user enters the following URL:

  http://www.comp.com/~dan/football/college/

  VM:Webgateway serves an automatic directory containing the following items:

   File: CHANGES.HTML   
   File: SCORES