The SNDDOMFAX command allows you to fax OS/400 spooled files of type AFP or SCS directly from an OS/400 command line using Domino Fax for iSeries. This is sample code only.

July 26, 2002: This updated version of SNDDOMFAX supports multiple mail boxes.

(C) Copyright IBM Corp. 2000
All rights reserved.
US Government Users Restricted Rights -
Use, duplication, or disclosure restricted
by GSA ADP Schedule Contract with IBM Corp.

Licensed Materials - Property of IBM

Command requirements and restrictions

Transferring Files to your iSeries System

Using the SNDDOMFAX Command

Creating the SNDDOMFAX Command  (only necessary if you change the command)
 

• The SNDDOMFAX command makes use of Host Print Transform which requires that 5769SS1 Option 8 (AFP Compatibility Fonts) be installed on your system.
• A Domino server must reside on the same iSeries where the SNDDOMFAX command is run and the Domino server must have access to a Domino Fax server via foreign domains.
• The program SNDDOMFAX and the command source must be in the same library (QFXDTOOLS).

If you want to put them into a different library you can use the Change Command (CHGCMD) command to link the Command Processing Program with the Command.
• The Workstation Customization object, QFXDFINE, must be in the library QFXDTOOLS.
• The save file enclosed in the sndfax.zip file is a V4R5 save file.  It's contents have been compiled on a V4R5 system.  Therefore, the QFXDSAV file may only be restored on a V4R5 or later system, and the SNDDOMFAX command may only be compiled and run on V4R5 or later systems.
• User considerations:
• The user must be registered in the System Distribution Directory. Use the Add Directory Entry (ADDDIRE) command to do this if necessary.
• The PUBLIC authority to the SNDDOMFAX command is set to *EXCLUDE. Individuals who will run the command must be manually added to the authorization list for both the command.

This is necessary because users won't have access to some of the objects that SNDDOMFAX uses so it runs under user profile *OWNER(QSYS) instead of *USER. Use the Work with Authority command (WRKAUT) to authorize individuals or groups to run the command.
• You must either library qualify the call to SNDDOMFAX or add QFXDTOOLS to your library list.
• The use of Host Print Transform imposes the following restrictions on the content of the faxed spooled files:
• No support for Graphics Tower or GOCA
• To fax an overlay, you must use an *AFPDS spooled file (not *SCS)
• Font substitution may provide undesirable results
• 2UP and 4UP printing/faxing are not supported
• CHRSIZ keyword is not supported
• Host Print Transforms is CPU intensive and may affect overall system performance.

After downloading the sndfax.zip file and unzipping it, you have the following files on your workstation:

readme.html - the file you are currently reading
qfxdsav.bin - OS/400 save file of library QFXDTOOLS. This library contains all SNDDOMFAX objects and source.

  a.    Create an OS/400 library and save file in preparation for transferring qfxdsav to the iSeries.

For example, create a library called mylib and a save file in mylib called QFXDSAV on the iSeries system, as follows:

crtlib mylib
crtsavf mylib/qfxdsav

For example:

cd xxxx   [change to the directory on your workstation that contains the save file]

ftp [your iSeries system name or IP address]

Name: [Enter your iSeries user profile name and press enter]
Password: [Enter your iSeries password and press enter]

ftp>binary
         Representation type is binary IMAGE.
ftp>put qfxdsav  mylib/qfxdsav (replace
ftp>quit

The qfxdsav save file for the QFXDTOOLS library is now on your iSeries system.

On the iSeries system where you transferred QFXDSAV, run the following command:

RSTLIB SAVLIB(QFXDTOOLS) DEV(*SAVF) SAVF(MYLIB/QFXDSAV)

When the RSTLIB command completes, you have a new library on your iSeries system called QFXDTOOLS which contains all of the SNDDOMFAX objects and source as listed below:

Review the user considerations before attempting to run the command.

Use the WRKSPLF command to identify the attributes of the spooled file you wish to fax.

Enter SNDDOMFAX on any OS/400 command line and press F4 to display the command prompt.

Enter the required information:

• Domino Server Name (for example, as26faxdom)

Note: This can be any Domino server located on the iSeries system that has access to the fax server via foreign domains.
• Fax recipients (for example, Susan Green@9-555-1234@fax)
• From information (name and information about sender of fax)

Press Page Down to display the second page of the command prompt. Specify the following:
 
• Message Text (for example, Here is the information you asked for)
• Spooled File (information necessary to identify the spooled file or files)
• Scheduled Date and Time (for delayed transmission)

Note: You can specify the most recently spooled file of a particular name (for example, QSYSPRT) for your current session by using * as the Job Name.

You only need to perform the steps described in this section if you make changes to the command. You do not need to create the command if you plan to use it without customizing it.

Note: To successfully run the these commands, you must have the following items installed on your iSeries system (use DSPSFWRSC command to determine if they are already installed):

• 5769CX2 ILE C for AS/400
• 5769LNT Option 3 (C API) of Domino for iSeries

(If necessary, use LODRUN command to install it from the Domino for iSeries CD.)

ADDLIBLE QNOTESAPI
CRTCMOD MODULE(QFXDTOOLS/QFAXCALHPT) SRCFILE(QFXDTOOLS/QCSRC) TEXT('SNDDOMFAX module - calls Host Print Transform')
CRTCMOD MODULE(QFXDTOOLS/QFAXSETENV) SRCFILE(QFXDTOOLS/QCSRC) TEXT('SNDDOMFAX module - sets up Notes environment')   CRTCMOD MODULE(QFXDTOOLS/QFAXSNDFAX) SRCFILE(QFXDTOOLS/QCSRC) TEXT('SNDDOMFAX module - sends the fax')

/* create the SNDDOMFAX command processing program */

CRTPGM PGM(QFXDTOOLS/SNDDOMFAX) MODULE(QFXDTOOLS/QFAXCALHPT QFXDTOOLS/QFAXSETENV QFXDTOOLS/QFAXSNDFAX) BNDSRVPGM(QNOTES/LIBNOTES QNOTES/QNNINAPI QSYS/QWPZHPT1) USRPRF(*OWNER) AUT(*USE)

/* change the owner of the SNDDOMFAX program to QSYS */

CHGOBJOWN OBJ(QFXDTOOLS/SNDDOMFAX) OBJTYPE(*PGM) NEWOWN(QSYS)

/* create the command */

CRTCMD CMD(QFXDTOOLS/SNDDOMFAX) PGM(QFXDTOOLS/SNDDOMFAX) SRCFILE(QFXDTOOLS/QCMDSRC) TEXT('SNDDOMFAX command') MSGF(QFXDTOOLS/SDFMSG) PRDLIB(QFXDTOOLS) AUT(*EXCLUDE)

Note: Use the Work with Authority command (WRKAUT) to authorize appropriate individuals or groups to run the SNDDOMFAX command.

/* Create the workstation customization object */
CRTWSCST WSCST(QFXDTOOLS/QFXDFINE) TEXT('SNDDOMFAX workstation customization object') SRCFILE(QFXDTOOLS/QTXTSRC)