---
name: "ptal-hp"
section: "1"
platform: "linux"
package: "hpoj"
version: "0.91-14"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/ptal-hp"
---

# ptal-hp(1)

## NAME

hpoj reference: `"ptal-hp"`

## SYNOPSIS

ptal-hp \[*devname*\] *command* \[*params...*\]

## DESCRIPTION

The `"ptal-hp"` command-line utility provides high-level access to various control and status features of supported HP multi-function peripherals, including:

- •

  General device information

- •

  Front-panel display readback

- •

  Clock readback and setting

Not all features are available on all models. In general, the common thread between the various functions of `"ptal-hp"` is that internally they involve access to PML objects on the device. On the other hand, `"ptal-pml"` may be used to get and set PML objects directly.

## OPTIONS

- •

  `"`*devname*`"` is the optional PTAL device name

- •

  `"`*command*`"` is the command for `"ptal-hp"`, one of:

  - •

    `"device"` -- general device information

  - •

    `"display"` -- display readback

  - •

    `"clock"` -- clock readback and setting

- •

  `"[`*params...*`]"` is zero or more parameters for the specific `"`*command*`"`.  See the following sections for more information.

`"device"` -- general device information Displays various information about the device, and displays `"(unavailable)"` for information that the device doesn't provide. Syntax:

ptal-hp \[*devname*\] device

There are no additional command-line parameters. See also `"ptal-devid"`. Example for a PSC 750:

Model name:        PSC 700 Series Model number:      750 Serial number:     MY11TA1040WB Firmware version:  BD401R Firmware datecode: (unavailable)

Example for an OfficeJet 700:

Model name:        (unavailable) Model number:      (unavailable) Serial number:     (unavailable) Firmware version:  (unavailable) Firmware datecode: (unavailable)

`"display"` -- display readback Displays the contents of the LCD (liquid crystal display) on the device's front panel, or displays `"(unavailable)"` if the device doesn't provide this information.  See the `"xojpanel"` column on the hpoj Supported devices page for the most up-to-date information about which models support this feature. Syntax:

ptal-hp \[*devname*\] display

There are no additional command-line parameters. A related utility is `"xojpanel"`, which is a graphical application that continuously displays the LCD contents in its own window.  The `"xojpanel"` document contains some useful information that also applies to "`"ptal-hp display"`". Example for a PSC 750:

1 Copy   / 100%

Example for a LaserJet 3200:

READY           AUTO JUL-31-2001  11:35PM

Example for an OfficeJet G85 with a page loaded in the ADF:

Jul 31 01 11:37p Original loaded

Example for a LaserJet 1100A:

(unavailable)

`"clock"` -- clock readback and setting Displays the current date/time of the device's clock (if it has one), and if desired, synchronizes the clock to the PC's clock and/or changes the date/time display formats. Syntax:

ptal-hp \[*devname*\] clock \[*params...*\]

Where `"`*params...*`"` may be zero or more of:

- •

  `"-set"` -- Sets device clock to PC clock

- •

  `"-mmddyy"`, `"-ddmmyy"`, `"-yymmdd"` -- Sets date format

- •

  `"-12hour"`, `"-24hour"` -- Sets time format

Any parameters you specify are processed in order of appearance on the command line. "`"ptal-hp clock"`" currently does not support setting the device's clock to an arbitrary time or date (different from the PC clock). Most models allow you to set the clock from their front-panel menus.