Technical Memo: Using SCRIPT Facility Settings





Products	Support	Download	Contact

USING SCRIPT FACILITY SETTINGS

Contents | Index | About the Icons

Abstract

This document summarizes how to use SCRIPT settings to establish default page layouts with the ScriptServer for OpenVMS product.

How SCRIPT Settings Work

The SCRIPT facility provides settings libraries as a convenience for storing and recalling page layout parameters. By default, users of SCRIPT have their own private libary, which is SYS$LOGIN:SPD_LIBRARY.DAT. When a print job is submitted with the GO command, SCRIPT creates an SPD (ScriptServer Page Description) file in SYS$SCRATCH with the filename "myfile.ext$SPD". The print job is submitted with the print PARAMETER SPD$FILE=spd-file-name, which conveys the page layout parameters to the print symbiont.

In cases where it is not convenient (or even possible) to use the SCRIPT facility to submit print jobs, alternative ways are available to access the page layout features available in SCRIPT from the PRINT command. This is accomplished using the system-wide settings library (SCRIPTSERVER:SPD$LIBRARY.DAT). The system administrator can create SCRIPT settings that are stored here that are accessed directly by the symbiont. Settings stored in the system-wide library can be accessed in one of the following ways:

the PRINT command qualifier PARAMETER SCRIPT_SETTINGS=setting-name

associating the settings with a VMS form using the logical name SSV$FORM_form-name_SETTINGS, for example:
```
    $ DEFINE/SYSTEM SSV$FORM_DEFAULT_SETTINGS LINE-PRINTER
```
associating the settings with a queue using the logical name SSV$queue-name_SETTINGS, for example:
```
    $ DEFINE/SYSTEM SSV$MYQUEUE_SETTINGS LINE-PRINTER
```
establishing the settings as a system-wide default using the logical name SSV$DEFAULT_SETTINGS, for example:
```
    $ DEFINE/SYSTEM SSV$DEFAULT_SETTINGS DUPLEX
```

Fine-Tuning SCRIPT Settings

By default, the SCRIPT facility will automatically adjust vertical spacing when the font scale is changed ("auto-leading"), and the font scale when the vertical spacing is changed ("auto-scaling"). This can be undesirable in cases where you want to manipulate these settings without affecting others, such as when setting up a page layout for use with SoftForms. To disable these automatic adjustments, invoke the SCRIPT facility with the /DYNAMIC qualifier, for example:

    $ SCRIPT/DYNAMIC=(NOLEADING,NOSCALING)

Specifying the Current Settings Library

As stated earlier, the SCRIPT facility uses the personal settings library by default. You can change the library to be used when SCRIPT is invoked as follows:

    $ SCRIPT/LIBRARY=library-filespec

To invoke SCRIPT with the system-wide settings library as the current library:

    $ SCRIPT/LIBRARY=SCRIPTSERVER:SPD$LIBRARY.DAT

To change the current library from withini the SCRIPT menu, use the LIB command, such as:

    LIB library-filespec

This provides a convenient way to move settings between libraries. See "Manipulating Settings" below for an example.

Manipulating Settings in Settings Libraries

The settings manipulation commands use two-character mnemonics like the commands for manipulating the settings themselves. These commands are:

SS setting-name to save current settings as setting-name
DS setting-name to delete settings setting-name
LS setting-name to load setting setting-name. If setting-name is omitted, a pop-up menu displays a list to choose from.
SL to show the settings stored in the current library

To move settings between libraries, load the settings from one library, switch libraries, then save the settings. For example, to move settings DUPLEX from the personal library to the system-wide library:

LS DUPLEX
LIB SCRIPTSERVER:SPD$LIBRARY.DAT
SS DUPLEX