Advanced Options for Printronix Devices

If the Family selected is Family Driver and the Model selected is PGL Printronix Graphics Language, a printer language from Printronix., then the Advanced tab displays the following options. Some options may not be relevant to some device models.

If the Family selected is Printronix 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.

Advanced Options

Option	Description	Values
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)
Error Report	Configure error reporting for the device.	Debug: The device is put in debug mode whenever a label template is received for printing. Each label is printed. If a printer language error occurs, the error is also printed on the media. Fault: If a printer language error occurs, the error is printed on the media, the message IGP Error is displayed on the front panel, and then the printer goes offline. The error must be cleared before the printer can resume normal operation. Off: Physical boundary checking is turned off. If a field extends beyond the page boundary, it is clipped. (Default) On: Physical boundary checking is performed. If a field extends beyond a page boundary, it is reported as an error.
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.

Option

Description

Values

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.

Cleared : Use device options configured on the device.

Selected : Send all device options configured in Loftware Enterprise SP to the device. (Default)

Error Report

Configure error reporting for the device.

Debug: The device is put in debug mode whenever a label template is received for printing. Each label is printed. If a printer language error occurs, the error is also printed on the media.

Fault: If a printer language error occurs, the error is printed on the media, the message IGP Error is displayed on the front panel, and then the printer goes offline. The error must be cleared before the printer can resume normal operation.

Off: Physical boundary checking is turned off. If a field extends beyond the page boundary, it is clipped. (Default)

On: Physical boundary checking is performed. If a field extends beyond a page boundary, it is reported as an error.

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

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

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.