3-7-2 Displaying and Configuring the Operating Environment Settings

You can configure the following settings in each tab of Operating Environment Settings:

SVF directory Tab

The SVF directory tab shows the directory that contains main files for SVF for Java Print such as the operating environment settings files and Java libraries.

SVF directory tab

Barcode Tab

Use the Barcode tab to specify the format for printing barcodes on forms.

Barcode tab

Check data length
  • Enable (Data length <= Barcode length - Start / Stop)
    No barcode will be printed if the number of digits of the output data (including start/stop characters) exceeds the designed number of digits. Printing will be continued but no barcode will be output.
  • Disable
    Barcodes are output regardless of the number of digits.
Printing when designed number of characters and data length differs Specify how to print barcodes when the number of digits of the output data is different from the designed number of digits.
  • Display by adjusting element width based on the barcode length
    Adjusts the width of each element regardless of the number of output digits so that the data fits in the designed barcode width. Therefore, barcodes are always printed with nearly the same width.
    However, if Disable is selected for Check data length and the number of output digits is greater than the designed number of digits, the width of elements becomes thinner, and no barcode will be printed when the specific barcode density is exceeded.
  • Print with designed element width
    Always uses the designed element width. The width of barcodes changes according to the number of output digits.
Vertical text direction (Counterclockwise)
  • 90 degrees (First character at the bottom)
    The first digit is at the bottom.
  • 270 degrees (First character at the top)
    The first digit is at the top.
Printing of human-readable characters
  • Start / Stop Character
    • Enable
      Prints start/stop characters for NW7 and CODE39.
    • Disable
      Does not print start/stop characters.
  • Check character
    • Enable
      Prints check characters for CODE39 with check digit, JAN/EAN-13, and JAN/EAN-8.
    • Disable
      Does not print check characters.

Link field Tab

When a text string is output to a field with a link destination set, if the string length exceeds the number of digits (print) or the number of digits (data), the overflowed data will be output to the link destination. To divide data at a specific position, insert a delimiter.

Link field tab

Delimiter settings
  • Enable
    Enables the Delimiter and Separation rule settings shown below.
  • Disable
    Does not set delimiter conditions.
Delimiter Specify the delimiter(s) from the list.
If you specify multiple delimiters, they will be processed using the OR condition. If you select Etc., you can specify any character or string in the input field.
Note

The character code of delimiters is UTF-8.

Separation rule Specify how to handle the delimiter.
  • Remove the delimiter and split
    Does not include the delimiter in the divided strings.
  • Split before the delimiter
    Places the delimiter as the first character of the following string in the set of divided strings.
  • Split after the delimiter
    Places the delimiter as the last character of the preceding string in the set of divided strings.

Environment Variables (Environment variables / TextFrame Tab)

You can use this tab to specify the path that SVF for Java Print uses to search XML form files and images and the path for text frames. The search path specified on this tab is added to the system environment variable PATH while SVF for Java Print is working.

Search path setting screen

Search path
  • Enable
    Specify the search path(s) for XML form files and image files used for printing, as well as data files for various utilities. To specify multiple paths, separate them with a half-width comma (,).
    The paths specified here will be searched with a higher priority.
  • Disable
    Search paths are not specified.
Note

Since a half-width comma (,) is treated as a path delimiter, you cannot use a half-width comma for a path name.

Registering or Deleting Search Paths from a Window

You can specify search paths not only by directly typing them in the input field but also by visually searching for the paths using the Select the search directory window. You can also display or delete paths that have already been registered.

1.

Click the button on the right edge of the Search path input field to open the Select the search directory window.

Select the search directory window

2.

Select the search directory from the directory tree in the upper part of the window and click the Add button.
The path of the added folder appears in List of Candidate Folders in the lower part of the window.
To register multiple search paths, repeat Step 2.

3.

If you have specified multiple search paths, searching is performed according to the order shown in List of Candidate Folders (from top to bottom).
To change the search order, select a folder path that you want to move, and click the Move Up or Move Down button.

4.

If search paths are already specified, the paths appear in List of Candidate Folders when you open the Select the search directory window.
Select a folder path that you want to delete, and click the Delete Selected Row button. To delete all paths under Folder Path in List of Candidate Folders, click the Delete All Rows button.

5.

Click the OK button to confirm the settings in List of Candidate Folders. Click the Cancel button to cancel the settings.

TextFrame (Environment variables / TextFrame Tab)

TextFrame setting screen

Font setting You can use this setting to match the pitch information of the characters used in a text frame between the following different output results:
  • Images drawn on the design screen of SVF Designer
  • Test print from SVF Designer
  • Output result from SVF for Java Print

Specify the names, paths, and table numbers of the fonts used in the text frame in the format of "[<font_name>,<font_path>,<font_table_number>]," separating each font specification with a comma (,).

  • <font_name>
    The name of the font designed in the text frame.
  • <font_path>
    Specify the path of the font file to embed. Specify the absolute path in the SVF for Java Print execution environment. Specify the alternative font path to use the font on UNIX.
  • <font_table_number>
    The number indicating at which position the font is located in TTC (True Type Collection). Always set to "1" except when the font file is TTC.
