zpl.tools
Printer configuration

^MI - Set Maintenance Information Message

Sets the wording printed on the maintenance alert labels `^MA` schedules.

^MI sets the text on the maintenance alert labels ^MA schedules. The alert can then say something useful to the person who finds it, such as an extension number rather than a generic instruction.

Syntax

^MIa,b

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 renderer never prints the alert labels this text appears on, so the message does not affect the format. 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

aAlert typeoptional · one of a set

Which alert's message this command sets.

Default
R
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 (R, C).
R
Printhead replacement alert (default)
C
Printhead cleaning alert
bMessageoptional · text

Text printed on the alert label, up to 63 characters.

Default
"PLEASE REPLACE PRINT HEAD" for type R, "PLEASE CLEAN PRINT HEAD" for type C
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage

Behavior

Each alert type holds one message, so both types need the command twice. An omitted message restores the defaults, PLEASE REPLACE PRINT HEAD for type R and PLEASE CLEAN PRINT HEAD for type C.

The message appears only on an alert label, never on the format that carries the command, and this API renders no alert label — see ^MA. ^MI is absent from the 2006 edition of the ZPL II guide; the limits follow Labelary's reference.

Example

A replacement-alert message pointing at an extension:

^XA
^MIR,CALL EXT 1234 FOR REPLACEMENT
^FO50,50^A0N,30,30^FDAlert text set^FS
^XZ

Open in viewer