zpl.tools
Printer configuration

^JH - Early Warning Settings

Configures the consumable and maintenance warnings the printer reports as media, ribbon and printhead wear out.

^JH sets the limits behind the printer's consumable and maintenance warnings, and also tells the printer that an operator replaced a consumable. Arguments b, d, g and i set the intervals; c, e, h and j reset the counters that measure against them.

Syntax

^JHa,b,c,d,e,f,g,h,i,j

Support

Recognised, deliberately skippedparsed: none · state: none · rendered: none

Accepted and skipped, because it configures the printer rather than the label. It cannot change the rendered output, and Labelary skips it too.

The command tracks consumable wear against an odometer a render does not have. It changes what the printer tells an operator, never what it images. The renderer does not parse this command. It reports IGNORED_COMMAND at info severity, which does not reach X-Warnings. Labelary is also silent, so the rendered label is identical in both engines. — not pinned by a test

Labelary renders this command.

Parameters

aMedia warningsoptional · one of a set

Enables the media-related early warnings.

Default
D
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
No documented value is exercised by a test (E, D).
E
Enable media warnings
D
Disable media warnings (default)
bLabels per rolloptional · integer

How many labels a full roll holds, which is what the media warning counts down.

Default
900
Accepted range
100 to 9999 labels
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
No test at the minimum, maximum or one step outside the range.
cMedia replacedoptional · Y or N

Declares a fresh roll, resetting the media countdown.

Default
N
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
No documented value is exercised by a test (Y, N).
Y
The roll is new
N
It is not (default)
dRibbon lengthoptional · integer

Length of a full ribbon, for the ribbon countdown.

Default
varies by printer model
Invalid value
not documented, and we have not measured it. Labelary's reference says the accepted range and the default vary by printer model. The renderer does not parse the command, so this data states neither.
Test coverage
eRibbon replacedoptional · Y or N

Declares a fresh ribbon, resetting the ribbon countdown.

Default
N
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
No documented value is exercised by a test (Y, N).
Y
The ribbon is new
N
It is not (default)
fMaintenance warningsoptional · one of a set

Enables the printhead cleaning and replacement warnings.

Default
D
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
No documented value is exercised by a test (E, D).
E
Enable maintenance warnings
D
Disable maintenance warnings (default)
gHead cleaning intervaloptional · integer

Distance between printhead cleanings, as an index: value n means 100 + (50 * n) meters.

Default
the previously set value
Accepted range
0 to 16
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command. ^JH is absent from the 2006 guide, and Labelary's reference gives no default either.
Test coverage
No test at the minimum, maximum or one step outside the range.
hHead cleanedoptional · Y or N

Declares the printhead cleaned, resetting that countdown.

Default
N
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
No documented value is exercised by a test (Y, N).
Y
The printhead is clean
N
It is not (default)
iHead life intervaloptional · integer

Expected printhead life, in inches of media.

Default
1000000
Accepted range
100 to 3500000 inches
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
No test at the minimum, maximum or one step outside the range.
jHead replacedoptional · Y or N

Declares a new printhead, resetting the life countdown.

Default
N
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
No documented value is exercised by a test (Y, N).
Y
The printhead is new
N
It is not (default)

Behavior

The printer counts the warnings against its own odometer of labels printed and media used, never against the format that configures them. The settings therefore only mean anything on a device that accumulates wear between jobs.

The two enable flags are independent: a covers media and ribbon, f the printhead clean and replace warnings. The printer stores a limit set while either flag is off, but does not act on it.

^JH is absent from the 2006 edition of the ZPL II guide; the argument ranges here follow Labelary's reference. The ribbon length has neither a range nor a default, because both vary by printer model.

Example

Every warning enabled, with a fresh roll and ribbon declared. The label prints unchanged:

^XA
^JHE,1000,N,7,N,E,12,N,2000000,N
^FO50,50^A0N,40,40^FDWarnings on^FS
^XZ

Open in viewer