The front panel mode commands affect the way a file is printed if the commands are in a setup module and the setup module is specified with the file in the PRINT command. To use front panel commands to affect a print job, use the following procedure:

1. Create a setup module that includes the necessary front panel mode commands.
2. Ask your system manager to insert the setup module into a Proprinter device control library.
3. Print the file, specifying the setup module and the file. For example:

   $ PRINT/QUEUE=PS$A14/PARAMETERS=DATA_TYPE=PROPRINTER/SETUP=module-name file-name.DAT

The system manager can include the setup module in a form definition, which can be associated with a queue by default. In this case, you need only specify the data file name and the queue name in the PRINT command.

For example, to change the default character set of the translator from code page 437, character set 1, to code page 850, character set 2, create a setup module that contains the following escape sequence:

Escape Sequence Format

ESC ` ETX NUL CR R ETX ESC ` STX NUL ENQ STX

Decimal Values

027 096 003 000 013 082 003 027 096 002 000 005 002

To change the translator from printing on just 10 inches of a letter-size sheet to printing on all 11 inches of the sheet, create a setup module that includes the following escape sequences:

Escape Sequence Format

ESC ' STX NUL DC1 LF ESC ' ETX NUL EOT CAN ETX

Decimal Values

027 096 002 000 017 010 027 096 003 000 004 024 003

This front panel command changes the top offset to 10 points, and sets the text length to 11 inches. Because most laser printers cannot print on the entire sheet, you may need to scale the page using the NUMBER_UP or LAYUP parameters to fit within the printable area.

10.4 Changing the Printable Area

Applications that create files for Proprinter print jobs assume that the entire page is available for printing. Dot matrix printers, such as Proprinter devices, use the full page. Laser printers, such as those supported by the DECprint Supervisor for OpenVMS software, have a printable area that is often smaller than the entire page, and leave a blank margin around the printable area.

The software that translates Proprinter files for PostScript printing formats the text so that it prints only within the printable area on the laser printer. Specifically, the translator formats the text so that it does not print within 1/4 inch of the left and right edges of the page, nor within 1/2 inch of the bottom edge. The first line of a file prints with its baseline 1/2 inch from the top edge of the page. This is illustrated in Figure 10-1.

Figure 10-1 Proprinter Default Printable Area

10.4.1 Proprinter Files That Do Not Fit on the Page

Figure 10-2 Proprinter Page on Two PostScript Pages

You can correct this problem by using a setup module that causes the translator to put more lines on the page.

For example, to change the translator from printing on 10 inches of a letter-size sheet to printing on 11 inches of the sheet, create a setup module to scale the page. Include the following escape sequences:

Proprinter Escape Sequence Format

ESC ' STX NUL DC1 LF ESC ' ETX NUL EOT CAN ETX

Decimal Values

027 096 002 000 017 010 027 096 003 000 004 024 003

This changes the top offset to 10 points, and sets the text length to 11 inches.

The new output may also need to be scaled because the text prints off the bottom of the page (see Figure 10-3).

Figure 10-3 Proprinter Page Too Long

You can correct this problem by scaling the page image. To scale the page image, specify any one of the following for the print job:

/PARAMETERS=NUMBER_UP=1 /PARAMETERS=LAYUP_DEFINITION=BORDERS /PARAMETERS=LAYUP_DEFINITION=layup-file-name

The DECprint Supervisor for OpenVMS software includes an example layup definition file that shrinks the size of the logical page to fit within the normal laser printer margins. The example file PROPRINTER-FULL-PAGE.LUP is supplied in SYS$COMMON:[SYSHLP.EXAMPLES.DCPS]. Ask your system manager to copy it to the DCPS$LAYUP area if it is not already there. Then you can specify the layup definition file in the PRINT command, as follows:

$ PRINT file.PRO/PARAMETERS=LAYUP_DEFINITION=PROPRINTER-FULL-PAGE/NOTIFY

The final output is illustrated in Figure 10-4.

Figure 10-4 Proprinter Page Adjusted to Fit PostScript Page

You can select the page size with the /PARAMETERS=PAGE_SIZE qualifier. All page size values are supported by the Proprinter translator. The translator will print within the area of the page specified by the PAGE_SIZE parameter except for a small area around the edge of the page. The area around the edge of the page is specified by the top offset and the left offset (see Table 10-2).

The top offset specifies the position of the baseline of the first line of the page as well as the default margin at the bottom of the page. The default top offset is 1/2 inch.

