4.7.3 Runtime Environment Settings dialog box

(1) Items in the dialog box

Runtime parameters

Specifies run-time parameter to be passed to the job definition script.

Example:

If the name of the job definition script to be used is a.ash and ABC is specified for a run-time parameter, ABC is used as the first argument for a.ash.

Runtime directory

Specifies the current drive or folder in which the job definition script is to be executed.

If this information is omitted, the editor's current folder is assumed.

The editor's current folder is one of the following:

• Folder containing the job definition script file

• Program folder

• Program's current folder

• Shortcut work folder

Example:

In this example, job definition script pwd is specified in the job definition script named a.ash. Specifying C:\ for the run-time directory produces the same results as when the following specification is made in a Windows directory:

  C:\> a.ash
  C:\
  C:\>

Job environment file

Specifies the job environment file to be used during debugging. The specified file is used by the job to be debugged.

If this information is omitted, the file specified in the ADSH_ENV environment variable is used. If no file is specified in the ADSH_ENV environment variable, the default value is assumed.

Logical host

Specifies the logical host to be used by the user-reply functionality. The user-reply functionality used by the job subject to debugging is run on the specified logical host.

If this information is omitted, the user-reply functionality is run on the physical host.

Coverage information

Specifies whether coverage information is to be accumulated:

• Do not accumulate

  Does not accumulate coverage information. This is equivalent to omitting the -t option in the adshexec command. The function for displaying coverage information during debugging is disabled.

• Accumulate

  Accumulates coverage information. If the job definition script file has been modified, the job is terminated without executing the job definition script. This is equivalent to specifying the -t option in the adshexec command. The coverage information can be displayed from the editor.

• Accumulate (and overwrite on update)

  Accumulates coverage information. If the job definition script file has been modified, the editor discards the accumulated coverage information and then starts accumulating the new coverage information. This is equivalent to specifying both the -t and -f options in the adshexec command. The coverage information can be displayed from the editor.

By default, Do not accumulate is selected.

Coverage information is saved in a coverage information file (asc file). The asc file is created in the directory where the job definition script file is located. If there is already an asc file in the directory where the job definition script file is located, the editor uses that asc file.

To display the coverage information accumulated in the coverage information file, select View Coverage Information from the editor's View menu or use the adshcvshow command. To merge coverage information contained in two separate coverage information files, use the adshcvmerg command. For details about coverage information, see 3.9 Acquiring coverage information.

Shell option

Specifies whether the xtrace shell option is to be set.

• Disable xtrace

  Does not set the xtrace shell option when debugging starts. This is the same as the adshexec command with the -x option omitted.

• Enable xtrace

  Sets the xtrace shell option when debugging starts. This is the same as the adshexec command with the -x option specified.

  When this item is selected, executed commands and their arguments are output to the standard error output as trace information. For details, see 3.5 Outputting the executed commands and their arguments.

The default is that Disable xtrace is selected.

The shell options also include the option for limiting available functions and the option for switching the execution mode. For details about the shell options, see 5.6 Shell options.

To Page Top

(2) Operations in the dialog box

• Clicking the OK button creates an execution environment file containing the information specified in the dialog box.

• Clicking the Cancel button closes the dialog box without creating an execution environment file.

To Page Top