Setting example for Windows OS:
["MS Mincho","C:\Windows\Fonts\msmincho.ttc",1],
["MS Gothic","C:\Windows\Fonts\msgothic.ttc",1],
["Courier New","C:\Windows\Fonts\cour.ttf",1],
["MS P Mincho","C:\Windows\Fonts\msmincho.ttc",2],
["MS P Gothic","C:\Windows\Fonts\msgothic.ttc",2],
["OCRB","C:\Windows\Fonts\OCRB.TTF",1]
Setting example for Unix/Linux OS:
["MS Gothic"," <JRE_installation_directory>/jre/lib/fonts/SUJPGBF.TTF",1],
["MS Mincho"," <JRE_installation_directory>/jre/lib/fonts/SUJPMLF.TTF",1],
["SUGothic"," <JRE_installation_directory>/jre/lib/fonts/SUJPGBF.TTF",1],
["SUMincho"," <JRE_installation_directory>/jre/lib/fonts/SUJPMLF.TTF",1],
["SUPGothic"," <JRE_installation_directory>/jre/lib/fonts/SUJPGBP.TTF",1],
["SUOCR-B"," <JRE_installation_directory>/jre/lib/fonts/SUOCRB.TTF",1],
["SUEuropeanR"," <JRE_installation_directory>/jre/lib/fonts/SULT1MIN.TTF",1],
["SUPMincho"," <JRE_installation_directory>/jre/lib/fonts/SUJPMLP.TTF",1]

Change the above settings according to your environment.
If you do not configure this setting, misalignment may occur in output results.

Debug settings Tab

Debug settings tab

Debug mode Specify whether or not to enable the debug mode.
  • ON
    Enables the debug mode. You can specify Destination directory and Debug level.
  • OFF
    Disables the debug mode.
Destination directory Specify the name of the directory to which you want to output the debug log for an executed printing process.
Click the button to open the Select the destination directory window. In the Select the destination directory window, select the directory in the same manner as in the Select the search directory window and click the OK button to specify the output destination.
Hint

The debug log is output for each executed process as a text file named "svf_<number>.txt." If no output destination directory is specified or an invalid directory is specified, the log is output to the directory specified by the Java runtime environment system property "java.io.tmpdir."
"java.io.tmpdir" is a system property you can specify as a Java startup option. The default location is "%windir%\Temp" in Windows and "/tmp" or "/var/tmp" in UNIX/Linux.

Debug level Specify the debug level.
Select necessary debug levels only, because performance may be degraded when the debug mode is enabled.
Levels 1, 2, 10, and 11 are specified by default. You should specify other levels only when you are directed to do so by the support center during troubleshooting.

SVF spooler settings Tab

Configure the SVF Spooler settings. For details on SVF Spooler, see "Chapter 5 Managing Spooling With SVF Spooler."

SVF spooler settings tab

Destination
  • Host
    Specify the IP address of the machine where the spooler daemon is running.
    Spooling to another host is not possible. Specify the local host or its own network address.
  • Port
    Specify the port number of the machine where the spooler daemon is running.
Save spool file
  • Save destination
    Specify the directory in which you want to save spool data. The executing user of the spooler needs the write permission.
    If nothing is specified, the SvfSpooler directory is created under the system default temporary directory and the spool data is saved in that directory.
Log
  • Log level
    Select the log level used for outputting the log from EMERG, ALERT, CRIT, ERR, WARNING, NOTICE, INFO, and DEBUG.
    Level specification is based on syslog.
  • Debug log type
    Specify what types of logs to output when you output the debug log.
    You can specify the following types. Select any combination of these types as necessary.
    • Standard debug
    • Print
    • Command
    • Job
    • Printer status
    • TCP
    • UDP
    • SNMP
    • Detail debug
    • Spool data

    If you select DEBUG in Log level, Standard debug is always enabled.

  • Log output to stdout
    Specify whether or not to output the log to "stdout."
  • Log output to stderr
    Specify whether or not to output the log to "stderr."
  • Log output to syslog server
    Specify whether or not to output the log to "syslog."
  • Syslog server
    Specify the syslog server when you output the log to "syslog."
  • Facility
    Specify the facility when you output the log to "syslog."
  • Log output to file
    Specify whether or not to output the log to a "local file."
  • Directory to save
    Specify the output destination directory when you output the log to a "local file."
    If nothing is specified, the SvfSpoolerLogs directory is created under the system default temporary directory and the log is output to that directory.
  • Number of days to retain
    Specify the number of days to retain the log when you output the log to a "local file."
  • Character encoding
    Specify the output encoding to use when you output the log to a "local file."
    If the specified encoding cannot be used, UTF-8 will be used.
Setting at abnormal
  • Stop the printer when an error occurs
    Specify whether or not to stop the printer when printing terminates abnormally.
    • Enable   Sets the printer to a suspended state when printing terminates abnormally.
    • Disable   Attempts to print the abnormally terminated document again.
  • Behavior when error occurs
    Specify the behavior when an error occurs while print data is being sent.
    You can specify this setting only when you set Stop the printer when an error occurs to Disable.
    • Abort   Sets the printer into a suspended state.
    • Skip   Skips to the next job.

    In either case, the job where the error occurred will be set to "Abnormal termination."

  • Destination for abnormal termination log
    Specify the output destination file for the "abnormal termination log."
    If nothing is specified, the "abnormal termination log" will not be output.
Advanced settings
  • Behavior for testing
    Specify whether or not to delete the file without printing.