SNDDOMFAX command
Version 1.1.0
Sept 30, 2009
The SNDDOMFAX command allows you to fax IBM i spooled files of type AFP or SCS directly from an IBM i command line using Domino Fax for i5/OS.
You can download the SNDDOMFAX command from this web site. This command is provided as sample code only and is not supported.
IMPORTANT NOTICE: This example contains C programming source code (Sample Code) for your consideration. IBM grants you a nonexclusive copyright license to use this Sample Code as an example from which you can generate similar function tailored to your own specific needs. This Sample Code is provided by IBM for illustrative purposes only and has not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of this Sample Code. IBM provides no program services for this Sample Code. All Sample Code contained herein is provided to you "AS IS" without any warranties of any kind. THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGMENT ARE EXPRESSLY DISCLAIMED. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSIONS MAY NOT APPLY TO YOU. IN NO EVENT WILL IBM BE LIABLE TO ANY PARTY FOR ANY DIRECT, INDIRECT, SPECIAL OR OTHER CONSEQUENTIAL DAMAGES FOR ANY USE OF THIS SAMPLE CODE INCLUDING, WITHOUT LIMITATION, ANY LOST PROFITS, BUSINESS INTERRUPTION, LOSS OF PROGRAMS OR OTHER DATA ON YOUR INFORMATION HANDLING SYSTEM OR OTHERWISE, EVEN IF WE ARE EXPRESSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
(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
- The SNDDOMFAX command makes use of Host Print Transform which requires that 5722SS1(on IBM i 5.4) or 5761SS1(on IBM i 6.1) Option 8 (AFP Compatibility Fonts) be installed on your system.
- A Domino server must reside on the same IBM i system 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 sndfax1.zip file contains a QFXDSAV save file and a readme file. The content of QFXDSAV have been compiled on an IBM i 5.4 system but target i5/OS V5R2. Therefore, the SNDDOMFAX command may only be compiled and run on i5/OS V5R2 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.
Typically, users will not have access to some of the objects that SNDDOMFAX uses so the command 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.
Using the SNDDOMFAX Command
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 IBM i 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 IBM i 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 the 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.
Downloading the SNDDOMFAX command
Download the sndfax1.zip (241KB) file and unzip it. You will have the following files on your workstation:
| qfxdsav |
IBM i save file of library QFXDTOOLS. The QFXDTOOLS library contains all SNDDOMFAX objects and source. |
 |
| readme.html |
Contains instructions for
 |
 |
transferring the save file from your workstation to the IBM i server |
 |
building the command if you choose to customize it |
|
|