zpl.tools
Printer configuration

^SQ - Halt ZebraNet Alert

Stops or restarts the alerts `^SX` configured, without discarding their configuration.

^SQ stops the alerts ^SX configured and starts them again, and leaves their configuration alone. It is the pause button for the ZebraNet alert system, not a way to remove an alert. The destination, the address and the port all survive a halt.

Syntax

^SQa,b,c

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.

Alerts travel on a printer-to-host channel, and nothing they carry reaches the label. 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

aConditionrequired · one of a set

Which error condition's alert to stop or start. * covers all of them.

Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command. The guide gives no default.
Test coverage
No documented value is exercised by a test (A-W, *).
A-W
A single error condition, identified by letter
*
Every error condition
bDestinationrequired · one of a set

Which alert destination to stop or start.

Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command. The guide gives no default.
Test coverage
No documented value is exercised by a test (A, B, C, D, E, F, *).
A
Serial port
B
Parallel port
C
Email
D
TCP
E
UDP
F
SNMP
*
Every destination
cStopoptional · Y or N

Whether the command stops or restarts the matching alerts.

Default
Y
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 (Y, N).
Y
Stop the alerts (default)
N
Start them again

Behavior

Both selectors accept *, which is the usual form: ^SQ*,*,Y stops everything and ^SQ*,*,N starts everything again. Narrower combinations halt one condition on one destination, and the condition letters are the same set ^SX uses — see that command for each letter.

An alert travels a printer-to-host channel and nothing it carries reaches the label, so the renderer ignores this command. ^SQ also needs a prior ^SX to have any effect on hardware, because otherwise no alert exists to halt.

Example

Every alert on every destination halted:

^XA
^SQ*,*,Y
^FO50,50^A0N,30,30^FDAlerts halted^FS
^XZ

Open in viewer

  • ^SX Set AlertConfigures where the printer reports an error condition: serial, parallel, email, TCP, UDP or SNMP.
  • ^JH Early Warning SettingsConfigures the consumable and maintenance warnings the printer reports as media, ribbon and printhead wear out.
  • ^NT Set SMTPPoints the printer at an SMTP server so it can e-mail alerts.