Serving Files Using CMS Search Order

Summary of Steps

1. Move the files to minidisks and SFS directories that are accessed by the VM:Webgateway SVM.
2. Ensure the VM:Webgateway SVM has authorization to read the files you want to serve.
3. If the DIRMAP file defined as the server root domain does not exist, create it.
4. Add FILE directory control records to the DIRMAP file to identify the files you want to serve.

Steps in Detail

1. Move the files to minidisks and SFS directories that are accessed by the VM:Webgateway SVM.

   The virtual addresses of the accessed minidisks from which you want to serve files should be in the ranges 0100-01FF or 0800-1FFF. By default, VM:Webgateway detaches minidisks that have virtual addresses outside these ranges at initialization.

   To use a minidisk with a virtual address that is outside these ranges, identify the virtual address on the RESVADDR configuration record in the VMWEBSRV CONFIG file. For more information about the RESVADDR configuration record, refer to the Getting Started book.

   You must leave at least one filemode available for VM:Webgateway to use. When serving a user page-owned Webshare compatibility CGI program that is to run on the VM:Webgateway SVM, VM:Webgateway accesses the minidisk or SFS directory that contains the CGI program at the last available filemode in the VM:Webgateway SVM.

   While the minidisk or SFS directory is accessed, if a web browser user requests a file and the first version in the CMS search order resides on the minidisk or SFS directory that contains the Webshare compatibility CGI program, VM:Webgateway will serve that version of the file.

   To reduce the chances of VM:Webgateway serving files from minidisks and SFS directories it accesses to run Webshare compatibility CGI programs, make sure the free filemode is low in the CMS search order, for example, filemodes T-X.

2. Ensure the VM:Webgateway SVM has authorization to read the files you want to serve.

3. If the DIRMAP file defined as the server root domain does not exist, create it.

   To determine what filename to use, enter the QUERY SOCKET command from a VM userid.

   If there are several versions of the DIRMAP file defined as the server root domain, VM:Webgateway uses the first version it locates using the CMS search order.

4. Add FILE directory control records to the DIRMAP file to identify the files you want to serve.

   For example, to identify all HTML files add the following record:

   FILE *.HTML = =

   If you have minidisks and directories accessed by the VM:Webgateway SVM that contain files you do not want to serve, use pattern matching on FILE records carefully. You want to ensure you do not mistakenly serve files because their fileids match an entry on a FILE record that uses pattern-matching characters.

URLs for Files Served Using CMS Search Order

A web browser user views a file by identifying the file in the last element of the path portion of the URL.

When VM:Webgateway determines the filename and filetype of a file to serve, and versions of that file exist on more than one accessed minidisk or directory, VM:Webgateway serves the version of the file found on the first accessed minidisk or directory.

For example, you want to view the file PLANS HTML. All of the following are true:

• The server root domain is defined as the ROOT DIRMAP file.
• The ROOT DIRMAP file contains a FILE record identifying the PLANS HTML file.
• Versions of the PLANS HTML file exist on the minidisks accessed at filemodes C, F, and G.
• The VM:Webgateway SVM is identified by www.company.com on TCP port 80.

http://www.company.com:80/plans.html

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

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. An automatic directory is a list of files you identify in the DIRMAP file that you specified when defining the server root domain to use CMS search order. VM:Webgateway creates a hyperlink to each file in the list to allow a user to easily select and view files.

Example

When you defined the server root domain to use CMS search order, you specified the ROOT DIRMAP file. The VM:Webgateway SVM is identified by www.company.com on TCP port 80. When a web browser user enters the following URL, VM:Webgateway displays a list of the files identified in the ROOT DIRMAP file:

http://www.company.com:80/