1. ZPL II, ZBI 2, Set-Get-Do, Mirror, WML Programming Guide
  2. ZPL II, ZBI 2, Set-Get-Do, Mirror, WML Programming Guide
  3. ZPL Commands
  4. ^HW
  • ZPL II, ZBI 2, Set-Get-Do, Mirror, WML Programming Guide
^HW

^HW

^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.

Host Directory List

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
Parameters
Details
d =
 location to retrieve object listing
Values:
R:
,
E:
,
B:
,
A:
and
Z:
Default:
R:
o =
 object name
Values:
1
 to
8
 alphanumeric characters
Default:
 asterisk (
*
). A question mark (
?
) can also be used.
x =
 extension
Values:
 any extension conforming to Zebra conventions
Default:
 asterisk (
*
). A question mark (
?
) can also be used.
f =
 format
The
f
 parameter is only supported in firmware version V60.16.0Z and V53.16.0Z or later.
Values:
c =
 column format
d =
 default format
Default:
d
Example:
 Listed is an example of the
^HW
 command to retrieve from information
R:
^XA
^HWR:*.*
^XZ
The printer returned this information as the Host Directory Listing:
-DIR R:*.*
*R:ARIALN1.FNT 49140
*R:ARIALN2.FNT 49140
*R:ARIALN3.FNT 49140
*R:ARIALN4.FNT 49140
*R:ARIALN.FNT 49140
*R:ZEBRA.GRF 8420
-794292 bytes free R:RAM