~PM - Decommission Printer
Wipes the printer's stored settings and data so the unit can be retired.
~PM wipes a printer's stored settings and data so the unit can leave the
building. It is destructive and irreversible on hardware, and it has an interlock
against an accidental send. The command must carry the printer's own serial number,
and the number must match.
Syntax
~PMa,bSupport
Accepted and skipped, because it configures the printer rather than the label. It cannot change the rendered output, and Labelary skips it too.
Destructive on hardware and inert here: no persistent memory exists to wipe, and the serial number it demands belongs to a physical unit. This is not ^PM print mirror image, which does affect the image. 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
aSerial numberrequired · textThe printer's own serial number. The command does nothing unless it matches, which is the safety interlock on a destructive operation.
- Invalid value
- not documented, and we have not measured it. The renderer does not parse this command. No device serial number exists here to check a value against.
- Test coverage
bWipe countoptional · integerHow many times to overwrite printer memory.
- Default
- 0
- Accepted range
- 0 to 3 passes
- 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.
Behavior
This is not ^PM, print mirror image, which does change the label. The two are
unrelated commands that share a mnemonic and differ only in the prefix.
The second argument asks for up to three overwrite passes over printer memory, for a unit whose stored formats or graphics are sensitive.
This API has no persistent memory to wipe and no serial number to match, so the
renderer ignores this command. ~PM is absent from the 2006 edition of the ZPL II
guide; the arguments follow Labelary's reference.
Example
A decommission request with a serial number and one wipe pass. The serial number matches nothing and the label prints as written:
^XA
~PM1234567890,1
^FO50,50^A0N,30,30^FDDecommission^FS
^XZ
Related commands
^PMPrint Mirror ImageMirrors the finished label left-to-right about its vertical centerline.^JUConfiguration UpdateSaves the printer's current settings to non-volatile memory, or reloads saved or factory settings.^JBInitialize Flash MemoryReformats one flash storage device, and discards every graphic, font and format stored on it.