Advanced Options for Zebra Devices

If the Family selected is Family Driver and the Model selected is ZPL II Zebra Programming Language II, a printer control language., then the Advanced tab displays the following options. Some options may not be relevant to some device models.

If the Family selected is Zebra and a specific model is selected, then only options appropriate to that model are displayed. For more information about drivers and Loftware Enterprise™ SP, see Managing Devices.

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.

Advanced Options

Option	Description	Values
Always Download Format	Whether the label template is sent with every print request.	: The label template is not sent. (Default) : The label template is sent.
Z64 Compression	Whether to use Z64 compression when sending labels to the device.	: Do not use Z64 compression. : Use Z64 compression. (Default)
Send Device Options	Whether to send device options configured in Loftware Enterprise SP to the device, or to use the device options configured on the device. When this check box is cleared, the options that are configured on the device are disabled in Loftware Enterprise SP.	: Use device options configured on the device. : Send all device options configured in Loftware Enterprise SP to the device. (Default)
Print Label As Image	Whether Loftware Enterprise SP should render the entire label as an image or generate each field individually. If individually, the field is rendered natively by the device if possible. If the device does not support native rendering of the field, then Loftware Enterprise SP generates an image for the field.	: Render fields individually. (Default if supported for device) : Render entire label as an image.

Device Contact

Loftware Enterprise SP can contact devices to request information. For each device, you can configure how long Loftware Enterprise SP waits for a response and whether Loftware Enterprise SP repeats the request if no response is received.

Note: These options are applied only when On-Demand Status or a business rule prompts Loftware Enterprise SP to request detailed status from a device. These options are not used when performing periodic device status checks.

Option	Description	Values
Read Retry Attempts Source	When Loftware Enterprise SP requests information from a device and does not receive a response, you can specify the maximum number of times that Loftware Enterprise SP should repeat the request. If the maximum number of retry attempts is made without receiving a response, Loftware Enterprise SP reports an error. This option allows you to configure whether the number of retry attempts is managed via a global setting or a value that you customize for this device. Tip: You can view the value of the global setting in System by clicking System Properties. For Namespace, enter deviceManagement to filter the list, and then view the system key named connection.readRetry.count.	Use Global Setting: The maximum number of retry attempts is specified by a global system key. (Default) Custom Value: The Read Retry Attempts option is displayed and overrides the global setting.
Read Retry Attempts	The maximum number of times that Loftware Enterprise SP should repeat a request to the device. Note: This option is displayed only if Read Retry Attempts Source is set to Custom Value.	0 to 10 retry attempts Default: 3
Read Wait Time Source	When Loftware Enterprise SP requests information from a device, you can specify how long Loftware Enterprise SP waits to receive a response from the device before repeating the request or reporting an error. This option allows you to configure whether the wait time is managed via a global setting or a value that you customize for this device. Tip: You can view the value of the global setting in System by clicking System Properties. For Namespace, enter deviceManagement to filter the list, and then view the system key named connection.readWait.time_msec. The value is in milliseconds.	Use Global Setting: The wait time is specified by a global system key. (Default) Custom Value: The Read Wait Time option is displayed and overrides the global setting.
Read Wait Time	How long Loftware Enterprise SP should wait to receive a response from the device before repeating the request or reporting an error. Note: This option is displayed only if Read Wait Time Source is set to Custom Value.	100 to 9999ms Default: 1000ms
Close Connection Wait Time Source	When a job is complete and Loftware Enterprise SP has issued a command to close the communication connection that was established with the device, you can specify how long Loftware Enterprise SP should wait to receive an acknowledgment from the device before reporting an error. This option allows you to configure whether the wait time is managed via a global setting or a value that you customize for this device. Tip: You can view the value of the global setting in System by clicking System Properties. For the Namespace, enter deviceManagement to filter the list, and then view the system key named socket.sotimeout.disconnect.time_sec. The value is in seconds.	Use Global Setting: The wait time is specified by a global system key. (Default) Custom Value: The Close Connection Wait Time option is displayed and overrides the global setting.
Close Connection Wait Time	How long Loftware Enterprise SP should wait to receive an acknowledgment from the device after sending a command to close the communication connection established for the job before reporting an error. Note: This option is displayed only if Close Connection Wait Time Source is set to Custom Value.	0 to 9999s Default: 0s If 0s is selected, Loftware Enterprise SP will wait indefinitely for a response.

Option

Description

Values

Read Retry Attempts Source

When Loftware Enterprise SP requests information from a device and does not receive a response, you can specify the maximum number of times that Loftware Enterprise SP should repeat the request. If the maximum number of retry attempts is made without receiving a response, Loftware Enterprise SP reports an error.

This option allows you to configure whether the number of retry attempts is managed via a global setting or a value that you customize for this device.

Tip: You can view the value of the global setting in System by clicking System Properties. For Namespace, enter deviceManagement to filter the list, and then view the system key named connection.readRetry.count.

Use Global Setting: The maximum number of retry attempts is specified by a global system key. (Default)

Custom Value: The Read Retry Attempts option is displayed and overrides the global setting.

Read Retry Attempts

The maximum number of times that Loftware Enterprise SP should repeat a request to the device.

Note: This option is displayed only if Read Retry Attempts Source is set to Custom Value.

0 to 10 retry attempts

Default: 3

Read Wait Time Source

When Loftware Enterprise SP requests information from a device, you can specify how long Loftware Enterprise SP waits to receive a response from the device before repeating the request or reporting an error.

