| |  | Serving Files from a BFS Directory
Steps | URLs for Files Served from BFS Directories | When URLs Identify Directories
- If you want VM:Webgateway to serve files and CGI programs from a BFS directory, move the files and programs to the directory or to one of its subdirectories.
- VM:Webgateway requires read and search permissions to all parent directories of the files you want to serve. In BFS, give the VM:Webgateway SVM permission to read and search the BFS directory and its subdirectories.
- In BFS, give the VM:Webgateway SVM permission to read the static files you want VM:Webgateway to serve. If you want to control user access to the files based on criteria like requesting userid, set up access control through VM:Webgateway. (If you do not want VM:Webgateway to serve a file at all, do not give VM:Webgateway permission to read it.)
- In BFS, give the VM:Webgateway SVM permission to read and execute the CGI programs you want VM:Webgateway to serve. If you want to control user access to the programs based on criteria like requesting userid, set up access control through VM:Webgateway. (If you do not want VM:Webgateway to serve a CGI program at all, do not give VM:Webgateway permission to read or execute it.)
Note: You cannot serve CGI programs that run in Webshare compatibility mode (SVMWEBSHARE and WORKERWEBSHARE) from a BFS directory.
A web browser user views a file by identifying the file in the last element of the path portion of the URL. In addition, if a file resides in a subdirectory, the path portion of the URL must also include elements to indicate each subdirectory VM:Webgateway must look at to obtain the file. When analyzing the URL to determine what file to serve, VM:Webgateway performs a case sensitive match when comparing each element in the URL to a BFS directory name or BFS file name. As a result, for VM:Webgateway to serve a file, the web browser user must specify the URL using the exact case you used when naming a BFS directory or file. Examples The user with VM userid DAN defined his user page as /../VMBFS:VMSYSU:DAN/WebUserRoot. The VM:Webgateway SVM is identified by www.comp.com on port 80. To view file HomePage.html owned by userid DAN that is stored in the directory /../VMBFS:VMSYSU:DAN/WebUserRoot use the following URL: http://www.comp.com:80/~dan/HomePage.html To view the file Projects.Html stored in the subdirectory /../VMBFS:VMSYSU:DAN/WebUserRoot/TiMe use the following URL: http://www.comp.com:80/~dan/TiMe/Projects.Html To view the file DATA.HTML stored in the subdirectory /../VMBFS:VMSYSU:DAN/WebUserRoot/TiMe/Sched use the following URL: http://www.comp.com:80/~dan/TiMe/Sched/DATA.HTML The VM:Webgateway system administrator defined the server root domain as /../VMBFS:VMSYSU:VMWEBSRV/web_root. The VM:Webgateway SVM is identified by www.comp.com on port 80. To view the file Openings.html in the server root domain and stored in the directory /../VMBFS:VMSYSU:VMWEBSRV/web_root, use the following URL: http://www.comp.com:80/Openings.html To view the file News.Html stored in the subdirectory /../VMBFS:VMSYSU:VMWEBSRV/web_root/MIS, use the following URL: http://www.comp.com:80/MIS/News.Html To view the file DOWN.HTML stored in the subdirectory /../VMBFS:VMSYSU:VMWEBSRV/web_root/MIS/maint, use the following URL: http://www.comp.com:80/MIS/maint/DOWN.HTML
Note: If VM:Webgateway is using SSL Feature and is configured to use SSL, begin the URLs with https:// rather than http://. To determine whether VM:Webgateway is using SSL, enter the QUERY SOCKET command from your VM userid.
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 the data available for serving. The data available for serving is all the files and subdirectories in the current directory. VM:Webgateway creates a hyperlink to each file and subdirectory in the list to allow a user to easily select and view data.
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. Overriding Automatic Directory Generation (listed in the side bar) describes how to prevent VM:Webgateway from serving automatic directories.
Examples The user with VM userid DAN defined his user page as /../VMBFS:VMSYSU:DAN/WebUserRoot. The VM:Webgateway SVM is identified by www.company.com on port 80. When a web browser user enters the following URL, VM:Webgateway displays a list of files and subdirectories contained in the directory /../VMBFS:VMSYSU:DAN/WebUserRoot: http://www.company.com:80/~dan/ When a web browser user enters the following URL, VM:Webgateway displays a list of files and subdirectories contained in the directory /../VMBFS:VMSYSU:DAN/WebUserRoot/TiMe: http://www.company.com:80/~dan/TiMe The VM:Webgateway system administrator defined the server root domain as /../VMBFS:VMSYSU:VMWEBSRV/web_root. The VM:Webgateway SVM is identified by www.company.com on port 80. When a web browser user enters the following URL, VM:Webgateway displays a list of files and subdirectories contained in the directory /../VMBFS:VMSYSU:VMWEBSRV/web_root: http://www.company.com:80/ When a web browser user enters the following URL, VM:Webgateway displays a list of files and subdirectories contained in the directory /../VMBFS:VMSYSU:VMWEBSRV/web_root/MIS: http://www.company.com:80/MIS
.
Note: To make the URLs that are required to access your files more meaningful, create logical directories and use alias names. |
