Errors in layup definition files are returned with the identification BADLAYDEF. To display the error messages on your terminal, use the /NOTIFY qualifier in the PRINT command line. To print or keep error messages, use the MESSAGES parameter to the PRINT/PARAMETERS command. Error messages use the following format:

%DCPS-W-BADLAYDEF, condition on line line-number in layup definition

The condition describes the problem and line-number is the line number in the layup definition file on which the error occurred. See Section A.3 for the text and explanation of the messages generated by errors in a layup definition file.

The system manager can create form definitions, which you can include in your PRINT command to modify the appearance of your printed file. When you specify an unknown form, DECprint Supervisor informs you immediately. If you specify an unknown setup module to modify your file, DECprint Supervisor does not inform you of the problem until it starts printing the job and needs to access the setup module.

Example 13-1 shows a PRINT command that includes a form called LANDSCAPE.

Example 13-1 Including a Form in a PRINT Command

$ PRINT/QUEUE=LPS20/FORM=LANDSCAPE

The following sections explain how to use forms.

13.1 Finding Forms on Your System

To find the forms available for your use, issue the following command:

$ SHOW QUEUE/FORM

A list of forms and their functions is displayed:

Form name Number Description --------- ------ ----------- PITCH12 (stock=DEFAULT) 122 12 Characters per Inch PITCH13 (stock=DEFAULT) 121 13.2 Characters per Inch PITCH16 (stock=DEFAULT) 120 16.5 Characters per Inch PITCH6 (stock=DEFAULT) 125 6 Characters per Inch PITCH660 (stock=DEFAULT) 124 6.6 Characters per Inch PITCH8 (stock=DEFAULT) 123 8.25 Characters per Inch PORTRAIT (stock=DEFAULT) 20 80 by 60 (portrait) PS (stock=LASER) 2001 Postscript Form

You can display the attributes of a form using the SHOW QUEUE/FORM/FULL command. For example this command displays the attributes of DCPS$DEFAULT:

$ SHOW QUEUE/FORM/FULL DCPS$DEFAULT

Form name Number Description --------- ------ ----------- DCPS$DEFAULT (stock=DEFAULT) 1115 DCPS default /LENGTH=66 /STOCK=DEFAULT /TRUNCATE /WIDTH=80

This form sets the page length and width, truncates long lines, and uses a default paper stock.

13.2 Using Forms with ANSI Files

Most of the time, you use form definitions with ANSI files, because many of the qualifiers for form definitions apply only to ANSI files. The qualifiers allow you to specify the page length and margins and allow long lines to either truncate or wrap to the next line. Files with data types besides ANSI, such as PostScript, have internal controls that set up your page's attributes.

Table 13-1 shows the qualifiers that affect only ANSI files.

Table 13-1 DEFINE/FORM Qualifiers for ANSI Files

This Qualifier ...	Does the Following ...
/LENGTH= n	Sets the length of each page, in lines.
/MARGIN= keyword= n	Sets the page margins.
/PAGE_SETUP= module	Applies a page setup module to each page in the job.
/[NO]TRUNCATE	Truncates long lines that do not fit in the page width.
/WIDTH= n	Sets the width of the page in columns or characters.
/[NO]WRAP:	Wraps lines wider than the page to the next line.

There are two qualifiers that the system manager can use with all types of files: /SETUP and /STOCK. The following sections explain what those qualifiers do.

13.3.1 Using Forms that Invoke Setup Modules (/SETUP)

Your system manager can associate a setup module with a form. To see if a setup module has been included in a form definition, issue the SHOW QUEUE/FORM/FULL command and look for the /SETUP qualifier in the descriptions of the forms. For example:

$ SHOW QUEUE/FORM/FULL

Form name Number Description --------- ------ ----------- CONFIDENTIAL (stock=DEFAULT) 15 Prints CONFIDENTIAL on each page /LENGTH=66 /SETUP=(PRIVATE) /STOCK=DEFAULT /TRUNCATE /WIDTH=80

