page-select (Document Only)

Specifies the first and last page of a document that InfoPrint prints.

GUI label

Pages to process

DSS

AIX, CUPS, PSF, Email, InfoPrint 2000, Passthrough

Type

Resettable, multi-valued, complex, per-document

Syntax

first-page:last-page

Separate the values with a colon, for example:

25:48
     -x "page-select=25:48"
or
 1:3 9:13
-x "page-select=1:4 9:13"

You can omit the first-page value or the last-page value, for example:

:6
10:
See Usage Guidelines.

Components

  • first-page: Specifies the number of the page where printing starts.
    GUI label
    Lower limit
    Type
    Multi-valued
    Allowed Values
    You can enter a value of 1 through 2147483647.
    Default Value
    No default value
  • last-page: Specifies the number of the page where printing ends.
    GUI label
    Upper limit
    Type
    Multi-valued
    Allowed Values
    You can enter a value of 1 through 2147483647.
    Default Value
    No default value

Usage Guidelines

  • You can specify up to 10 page ranges to be printed. If you specify more than 10 page ranges, no pages print and an error is displayed.
  • Page numbering always starts at one (1) even if the job you print uses an alternate numbering system, such as roman numerals or folio-by-chapter (1-1, 1-2, and so on) numbering. You cannot request a range of pages using page numbers from an alternate numbering system.
  • This attribute is not valid for ASCII or KGL documents.
  • For AIX, CUPS, and Passthrough, this attribute works only when using InfoPrint Manager pioinfo and piorpdm CUPS backends.

  • For AIX, CUPS and Passthrough this attribute doesn't support multiple values.
  • For AIX, CUPS, and Passthrough DSSs, this attribute works only for PCL, PDF, and PS.
  • If you omit the first-page value, for example :6, InfoPrint prints from the first page of the job through page 6.
  • If you omit the last-page value, for example 6:, InfoPrint prints from page 6 through the last page of the job.
  • Entering a combination of first-page last-page values where the first-page value is greater than the last-page value is an error.
  • If InfoPrint cannot find the first-page value in the document, no pages print and InfoPrint issues an error.
  • If InfoPrint cannot find the last-page value in the document, it prints pages from first-page value to the end of the document. InfoPrint does not issue an error.
  • For jobs with document-format=dpf-ipds, the first-page value is only applied to the first copy, and all following copies start at page 1.
  • For jobs with document-format=dpf-ipds, the last-page value is always ignored.
  • For jobs with document-format=dpf-ipds, only the first range is processed, the remaining ranges arealways ignored.
  • When you specify the force-cse-sheet-eject attribute as true and you use the page-select attribute to specify a page range, you can get more sheets than specified with page-select attribute alone.
  • If blank pages are inserted into the job by formdef settings or because the force-cse-sheet-eject attribute is set to true, the pages are inserted in addition to the page range specified with this attribute.