The left offset specifies the area at the left edge of the page as well as the default margin at the right edge of the page. The default left offset is 1/4 inch.

If your application allows for a margin around the page, you can decrease these offsets.

If you need a page size that is not supported by DECprint Supervisor, you can explicitly specify the page size using the front panel mode escape sequences for form length and margins (see Table 10-2). These escape sequences specify the length and width of the page measured from the offsets.

10.5 Specifying the Input Tray for Proprinter Print Jobs

A Proprinter file may contain instructions to select the printer input tray on a Proprinter printer. When you print this file on a different type of printer, the print job will fail if the specified input tray is not available. You can modify the print job to redefine the input tray selection command, using a PostScript setup module. Your system manager can create a setup module to redefine the appropriate Postscript operators, as in the following which shows the contents of a setup module that selects tray 3 for the upper input tray, and tray 1 for the bottom input tray.

/settoptray {statusdict begin 3 setpapertray end} def /setbottomtray {statusdict begin 1 setpapertray end} def

Input tray values are specific to the printer. Refer to the PostScript documentation for your printer to determine the numbers for the available trays.

The input tray selection commands, and the PostScript operators to which the Proprinter translator converts them, are listed in Table 10-3. The default setpapertray value is the value that the translator uses if no other value has been defined. A setup module with a different value would override the default value.

Table 10-3 PostScript Operators for Changing Input Trays

Bin	Meaning	PostScript Extension Operator	Default setpapertray Value
0	No change
1	Upper tray	settoptray	1
2	Lower tray	setbottomtray	2
3	Envelope feeder	setenvelopefeedertray	3

10.6 Including Soft Fonts in Proprinter Print Jobs

If your Proprinter file requires soft fonts to be loaded in the printer, you can download the font using Proprinter setup modules.

The system manager must create a device control library designated for Proprinter setup modules and include that library in the search list in DCPS$STARTUP.COM, as described in the System Manager's GuideSystem Manager's Guide.

Proprinter setup modules from the Proprinter device control library are handled differently from ANSI and PostScript setup modules. Records from a Proprinter module are not appended with carriage control characters (<CR><LF>) because Proprinter setup modules can include binary data, such as Proprinter fonts and raster graphics. If the Proprinter setup module contains lines of text that must be separated by carriage control characters, you must explicitly specify them in the Proprinter setup module.

Proprinter setup modules are processed without a subsequent page eject command, so that anything printed by such setup modules will appear on the first page of the file.

The List data type is a list numbering tool that prints line-oriented text in a format that is easier to read. The List data type creates output that has:

• The file name at the top of each page
• The page number at the top of each page
• Line numbers for each line of the file
• Horizontal gray bars shading each page
• An end marker to indicate the end of the file

Figure 11-1 is an example of a page printed using the List data type.

Figure 11-1 List Data Type Output

You must have the DCPS-Plus license installed on your system to use the List data type.

11.1 Using the List Data Type

Use the following PRINT parameter to print your text document using the List data type:

/PARAMETERS=DATA_TYPE=LIST

For example, to print the file XREPORT.TXT using the List data type, enter the following command:

$ PRINT XREPORT.TXT/PARAMETERS=DATA_TYPE=LIST

By default, DECprint Supervisor for OpenVMS prints using the List data type if the file extension is one of the following:

B32 CPP MMS BAS CXX PAS BLI FOR PLI C H R32 CBL HXX REQ COM MAR

See the DECprint Supervisor for OpenVMS for OpenVMS System Manager's Guide for information about changing this list.

11.2 Using OpenVMS Forms with the List Data Type

The List data type ignores form settings for margins, page width, and so forth when formatting pages. It creates a page with maximum content at a size compatible with both A (Letter) and A4 paper:

• Portrait orientation: 80 columns, 70 lines
• Landscape orientation: 132 columns, 55 lines

However, any setup modules invoked by the form definition are applied to the print job.

This chapter describes how to print different types of files on a PostScript printer, and shows how to access the printer-specific features. Some features are not supported by all types of printers. You should be aware of the type of file you are printing, and the capabilities of your printer.

There are many types of PostScript printers with unique capabilities and features. Make sure your printer can perform the functions you specify in the print job. If your printer does not have a capability you request (for example, two-sided printing), your print job may be terminated and a message displayed to inform you of the problem. Some of the unique capabilities that may be available on your printer include:

• Two-sided (duplex) printing
• Variable paper sizes (envelopes, B-size paper, and so forth)
• Multiple input trays and input tray selection
• Multiple output trays and output tray selection
• Color printing

