Advanced Options for Toshiba Devices

If the Family selected is Family Driver and the Model selected is TPCL Tec Printer Command Language, a programming language from Toshiba for communication between a computer and a printer., then the Advanced tab displays the following options. Some options may not be relevant to some device models.

If the Family selected is Toshiba 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
Command Codes	The characters to indicate the start of a command to the device, a separator between parts of a multi-part command, and the end of the command. Toshiba consoles may refer to this option as Control Character Mode.	{, \|, } ESC, LF, NUL Custom
Command Start Code	The hexadecimal code for the character to indicate the start of a command to the device. Note: This option is configurable only if Command Codes is set to Custom.	00 to FF Default: 7B
Command Separator Code	The hexadecimal code for the character to act as a delimiter between the parts of a multi-part command. Note: This option is configurable only if Command Codes is set to Custom.	00 to FF Default: 7C
Command End Code	The hexadecimal code for the character to indicate the end of a command to the device. Note: This option is configurable only if Command Codes is set to Custom.	00 to FF Default: 7D
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

Fine Adjustments

Option	Description	Values
Fine Adjustments	Whether to allow configuration of fine-tuning adjustments for the position of cut and strip operations, the label position before printing, and the length of backfeed after a cut or strip operation.	: Disable fine adjustments. (Default) : Enable fine adjustments.
Cut/Strip Fine Adjustment	The length by which to reposition the label before cutting the label or stripping the label from the backing paper. A positive value moves the cut or strip position forward. Note: This option is available only if Fine Adjustments is enabled.	-500 to 500 tenths of a millimeter Default: 0
Feed Fine Adjustment	The length by which to reposition the label before printing. A positive value moves the printing start position forward. Note: This option is available only if Fine Adjustments is enabled.	-500 to 500 tenths of a millimeter Default: 0
Backfeed Fine Adjustment	The length by which to reposition the label after a cut or strip operation. A positive value increases the backfeed, moving the label backward. Note: This option is available only if Fine Adjustments is enabled. Tip: The Backfeed Length option in the Options tab also configures the backfeed length. For more information, see Options for Toshiba Devices.	-99 to 99 tenths of a millimeter Default: 0

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.