Enabling an IBM System i to Send E-Mail when Using Infoprint Server to Convert SPLFs to PDF

Resolving The Problem

This document provides step-by-step instruction for enabling an IBM System i to send e-mail when using the IBM Infoprint Server for iSeries product (5722IP1) to convert spooled files to Adobe Acrobat PDF format.

This document was last updated on 27 August 2014.

---

Instructions for enabling an IBM System i to send e-mail when using the IBM Infoprint Server for iSeries product (5722IP1) to convert spooled files to Adobe Acrobat PDF format can be found in Chapter 6, Enabling E-mail, in the Infoprint Server for iSeries User’s Guide, Version 5, Release 4.0 (G544-5775-05), and specifically in the section titled "Enabling You i5/OS to Send E-Mail".

The InfoPrint Server for IBM i User's Guide (G544-5775-05) publication is available in Adobe PDF format at the following links:

7.2	www-01.ibm.com/support/knowledgecenter/ssw_ibm_i_61/rzair/g5445775.pdf
7.1	www-01.ibm.com/support/knowledgecenter/ssw_ibm_i_61/rzair/g5445775.pdf
6.1	www-01.ibm.com/support/knowledgecenter/ssw_ibm_i_61/rzair/g5445775.pdf
5.4	http://www-01.ibm.com/support/knowledgecenter/ssw_i5_54/books/g5445775.pdf

These same instructions are also available in section 2.1.4 "Configuring the iSeries server to send e-mail" in the IBM® Redbooks™ IBM eServer iSeries Printing VII: Infoprint Server Implementation (SG24-6250). The IBM® Redbooks™ abstract is available at the following link:

http://publib-b.boulder.ibm.com/Redbooks.nsf/RedpaperAbstracts/redp3752.html?Open

and the IBM® Redbooks™ manual is available in Adobe PDF format at the following link:

http://www.redbooks.ibm.com/redpapers/pdfs/redp3752.pdf

These instructions have been copied and modified from these publications.

---

Before starting with configuring SMTP for authentication, a digital certificate must be installed in in the Digital Certificate Manager (DCM).

For more information and for step-by-step instructions, please refer to the following Technotes:

N1017620: Configuring MSF/SMTP on the IBM i
N1012245: SMTP New Configuration Checklist, Short Version
N1018903: Simple Troubleshooting for Send Distribution (SNDDST)

These are the steps required to set up your i5/OS to send e-mail with Infoprint Server 5.2 and higher. Enter the commands with the given parameters and values as shown in capital letters below. If you prefer, enter the command (such as CHGDSTA), then press F4 to be prompted through the command. Pressing F11 toggles between the parameter keywords (such as SMTPRTE) and a list (sometimes partial) of acceptable values for that parameter.

