Basic Information

Current version and download

Installation requirements

1. IBM i V7R1 with Option 39 - "International Components for Unicode" - More information about Option 39 can be found at hier
2. Toolmaker Installation Manager (TIM) - More information about TIM can be found here hier
3. Toolmaker WOPiXX Version 2.34 - More information about WOPiXX can be found at hier
4. Hardware für das Faxen or a connection to the fax service provider Retarus GmbH
5. If you want to use the directfax Windows Client to send documents from Microsoft Office, then you must have the 32bit version of Microsoft Office must be installed on the PC. Please refer to the page Microsoft Office 32bit-Version for the Toolmaker Windows Clients.

You can determine the version you have installed:

directfax Lite vs. full version

directfaxLite is a functionally limited but inexpensive version of directfax.

The following functions are available in the Lite version not available:

• The automatic incoming fax distribution
• The AutoFax function (autom. fax sending without programming)
• The options for designing fax documents described in the manual in the chapter Creating mixed faxes (landscape fax, font selection, line and box commands, graphics positioning)
• The sending of spool files with *AFPDS, *USERASCII or *ADVSCS data stream.
• The image display on a 3489 screen.

The directfax/PC component can be licensed in conjunction with the Lite version without any functional restrictions.

Installation

Initial installation and upgrade on IBM i

The installation and update on IBM i is done via theToolmaker Installation Manager (TIM)

• The order is INSTALL_PRODUCT
• The product to be specified is DIRFAX

Initial installation and update of the various clients

The procedure for installing and updating the directfax Windows client is described on the directfax - Installation der Clients described

Steps after a release upgrade or change to a new IBM i system

Initialization with INZDIRRFAX

After a release upgrade or after switching to a new IBM i - system the product has to be initialized.

If points 1 and 2 are valid, then enter these commands:

ADDLIBLE DIRECTFAX
CALL INZDIRFAX

copy directfax commands to QUSRSYS (or other library)

If the directfax commands, e.g. WRKFAXSTS, WRKINCFAX, etc. are not (anymore) in QUSRSYS, then they can be copied there with this command:

ADDLIBLE DIRECTFAX
CALL CPYFAXCMD QUSRSYS

Instead of the QUSRSYS, the name of another library (QGPL, or your own library) can also be specified.

IBM i - Re-enable configuration for the directfax Windows client

If the Windows client is in use the environment of the job TCPSERVER must be restored after a release upgrade or changeover:

ADDLIBLE DIRECTFAX
CALL CFGTCPFAX

If there are problems on the Windows clients afterwards, please read the section Installation des directfax Windows-Clients section.

Copy commands into the QUSRSYS

Libraries and IFS directories (take into account when backing up data)

Libraries on IBM i

• DIRECTFAX
• DIRECTFAXF

IFS directory

• /Toolmaker/DirectFax400

And of course the libraries and directories of WOPiXX.

Weitere Dokumentation zu directfax

Fehlersuche und -behebung für directfax

Fehlersuche und -behebung TCUx

Versions and compatibility

IBM i

Further information about the versions

• Fax transmission via the service provider Retarus is supported as of version 5.92. Further information about the directfax-Retarus connection

Windows Client

Steps after an IBM i release upgrade or change of IBM i hardware

After a release change the product must be initialized:

1. ADDLIBLE DIRECTFAX
2. CALL INZDIRFAX
3. Make sure that the directfax subsystem is started after each IPL:
   1. STRDIRFAX

If the PC client is in use, the environment of the job TCPSERVER has to be restored after a release change or upgrade:

1. ADDLIBLE DIRECTFAX
2. CALL CFGTCPFAX
3. Make sure that after each IPL the directfax PC - server job is started:
   1. ADDLIBLE DIRECTFAXF
   2. STRSRV

If there are problems working with the directfax PC client even after following these steps, please check the installation by means of the page directfax - Installation des Clients.

Notes on licensing

directfax can be used in different expansion stages with more or less functionality. The functionality is realized by license models. By entering the appropriate license, the function is activated.

After the first installation directfax can be tested for a maximum of 30 days without licensing.For more information, please visit Lizenzdatei.

directfax shareware function

directfax is delivered with a usage limitation, which allows to send faxes even without a To send faxes without a license. This option, called shareware, is intended for interested parties to "try it out" and allows the sending of 5 Faxes daily. After that the control program terminates and some menu items are blocked. The next day directfax can be started normally again.

The functional range of shareware includes that of the directfax Lite version. Therefore the functions AutoFax, automatic incoming fax distribution, image display and MIX commands are blocked if no valid license for the system has been entered or the test time has expired!

The license file and the backup

The IFS directory /Toolmaker/Directfax400 also contains important data for directfax, depending on the configuration and your usage habits. Please take this into account in your daily data backup.

Show active licenses and options

Which licenses and options are active on your system is displayed with these commands:

ADDLIBLE DIRECTFAX
DSPLICINFO *FULL

Available license options for directfax

ARCH archiving interface

BASE basic version

DIST Fax reception and distribution in the BASE version

EDIT spool preparation/autofax in BASE version

EML Email dispatch

FONT Font generator

FULL Full version

GZ Charge counting with certain hardware

IFS IFS Monitor (WOPiXX required/browser operation)

LITE Limited Lite Version

MLIN Additional lines/multiline

NETW Network component

OEM Special OEM license

PC PC client license

PCL conversion of SPLFs with USERASCII data stream

RETA Retarus interface (Internet fax service)

SHR Shareware License (autom. 5 faxes per day)

SIGN Digital signature

Uninstallation of IBM i software

If you want to stop using directfax on your system, you have to make sure that the Library names DIRECTFAX or DIRECTFAXF no longer appear in

• Job descriptions (JOBD)
• System values (e.g. QUSRLIBL)

Set all activities with Product, leave all fax menu displays with F3 and make sure that neither the library DIRECTFAX nor DIRECTFAXF is accessible Helpful can be the Auswahl 8 des TIM-Menüs which shows you for a library if and which objects are still locked by which jobs.

Then enter the following command:

CALL DIRECTFAX/DROPDIRFAX

The program copies itself to the library QUSRSYS and starts the copy in the QUSRSYS with the command SBMJOB, so that the whole deletion action runs in the background. Deleting all directfax objects can take 10-15 minutes. A final message is sent to the QSYSOPR message queue (text: - DIRECTFAX DROPPED - JOBLOG PRINTED -)

License code backup for high availability, mirroring, backup

From version 6

The certificate file (e.g. License_DIRFAX_06_65481XX.txt) is stored IFS directory /Toolmaker of your IBM i. Since the file name contains the serial no. of the associated system, no special action is required here during mirroring. The license files of the production and backup machine can be placed in the same directory /Toolmaker.

Up to and including version 5.92

In the context of a high availability solution with mirroring of the objects, the license code of directfaxon the backup machine is always overwritten with that of the production machine.

This can be prevented by using the License objects for directfax removed from mirroring.

When transferring libraries from production systems to backup systems, the following license code objects must not be synchronized as well, or must be restored from a backup after synchronization on the backup system.

License code objects directfax:

Library Object type Object name
DIRECTFAX *USRSPC DF*