In this example, the setup module called PRIVATE is included in the form definition.

13.3.2 Using Forms that Specify the Paper Stock (/STOCK)

Your system manager can use the /STOCK qualifier to specify a type of paper that must be used when a form is invoked. When you use that form, you must ensure that the the specified stock is in the printer. Otherwise, the job is held in the queue until you load the specified stock or use a different form definition.

To see if a form requires special stock, issue the SHOW QUEUE/FORM/FULL command and look for the /STOCK qualifier in the description of the form. For example:

$ SHOW QUEUE/FORM/FULL LANDSCAPE

Form name Number Description --------- ------ ----------- LANDSCAPE (stock=DEFAULT) 10 132 by 66 (landscape) /LENGTH=66 /MARGIN=(TOP=2,BOTTOM=4) /SETUP=(LANDSCAPE) /STOCK=DEFAULT /TRUNCATE /WIDTH=132

If the /STOCK qualifier has the DEFAULT parameter, any type of paper is allowed.

13.4 Using the Default Form Definition

If you omit a form definition in your print request but supply one of the following qualifiers, the default form definition DCPS$DEFAULT is automatically associated with your ANSI file:

• /HEADER
• /SPACE
• /PARAMETERS=[NO]TAB

To find the attributes of the default form definition, issue the following command:

$ SHOW QUEUE/FORM/FULL DCPS$DEFAULT

Form name Number Description --------- ------ ----------- DCPS$DEFAULT (stock=DEFAULT) 1115 DCPS default /LENGTH=66 /STOCK=DEFAULT /TRUNCATE /WIDTH=80

This chapter contains general information about using setup modules, and information about setup modules that can be used by several printers. See Chapter 19 for information about printer-specific modules.

You can also use setup modules implicitly through the use of forms, as described in Chapter 13.

14.1 What Is a Setup Module?

A setup module is a file containing instructions that modify the appearance of a print job or redefine the instructions in the print job.

To include a setup module in a print job, use the /SETUP qualifier in the PRINT command. The following example uses a setup module that specifies 600 dots-per-inch (DPI) resolution:

$ PRINT/QUEUE=LPS32$2SIDES/SETUP=RES_600X600 IMAGE.PS

14.2 Locating Setup Modules

DECprint Supervisor for OpenVMS ships with various setup modules, which are located in the following device control library:

SYS$LIBRARY:DCPS$DEVCTL.TLB

To list the setup modules, use the following command:

$ LIBRARY/LIST SYS$LIBRARY:DCPS$DEVCTL.TLB

A list of setup modules, similar to the following example, is displayed:

DCW1000_DISPLAY DCW1000_ENHANCED DCW1000_HIGHRES LPS$$APPLE360_INITPSDEVICE LPS$$APPLE360_SETINPUTTRAY RES_1200X1200 RES_1200X600

Some setup modules are created only for certain printers. Those setup modules have the printer name as part of their file name. For instance, the setup module DL3500_RET_DARK is intended for the DEClaser 3500 printer.

See Section 14.4 and later sections for descriptions of some of the setup modules.

14.2.1 Locating Custom Setup Modules

Custom setup modules go in special device control libraries, which are required to be .TLB (text library) files located in SYS$LIBRARY. The following command lists all of the text libraries in SYS$LIBRARY. To determine which of these libraries are special device control libraries used with DCPS, check with your system manager or correlate the .TLB file names with the libraries and library search lists associated with the /LIBRARY qualifier for your system's DCPS print queues.

$ DIRECTORY SYS$LIBRARY:*.TLB

14.2.2 Displaying the Contents of a Setup Module

To see the instructions that a setup module contains, follow these steps:

1. Extract the setup module from the device control library. The following example extracts the setup module DI_ON from DCPS$DEVCTL.TLB and renames it MYSETUP.TXT in the user's directory:

   $ LIBRARY/EXTRACT=(DI_ON)/OUT=MYSETUP SYS$LIBRARY:DCPS$DEVCTL.TLB

