Serving Files from Logical Directories When Using CMS Search Order

Steps

1. Place the DIRMAP files on minidisks and SFS directories accessed by the VM:Webgateway SVM. If there is more than one version of the same DIRMAP file, VM:Webgateway uses the version on the first accessed minidisk or SFS directory.
2. Place the files identified in logical directories on minidisks and SFS directories accessed by the VM:Webgateway SVM. If there is more than one version of the same file, VM:Webgateway serves the version on the first accessed minidisk or SFS directory.

URLs for Files Served From 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 DIRMAP the VM:Webgateway system administrator specified when defining the server root domain. If a match is found on a DIR record, VM:Webgateway continues to match elements, but switches to use the DIRMAP file specified on the DIR record. If more than one version of the specified DIRMAP file exists, VM:Webgateway uses the version on the first accessed minidisk or SFS directory.

Examples

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 RECRUITING    RECRUIT  HTML 
 

• There are versions of the CMS file FTBLRULE HTML on the minidisks accessed at C and G. To view the file, enter the following URL:

  http://www.company.com/football/rules.html

  VM:Webgateway serves the version of the file on the minidisk accessed at filemode C.

• There are versions of the CMS file RECRUIT HTML on the SFS directories accessed at filemode E and F. To view the file, enter the following URL:

  http://www.company.com/football/college/recruiting

  VM:Webgateway serves the version of the file on the directory accessed at filemode E.

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 structures displayed above.

• A web browser user enters the following URL:

  http://www.company.com/

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

  Dir: FOOTBALL

• A web browser user enters the following URL:

  http://www.company.com/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.company.com/football/college/

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

  File: CHANGES.HTML
File: RECRUITING