Compiling scripts

Once you have created a script file, it must be processed for use by UI Toolkit. The Script compiler converts window and column scripts into window and column definitions. These definitions are then loaded into a window library (ISAM file) created by Script. (Proto and Composer can also compile a script file.)

You can compile scripts in the following ways:

Running Script interactively

When you run Script interactively, it will prompt you for the information it needs. Files are compiled one at a time, but after compiling a file, you’ll be prompted to compile another.

1. Start Script with your system’s execute command.

On…

Do this…

Windows and UNIX

At a command prompt, enter

dbr WND:script

OpenVMS

At a command prompt, enter

run WND:script

Script will display this prompt:

Window Libr:

2. Enter the name of the window library that will contain the compiled window and column definitions. Script will search for an existing library and modify it by loading the specified script files. If you append /c (or /C) to the library name, Script either creates a new library file, if it doesn’t already exist, or completely overwrites the existing library.

You are then prompted with the following:

Script File:

3. Enter the name of the file that contains the window script(s) that you want to compile. The default extension is .wsc.
4. After Script creates the window library, it prompts for another script file. Type another filename or press enter at the prompt to exit. (Alternatively, you can type an end‑of‑file character to exit.)
Note

When Script ends, it will exit with a status of D_EXIT_FAILURE if it encountered any errors (0 on OpenVMS, 1 on all other systems). Otherwise, it will exit with a status of D_EXIT_SUCCESS (1 on OpenVMS, 0 on all other systems). Most operating systems have commands that enable you to test for the exit status. See the documentation for your operating system for more information.

Running Script using the command‑line syntax

Running Script from the command line enables you to compile multiple files at once. You can also put these commands in a batch file to build windows quickly and automatically.

On Windows and UNIX, from the command line run:

dbr WND:script [-c library_name|-l library_name] [-i script_file[, …]] [,-o error_file]

On OpenVMS, define a symbol and then run the command:

script:==$WND:script.exe
run script [-c library_name|-l library_name] [-i script_file[, …]] [,-o error_file]

Arguments

‑c library_name

Create a new library. The default extension is .ism.

‑l library_name

Specify an existing library. The default extension is .ism.

‑i script_file [, …]

Specify one or more script files that you want to compile. The default extension is .wsc.

‑o error_file

Specify an error log file. The default extension is .err.

Discussion

When running Script from the command line, you must specify either a library name or script file(s). The library can be one that already exists (‑l) or a new one (‑c)—but not both.

If no library file is specified, library_name will default to the same base name as the first script file specified, but with the extension .ism. (This works only with an existing library file; it will not create a new one.)

If no script file is specified, then a single script will be processed which has the same name as the library file specified, but with a .wsc extension.

You can specify up to 255 script files, which are processed in the order specified.

Specify ‑o to write error output to a file. If there are no errors, there will be no file. If ‑o is not specified, error output is directed to standard output (the terminal).