DevicesAdvanced Options for PCL 5e Devices

If the Family selected is PCLClosed Printer Command Language, a printer control language from Hewlett-Packard. and the Model selected is PCL 5e, the Advanced tab displays the following options. For more information about drivers and Loftware Enterprise™ SP, see Managing Devices.

Advanced Options

Option Description Values

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.

Send 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)

Use Macros

Whether to use a set of PCL commands (Macro) that have been downloaded and stored in a printer's memory.

Cleared: Do not use Macros

Selected: Use Macros configured on the device (Default)

Merge Macro Images

Whether to merge all images (barcodes, TrueType® Font text fields, etc.) into a single image and then store that single image in the macro, or add each image to the macro individually. The number of images allowed to be stored in a macro depends on the device.

Cleared: Do not merge Macro images (Default)

Selected: Merge Macro Images

Minimum Labels for Macros

The minimum number of labels that must print to use macros.

Default: If less than 2 labels are printed, do not use macros.

1 to 65536

Default: 2

Macro ID

The identification number of the Macro, used to invoke its use.

1 to 32767

Default: 10

Macro Error Action

What Loftware Enterprise SP should do in the case of a Macro error.

Use Global Setting

Do Nothing

Log Warning

Fail Print Job

Default: Use Global Setting

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 System Management 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 System Management 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

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.

Cleared: The PDF file is converted to an image and sent to the device to be printed and the DSOsClosed 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.

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.

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.