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, 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 are always 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.
- For PSF, the first and last pages of each range depend on the formdef or medium maps specified.
-
For PSF, if the inline form definition or the form definition specified externally is for duplex printing, an extra page might be printed. If the first page specified is even, then the page before the first page specified is printed as an extra page. Similarly, if the last page specified is odd, then the page after the last page specified is printed as an extra page.
Moreover, if the form definition specifies n-up printing to place pages side by side on a single sheet (front and back if duplex printing is also requested), the printed output displays the complete content of the sheets that include the selected pages. For instance, if the page-select is 2:7 and the form definition requires duplex 4-up, one sheet is printed with the pages 1-4 on the front side and pages 5-8 on the back side.