zpl.tools
Host status and queries

~HU - Return ZebraNet Alert Configuration

Sends the printer's configured alert destinations back to the host.

~HU returns the alert table that ^SX writes: which printer conditions report an alert, where each alert goes, and whether the printer reports both the set and the clear transition. It is the read side of a ZebraNet feature. A printer with no configured alerts does not answer the command.

Syntax

~HU

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.

Returns the alert routing ^SX sets, over the printer's link. Alerts are a ZebraNet feature with no counterpart in a render request. 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

~HU takes no arguments.

Behavior

The reply is one line per configured condition, in ^SX's argument order: condition, destination, condition-set flag, condition-clear flag, destination address, port. So B,C,Y,Y,ADMIN@COMPANY.COM,0 sends ribbon-out to an e-mail address, and reports both the arrival and the clearance of the condition. The guide states that a printer with no ^SX alerts does not respond.

An alert describes a printer that monitors itself over a network. A render request has no alert table and no link to return one on. 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

Reading the alert table alongside ordinary content. Only the content prints.

^XA
~HU
^FO50,50^A0N,40,40^FDAlert config^FS
^XZ

Open in viewer

  • ^SX Set AlertConfigures where the printer reports an error condition: serial, parallel, email, TCP, UDP or SNMP.
  • ~HS Host Status ReturnSends three status strings describing the printer's current state back to the host.
  • ~HQ Host QuerySends one of ten named printer reports back to the host.