VMS Help  —  PRINT Parameter, LAYUP_DEFINITION
   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.
Close Help