Setting up Your OS/400 to Send E-mail with Infoprint Serer Oeriew Infoprint Serer for iseries (Program Number 5722 IP1) lets you conert a spooled file to PDF and send it as e-mail. In order to use this function, your OS/400 must be set up to send e-mail. These instructions are for users in an enironment that meet all of these requirements: TCP/IP is configured. E-mail has not been set up before. You want to use the command line to configure your system for sending e-mail. You want to send e-mail with Infoprint Serer. If you use iseries Naigator or Operations Naigator, you can follow the steps in the iseries Information Center at http://www.as400.ibm.com/infocenter to set up your system to send e-mail. To find these instructions, go to Networking > TCP/IP > E-mail > Configure e-mail. This document contains instructions to set up your OS/400 to send e-mail. You can further customize your e-mail options by using other commands and parameters as desired. To receie e-mail on the OS/400 requires more configuration not gien in this document. For more information about using OS/400 commands or about setting up e-mail, go to any of these: The OS/400 online help: Gies detailed information about commands, parameters, and alues. To access the online help, press F1 from the command screen. The iseries Information Center: Contains information about commands, instructions to configure TCP/IP, and instructions to set up the OS/400 to send and receie e-mail. The Redbook AS/400 E-mail Capabilities, SG24-4703: Contains instructions to configure TCP/IP, instructions to set up the OS/400 to send and receie e-mail, and arious other e-mail topics. SNA Distribution Serices, SC41-5410-01: Contains information about using SNADS on the OS/400. Infoprint Serer for iseries: User s Guide, G544-5775-01: Contains instructions about using Infoprint Serer for iseries, including instructions to send e-mail. The Redbook IBM Eserer iseries Printing VI: Deliering the Output of e-business, SG24-6250: Contains instructions about using Infoprint Serer for iseries, including instructions to send e-mail. These are the steps required to set up your OS/400 to send e-mail with Infoprint Serer 5.1 and higher. They are explained in Detailed steps on page 3. Enter the commands with the gien parameters and alues 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 alues for that parameter. 1. Enter CHGDSTA SMTPRTE(INTERNET GATEWAY) 2. Enter ADDDIRE USRID(INTERNET GATEWAY) USRD( Generic Internet user ) SYSNAME(INTERNET) PREFADR(NETUSRID *IBM ATCONTXT) 3. Enter CHGPOPA MSGSPLIT(*NOMAX) AUTOSTART(*YES) 4. Enter CHGSMTPA AUTOSTART(*YES) MAILROUTER( mailrouter ) FIREWALL(*YES) 1
A alue for MAILROUTER is required only if you want to control what happens when a name and address cannot be resoled. The mail router name would typically be set up by the system administrator. Specify MAILROUTER(*NONE) if you are unsure. 5. 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 ) 6. Add users to the system distribution directory. The alue for USER must be the same as the alue for USRPRF specified in step 5. ISERIES is the system name of the iseries that Joe works on. Enter: ADDDIRE USRID(JOEJ ISERIES) USRD( Joe Johnson ) USER(JOEJ) 7. Note: Only complete this step if you want to use an SMTP serer to send e-mail with Infoprint Serer. You cannot specify an SMTP serer with Infoprint Serer 5.1. This step requires *SECADM special authority. Add an SMTP address for the users in the system distribution directory. a. To add an SMTP address for the user ID JOEJ, enter WRKDIRE and press Enter. b. Choose option 2 (Change) by the user ID you want to change and press Enter. c. Press F19 (Add name for SMTP). If there is no SMTP address associated with this ID, a message appears on the bottom of the screen. Press Enter. d. Specify either the SMTP user ID and domain or the SMTP route. We specify the user ID and domain of Joe s Internet e-mail address: JOEJ@SUPERSUNSEEDS.COM. Add Name for SMTP System: ISERIES User ID...: Address...: JOEJ ISERIES SMTP user ID... JOEJ SMTP domain... SUPERSUNSEEDS.COM SMTP route... F3=Exit F4=Prompt F12=Cancel 8. Enter ENDTCPSVR SERVER(*SMTP) 9. Enter STRTCPSVR SERVER(*SMTP) You can now test the new e-mail setup by using the SNDDST command. We suggest you do this before testing Infoprint Serer for the first time. 10. Test the e-mail setup by entering this command. You can use the TOUSRID or TOINTNET parameters or both: SNDDST TYPE(*LMSG) TOUSRID((user address)) TOINTNET((me@mysystem.com)) DSTD( E-mail ) LONGMSG( This is a test to determine whether my new e-mail setup works. ) SUBJECT( E-mail test ) 2 Setting up Your iseries to Send E-mail
11. Go to your Internet mail system or OS/400 to see if you hae receied the message. For instructions about using SNADS to receie e-mail on your OS/400, refer to the iseries Information Center. Detailed steps Follow these steps to set up your system to send e-mail with Infoprint Serer 5.1 and higher. All of the steps except step 7 are required for any installation. If you want to use an SMTP serer with a release of Infoprint Serer later than 5.1, all steps (including step 7) are required. 1. Specify the user ID and address that the mail serices will use to route mail that has an internet address as recipients. 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: CHGDSTA SMTPRTE(INTERNET GATEWAY) To enter the alues from the display, enter CHGDSTA and press F4, then fill in the alues shown in bold on the screen below: Change Distribution Attributes (CHGDSTA) Keep recipients... *BCC *SAME, *BCC, *ALL, *NONE Use MSF for local... *NO *SAME, *NO, *YES Route to SMTP gateway: User ID... INTERNET Character alue, *SAME, *NONE Address... GATEWAY Character alue Bottom F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display F24=More keys Route to SMTP gateway (SMTPRTE) Specify the special user ID and address that the mail serices will use to route mail that has internet addresses as recipients. 2. Create a directory entry that the mail serices will use to route mail that has an internet address as recipients. User ID and Address must be the same alues 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) Alternatiely, enter ADDDIRE and press F4, then fill in the alues shown in bold on the screens below. Press F10 and scroll down to display Preferred address: Setting up Your OS/400 to Send E-mail with Infoprint Serer 3
Add Directory Entry (ADDDIRE) User identifier: User ID... INTERNET Character alue Address... GATEWAY Character alue User description... Generic Internet user User profile... Name, *NONE System name: System name... INTERNET Character alue, *LCL, *PC... System group... Character alue Network user ID... *USRID Last name... *NONE First name... *NONE Middle name... *NONE Preferred name... *NONE F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel F13=How to use this display F24=More keys Add Directory Entry (ADDDIRE) Preferred address: Field name... NETUSRID Character alue, *USRID... Product ID... *IBM Character alue, *NONE Address type... ATCONTXT Character alue cc:mail address... *NONE cc:mail comment... *NONE Allow synchronization... *YES *YES, *NO DLO owner... *USRPRF *USRPRF, *GRPPRF Bottom F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display F24=More keys User ID (USRID) Specifies the user ID and address. They must be the same alues you specified for User ID and Address in step 1. User description (USRD) Describes this user ID. System name (SYSNAME) Specifies the one- or two-part name of the system on which the user works. For this special user ID, the system name does not hae to be the name of an actual system. Preferred address (PREFADR) Specifies the preferred address for a user. This tells the mail serer framework what fields to use in the system distribution directory for the preferred address of a user. For this special user ID, field-name must be NETUSRID, the product ID must be *IBM, and the address-type must be ATCONTXT. 4 Setting up Your iseries to Send E-mail
3. Specify that outgoing e-mail messages are not split apart and specify that the POP mail serers are started when TCP/IP is started. On the command line, enter: CHGPOPA MSGSPLIT(*NOMAX) AUTOSTART(*YES) To enter the alues from the display, enter CHGPOPA and press F4, then fill in the alues shown in bold on the screen below: Change POP Serer Attributes (CHGPOPA) Autostart serers... *YES *YES, *NO, *SAME Number of initial serers... 3 1-20, *SAME, *DFT Inactiity timeout... 600 10-65535 seconds, *SAME, *DFT Message split size... *NOMAX 32-2048 kilobytes, *SAME... MIME CCSID: Coded character set identifier 00819 *SAME, *DFT, 00819, 00912... When to use... *BESTFIT *SAME, *BESTFIT, *ALWAYS Allow standard POP connection. *YES *SAME, *YES, *NO Host serer connection... *NONE *SAME, *NONE, *ALL, *IP... + for more alues Address book: Enabled... *NO *SAME, *NO, *YES Refresh interal... 1-65535 minutes, *NONE Bottom F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display F24=More keys Autostart serers (AUTOSTART) Specifies whether to automatically start the POP mail serer when TCP/IP is started by the STRTCP command or STRTCPSVR SERVER(*AUTOSTART) command. Message split size (MSGSPLIT) Specifies the number of kilobytes to use for partial message blocks when the mail message exceeds this count. Many mail serers cannot put split messages back together correctly. MSGSPLIT(*NOMAX) specifies that messages are neer split. 4. Configure the SMTP serer to specify that it is started when TCP/IP is started and to specify the mailrouter to use to get through the Firewall, if you hae one. On the command line, enter: CHGSMTPA AUTOSTART(*YES) MAILROUTER( mailrouter ) FIREWALL(*YES) If you exchange e-mail with Domino serers, specify *NO for Percent routing character (PCTRTGCHR) along with the parameters listed aboe. To enter the alues from the display, enter CHGSMTPA and press F4, then fill in the alues shown in bold on the screens below: Setting up Your OS/400 to Send E-mail with Infoprint Serer 5
Change SMTP Attributes (CHGSMTPA) Autostart serer... *YES *YES, *NO, *SAME Retries by minute: Number of retries... 3 0-99, *SAME, *DFT Time interal... 30 0-99, *SAME, *DFT Retries by day: Number of retries... 0 0-9, *SAME, *DFT Time interal... 0 0-9, *SAME, *DFT Retries by hour: Number of retries... 0 0-99, *SAME, *DFT Time interal... 0 0-99, *SAME, *DFT Retry remote name serer... *NO *YES, *NO, *SAME Automatic registration... *NO *NO, *YES, *SAME User ID prefix... *DFT Name, *SAME, *DFT Address... *DFT Name, *SAME, *DFT System name... *DFT Character alue, *SAME, *DFT Alias table type... *SYSTEM *SAME, *SYSTEM, *PERSONAL F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display F24=More keys Change SMTP Attributes (CHGSMTPA) User ID delimiter...? *SAME, *DFT,?, =,., &, $... Mail router... mailrouter Coded character set identifier 00819 1-65533, *SAME, *DFT Mapping tables: Outgoing EBCDIC/ASCII table. *CCSID Name, *SAME, *CCSID, *DFT Library... Name, *LIBL, *CURLIB Incoming ASCII/EBCDIC table. *CCSID Name, *SAME, *CCSID, *DFT Library... Name, *LIBL, *CURLIB Firewall... *YES *YES, *NO, *SAME Journal... *NO *YES, *NO, *SAME Process all mail through MSF.. *NO *YES, *NO, *SAME Percent routing character... *YES *YES, *NO, *SAME F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display F24=More keys Autostart serer (AUTOSTART) Specifies whether to start the SMTP serer automatically when TCP/IP is started by the Start TCP/IP (STRTCP) command or STRTCPSVR SERVER(*AUTOSTART) command. Mail router (MAILROUTER) Specifies that a mail router is used when SMTP cannot find the name and address of the recipient in the system or personal alias tables or when SMTP cannot resole the address of the recipient. A alue for MAILROUTER is required only if you want to control what happens when a name and address cannot be resoled. The mail router name would typically be set up by the system administrator. Specify MAILROUTER(*NONE) if you are unsure. Firewall (FIREWALL) Specifies whether outbound mail destined for a host in a remote domain is forwarded to the mail router to get through the network s Firewall. 6 Setting up Your iseries to Send E-mail
Percent routing character (PCTRTGCHR) Specifies whether the percent sign (%) is interpreted as a routing character. Specify *NO if you exchange e-mail with Domino serers. 5. Create user profiles for any users who want to send e-mail. We will create user JOEJ and gie him a password of not2bad Enter this on the command line: CRTUSRPRF USRPRF(JOEJ) PASSWORD(not2bad) TEXT( Joe Johnson ) If the user is only allowed to sign on to the OS/400 to receie e-mail, specify INLMNU(*SIGNOFF) along with the alues specified aboe. To enter the alues from the display, enter CRTUSRPRF and press F4, then fill in the alues shown in bold on the screen below: Create User Profile (CRTUSRPRF) User profile... JOEJ Name User password... not2bad Character alue, *USRPRF... Set password to expired... *NO *NO, *YES Status... *ENABLED *ENABLED, *DISABLED User class... *USER *USER, *SYSOPR, *PGMR... Assistance leel... *SYSVAL *SYSVAL, *BASIC, *INTERMED... Current library... *CRTDFT Name, *CRTDFT Initial program to call... *NONE Name, *NONE Library... Name, *LIBL, *CURLIB Initial menu... MAIN Name, *SIGNOFF Library... *LIBL Name, *LIBL, *CURLIB Limit capabilities... *NO *NO, *PARTIAL, *YES Text description... Joe Johnson Bottom F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel F13=How to use this display F24=More keys User profile (USRPRF) Specifies the name (user ID) assigned to this user profile. This ID will be added to the system distribution directory in step 6. User password (PASSWORD) Specifies the password that lets the user sign on the system. The user should change this password after logging on. Initial menu (INLMNU) Specifies the name of the menu that is shown when the user signs on. *SIGNOFF specifies that the user is signed off the system after the initial program is completed. Only specify this alue for a user that is only allowed to access the iseries to retriee e-mail. 6. Add users to the system distribution directory. Any user specified as the sender of the e-mail must be registered in this directory. The alue for USER must be the same as the alue for USRPRF specified in step 5. ISERIES is the system name of the iseries that Joe works on, we use that for the address. Add JOEJ to the directory by entering this command: ADDDIRE USRID(JOEJ ISERIES) USRD( Joe Johnson ) USER(JOEJ) Setting up Your OS/400 to Send E-mail with Infoprint Serer 7
To use the panels instead of the command line, enter ADDDIRE and press F4, then fill in the alues shown in bold on the screen below: Add Directory Entry (ADDDIRE) User identifier: User ID... JOEJ Character alue Address... ISERIES Character alue User description... Joe Johnson User profile... JOEJ Name, *NONE System name: System name... *LCL Character alue, *LCL, *PC... System group... Character alue Network user ID... *USRID Last name... *NONE First name... *NONE Middle name... *NONE Preferred name... *NONE F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel F13=How to use this display F24=More keys User identifier (USERID) Specifies the user ID and address for the user. User ID is usually the same alue as the user specified in the user profile. Address is typically the last name of the user or the name of a group of users, such as a system name. We use the system name in this example. User description (USRD) Describes this user ID. User profile (USER) User profile must be the same as the user profile (USRPRF) specified in step 5. 7. Only complete this step if you are going to use a release of Infoprint Serer higher than 5.1 and an SMTP serer instead of SNDDST to send the e-mail. Add an SMTP address for the user ID added to the system distribution directory in step 6. You need to be the system administrator (special authority *SECADM) to complete this step. a. To add an SMTP address for the user ID JOEJ, enter WRKDIRE and press Enter. b. Choose option 2 (Change) for the user ID you want to change: 8 Setting up Your iseries to Send E-mail
Work with Directory Entries Type options, press Enter. 1=Add 2=Change 4=Remoe 5=Display details 6=Print details 7=Rename 8=Assign different ID to description 9=Add another description Opt User ID Address Description AMYE ISERIES Amy Eers BECKYJ ISERIES Becky Johnston BRIANR ISERIES Brian Reynolds BRUCEB ISERIES Bruce Baily CHARLENE ISERIES Charlene Steenson DAVIDM ISERIES Daid Meyer DAVIDR ISERIES Daid Ried DIANEF ISERIES Diane Follette FRANKT ISERIES Frank Tilmore FRITAS ISERIES Frita Smith JUDYP ISERIES Judy Peterson 2 JOEJ ISERIES Joe Johnson F3=Exit F5=Refresh F9=Work with nicknames F11=Sort by description F12=Cancel F13=Work with departments F17=Position to F24=More keys c. The directory entry is shown. Note option F19 (Change name for SMTP): Change Directory Entry User ID/Address...: JOEJ ISERIES Type changes, press Enter. Description... JoeJohnson System name/group... ISERIES F4 for list User profile... JOEJ F4 for list Network user ID... JOEJ ISERIES Name: Last... First... Middle... Preferred... Full... F3=Exit F4=Prompt F5=Refresh F12=Cancel F18=Display location details F19=Change name for SMTP F22=Remoe name for SMTP d. Press F19. If there is no SMTP address associated with this ID, a message appears on the bottom of the screen. Press Enter: Setting up Your OS/400 to Send E-mail with Infoprint Serer 9
Change Directory Entry User ID/Address...: JOEJ ISERIES Type changes, press Enter. Description... JoeJohnson System name/group... ISERIES F4 for list User profile... JOEJ F4 for list Network user ID... JOEJ ISERIES Name: Last... First... Middle... Preferred... Full... F3=Exit F4=Prompt F5=Refresh F12=Cancel F18=Display location details F19=Change name for SMTP F22=Remoe name for SMTP User ID/address does not exist in SMTP table. Press Enter to add, F12 to... e. Specify either the SMTP user ID and domain or the SMTP route. We specify the user ID and domain of Joe s Internet e-mail address: JOEJ@SUPERSUNSEEDS.COM. Add Name for SMTP System: ISERIES User ID...: Address...: JOEJ ISERIES SMTP user ID... JOEJ SMTP domain... SUPERSUNSEEDS.COM SMTP route... F3=Exit F4=Prompt F12=Cancel 8. Stop the SMTP serer. Enter this command on the command line: ENDTCPSVR SERVER(*SMTP) 9. Start the SMTP serer. Enter this command on the command line: STRTCPSVR SERVER(*SMTP) You can now test the new e-mail setup by using the SNDDST command. We suggest you do this before testing Infoprint Serer. 10 Setting up Your iseries to Send E-mail
10. Test the e-mail setup by entering this command. You can use the TOUSRID or TOINTNET parameters or both: SNDDST TYPE(*LMSG) TOUSRID((user address)) TOINTNET((me@mysystem.com)) DSTD( E-mail ) LONGMSG( This is a test to determine whether my new e-mail setup works. ) SUBJECT( E-mail test ) To use the panels instead of the command line, enter SNDDST and press F4, then fill in the alues shown in bold on the screens below. To display the appropriate parameters, specify *LMSG then press enter. Send Distribution (SNDDST) Information to be sent...>*lmsg *MSG, *DOC, *FILE, *IDP... Recipient: User ID... QUEEN Character alue Address... ISERIES Character alue Recipient type... *PRI *PRI, *CC, *BCC + for more alues Internet Recipient: Internet address... QUEEN@SUPERSUNSEEDS.COM Recipient type... *PRI *PRI, *CC, *BCC + for more alues Description... E-mail F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel F13=How to use this display F24=More keys Send Distribution (SNDDST) Message... *NONE Long Message... -mail setup works. This is a test to determine whether my new e... Confirmation of deliery... *NO *NO, *YES Sensitiity... *NONE Content importance... *NORMAL *NORMAL, *LOW, *HIGH Priority... *NORMAL *NORMAL, *HIGH, *LOW F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel F13=How to use this display F24=More keys Setting up Your OS/400 to Send E-mail with Infoprint Serer 11
Send Distribution (SNDDST) Subject... E-mail test + for more alues Document date... *NONE Date, *NONE, *CURRENT File cabinet location... *NONE Copy list... *NONE + for more alues Expiration date... *NONE Date, *NONE Creation date... *NONE Date, *NONE, *CURRENT Reference... *NONE Action due date... *NONE Date, *NONE, *CURRENT F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel F13=How to use this display F24=More keys Information to be sent (TYPE) Specifies the type of information that is sent and the parameters that are alid on this command. When you specify *LMSG, the text specified on the Long Message prompt (LONGMSG parameter) is sent as an final-form text document. To specify a subject and an Internet e-mail address, you must specify *LMSG. Recipient (TOUSRID) Specifies one of the following: The user ID and address of zero or more users to whom the distribution is being sent The distribution list name of zero or more distribution lists containing the user ID and address of one or more users to whom the distribution is being sent Specify a alue for TOUSRID, TOINTNET, or both. Internet Recipient (TOINTNET) Lets you specify an Internet e-mail address, such as QUEEN@SUPERSUNSEEDS.COM. Specify a alue for TOUSRID, TOINTNET, or both. Description (DSTD) Describes the distribution. This parameter is required. Long Message This text, up to 5000 characters (about a page), is sent to the recipients. The text is put into a final-form text document (FFTDCA) and sent as a note. Subject Specifies the subject of the e-mail. 11. Go to your Internet mail system or OS/400 to see if you hae receied the message. For instructions about using SNADS to receie e-mail on your OS/400, refer to the iseries Information Center. 12 Setting up Your iseries to Send E-mail