~JX - Cancel Current Partially Input Format
Discards the format being received, so it prints no page.
~JX cancels the format that arrives right now. It is the narrow version of
~JA: the guide says it affects neither a format already in print nor any format
sent after it. Use it to abandon a partly transmitted format that is wrong.
Syntax
~JXSupport
Every documented parameter renders the same output Labelary produces.
The parser reads the command and the renderer cancels. ~JX discards the format being received, so it prints no page: ^XA^FO50,50^A0N,40,40^FDhi^FS~JX^XZ answers X-Total-Count: 0. It reaches no further than that format. A label the same request has already finished keeps its page, and so do the queued copies of a ^PQ run. That is what separates ~JX from ~JA, which discards both. Between two formats there is nothing to cancel and the command does nothing at all. Measured against Labelary on 2026-08-21. — not pinned by a test
Labelary renders this command.
Parameters
~JX takes no arguments.
Behavior
It is a control command, so the printer acts on it as it reads it, and it can appear anywhere inside the format it cancels. That is the only place it is useful.
The distinction from ~JA shows up as soon as a request carries more than one
format. ~JX cancels the format being received and nothing else. A label the
request had already finished keeps its page, and so do the queued copies of a
^PQ run; ~JA discards both. Between two formats there is no format to
cancel, so ~JX does nothing at all.
Only the immediate spelling is a command. ^JX does not exist, and the label
carrying it prints as if it were not there.
Known issues
Differences from the specification
Labelary against the ZPL II guide
Where Labelary — our compatibility target — behaves differently from the printed specification.
- Labelary reports
^JXas a command that does not exist and prints the label. The guide documents only the immediate spelling, so the caret form is not ZPL. We measured this on 2026-08-21. — pinned bytest_jx_caret_spelling_is_not_a_command
Example
Related commands
~JACancel AllDiscards the format being received and every label the request has already printed.~JPPause and Cancel FormatDiscards the incoming format and pauses the printer.^XZEnd FormatEnds a label format and prints it.