LAYUP_DEFINITION=layup-definition-filename LAYUP_DEFINITION="(option;...)" Specifies layup options or a layup definition file that sets the layup features. Layup features are borders, sheet margins, alternating margins, pages per sheet, first page, page order, and page grid. Layup definition files are located in DCPS$LAYUP: and have the file type LUP. Do not specify the file type when you specify the layup definition file in the command line. To use a layup option and NUMBER_UP together, you must specify both on the command line or associate both with a queue.
1 – Options
Layup options allow you to specify the number of pages to print on each sheet of paper, their position on a sheet, the size of margins and whether borders are printed. The layup options and the syntax for specifying values is as follows: ALTERNATE=[LEFT|RIGHT|TOP|BOTTOM] [NO]BORDERS FIRSTPAGE=n GRID=columns,rows MARGINS=t,b,l,r PAGEORDER= PAGESPERSHEET=n You can specify layup options in either a layup definition file, or in-line as part of the PRINT command.
2 – In-line
You can specify layup definition options in your command line by enclosing them in parentheses and separating them with semi-colons. You must also enclose the entire layup definition string in quotes, as follows: $ PRINT /PARAMETERS=(LAYUP_DEFINITION="(option1;option2;...)") See the Examples topic for examples of PRINT commands that include in-line layup options.
3 – ALTERNATE
ALTERNATE=[LEFT|RIGHT|TOP|BOTTOM] Shifts every other page image in preparation for two-sided printing. Use this option in combination with the MARGINS option. Specify one of the words, LEFT, RIGHT, TOP or BOTTOM to cause the DECprint Supervisor to shift alternate page side images appropriately. Specifying LEFT or RIGHT alternates the left and right margins you specify with the MARGINS option (those margins along the long edge of a sheet of paper). Specifying TOP or BOTTOM alternates the top and bottom margins you specify. If you specify ALTERNATE with no option values, left and right margins alternate.
4 – BORDERS
BORDERS NOBORDERS Draws a border around each page. If you use the NUMBER_UP parameter, the default is to draw borders around each page spot. Specify NOBORDERS to inhibit drawing of borders. The default is to draw page borders whenever the layup feature is used.
5 – FIRSTPAGE
FIRSTPAGE=value Specifies the first page spot where a page will be printed. You must specify a value to FIRSTPAGE. The value is the number of the page spot on which to print the first page. Page spots are numbered starting at 1. The FIRSTPAGE option is useful for specifying how to print pages when you need to preview the layout of pages for documents with right and left pages. Without the FIRSTPAGE option, pages are printed at all the page spots. You can use FIRSTPAGE to print your layout in a way that reflects proper right and left orientation. The default is to use the first page spot on a sheet.
6 – GRID
GRID=columns,rows Sets the number of page spots on a sheet in columns and rows. Specify columns and rows as the numbers of columns and rows desired on each sheet side. This option overrides the NUMBER_UP parameter.
7 – MARGINS
MARGINS=t,b,l,r Sets the margins for a sheet, where t is the top margin, b is the bottom margin, l is the left margin and r is the right margin. The numbers are interpreted as printer points, where there are 72 points to an inch, or 28.35 points per centimeter. Pages are scaled to fit within the margins.
8 – PAGEORDER
PAGEORDER=value Specifies the order in which pages appear on a sheet. This can be thought of as the reading order of the pages. You must supply one of the following values to PAGEORDER: RightDown Pages ordered left to right, top to bottom LeftDown Pages ordered right to left, top to bottom RightUp Pages ordered left to right, bottom to top LeftUp Pages ordered right to left, bottom to top DownRight Pages ordered top to bottom, left to right DownLeft Pages ordered top to bottom, right to left UpRight Pages ordered bottom to top, left to right UpLeft Pages ordered bottom to top, right to left
9 – PAGESPERSHEET
PAGESPERSHEET=value Sets the number of pages that will print per sheet, no matter how many page spots are set by the NUMBER_UP parameter. The NUMBER_UP parameter or the GRID layup option determines the maximum number of pages you can print for each sheet. PAGESPERSHEET determines only the range of page spots to use; not their layout. You must supply a value to PAGESPERSHEET. The value must be less than the value supplied to the NUMBER_UP parameter value.
10 – Examples
The following PRINT commands illustrate the use of the layup feature: $ PRINT /PARAMETERS=(SIDES=2,LAYUP=LPS$DOUBLEHOLES) DOCUMENT.PS prints DOCUMENT.PS using the DCPS-supplied layup definition file LPS$DOUBLEHOLES to alternate page side images for edge-binding. $ PRINT /PARAMETERS=(SIDES=2,NUMBER_UP=2,LAYUP="(NOBORDERS)") MAIL.TXT prints the file MAIL.TXT as two-sided, two-pages per side and with no page borders. $ PRINT /PARAMETERS= - _$ (LAYUP="(MARGINS=20,20,60,20;NOBORDERS;ALTERNATE=LEFT)", - _$ SIDES=2,PAGE_ORIENTATION=LANDSCAPE) - _$ MONTHLY_REPORT.TXT prints the file MONTHLY_REPORT.TXT with landscape orientation, alternating page images across the long-edge margin.