pdspace command: backspaces or forward spaces a printer

Syntax

pdspace [-H host:port] [-c destination] {-b SideCount | -f SideCount} [-n]
[-x "attribute=value …"] [-X AttributesFileName]
[ServerName:]DestinationName …

pdspace -h

Description

Use the pdspace command to backspace or forward space the job currently printing on the specified PSF physical printer a given number of sides. If the job is printing on one side of the medium, one side is equivalent to one sheet. If the job is printing on two sides of the medium (duplex), two sides are equivalent to one sheet.
    Note:
  1. The functions of this command only apply to PSF IPDS actual destinations.
  2. Before using the pdspace command, make sure that SNMP has been enabled on the printer.
  3. While all PSF IPDS actual destinations support the pdspace command, installing the level of microcode especially written for backspacing or forward spacing makes sure that the printer stops quicker and the appropriate page prints. For example, the microcode that supports pdspace for the InfoPrint Pro C900AFP, InfoPrint 2000 AFP, InfoPrint 3000, InfoPrint 4000, and InfoPrint 4100 printers stops the printers in less than five seconds after the pdspace is submitted.
  4. You cannot backspace or forward space ASCII print jobs.

You can enter the pdspace command while the printer is stopped, paused, or running.

  • If the printer has been stopped by pressing the STOP button on the printer device, the printer operator must press the START or READY button before the printer can start printing again. You cannot force a stopped printer to do an nonprocess runout (NPRO) by specifying the -n flag; but the operator can force an NPRO by pressing the NPRO button.
  • If the printer has been paused with the pdpause command, you must enter the pdresume command before the printer can start printing again.
  • If the printer is running, the pdspace command takes effect as soon as possible. However, some pages will continue to print before the command takes effect because the printer might not stop immediately.
  • Another way to use the pdspace command for InfoPrint 3000, InfoPrint 4000, and InfoPrint 4100 follows:
    1. Stop the printer with the pdpause command.
    2. When the printer stops, specify pdspace and the backspace or forward space should be accurate from the last printed page.
    3. To begin printing again, enter the pdresume command.

The printer backspaces or forward spaces the number of sides you specify, except that:

  • The printer will not backspace or forward space to the back side of a duplexed sheet. If a backspace or forward calculation points to the back side of a duplexed sheet, the printer backspaces or forward spaces to the front side of that sheet.
  • When backspacing, if you specify a side count of -1, the job restarts printing on page 1 with a new header sheet.
  • When backspacing, if you specify more sides than have already printed, the job restarts printing on page 1 without a header sheet.
  • When forward spacing, if you specify more sides than there are sides left to print, the job terminates.

    Note:
  1. InfoPrint backspaces or forward spaces from the last printed sheet: any count is one less than you would normally expect. For example, if you backspace ten sides starting at page 39, the job resumes on page 30 because page 39 is counted as one of the pages backspaced.
  2. A backspace or forward space request is accepted for dpf-ipds jobs, but unpredictable results will occur.

Flags

You can use these flags with the pdspace command:

-H host:port

Identifies the host and port of the InfoPrint Manager server used for communication. When not specified, the command follows the Configuration logic to define the host and socket.

-b SideCount
Specifies the number of sides to backspace before continuing to print. Using this flag is equivalent to specifying the command attribute back-space.
-c destination DEFAULT=destination
Specifies the object class of destination, which represents a PSF physical printer. This is the only allowed class. Using this flag is equivalent to specifying the command attribute class.
-f SideCount
Specifies the number of sides to forward space before continuing to print. Using this flag is equivalent to specifying the command attribute forward-space.
-n
Causes the printer to do an NPRO (move the last printed page to the stacker) before restarting printing. An NPRO makes it easier to see exactly where the spacing took place. Using this flag is equivalent to specifying the command attribute non-process-runout=true.
-x "attribute=value …"
Consists of a single attribute string, containing one or more attribute-value pairs.
-X AttributesFileName
Specifies the name of a file containing attribute and value pairs that you want InfoPrint to insert at the current point in the command. Using this flag is equivalent to specifying the command attribute attributes.
-h
Displays a command-specific help message containing information about command syntax and flags. If you use this flag with any other flag or attribute, InfoPrint recognizes only the -h flag.

Configuration logic

The command determines which server host and server port to use based on this sequence:

  1. Server host and server port specified with the -H parameter.
  2. Server host and server port specified with the PDHOST and PD_SOCKET envirnonment variables.
  3. Uses the defaults for PDHOST=localhost and PD_SOCKET=6874.
Note: This configuration logic enables multiple commands to run on a single machine communicating with one or more InfoPrint Manager servers.

Command attributes

You can define these attributes in a -x "attribute=value …" string or in an attributes file designated in the -X AttributesFileName flag.

attributes=<