2. Type or edit the setup module to display its contents. For example:

   $ TYPE MYSETUP.TXT

   
   The setup module DI_ON enables the DECimage image enhancement feature, and contains the following instructions:

   %! % ~~~~~~~~~~ DI_on ~~~~~~~~~~ statusdict begin false setDECimage end systemdict /languagelevel known {languagelevel} {1} ifelse 2 ge {currentpagedevice /Install get exec} if statusdict begin true setDECimage end % ~~~~~~~~~~~~~~~~~~~~~~~~~~~

   Note Some setup modules contain escape sequences or graphics, which cannot be displayed when you type the file.

To create a setup module, follow these steps:

1. Create a setup module that includes the necessary escape sequences or PostScript operators.
2. Ask your system manager to insert the setup module into a device control library.
3. Print the file, specifying the setup module and the file. For example:

   $ PRINT/QUEUE=PS$A14/SETUP=module-name MYFILE.DAT

The following setup modules invoke the DECimage feature or modify the DECimage parameters. They are grouped into the following categories:

• Enabling and Disabling DECimage
  Table 14-1 lists setup modules that leave all current parameters intact and turn DECimage on or off. It is not necessary to use these modules if you use other DECimage setup modules. The DECimage setup modules automatically invoke DECimage for the current print job.

  Table 14-1 Enabling and Disabling DECimage

  Setup Module	Description
  DI_ON	Turns DECimage ON
  DI_OFF	Turns DECimage OFF

• Combined Parameters
  Table 14-2 lists setup modules that adjust two DECimage parameters simultaneously.

  Table 14-2 DECimage Setup Modules---Combined Parameters

  Setup Module	Description
  DI_HICONTRAST	Punch0 = 0.2, Punch1 = 0.8
  DI_LOCONTRAST	Punch0 = -.1, Punch1 = 1.1
  DI_BRIGHTER	Punch0 = -.2, Punch1 = 0.8
  DI_DARKER	Punch0 = 0.2, Punch1 = 1.2
  DI_NORMAL	Punch0 = 0, Punch1 = 1

• Individual Parameters
  When you specify one of the setup modules listed in Table 14-3, all other parameters remain at the default value or the value most recently modified by another setup module. The setup modules have no order dependency, so you may specify them in any order on the PRINT command line.

  Table 14-3 DECimage Setup Modules---Individual Parameters

  Setup Module	Description
  DI_PUNCH0_0	Punch0 = 0
  DI_PUNCH0_0P1	Punch0 = 0.1
  DI_PUNCH0_0P2	Punch0 = 0.2
  DI_PUNCH0_M0P1	Punch0 = -.1
  DI_PUNCH0_M0P2	Punch0 = -.2
  DI_PUNCH1_1	Punch1 = 1
  DI_PUNCH1_0P8	Punch1 = 0.8
  DI_PUNCH1_0P9	Punch1 = 0.9
  DI_PUNCH1_1P1	Punch1 = 1.1
  DI_PUNCH1_1P2	Punch1 = 1.2
  DI_SHARP_0P5	Sharpness = 0.5
  DI_SHARP_1	Sharpness = 1.0
  DI_SHARP_1P5	Sharpness = 1.5
  DI_SHARP_2	Sharpness = 2.0
  DI_SHARP_2P5	Sharpness = 2.5

For example, the following command adds sharpening and shifts the gray levels:

$ PRINT/NOTIFY/QUEUE=queue/SETUP=(DI_SHARP_2,DI_DARKER) file

14.5 Resolution Setup Modules

You can use the following resolution setup modules to temporarily change the resolution on multiple resolution printers:

• RES_300X300 --- 300 dpi horizontal by 300 dpi vertical resolution
• RES_600X300 --- 600 dpi horizontal by 300 dpi vertical resolution
• RES_600x600 --- 600 dpi horizontal by 600 dpi vertical resolution
• RES_1200x600 --- 1200 dpi horizontal by 600 dpi vertical resolution
• RES_1200x1200 --- 1200 dpi horizontal by 1200 dpi vertical resolution