l8HP DECprint Supervisor (DCPS) for OpenVMSG

HP DECprint Supervisor (DCPS) for OpenVMS
User's Guide

z d f

10.6.2 Restarting Interrupted Print Jobs

HYou can save paper when you restart interrupted print jobs by using the EPAGE_LIMIT parameter to start the print job near the point where the print job stopped. For example:

"
L $ SET ENTRY /PARAMETERS="PAGE_LIMIT=(30,)" /RELEASE 301

HIn this example, print job 301 was released and printing started on the 30th page of the print job.

Note

@Using the PAGE_LIMIT parameter will not save system overhead or Jprocessing time because the DECprint Supervisor software must process the Fentire print job from the beginning in order to print selected pages.

10.6.3 Using PAGE_LIMIT on Two-Sided Print Jobs

DWhen you use the PAGE_LIMIT parameter with duplex (two-sided) print Hjobs, the software ignores the respective positions of left (verso) and Dright (recto) pages. The first page you specify with the PAGE_LIMIT &parameter will always be a recto page.

Note

ETo successfully print with PAGE_LIMIT on both sides of the paper and Dmaintain the positions of recto and verso pages, you must specify a /recto page for the first page to print.

FThe maximum PAGE_LIMIT value, for either the starting or ending page, is 999999.d

10.7 Specifying the Logical Page Size

ECertain types of files contain instructions for the size of the page Gthat will be printed. The application that generates PostScript files, Hfor example, assumes a certain media size and generates PostScript data to create pages of that size.

HNote, however, that the logical page size specified in the file differs Efrom the physical size of a sheet of paper. You specify the physical Gsheet size using the SHEET_SIZE parameter. Use the PAGE_SIZE parameter <to specify the logical page size for files that do not have instructions for the page size.

FIf you do not specify SHEET_SIZE in your PRINT command, the PAGE_SIZE Gvalue is assumed to be the physical sheet size as well. In a print job Nwhere neither PAGE_SIZE nor SHEET_SIZE are specified, the DECprint Supervisor Esoftware assumes the size of the media loaded into the default input tray.

MTo list the PAGE_SIZE values supported by the DECprint Supervisor, enter the 'HELP PRINT_PARAMETER PAGE_SIZE command.

GTo print an ANSI file using a logical page that will fit on a business &envelope, enter the following command:

"
M $ PRINT /PARAMETERS=PAGE_SIZE=BUSINESS_ENVELOPE ADDR.TXT

EIf you include the PAGE_SIZE parameter in a print job for PostScript Cfiles, the parameter is ignored. However, you can include both the DPAGE_SIZE and SHEET_SIZE parameters to allow the logical page to be kadjusted to fit on the physical sheet (see Section 10.8).

:Some page sizes are known by multiple names, as listed in ƒTable 10-2. You may use any of these names to specify a page size to HDCPS. The DCPS term is the term printed by DCPS on the trailer page and reported in error messages.g

10.8 Changing the Size of the Printed Page

FIn a PostScript file, the page size is the size of the media that the Happlication assumes when generating the PostScript file. In most cases, Athe page size and the sheet size are identical. However, you can Fspecify a different page size and sheet size so that the logical page His scaled to fit on the physiscal sheet. For example, use the following /command tp print B-size images on A-size paper:

"
P $ PRINT /PARAMETERS=(SHEET_SIZE=A,PAGE_SIZE=B) MOD_LINE.TXT

