zpl.tools
Print control

^JZ - Reprint After Error

Controls whether a label interrupted by an error is reprinted once the error clears.

^JZ decides what happens to a half-printed label after the ribbon runs out, the media runs out or the head opens. The printer either prints the label again once the condition clears, or leaves the partial label as the only output. It is a printer mode, not an instruction about one label. It stays in force until another ^JZ or a power cycle, and applies only to later labels.

Syntax

^JZa

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.

Error recovery is a printer function. A render either succeeds or returns an error. 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

aReprintrequired · Y or N

Whether the printer reprints an interrupted label automatically.

Invalid value
enough to make the whole command be ignored. The guide is explicit: if the argument is missing or incorrect, the printer ignores the whole command, and the previous setting stays in force. No per-command default exists; the initial value at power-up is Y.
Test coverage
No documented value is exercised by a test (Y, N). The invalid-value rule is not pinned by a test.
Y
Reprint the interrupted label
N
Do not reprint

Behavior

A ^JZ governs error recovery for every format after it in the same session. A format therefore carries one in a prologue rather than per label.

None of that reaches a render. A request either returns a label or fails with an error, so no partial page exists to reprint. 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.

Example

Reprint after an error, set for every label that follows:

^XA
^JZY
^FO50,50^A0N,40,40^FDReprint on error^FS
^XZ

Open in viewer

  • ^PQ Print QuantityPrints the label more than once, the one command here that changes how many pages come back.
  • ^PR Print RateSets the speed of the media during print, slew and backfeed.