gatewayscript-location

This command specifies the location of the GatewayScript file for the action to run.

Syntax

gatewayscript-location location

Parameters

location
Specifies the name and location of the script file to run.

Guidelines

The gatewayscript-location command is required when the action type, as specified by the type command, is gatewayscript.

Use one of the following formats to specify the location.
  • URL. The prefix of the URL can be the local:, store:, or temporary: directory. When you specify the URL, use the absolute path to the file, such as, temporary:///my_scripts/jsTest.js, or use a relative path, such as ../my_scripts/jsTest.js.
  • A context variable that expands to a URL that specifies the file location. Use the var://context/contextName/varName format, such as var://context/myContext/myLocation.
  • A context. The context content runs as GatewayScript. An action that precedes the processing action, such as a fetch action, must populate the context with the script. Use one of the following formats:
    • var://context/name/
    • var://context/name

Examples

  • Specify that the GatewayScript action runs a script with the local://sub-dir/testscript.js file. The script debugger is enabled for this action.
    # type gatewayscript
    # gatewayscript-location local://sub-dir/testscript.js
    # debug on
  • Specify that a gatewayscript action runs a script that is in a context. The context that contains the script is var://context/myTestContext.
    # type gatewayscript
    # gatewayscript-location var://context/myTestContext