zpl.tools
Host status and queries

~HM - Host RAM Status

Sends total, maximum and available printer memory back to the host.

~HM returns three numbers about the printer's RAM, immediately on receipt: the installed amount, the amount a user can reach, and the amount free. Software that downloads fonts or graphics uses it to check that the next ~DG fits.

Syntax

~HM

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.

Reports memory figures over the printer's link. The request bounds this object store, not a fixed RAM budget, so no equivalent number exists to report. 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

~HM takes no arguments.

Behavior

The reply is one line of three kilobyte figures, for example 3584,3586,3586: total installed, maximum available to the user, currently available. Only the third figure moves: a graphic, a font or a saved bitmap changes the amount free, and the printer fixes the first two at power-on. Space that bitmaps hold counts as available, because ^MCN can release it.

A render request has nothing equivalent to report. Its object store holds only what its own ~DG or ~DY commands put there, and it ends with the request, so it has no fixed budget. The renderer ignores the command, and the page is unchanged. It reports IGNORED_COMMAND at info severity, which does not reach X-Warnings. Labelary is also silent.

Example

A memory check before a download, on a format that renders regardless.

^XA
~HM
^FO50,50^A0N,40,40^FDRAM status^FS
^XZ

Open in viewer