HWhen you specify the PAGE_SIZE and SHEET_SIZE parameters with different Kvalues, the DECprint Supervisor software automatically scales the pages to Afit the sheet size, including borders around pages as if you had Dspecified the NUMBER_UP parameter. You can use the LAYUP_DEFINITION iparameter as described in Chapter 11 to disable borders.{

10.8.1 Automatic Scaling When Queue Has PAGE_SIZE and SHEET_SIZE Parameters

?DCPS assumes an implicit NUMBER_UP=1 when all of the following conditions exist:

Queue default parameters for both PAGE_SIZE and SHEET_SIZE have been set to different sizes<
Your PRINT command does not specify these parameters:
- PAGE_SIZE
- SHEET_SIZE
- INPUT_TRAY
H
NUMBER_UP and LAYUP_DEFINITION are not specified for the queue or in your print command

FNUMBER_UP=1 scales the logical page size to fit on the physical sheet Gsize. This results in the same behavior as specifying different values Dfor PAGE_SIZE and SHEET_SIZE on the command line without specifying NUMBER_UP or LAYUP_DEFINITION.

Note

EFiles that contain instructions to select a paper tray or media size Emay not print as expected when you use this method of scaling pages.

Chapter 11
Using Layup to Modify Printed Documents

11.1 Specifying Layup Options in Print Jobs

HLayup is a printing system feature that allows you to map logical pages Eto physical sheets. The page layout adjustments you can make include Hspecifying the number of pages to print on each sheet of paper, setting (margins, and using borders around pages.

EPage layup adjustments can be specified in two ways. You can include Glayup options directly in the PRINT command line, or you can include a 'layup definition file in the print job.N

11.1.1 Specifying Layup in the Print Job

CYou can include a layup definition file in the print job using the following command format:

"
c $ PRINT file-name.PS /PARAMETERS=LAYUP_DEFINITION=layup_file

DIn the PRINT command line, include the name of the layup definition Dfile for layup_file, but do not include the file type .LUP.

HYou can directly specify one or more layup options in the PRINT command Bby including them in the LAYUP_DEFINITION parameter as shown here:

"
J $ PRINT /PARAMETERS=(LAYUP="(NOBORDERS)",NUMBER_UP=2)

FThis command is useful for disabling borders when using the NUMBER_UP =parameter. When you provide layup options directly using the ELAYUP_DEFINITION parameter, you must include the quotation marks and Hthe parentheses to distinguish the options from a layup definition file name.

fThe layup options are listed in Table 11-1.

m ' . $
Table 11-1 Layup Definition File Options
Layup Option Operation Performed Reference
ALTERNATE 6 Exchanges a pair of margins on alternate sheets. I Section 11.1.2
BORDERS & Draws a border around each page. F Section 11.1.3
FIRSTPAGE J Specifies the first page spot (print location) where a page will be printed. H Section 11.1.4
GRID J Sets the number of page spots on a sheet in columns and rows. (This " option overrides NUMBER_UP.) G Section 11.1.5
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, andI r is the right margin. Pages are scaled to fit within the margins. F Section 11.1.6
PAGEORDER ; Specifies the order in which pages appear on a sheet. H Section 11.1.7
PAGESPERSHEET M Sets the number of pages that will print per sheet, no matter how many & page spots are set by NUMBER_UP. B Section 11.1.8

**Table 11-1 Layup Definition File Options**
Layup Option	Operation Performed	Reference
ALTERNATE	6 Exchanges a pair of margins on alternate sheets.	I Section 11.1.2
BORDERS	& Draws a border around each page.	F Section 11.1.3
FIRSTPAGE	J Specifies the first page spot (print location) where a page will be printed.	H Section 11.1.4
GRID	J Sets the number of page spots on a sheet in columns and rows. (This " option overrides NUMBER_UP.)	G Section 11.1.5
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, andI r is the right margin. Pages are scaled to fit within the margins.	F Section 11.1.6
PAGEORDER	; Specifies the order in which pages appear on a sheet.	H Section 11.1.7
PAGESPERSHEET	M Sets the number of pages that will print per sheet, no matter how many & page spots are set by NUMBER_UP.	B Section 11.1.8

BThe following sections describe the layup options in more detail. sSection 11.2.1 includes some sample layup definition files.

11.1.2 Specifying Margin Alternation

FThe ALTERNATE option lets you exchange a pair of margins on alternate Hsheets. This option is useful to prepare a job for double-sided copying.

pTable 11-2 describes the values that can be supplied to the ALTERNATE option.

d !
Table 11-2 ALTERNATE Option Values
Value Result
LEFT ' Left and right margins alternate.
RIGHT ' Left and right margins alternate.
none Same behavior as LEFT.
TOP ' Top and bottom margins alternate.
BOTTOM ' Top and bottom margins alternate.

**Table 11-2 ALTERNATE Option Values**
Value	Result
LEFT	' Left and right margins alternate.
RIGHT	' Left and right margins alternate.
none	Same behavior as LEFT.
TOP	' Top and bottom margins alternate.
BOTTOM	' Top and bottom margins alternate.

CIf you specify ALTERNATE with no option values, the left and right margins alternate.

DMargin alternation is part of the default processing for print jobs $with the following print parameters:

/PARAMETERS=SIDES=TUMBLE(
/PARAMETERS=SIDES=ONE_SIDED_DUPLEX(
/PARAMETERS=SIDES=ONE_SIDED_TUMBLE

FMargin alternation is not performed as part of the default processing 3for print jobs with the following print parameters:

/PARAMETERS=SIDES=1)
/PARAMETERS=SIDES=TWO_SIDED_SIMPLEX

AIf you omit /PARAMETERS=SIDES from the PRINT command, the margin Falternation processing depends on the printer hardware (refer to your printer owner's manual).

11.1.3 Specifying and Omitting Borders

GThe BORDERS option draws a border around each page. Borders are useful Bfor differentiating pages when you are printing a job using PRINT E/PARAMETERS=NUMBER_UP. (If you use NUMBER_UP, the default is to draw Bborders.) You can turn off the borders using the NOBORDERS option.

GBorders are drawn around actual pages only, not around all page spots. @This feature allows you to distinguish between blank pages in a ydocument and nonexistent pages. Figure 11-1 shows four pages printed 6on a sheet without the borders option. The command is:

"
` $ PRINT /PARAMETERS=(NUMBER_UP=4,"LAYUP_DEFINITION=(NOBORDERS)") MYFILE.MEM

vFigure 11-2 shows the same pages printed with borders, which is the =default action for print jobs with NUMBER_UP. The command is:

"
? $ PRINT /PARAMETERS=NUMBER_UP=4 MYFILE.MEM

9Figure 11-1 NUMBER_UP =4 Without Borders

6Figure 11-2 NUMBER_UP =4 With Borders

11.1.4 Specifying the First Page Spot to Use

GThe FIRSTPAGE option specifies the first page spot (that is, location) where a page will be printed.

FYou must specify a value to FIRSTPAGE. The value is the number of the Dpage spot on which to print the first page. Page spots are numbered Dstarting at 1. The value supplied to FIRSTPAGE must be less than or =equal to the value supplied to NUMBER_UP. You cannot specify NOFIRSTPAGE.

5The default is to use the first page spot on a sheet.

HThe FIRSTPAGE option affects only the first sheet of the print job. All +other sheets begin printing at page spot 1.

FThe FIRSTPAGE option is useful for specifying how to print pages when Eyou need to preview the layout of pages for documents with right and Gleft pages. Without the FIRSTPAGE option, pages are printed at all the Epage spots. You can use FIRSTPAGE to print your layout in a way that "reflects the right and left pages.

~Figure 11-3 shows how pages are printed when the NUMBER_UP value is 8 6and the FIRSTPAGE value is not specified. For example:

"
L $ PRINT /QUEUE=PS$A10 /PARAMETERS=NUMBER_UP=8 MYFILE.PS

ANote that the last page printed on the first side is a left page.

;Figure 11-3 NUMBER_UP =8 Without FIRSTPAGE

tFigure 11-4 shows how pages are printed when NUMBER_UP=8 and 'FIRSTPAGE=2 are both used. For example:

"
Y $ PRINT /PARAMETERS=(NUMBER_UP=8,"LAYUP_DEFINITION=(FIRSTPAGE=2)") -1 _$ /QUEUE=PS40$A10 MYFILE.PS

<As this figure shows, the last page printed is a right page.

8Figure 11-4 NUMBER_UP =8 With FIRSTPAGE

11.1.5 Specifying the Page Grid

AInstead of using the NUMBER_UP parameter in the PRINT command to Especify the maximum number of page spots on a sheet, you can use the 'GRID option in a layup definition file.

CThe GRID option takes two values. The first value is the number of Fcolumns in the grid, the second is the number of rows. The product of !the two values cannot exceed 100.

DThe grid is interpreted in relation to the pages, not the sheet. As Cwith NUMBER_UP, the orientation of the pages is independent of the Hsheet orientation. Thus, you can print pages with portrait orientation, 1but you hold the sheet in landscape to read them.

EThe following example specifies that the pages will print 6-up, in a /grid of two columns across and three rows down:

"
Grid = 2, 3

B

11.1.6 Specifying Sheet Margins

BThe MARGINS option sets the margins of the sheet on which you are Aprinting. This option takes four values. The values set the top, =bottom, left, and right margins for a sheet. The numbers are Binterpreted as printer's points. (There are 72 points to an inch.)

DAlways specify the values for sheet margins in the following order: Gtop, bottom, left, and right. Sheet margins are independent of whether Dthe page is portrait or landscape orientation. Positive values move Btoward the center of the page; negative values move away from the center of the page.

CWhen you print using a layup definition file that uses the MARGINS Hoption, the page is scaled to fit on the area of the sheet that is left Fwhen margins are subtracted. Therefore, the size of text and graphics Gmay be changed on the printed document to fit the margins you specify. HWhen pages are scaled, the aspect ratio (relationship of page height to Cpage width) is preserved. Where there is space left, it is equally edivided on both sides of the page (see Figure 11-5).

BFigure 11-5 Usable Sheet Area With MARGINS Option

GIf you specify the MARGINS option but do not specify any values, layup Guses a value of 36 for all four margins. If you specify NOMARGINS, the /software uses the value 0 for all four margins.

EThe default margin setting is a 36-point margin (a half inch) on all sides.

1The following example creates a wide left margin:

"
U $ PRINT /PARAMETERS=("LAYUP_DEFINITION=(MARGINS=10,10,60,10)") -2 _$ /QUEUE=PS40$A10 MYFILE.TXT

)This example sets the margins as follows:
Top margin 10 points
Bottom margin 10 points
Left margin 60 points
Right margin 10 points
U

11.1.7 Specifying the Order of Page Spots to Use

EThe PAGEORDER option sets the order in which the pages appear on the /sheet, that is, the reading order of the pages.

xYou must supply a value to PAGEORDER. Table 11-3 describes the eight Avalues that can be used. The default page order is RightDown.

c &
Table 11-3 PAGEORDER Option Values
Value Description
RightDown G Pages are ordered left to right, top row first, then moving down.
LeftDown G Pages are ordered right to left, top row first, then moving down.
RightUp H Pages are ordered left to right, bottom row first, then moving up.
LeftUp H Pages are ordered right to left, bottom row first, then moving up.
DownRight L Pages are ordered top to bottom, left column first, then moving right.
DownLeft L Pages are ordered top to bottom, right column first, then moving left.
UpRight L Pages are ordered bottom to top, left column first, then moving right.
UpLeft L Pages are ordered bottom to top, right column first, then moving left.

**Table 11-3 PAGEORDER Option Values**
Value	Description
RightDown	G Pages are ordered left to right, top row first, then moving down.
LeftDown	G Pages are ordered right to left, top row first, then moving down.
RightUp	H Pages are ordered left to right, bottom row first, then moving up.
LeftUp	H Pages are ordered right to left, bottom row first, then moving up.
DownRight	L Pages are ordered top to bottom, left column first, then moving right.
DownLeft	L Pages are ordered top to bottom, right column first, then moving left.
UpRight	L Pages are ordered bottom to top, left column first, then moving right.
UpLeft	L Pages are ordered bottom to top, right column first, then moving left.

~Figure 11-6 shows how pages are printed with each PAGEORDER value in landscape orientation.!

FFigure 11-6 PAGEORDER Options (Landscape Orientation)

~Figure 11-7 shows how pages are printed with each PAGEORDER value in portrait orientation.!

EFigure 11-7 PAGEORDER Options (Portrait Orientation)

11.1.8 Specifying the Number of Pages to Print on Each Side of a Sheet

DThe NUMBER_UP parameter to the PRINT command determines the maximum Gnumber of pages you can print for each sheet. The PAGESPERSHEET option Ain a layup definition file specifies how many pages are actually printed on a sheet.

?Because NUMBER_UP determines the number of page spots, it also Ddetermines the layout of the page spots on the sheet. PAGESPERSHEET Adetermines only the range of page spots to use, not their layout.

EYou must supply a value to PAGESPERSHEET, and the value must be less 9than the value supplied to NUMBER_UP. You cannot specify NOPAGESPERSHEET.

4The default is to use all the page spots on a sheet.

<For example, assume you have a layup definition file called .SIXPAGES.LUP that contains the following line:

"
PagesPerSheet = 6

=To print a file called MYFILE.TXT, use the following command:

"
[ $ PRINT /PARAMETERS=(LAYUP_DEFINITION=SIXPAGES,NUMBER_UP=8) MYFILE.TXT

GEven though this command provides eight page spots for each sheet, the Gjob prints with six pages on a sheet, leaving the other two page spots blank.f

11.2 Creating Layup Definition Files

AYou can create the layup definition files that you need, include Foptions to specify the margins, page placement, and borders, and then Eask your system manager to copy the file into a directory defined by 'the systemwide logical name DCPS$LAYUP.

EWhen you create a layup definition file with selected layup options, follow these rules:

Name the layup definition file using the file type .LUP. The file I name can contain letters, numbers, underscores (_), and hyphens (-) as 0 long as the hyphen is not the first character.6
Include each option to be specified in the file B layup_file.LUP. Start each layup option on a new line. ;
Blank lines and white space within lines are ignored.J
To include comments in the file, begin the line with an exclamation H point (!). Comments are helpful for describing effects of the options in the layup definition file.&
Do not abbreviate layup options.H
You can use lowercase or uppercase letters for options, since the ' layup function is not case sensitive.I
For layup options that take values (indicated by an equal sign (=) H following the option name), you must include at least one value after I the equal sign. To specify multiple values, use commas to separate the values.I
If you specify a layup option more than once in a layup definition - file, the last setting in the file is used.F
Ask your system manager to store the layup definition file in a A system area pointed to by the logical name DCPS$LAYUP (see the B System Manager's GuideSystem Manager's Guide).

>Some examples of layup definition files are provided with the yDECprint Supervisor software and are described in Section 11.2.1.M

11.2.1 Sample Layup Definition Files

DThe first three layup definition files in this section are included Iwith the DECprint Supervisor software. They are located in the directory "SYS$COMMON:[SYSHLP.EXAMPLES.DCPS].

The following sample layup definition file is for a print job that E is printed one page to a sheet. It sets a wide left margin, so the G pages can be hole-punched. It does not alternate the margins, and it turns off borders.

"
F ! LPS$SINGLEHOLES.LUP specifies a larger left margin to allow for > ! hole punching. This file is for single sided printing. noborders margins = 19, 19, 60, 19 noalternate

I

The following sample layup definition file is for a print job that J is going to be copied double-sided and then hole-punched. It alternates H the larger margin. It turns off the borders, since it is intended for , jobs that are printed one page to a sheet.

"
F ! LPS$DOUBLEHOLES.LUP specifies a larger left margin to allow for = ! hole punching. This file is for double sided printing. noborders margins = 19, 19, 60, 19 alternate = left

F

The following sample layup definition file is for jobs that are I printed with more than one page to a sheet, for example, a job printed F with NUMBER_UP=6. This file uses borders to differentiate pages. It < leaves a wide left margin, but does not alternate margins.

"
D ! LPS$NUP.LUP specifies a variation for 2 up printing. A larger E ! left margin is specified to allow for hole punching. This file $ ! is for single sided printing. borders margins = 19, 19, 60, 19

H

The following sample layup definition file is for jobs that print H one page per sheet. It maintains the full size of the page image, but C allows a wide margin for hole-punching by using a negative right I margin. The negative right margin moves some of the page image off the G physical sheet, so this layup definition file is good only for pages that have page margins.

"
C ! LPS$ShiftForHoles.LUP specifies a wide left margin for hole- E ! punching without scaling down the size of the page image. The G ! negative margin means some of the page image is off the physical ; ! sheet. It is meant for printing one page per sheet. noborders margins = 0, 0, 60, -60

z a d f

Contents

Index

Top margin	10 points
Bottom margin	10 points
Left margin	60 points
Right margin	10 points

HP DECprint Supervisor (DCPS) for OpenVMSUser's Guide

10.6.2 Restarting Interrupted Print Jobs

10.6.3 Using PAGE_LIMIT on Two-Sided Print Jobs

Chapter 11Using Layup to Modify Printed Documents

11.1 Specifying Layup Options in Print Jobs

11.1.4 Specifying the First Page Spot to Use

11.1.5 Specifying the Page Grid

HP DECprint Supervisor (DCPS) for OpenVMS
User's Guide

Chapter 11
Using Layup to Modify Printed Documents