FILE Record for Minidisks, CMS Search Order, and SFS Directories

Record Syntax

urltoken

File identification that web browser users must specify in URLs to have VM:Webgateway display CMSfn CMSft on their browsers. You can express urltoken as:

• filename.filetype[.content_filetype1]
• filename
• string

The filename and filetype parameters must be valid CMS filenames and filetypes and can include pattern matching characters. The string parameter can be of any length and contain any characters except the pattern matching characters * and % and the characters listed below. You can never include these characters in urltoken because they are invalid in URLs:

blank	semicolon (;)
question mark (?)	colon (:)
at sign (@)	ampersand (&)
equal sign (=)	plus sign (+)
slash (/)

CMSfn CMSft

Identifies the CMS file VM:Webgateway is to serve on the user's browser when the user enters a file identification that matches urltoken. You cannot use pattern matching in either CMSfn or CMSft.

[content_filetype]

VM:Webgateway uses content filetypes to associate with urltoken or CMSfn CMSft. The content filetype you specify must already be defined in VM:Webgateway. You can use the QUERY FILETYPE command to display a list of existing content filetypes. You cannot use pattern matching in content_filetype2.

If you specify content_filetype1, you must also specify content_filetype2. If you do not specify either parameter, VM:Webgateway checks whether CMSft exists as a content filetype. If it does, VM:Webgateway uses the file characteristics of that filetype. If it does not, VM:Webgateway assumes these file characteristics:

Type: static file
Content Type: text/plain
Translation: USENGLISH
SSI: NO
Filter: NONE

How to Specify FILE Records

The values you specify on the FILE record depend on how you want web browser users to identify files in URLs. As explained earlier, you can express urltoken as filename.filetype[.content_filetype1], filename, or string.

FILE *.* = =

When urltoken is filename.filetype[.content_filetype1]

If you want to use filename for CMSfn, specify = for CMSfn. If you want to override filename, specify a different value for CMSfn. Use this method for CMSft and filetype as well.

When you allow pattern matching in filename, you must specify = for CMSfn. The same is true for filetype and CMSft.

When you specify content_filetype1, you must specify content_filetype2. If you want to use content_filetype1, specify = for content_filetype2. If you want to override content_filetype1, specify a different value for content_filetype2.

Examples

The VMWEBSRV DIRMAP file in userid LEANNA's user page includes these records:

FILE HOMEPAGE.HTML HOMEPAGE =
FILE HOMEPAGE.*HTML = = NOPARSE
FILE HOME*.HTML = =
FILE HOMEPAGE.TEXT.BOOK2HTM = = =

When a user enters URL http://www.company.com/~leanna/homepage.html, VM:Webgateway finds the first record and serves the HOMEPAGE HTML file.

When a user enters URL http://www.company.com/~leanna/homepage.texthtml, VM:Webgateway finds the second record and serves the HOMEPAGE TEXTHTML file, using the file characteristics specified for content filetype NOPARSE.

When a user enters URL http://www.company.com/~leanna/homerun.html, VM:Webgateway finds the third record and serves the HOMERUN HTML file.

When a user enters URL http://www.company.com/~leanna/homepage.text.book2htm, VM:Webgateway finds the fourth record and serves the HOMEPAGE TEXT file, using the file characteristics specified for content filetype BOOK2HTM.

When urltoken is filename

If you want to use filename for CMSfn, specify = for CMSfn. If you want to override filename, specify a different value for CMSfn.

When you allow pattern matching in filename, you must specify = for CMSfn. You cannot specify = for CMSft.

Examples

The VMWEBSRV DIRMAP file in userid LEANNA's user page includes these records:

FILE HOMEPAGE LEANNA HTML
FILE SOMETEXT = HTML
FILE HOME* = HTML PARSE

When a user enters URL http://www.company.com/~leanna/homepage, VM:Webgateway finds the first record and serves the LEANNA HTML file.

When a user enters URL http://www.company.com/~leanna/sometext, VM:Webgateway finds the second record and serves the SOMETEXT HTML file.

When a user enters URL http://www.company.com/~leanna/homerun, VM:Webgateway finds the third record and serves the HOMERUN HTML file, using the file characteristics specified for content filetype PARSE.

When urltoken is string

Example

The VMWEBSRV DIRMAP file in userid LEANNA's user page includes this record:

FILE COMPANYHOMEPG COMPANY HTML TRANSLTE

When a user enters URL http://www.company.com/companyhomepg, VM:Webgateway serves the COMPANY HTML file, using the file characteristics associated with content filetype TRANSLTE.