sheet-range (Job Only)

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

GUI label

Sheet range

DSS

PSF

Type

Resettable, multi-valued, complex, per-job

Syntax

first-sheet:last-sheet

Separate the values with a colon, for example: 

25:48

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

:6
10:
See Usage Guidelines.

Components

  • first-sheet: Specifies the number of the sheet where printing starts.
    GUI label
    First sheet
    Type
    Single-valued
    Allowed Values
    You can enter a value of 1 through 2147483647.
    Default Value
    none
  • last-sheet: Specifies the number of the sheet where printing ends.
    GUI label
    Last sheet
    Type
    Single-valued
    Allowed Values
    You can enter a value of 1 through 2147483647.
    Default Value
    none

Usage Guidelines

  • You can specify up to 10 sheet-ranges to be printed. If you specify more than 10 sheet-ranges, no sheets print and InfoPrint issues an error.
  • Sheet ranges must not overlap. If the sheet ranges overlap, InfoPrint issues an error.
  • The sheet-range attribute is not valid for ASCII and DPF IPDS jobs and is not supported in Submit Express.
  • When the sheet-range attribute is used with the results-profile attribute, the necessary sheet range is sent to the printer and then multiplied, as specified in the job-copies field from the results-profile attribute. Therefore the sheet range is applied to each copy.
  • When the sheet-range attribute is used with the copy-count attribute, the data stream is first multiplied and then the sheet range is applied to the already multiplied stream. Therefore the sheet range is applied only to the first copy.
  • If you omit the first-sheet value, for example :6, InfoPrint prints from the first sheet of the job through sheet 6.
  • If you omit the last-sheet value, for example 6:, InfoPrint prints from sheet 6 through the last sheet of the job.
  • Entering a combination of first-sheet last-sheet values where the first-sheet value is greater than the last-sheet value is an error.
  • If InfoPrint cannot find the first-sheet value in the document, no sheets print. InfoPrint does not issue an error.
  • If InfoPrint cannot find the last-sheet value in the document, it prints the sheets from the first-sheet value to the end of the job. InfoPrint does not issue an error.
Parent topic: Attributes for jobs and default jobs