Web Server--QUERY FILETYPE Command

	Select where you want to go:

Reference -
Commands

Select a command:

QUERY FILETYPE Command

Syntax | Parameters/Options | Examples

Displays the content filetypes for static files and CGI programs.

You can define content filetypes with the CONFIG FILETYPE command.

Syntax

To display content filetypes for static files:

QUERY FILETYPE content_filetype ... 
   ... [CONTENT-TYPE type/subtype] ...
   ... [TRANSLATE {* | NONE | tablename}] ... 
   ... [SSI {* | NO | YES}] ...
   ... [FILTER {* | NONE | ... 
   ... WORKERPIPE delim name args delim}] ... 
   ... [BFSLINEND {CRLF | NEWLINE | NONE}] ... 
   ... [SYSTEM {* | NO | YES}]

To display content filetypes for CGI programs:

QUERY FILETYPE content_filetype [ENVIRONMENT ... 
   ... {* | SVMEXEC | WORKEREXEC | ... 
   ... SVMWEBSHARE | WORKERWEBSHARE}] ...
   ... [AUTHHEADERPASSED {* | YES | NO}] ... 
   ... [SYSTEM {* | NO | YES}]

To display content filetypes for both types of files:

QUERY FILETYPE content_filetype

Parameters/Options

content_filetype

Name of the content filetype for which you want to display information. You can specify pattern-matching characters in content_filetype.

[CONTENT-TYPE type/subtype]

