Forms Processor Parameters

screen

$screen="filename";

$screen="URL";

• filename - The filename or complete path (relative to your WebCom home directory, or the absolute URL) to the file you wish to be returned to the browser that submitted your form.
  
  
• URL - The URL of the file you wish to be returned to the browser that submitted your form .
  
  
• NOTES:
  
• Using an absolute URL as the path to the file allows you to use your custom domain name, while using a path relative to your home directory allows you to return screens that are not under your www directory.
• You can only specify ONE screen parameter in a form or configuration file. If more than one file is specified, then the last occurrance of the screen parameter will be used.
• Using the screen parm in a config file for a form using the Secure Server may cause a message to display in Netscape informing the client that the transaction will not transfer securely. You can avoid this erroneous message by using a full URL in setting the parameter, as in $screen="https://webcom.securesites.net/userid/welcome.shtml" or returning a screen using a format screen nh format statement with a Location header.

Examples:

# sets the page to return to result.shtml in the www directory.

$screen="www/result.shtml";

# this example uses an absolute URL, and retains a custom URL.

$screen="http://www.thoreau.com/welcome.shtml";

See also:  Form Processor examples (which include the use of the screen parameter)

phone: 1-800-GETVERIO
© Verio Inc. 1996-2007 ::: Acceptable Use Policy ::: Privacy