DevicesReserved Keys for Detailed Status for Zebra Devices

The following reserved keys can be used to refer to detailed device data retrieved from a Zebra device by using a detailedDeviceStatus or detailedDeviceInfo business rule component. For examples, see Retrieve Detailed Device Status (XML).

Important! The detailedDeviceStatus and detailedDeviceInfo business rule components are supported for use only with Avery Dennison, cab, Datamax-O'Neil, Epson, Intermec IPL, Loftware, NOVEXX Solutions, PCL, Printronix, QuickLabel, SATO, Toshiba, and Zebra devices.

Important! Content in a business rule is case sensitive. This includes business rule component names, attributes, and values.

Note: It is recommended that Zebra ZPL II devices use x.17 or later firmware. For Zebra font commands, x.14 or later firmware is required. Loftware Enterprise SP supports Zebra ZPL II devices with x.10 or later firmware.

Device Status Data

The following reserved keys can be used to refer to detailed device data retrieved from a Zebra device by using a detailedDeviceStatus business rule component.

Reserved Key Description
DDS_BUFFERFULL

Whether all of the device's internal memory is in use. No more jobs can be sent until some internal memory is freed for use.

true: All memory is in use

false: Some memory is free

DDS_DIAGNOSTICMODE

Whether the device is in a diagnostic mode that may be helpful when troubleshooting problems with the device.

true: In diagnostic mode

false: Not in diagnostic mode

DDS_LABELLENGTH The length in dots of media for which the device is configured.
DDS_LABELSINBUFFER For the current job, the number of labels in the receive buffer.
DDS_LABELSREMAINING For the current job, the number of labels remaining to be printed.
DDS_LABELWAITING

Whether a printed label is waiting to be peeled off or torn off and removed from the device.

true: A label is waiting

false: No label is waiting

DDS_MEDIATYPE

The printing method used by the device, such as Direct Thermal (no ribbon) or Thermal Transfer (ribbon).

Values: DIRECT_THERMAL, THERMAL_TRANSFER

Tip: You can configure the Media Type in the Media Options tab. For more information, see Media Options for Zebra Devices.

DDS_OVERTEMPERATURE

Whether the print head is hotter than recommended for operation.

true: Too hot

false: Normal temperature or too cool

DDS_PAUSED

Whether the device has been manually paused.

true: Paused

false: Not paused

DDS_PRINTMODE

The Print Mode for which the device is configured. This mode determines the action the device takes after a label or group of labels has been printed.

Values: TEAROFF, PEELOFF, PEELOFF_PREPEEL, REWIND, APPLICATOR, CUTTER, CUTTER_DELAYED, RFID, DO_NOT_SEND, KIOSK_CUT

Tip: You can configure the Print Mode in the Options tab. For more information, see Options for Zebra Devices.

DDS_RAMERROR

Whether the device memory is corrupt and the device will remain in an error state until the problem is corrected.

true: Device memory is corrupt

false: Device memory is not corrupt

DDS_UNDERTEMPERATURE

Whether the print head is cooler than recommended for operation.

true: Too cool

false: Normal temperature or too hot

Common Reserved Keys for Device Status

These keys are available for most devices supported by Loftware Enterprise SP.

Reserved Key Description

DDS_CONNECTIONERROR

Whether any connection errors have occurred.

true: Connection errors occurred

false: No connection errors occurred

DDS_ENABLED

Whether Detailed Device Status reporting is enabled for this device in Loftware Enterprise SP.

true: Enabled

false: Disabled

DDS_FATALERRORS

Whether any errors that would prevent printing occurred.

true: Errors that prevent printing occurred

false: No errors that prevent printing occurred

Note: Not supported on Avery Dennison, NOVEXX Solutions, PCL, QuickLabel, or Toshiba devices.

DDS_PAPERERROR

Whether the device is out of label stock.

true: Out of stock

false: Not out of stock

Note: Not supported on Avery Dennison, NOVEXX Solutions, PCL, QuickLabel, or Toshiba devices.

DDS_PRINTHEADERROR

Whether the print head is up and not ready for printing.

true: Print head is up, not ready to print

false: Print head is down, ready to print

Note: Not supported on Avery Dennison, NOVEXX Solutions, PCL, QuickLabel, or Toshiba devices.

DDS_RAWDATA

The raw data (base 64 encoded) returned from a call to retrieve detailed device status from this device by using a business rule.

DDS_RIBBONERROR

Whether the device is out of ribbon.

true: Out of ribbon

false: Ribbon available

Note: Not supported on Avery Dennison, NOVEXX Solutions, PCL, QuickLabel, or Toshiba devices.

DDS_SUPPORTED

Whether Detailed Device Status reporting is supported and enabled for this device in Loftware Enterprise SP.

true: Supported and enabled

false: Not supported, disabled, or both

Device Information Data

The following reserved keys can be used to refer to detailed device data retrieved from a Zebra device by using a detailedDeviceInfo business rule component.

Reserved Key Description
DDI_FIRMWAREVERSION The version number of the firmware installed for the device.
DDI_HARDWAREMODEL The model name or model number of the device.
DDI_PRINTHEADRESOLUTION

The resolution configured for the device in dots per millimeter.

DDI_RESOLUTION

The resolution configured for the device in Dots Per Inch (dpi).

Tip: You can configure the Device Resolution in the Options tab. For more information, see Options for Zebra Devices.

DDI_TOTALMEMORY

The amount of memory existing in the device. This includes both available memory and memory that is in use or otherwise unavailable.

Common Reserved Keys for Device Information

These keys are available for most devices supported by Loftware Enterprise SP.

Reserved Key Description

DDI_CONNECTIONERROR

Whether any connection errors have occurred.

true: Connection errors have occurred

false: No connection errors have occurred

DDI_DEVICEFAMILY

The name of the device family in Loftware Enterprise SP.

DDI_DEVICEMODEL

The model of the device in Loftware Enterprise SP.

DDI_ENABLED

Whether Detailed Device Info reporting is enabled for this device in Loftware Enterprise SP.

true: Enabled for this device.

false: Disabled for this device.

DDI_RAWDATA

The raw data (base 64 encoded) returned from a call to retrieve detailed device information from this device by using a business rule.

DDI_SUPPORTED

Whether Detailed Device Info reporting is supported and enabled for this device in Loftware Enterprise SP.

true: Supported and enabled for this device.

false: Not supported, disabled, or both for this device.