Specifications
ZPL Commands
^HW
176
45541L-004 Rev. A ZPL II Programming Guide 9/15/06
^HW
Host Directory List
Description ^HW is used to transmit a directory listing of objects in a specific memory area
(storage device) back to the host device. This command returns a formatted ASCII string of
object names to the host.
Each object is listed on a line and has a fixed length. The total length of a line is also fixed.
Each line listing an object begins with the asterisk (*) followed by a blank space. There are
eight spaces for the object name, followed by a period and three spaces for the extension. The
extension is followed by two blank spaces, six spaces for the object size, two blank spaces, and
three spaces for option flags (reserved for future use). The format looks like this:
<STX><CR><LF>
DIR R: <CR><LF>
*Name.ext(2sp.)(6 obj. sz.)(2sp.)(3 option flags)
*Name.ext(2sp.)(6 obj. sz.)(2sp.)(3 option flags)
<CR><LF>
-xxxxxxx bytes free
<CR><LF>
<ETX>
<STX> = start of text
<CR><LR> = carriage return/line feed
<ETX> = end on text
The command might be used in a stand-alone file to be issued to the printer at any time. The
printer returns the directory listing as soon as possible, based on other tasks it might be
performing when the command is received.
This command, like all ^ (caret) commands, is processed in the order that it is received by the
printer.
Format ^HWd:o.x
This table identifies the parameters for this format:
Parameters Details
d = location to
retrieve object
listing
Accepted Values: R:, E:, B:, A:and Z:
Default Value: R:
o = object name Accepted Values: 1 to 8 alphanumeric characters
Default Value: asterisk (
*). A question mark (?) can also be used.
x = extension Accepted Values: any extension conforming to Zebra conventions
Default Value: asterisk (
*). A question mark (?) can also be used.