1	Specify the user ID and address that the mail services will use to route mail that has an internet address as a recipient. This is not the ID of an actual person. For this example, we use INTERNET as the user ID and GATEWAY for the address. We will create a directory entry with this user ID and address in step 2. On the command line, enter the following Change Distribution Attributes (CHGDSTA) command to specify the Route to SMTP gateway (SMTPRTE) parameter, for example: CHGDSTA SMTPRTE(INTERNET GATEWAY) Restriction: You need security administrator (*SECADM) authority to use this command.
2	Create a directory entry that the mail services will use to route mail that has an internet address as a recipient. User ID and Address must be the same values you specified for User ID and Address in step 1. On the command line, enter: ADDDIRE USRID(INTERNET GATEWAY) USRD(’Generic Internet user’)         SYSNAME(INTERNET) PREFADR(NETUSRID *IBM ATCONTXT)
3	Specify that outgoing e-mail messages are not split apart and specify that the POP mail servers are started when TCP/IP is started. On the command line, enter CHGPOPA MSGSPLIT(*NOMAX) AUTOSTART(*YES)
4	Configure the SMTP server to specify that it is started when TCP/IP is started and to specify the mail router to use to get through the Firewall, if you have one. If you exchange e-mail with Domino® servers, specify *NO for Percent routing character (PCTRTGCHR) along with the parameters listed below. If running 5.4 i5/OS or 6.1 i5/OS, use the Change SMTP Attributes (CHGSMTPA) command to specify the external mail server in the Mail router (MAILROUTER) parameter and set the Firewall (FIREWALL) parameter to *YES. For example: CHGSMTPA AUTOSTART(*YES) MAILROUTER(’mailserver’) FIREWALL(*YES) If running 7.1 i5/OS, use the Change SMTP Attributes (CHGSMTPA) command to specify the external mail server in the Forwarding mailhub server (FWDHUBSVR) parameter and set the Firewall (FIREWALL) parameter to *YES. For example: CHGSMTPA AUTOSTART(*YES) FWDHUBSVR(’mailserver’) FIREWALL(*YES) Note: A value for MAILROUTER is required only if you want to control what happens when a name and address cannot be resolved. The mail router name would typically be set up by the system administrator. Specify MAILROUTER(*NONE) if you are unsure.
5	If you want to use the local SMTP server, use the Change SMTP Attributes (CHGSMTPA) command to specify a value other than *NONE for the Allow relayed mail (ALWRLY) parameter. To provide for outgoing mail and yet to protect this server from being an open relay, prevent it from relaying any e-mail except that which originates on itself (127.0.0.1), enter the following Change SMTP Attributes (CHGSMTPA) command to allow relayed mail from a list of addresses: CHGSMTPA ALWRLY(*LIST) and enter the following Add SMTP List Entry (ADDSMTPLE) command: ADDSMTPLE TYPE(*ACCEPT) INTNETADR(’127.0.0.1’)
6	Create user profiles for any users who want to send e-mail. We will create user JOEJ. Enter: CRTUSRPRF USRPRF(JOEJ) PASSWORD(not2bad) TEXT(’Joe Johnson’) Chapter 6. Sending E-mail 151
7	Add users to the system distribution directory. The value for USER must be the same as the value for USRPRF specified in step 5. To use this ID to send e-mail, specify this user ID in the PDFSENDER parameter of the PSF configuration object used with the PDF subsystem. Alternatively, you can specify it in USRDFNDTA in the spooled file’s attributes or the printer file. ISERIES is the system name of the iSeries that Joe works on. Enter: ADDDIRE USRID(JOEJ ISERIES) USRD(’Joe Johnson’) USER(JOEJ) To use an SMTP server to send e-mail with Infoprint Server, use the Change Directory Entry (CHGDIRE) command to add the SMTP address and SMTP domain for each user in the system distribution directory. For example, if the user's email address is "joejohnson@supersunseeds" then the SMTP address would be "joejohnson" and the SMTP domain would be "supersunseeds.com", so the CHGDIRE command would be: CHGDIRE USRID(JOEJ ISERIES)         USRDFNFLD((SMTPAUSRID SMTP ’joejohnson’)         (SMTPDMN SMTP ’SUPERSUNSEEDS.COM’)) Alternatively, you can use the Work with Directory Entries (WRKDIRE) command and take Option 1 (Add) to add uesrs to the system distribution directory, and use the F19 (Add name for SMTP) key to add the SMTP user ID and SMTP domain for each user. Note: This step requires *SECADM special authority.
8	End and restart the *SMTP server using the End TCP/IP Server (ENDTCPSVR) and Start TCP/IP Server (STRTCPSVR) commands. For example: ENDTCPSVR SERVER(*SMTP) STRTCPSVR SERVER(*SMTP)
9	You can now test the new e-mail setup by using the SNDDST command. We suggest you do this before testing Infoprint Server for the first time. Test the e-mail setup by entering this command. You can use the TOUSRID or TOINTNET parameters or both: SNDDST TYPE(*LMSG) TOINTNET((me@mysystem.com)) DSTD(’E-mail’)        LONGMSG(’This is a test to verify that e-mail works.’)        SUBJECT(’E-mail test’)
10	Go to your Internet mail system or i5/OS to see if you have received the message. For instructions about using SNADS to receive e-mail on your i5/OS, refer to the iSeries Information Center. From the Information Center go to Networking > TCP/IP > E-mail