Content type and subtype associated with the content filetype. You can specify pattern-matching characters in type/subtype. For example, to display all content filetypes associated with text content types, specify text* or text/*.

The type and subtype parameters are case sensitive.

For a list of content types supported by many web browsers, refer to Common Content Types.

[TRANSLATE {* | NONE | tablename}]

Type of character set translation VM:Webgateway performs.

Asterisk (*): Displays content filetypes regardless of translation type. This is the default.
NONE: Displays content filetypes that are not associated with a translation table.
tablename: Displays content filetypes that are associated with the tablename translation table.
You can specify pattern-matching characters in tablename.

[SSI {* | NO | YES}]

Whether VM:Webgateway parses files for server-side include (SSI) commands.

Asterisk (*): Displays content filetypes regardless of whether VM:Webgateway is to parse for SSI commands. This is the default.
NO: Displays content filetypes that indicate VM:Webgateway should not parse for SSI commands.
YES: Displays content filetypes that indicate VM:Webgateway should parse for SSI commands.

[FILTER{ * | NONE | WORKERPIPE delim name args delim}]

Whether VM:Webgateway uses a filter to reformat files.

Asterisk (*)

Displays content filetypes regardless of whether VM:Webgateway uses a filter. This is the default.

NONE

Displays content filetypes that are not associated with a filter.

WORKERPIPE delim name args delim

Displays content filetypes associated with the specified filter. To identify a filter, specify the following parameters:

WORKERPIPE: Keyword indicating that the filter runs on a worker machine.
delim: Unique character that separates the indentification of the filter from the rest of the parameters on the command line. Use a character that is not used in any other part of the command. VM:Webgateway does not save delimiters; it does not use the delimiter when searching for filetypes that have matching filters.
name args: Identifies the filename of the filter and the arguments VM:Webgateway passes to the filter. The name and args parameters are case sensitive.
You can specify pattern-matching characters in name and args.

[BFSLINEND {CRLF | NEWLINE | NONE}]

Type of line end character VM:Webgateway uses for a file that is stored in BFS.

CRLF: Displays content filetypes that use a CRLF line end character for BFS files
NEWLINE: Displays content filetypes that use a NEWLINE line end character for BFS files
NONE: Displays content filetypes that use no line end character for BFS files; this characteristic is used for binary files

[ENVIRONMENT {* | SVMEXEC | WORKEREXEC | SVMWEBSHARE | WORKERWEBSHARE}]

Environment in which VM:Webgateway should run the CGI program.

Asterisk (*): Displays content filetypes of CGI programs that run in all environments. This is the default.
SVMEXEC: Displays content filetypes of CGI programs that run as EXECs on the VM:Webgateway SVM.
WORKEREXEC: Displays content filetypes of CGI programs that run as EXECs on VM:Webgateway worker machines.
SVMWEBSHARE: Displays content filetypes of CGI programs that run in Webshare compatibility mode on the VM:Webgateway SVM.
WORKERWEBSHARE: Displays content filetypes of CGI programs that run in Webshare compatibility mode on VM:Webgateway workers.

[AUTHHEADERPASSED {* | YES | NO}]

Whether VM:Webgateway passes the HTTP Authorization header to a CGI program.

Asterisk (*): Displays content filetypes regardless of whether VM:Webgateway can pass the HTTP Authorization header.
YES: Displays content filetypes of CGI programs to which VM:Webgateway passes the HTTP Authorization header.
NO: Displays content filetypes of CGI programs to which VM:Webgateway does not pass the HTTP Authorization header.

[SYSTEM {* | NO | YES}]

Whether the filetype is required for VM:Webgateway operation.

Asterisk (*): Displays all content filetypes regardless of SYSTEM type.
NO: Displays content filetypes that are not required for VM:Webgateway operation.
YES: Displays content filetypes that are required for VM:Webgateway operation.

Examples

To display content filetypes for CGI programs to which VM:Webgateway passes the HTTP authorization header, enter this command from your VM userid:

vmwebsrv query filetype * authheaderpassed yes

VM:Webgateway responds:

 Filetype Characteristics
 -------- ------------------------------------- 
 CGIAUTH  CGI AUTHHEADERPASSED YES ENVIRONMENT
          SVMEXEC SYSTEM NO
 CGIWEBSH CGI AUTHHEADERPASSED YES ENVIRONMENT 
          SVMWEBSHARE SYSTEM NO
 WRKEXEC  CGI AUTHHEADERPASSED YES ENVIRONMENT 
          WORKEREXEC SYSTEM NO
 WRKWEBSH CGI AUTHHEADERPASSED YES ENVIRONMENT 
          WORKERWEBSHARE SYSTEM NO

To display content filetypes for files containing HTML text, enter this command from the VM:Webgateway SVM:

query filetype * content-type text/html

VM:Webgateway responds:

 Filetype Characteristics
 -------- ---------------------------------------- 
 B2HTRANS FILE TRANSLATE USENGLISH CONTENT-TYPE 
          TEXT/HTML SSI NO FILTER WORKERPIPE
          |BMGR2HTM (NOTRANS| BFSLINEND CRLF
          SYSTEM NO
 HTML     FILE TRANSLATE USENGLISH CONTENT-TYPE 
          TEXT/HTML SSI NO FILTER NONE
          BFSLINEND CRLF SYSTEM NO
 SHTML    FILE TRANSLATE USENGLISH CONTENT-TYPE 
          TEXT/HTML SSI YES FILTER NONE
          BFSLINEND CRLF SYSTEM NO

To display all content filetypes whose file data should not be translated and that are required for VM:Webgateway operation:

query filetype * content-type image/gif system yes

VM:Webgateway responds:

 Filetype Characteristics
 -------- ------------------------------------ 
 VIGGIF   FILE TRANSLATE NONE CONTENT-TYPE    
          IMAGE/GIF SSI NO FILTER NONE
          BFSLINEND NONE BFSLINEND NONE 
          SYSTEM YES 
 VIOGIF   FILE TRANSLATE NONE CONTENT-TYPE  
          IMAGE/GIF SSI NO FILTER NONE
          BFSLINEND NONE BFSLINEND NONE
          SYSTEM YES 
 VIWGIF   FILE TRANSLATE NONE CONTENT-TYPE  
          IMAGE/GIF SSI NO FILTER NONE
          BFSLINEND NONE BFSLINEND NONE 
          SYSTEM YES

To display all content filetypes that use the French translation table:

query filetype * translate french

VM:Webgateway responds:

 Filetype Characteristics
 -------- ------------------------------------ 
 HTMLFREN FILE TRANSLATE FRENCH CONTENT-TYPE  
          TEXT/HTML SSI NO FILTER NONE
          BFSLINEND CRLF SYSTEM NO
 SHTMLFR  FILE TRANSLATE FRENCH CONTENT-TYPE  
          TEXT/HTML SSI YES FILTER NONE
          BFSLINEND CRLF SYSTEM NO

The VM:Webgateway system administrator told you that you can serve CGI programs that use content filetype CGIWEBSH. To determine the characteristics associated with the content filetype CGIWEBSH, enter this command from your VM userid:
vmwebsrv query filetype cgiwebsh

VM:Webgateway responds:
```
 Filetype Characteristics
 -------- ------------------------------------ 
 CGIWEBSH CGI AUTHHEADERPASSED YES ENVIRONMENT 
          SVMWEBSHARE SYSTEM NO
 
```
You created an HTML file on your VM userid. When you displayed the file on a web browser, it was unreadable because the filetype you are using does not indicate that the HTML file data should be translated from its EBCDIC representation to its equivalent ASCII representation in U.S. English. To determine what content filetype you should use, enter the following command from your VM userid:
vmwebsrv query filetype * content-type text/html translate usenglish filter none

VM:Webgateway responds:
```
 Filetype Characteristics
 -------- ---------------------------------------- 
 HTML     FILE TRANSLATE USENGLISH CONTENT-TYPE 
          TEXT/HTML SSI NO FILTER NONE
          BFSLINEND CRLF SYSTEM NO
 SHTML    FILE TRANSLATE USENGLISH CONTENT-TYPE 
          TEXT/HTML SSI YES FILTER NONE 
          BFSLINEND CRLF SYSTEM NO
 TEXTHTML FILE TRANSLATE USENGLISH CONTENT-TYPE 
          TEXT/HTML SSI NO FILTER NONE 
          BFSLINEND CRLF SYSTEM NO
 
```
Your site stores text files that originated on UNIX in the byte file system. You know that files with a filetype of UHTML use the NEWLINE character to indicate the end of a line. To verify that the filetype has the correct BFS line end character defined, enter the following command from your VM userid:
vmwebsrv query filetype * content-type text/html translate usenglish bfslinend newline

VM:Webgateway responds:
```
 Filetype Characteristics
 -------- -------------------------------------- 
 UHTML    FILE TRANSLATE USENGLISH CONTENT-TYPE 
          TEXT/HTML SSI NO FILTER NONE
          BFSLINEND NEWLINE SYSTEM NO
 
```
You created an image file in GIF format that is not readable on VM. To display this file on a web browser, use a content filetype that indicates the file data should not be translated. To determine what content filetype you should use, enter the following command from your VM userid:
vmwebsrv query filetype * content-type image/gif translate none

VM:Webgateway responds:
```
 Filetype Characteristics
 -------- -------------------------------------- 
 GIF      FILE TRANSLATE NONE CONTENT-TYPE 
          IMAGE/GIF SSI NO FILTER NONE BFSLINEND 
          NONE SYSTEM NO
 IMAGEGIF FILE TRANSLATE NONE CONTENT-TYPE 
          IMAGE/GIF SSI NO FILTER NONE BFSLINEND  
          NONE SYSTEM NO
 
```

You want to give a BookManager file a content filetype that identifies a filter that will reformat the BookManager file to an HTML file. The VM:Webgateway system administrator told you to use the filter BMGR2HTM REXX. To determine what content filetype to give your BookManager file, enter the following command from your VM userid:

vmwebsrv query filetype * filter workerpipe |bmgr2htm *|

VM:Webgateway responds:

 Filetype Characteristics
 -------- -------------------------------- 
 B2HTRANS FILE TRANSLATE USENGLISH
          CONTENT-TYPE TEXT/HTML SSI NO
          FILTER WORKERPIPE
          |BMGR2HTM (NOTRANS|
          BFSLINEND CRLF SYSTEM NO
 BOOK2HTM FILE TRANSLATE NONE CONTENT-TYPE 
          TEXT/HTML SSI NO
          FILTER WORKERPIPE
          |BMGR2HTM BOOK2HTM (TO ASCII|
          BFSLINEND CRLF SYSTEM NO

You want to view all content filetypes that are associated with filters. Enter the following command from the VM:Webgateway SVM:

query filetype * filter workerpipe *

VM:Webgateway responds:

 Filetype Characteristics
 -------- -------------------------------- 
 B2HTRANS FILE TRANSLATE USENGLISH   
          CONTENT-TYPE TEXT/HTML SSI NO
          FILTER WORKERPIPE |BMGR2HTM
          (NOTRANS| BFSLINEND CRLF
          SYSTEM NO
 BOOK2HTM FILE TRANSLATE NONE CONTENT-TYPE 
          TEXT/HTML SSI NO
          FILTER WORKERPIPE
          |BMGR2HTM BOOK2HTM (TO ASCII|
          BFSLINEND NONE SYSTEM NO
 HTM2PLA  FILE TRANSLATE USENGLISH   
          CONTENT-TYPE TEXT/PLAIN SSI NO
          FILTER WORKERPIPE |HTM2PLA|
          BFSLINEND CRLF SYSTEM NO


				Select where you want to go:

Reference -Commands

QUERY FILETYPE Command

Syntax

Parameters/Options

Examples

Reference -
Commands