In addition to these printer-specific features, make sure the type of media you request is loaded in the printer before you enter the PRINT command.

12.1 Printing Two-Sided Documents

To select two-sided printing, use the SIDES parameter to the PRINT command.

The SIDES parameter provides the printing features listed in Table 12-1.

Table 12-1 Values for SIDES Parameter

Value	Definition
1, ONE, or ONE_SIDED_SIMPLEX	Your job prints on one side of the sheet.
2, TWO, or TWO_SIDED_DUPLEX	Your job prints on both sides of the sheet. The second side is reached by turning the page about its left edge, as in the binding of a book.
TUMBLE or TWO_SIDED_TUMBLE	Your job prints on both sides of the sheet, and alternating pages are rotated 180 degrees. Figure 12-2 shows the format for two-sided tumble printing. The second side is reached by turning the page about its top edge, as in some legal documents.
ONE_SIDED_DUPLEX	Your job prints on one side of the sheet but alternate pages may be offset for binding. Retains page layout for duplex printing for copying on duplex copiers. Reflects the placement of margins and page numbers.
ONE_SIDED_TUMBLE	Your job prints on one side of the sheet, and alternating pages are rotated 180 degrees. This allows you to make a tumble-formatted copy to take to a copying facility for multiple copies. Reflects the placement of margins and page numbers.
TWO_SIDED_SIMPLEX	Your job is printed on both sides of a sheet. This setting does not reflect the placement of margins.

12.2 Specifying Landscape and Tumble Printing

Figure 12-1 Landscape Orientation with Two-Sided Printing

To print pages in portrait orientation and tumble mode (as shown in Figure 12-2), use the SIDES=TUMBLE parameter. For example:

$ PRINT/PARAMETERS=SIDES=TUMBLE MYFILE.PS

Figure 12-2 Portrait Orientation with Two-Sided Tumble Printing

If you need a landscape oriented document printed on two sides and bound along the short edge (see Figure 12-3), use both the SIDES=TUMBLE and the PAGE_ORIENTATION=LANDSCAPE parameters in the PRINT command.

For example:

$ PRINT/PARAMETERS=(SIDES=TUMBLE,PAGE_ORIENTATION=LANDSCAPE) MYFILE.PS

Figure 12-3 Landscape Orientation with Two-Sided Tumble Printing

If you specify SIDES=TUMBLE for a print job destined for a printer that does not support tumble printing, your print job is terminated and the following message is displayed:

DCPS-E-TUMBNOSUP, printer-name does not support tumble printing

To display the SIDES parameter values that are supported by your printer, enter the HELP PRINT_PARAMETER SIDES command and select the subtopic that describes your printer.

12.3 Specifying Multiple PostScript Files in Duplex Print Jobs

Use the following command to print two PostScript files using both sides of the sheet:

$ PRINT/QUEUE=PS$A14/PARAMETERS=SIDES=2 FILE1.PS,FILE2.PS

If FILE1.PS has three pages, page 1 is printed on the front of the first sheet; page 2 is printed on the back of the first sheet; and page 3 is printed on the front of the next sheet. Then, page 1 of FILE2.PS is printed on the back of that sheet, and so on.

To begin printing each new file on a new sheet, use the /FLAG, /BURST, or /TRAILER qualifier to print a file separation page between files. For example, the following command prints FILE1.PS and FILE2.PS and includes a flag page between each file:

$ PRINT/QUEUE=PS$DUPLEX/PARAMETERS=SIDES=2/FLAG FILE1.PS,FILE2.PS

12.4 Specifying the Physical Sheet Size

You can specify the size of the physical sheet or type of media on which to print your file. The DECprint Supervisor software may assume this information automatically from the:

• Information inside the file
• Printer's default input tray
• Logical page size specified in the PRINT command (see Section 12.7).

You can explicitly request a certain sheet size by including the SHEET_SIZE parameter in your PRINT command to specify a value that describes the physical media size. For example:

$ PRINT/PARAMETERS=SHEET_SIZE=A4 MYFILE.PS

To list the values available with your printer, enter the HELP PRINT_PARAMETER SHEET_SIZE command and select the subtopic that describes your printer.

Some sheet sizes are known by multiple names, as listed in Table 12-2. You may use any of these names to specify a sheet size to DCPS. The DCPS term is the term that DCPS prints on the trailer page and reports in error messages.

Table 12-2 Sheet and Page Size Synonyms

DCPS Term	Synonym
Business_Envelope	Com10
7_Envelope	Monarch
Halfletter	Statement