Previous Topic

Next Topic

Book Contents

Book Index

DO KSL: Automated Console Action Parameter

Specifies a KeyStroke OpenAccess (KOA) script to be executed.

Figure 157 DO KSL Parameter Format

Optional. Type KSL in the DO field and press Enter. The subparameters shown in Table 133 are displayed.

Table 133 DO KSL Subparameters

Subparameter

Description

scriptname

Name of the KeyStroke OpenAccess (KOA) script. Mandatory.

arguments

Arguments that are passed to the script. A maximum of nine arguments can be specified.

Note: Format of the scriptname and argument parameters is:

DO KSL = scriptname arg1 arg2 ... arg9

The scriptname and argument values are separated by spaces, not by tabs.

WAITMODE

Whether or not to wait for completion of the script. Mandatory. Valid values are:

  • Y (Yes) — Wait for completion of the script.
  • N (No) — Do not wait for completion of the script.

TIMEOUT

n — Number of seconds (maximum 9999) to wait for the completion of the script. Valid only if STOP is Y.
Default: 60 seconds. Mandatory.

STOP

Whether or not the KOA script should be stopped when time-out is reached. Valid values are:

  • Y (Yes) — Stop execution of the KOA script when time-out is reached. Default.
  • N (No) — Allow the KOA script to continue after time-out.

INITPROC

Name of a KOA script that handles the establishment, resetting, and termination of an environment (usually a VTAM session) for the KOA script specified in the DO KSL statement. Optional.

SHARELOC

Whether or not the KOA script specified in the DO statement should share Local and System AutoEdit variables with the calling rule. Mandatory.

Valid values are:

  • Y (Yes) — Local and System variables are shared. Variables set by the rule are accessible to the KOA script and variables set by the KOA script are accessible to the calling rule after completion of the script.

    Variables are shared only if Y (Yes) is also specified in subparameter WAITMODE.

  • N (No) — Variables are not shared. Default.

IMMEDIATE

Whether or not the KOA script should be executed by an Immediate server (described in "Using a Preset Environment" in General Information below). Mandatory.

Valid values are:

  • Y (Yes) — Execute the KOA script in an Immediate server.
  • N (No) — Queue the KOA script to a Special or General server for execution (described in "Using a Preset Environment" in General Information below). Default.

For information regarding KeyStroke OpenAccess (KOA) scripts, refer to the KeyStroke Language (KSL) User Guide.

Parent Topic

Rule Parameters