22 | 08 | 2014

Knowledge Base

This section contains miscellaneous information about YajHFC not included in the FAQ or other documentation.

If you did not find the answer you were looking for here, please also see the FAQ and the yajhfc-user mailing list archive.

Automated installation using logon.bat

This article contains a short example on how to automatically install YajHFC using a Windows domain logon.bat script. It has been contributed by Stefan Agethen.

Read more: Automated installation using logon.bat

Comparison of Windows fax printer options

Starting with version 0.5.2 the setup of YajHFC has three options for creating a fax printer. This article tries to give a short comparison to help you decide which one to choose.

Read more: Comparison of Windows fax printer options

Defining custom Modem names

In YajHFC, you can define custom modems. This can be useful in one of the following scenarios:

  • You would like to give your modems custom names instead of the default HylaFAX names (e.g. "Company A" for ttyS0, "Company B" for ttyS1)
  • You would like to make HylaFAX modem groups selectable in YajHFC.

To define custom modems, do the following steps:

  1. In the options dialog go to the Modems panel for the desired server.
  2. Check the Use the following list of modems option.
  3. Add/Modify/Remove the modems in the table as you like.
    For example: Enter the description "Company X" for the Modem with HylaFAX name "ttyS0". there).
    To add a modem group here, add a new line to the table and enter the group's name as defined in the HylaFAX configuration as HylaFAX name (similar to the predefined any modem).
  4. Click OK. You should now be able to see the modems you have defined in the modem selection list of the send dialog.

Error "All fill bits preceding EOL code must be 0."

Problem

If you are using YajHFC 0.5.2 or higher with the PDF plugin you may get the following (or a similar) exception when trying to view a received fax:

An error occured displaying the fax "faxNNNNNNNNN.tif":
All fill bits preceding EOL code must be 0.

java.lang.RuntimeException: All fill bits preceding EOL code must be 0.
    at com.itextpdf.text.pdf.codec.TIFFFaxDecoder.readEOL(TIFFFaxDecoder.java:1307)
    at com.itextpdf.text.pdf.codec.TIFFFaxDecoder.decode2D(TIFFFaxDecoder.java:797)
    at com.itextpdf.text.pdf.codec.TiffImage.getTiffImage(TiffImage.java:237)
    at com.itextpdf.text.pdf.codec.TiffImage.getTiffImage(TiffImage.java:106)
    at yajhfc.file.pdf.ITextTIFFFileConverter.convertToHylaFormat(ITextTIFFFileConverter.java:65)
    at yajhfc.file.MultiFileConverter.convertMultipleFiles(MultiFileConverter.java:102)
    at yajhfc.file.MultiFileConverter.convertMultipleFilesToSingleFile(MultiFileConverter.java:187)
    at yajhfc.file.MultiFileConverter.viewMultipleFiles(MultiFileConverter.java:162)
    at yajhfc.MainWin$ShowWorker.doWork(MainWin.java:491)
    at yajhfc.util.ProgressWorker.run(ProgressWorker.java:189)

Read more: Error "All fill bits preceding EOL code must be 0."

Installing a SSL certificate in Java

When your mail server has a self signed certificate, you may get an exception like the following when trying to send a mail using the YajHFC mailer plugin:

javax.mail.MessagingException: Could not convert socket to TLS;
  nested exception is:
  javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

[...]

Read more: Installing a SSL certificate in Java