This option allows you to configure whether the wait time is managed via a global setting or a value that you customize for this device.

Use Global Setting: The wait time is specified by a global system key. (Default)

Custom Value: The Read Wait Time option is displayed and overrides the global setting.

Read Wait Time

How long Loftware Enterprise SP should wait to receive a response from the device before repeating the request or reporting an error.

Note: This option is displayed only if Read Wait Time Source is set to Custom Value.

100 to 9999ms

Default: 1000ms

Close Connection Wait Time Source

When a job is complete and Loftware Enterprise SP has issued a command to close the communication connection that was established with the device, you can specify how long Loftware Enterprise SP should wait to receive an acknowledgment from the device before reporting an error.

This option allows you to configure whether the wait time is managed via a global setting or a value that you customize for this device.

Tip: You can view the value of the global setting in System by clicking System Properties. For the Namespace, enter deviceManagement to filter the list, and then view the system key named socket.sotimeout.disconnect.time_sec. The value is in seconds.

Use Global Setting: The wait time is specified by a global system key. (Default)

Custom Value: The Close Connection Wait Time option is displayed and overrides the global setting.

Close Connection Wait Time

How long Loftware Enterprise SP should wait to receive an acknowledgment from the device after sending a command to close the communication connection established for the job before reporting an error.

Note: This option is displayed only if Close Connection Wait Time Source is set to Custom Value.

0 to 9999s

Default: 0s

If 0s is selected, Loftware Enterprise SP will wait indefinitely for a response.

Pass Through File Types

You can configure Loftware Enterprise SP to pass an external file directly to a device without the need to associate the file with a label template. This allows you to print files that were created outside of Loftware Enterprise SP while still saving auditing data for the printed file. For example, you can select PDF under Pass Through File Types to print a PDF file from a public server or URL without creating or selecting a label template for printing.

Option	Description	Values
PDF	Whether PDF files are passed directly to your device.	: The PDF file is converted to an image and sent to the device to be printed and the DSOs Device Specific Option. Any option for a device that can be configured in Device Management. are referenced. (Default) : The PDF file is sent to the device to be printed as is and the DSOs are not referenced. Note: If a non-PDF file is sent to the device, then the printed results are indeterminate.

Option

Description

Values

PDF

Whether PDF files are passed directly to your device.

Cleared : The PDF file is converted to an image and sent to the device to be printed and the DSOs Device Specific Option. Any option for a device that can be configured in Device Management. are referenced. (Default)

Selected : The PDF file is sent to the device to be printed as is and the DSOs are not referenced.

Note: If a non-PDF file is sent to the device, then the printed results are indeterminate.

Advanced Troubleshooting

Option	Description	Values
Advanced Troubleshooting	Whether to display advanced troubleshooting options, including options for print stream scripting.	Disabled: Do not display advanced troubleshooting options, and do not run a print stream script for this device connection. (Default) Enabled: Display advanced troubleshooting options.

Option

Description

Values

Advanced Troubleshooting

Whether to display advanced troubleshooting options, including options for print stream scripting.

Disabled: Do not display advanced troubleshooting options, and do not run a print stream script for this device connection. (Default)

Enabled: Display advanced troubleshooting options.

Print Stream Scripting

This section is displayed only if the Advanced Troubleshooting option is enabled.

Tip: For assistance with print stream scripting, contact Loftware's Professional Services Group.

Option	Description	Values
Script Name	The name of the print stream script. Tip: This name may be included in log files, which may assist you if troubleshooting problems with the script.
Apply Script	Whether to run the print stream script. A print stream script is run just prior to sending data to a device. The effects of print stream scripting are reflected only in the print stream, not in the data map. Note: Regardless of whether Apply Script was selected, if the Advanced Troubleshooting option is disabled then the script is not run.	: Do not run the script. (Default) : Run the script.
Script	A print stream script written in JavaScript. Loftware Enterprise™ SP uses the Rhino JavaScript engine for Script data sources and supports both the Rhino and Nashorn JavaScript engines for use in scripts in business rules. Rhino is an open source JavaScript engine maintained by the Mozilla Foundation, and Nashorn is an open source JavaScript engine maintained by Oracle. These engines enable you to parse, compile, and run JavaScript statements. Note: JavaScript versions 1.3 and later conform to the Standard ECMA-262 ECMAScript Language Specification. For more about this specification, see "Scripting, Java, and XML" in External Links.

Option

Description

Values

Script Name

The name of the print stream script.

Tip: This name may be included in log files, which may assist you if troubleshooting problems with the script.

Apply Script

Whether to run the print stream script. A print stream script is run just prior to sending data to a device. The effects of print stream scripting are reflected only in the print stream, not in the data map.

Note: Regardless of whether Apply Script was selected, if the Advanced Troubleshooting option is disabled then the script is not run.

Cleared : Do not run the script. (Default)

Selected : Run the script.

Script

A print stream script written in JavaScript.

Loftware Enterprise™ SP uses the Rhino JavaScript engine for Script data sources and supports both the Rhino and Nashorn JavaScript engines for use in scripts in business rules. Rhino is an open source JavaScript engine maintained by the Mozilla Foundation, and Nashorn is an open source JavaScript engine maintained by Oracle. These engines enable you to parse, compile, and run JavaScript statements.

Note: JavaScript versions 1.3 and later conform to the Standard ECMA-262 ECMAScript Language Specification. For more about this specification, see "Scripting, Java, and XML" in External Links.