FileMail User Manual Version: 1.0 Document: DoFileMailV10e.doc Printdate: 05. Juni 2001 Author: Andreas Steiner Andreas Woodtli APOS Informatik AG Industriestrasse 14 CH-4658 Däniken
Contents 1 FileMail... 3 1.1 Key features...3 1.2 Menu FileMail...4 1.2.1 Send file as email...4 1.2.2 Set authority code...5 1.2.3 Display PTF-File...6 1.2.4 Display PTF-Level...6 2 Setup SMTP on the System... 7 2.1 Installing SMTP and TCP Connectivity Utilities...7 2.2 Changing Local Domain and Host Names...7 2.3 Creating a TCP Interface...7 2.4 Setting Up Remote Users...7 2.5 Setting Up Local Users...8 2.6 Changing The System Start Program...8 3 Lotus Notes considerations...10 3.1 Check if the required PTFs are installed (5769TC1)... 10 3.2 Obtain TCP/IP addresses... 10 3.3 Update the Host Table entries... 11 3.4 Update domain information... 11 3.5 Create the required data areas... 11 3.6 Update notes.ini... 12 4 Environment with external MailServer...13 4.1 Setup external MailServer... 13 5 Integration...14 6 Technical Support...15 Document: DoFileMailV10e.doc (05.06.01) page 2/15 APOS Informatik AG
1 FileMail FileMail gives you the possibility to e-mail database files directly out of an iseries. FileMail converts the database file into a CSV-Format (can be viewed with Microsofts Excel). 1.1 Key features?? Converting DB2/400 to CSV format?? Sending the Excel file directly out of an iseries?? Send-process can be called out of a program or by using commands or menu Document: DoFileMailV10e.doc (05.06.01) page 3/15 APOS Informatik AG
1.2 Menu FileMail The FileMail menu is accessed by command GO FILEMAIL. Or simple type in the command FILEMAIL. FILEMAIL APOS FileMail 31.05.01 08:55:18 Select one of the following: 1. Send file as e-mail 6. Set authority code (XSRLSET) 7. Display PTF-File (RUNQRY) 8. Display PTF-Level (XPTF) 90. Signoff Selection or command ===> 1.2.1 Send file as email If you select option 1 (Send file as e-mail) the following screen appears: Send Database File as E-Mail 31.05.01 10:58:10 Sender: STA Address: CHAPOS00 Email to...: cc...:. bcc..: Database file: Library: Message...: Close program after sending Y,N Y F3=Exit F10=Send email F12=Cancel Document: DoFileMailV10e.doc (05.06.01) page 4/15 APOS Informatik AG
Sender: Address: e-mail to: e-mail cc: e-mail bcc: Database file: Library: Message: Close program after sending E-mail sender (AS/400 user) Hostaddress (AS/400 Systemname) E-mail address. 5 Addresses max., 50 characters per address max. Copy to addresses. 5 Addresses max., 50 characters per address max. Blind copy addresses. 5 Addresses max., 50 characters per address max. Name of the databasefile Name of the Library E-mail message. 256 characters max. Close the program after sending the e-mail 1.2.2 Set authority code FileMail is protected by a 20 digit security code. If you don t set the security code FileMail will not work. With option 6 from the main menu (Set authority code) the following screen appears: Work with authoritycode (c) APosco 31.05.01 STA QPADEV0011 FIMABA10 XSRLD3 Enter Option and press Enter 2=change 4=delete 5=display S Module Description / Application Authoritycode FIMABA10 FileMail Version 1.0 27898 90249A0 103410 Weitere... F3=Exit F5=Refresh F6=Create F7=Page down F8=Page up F9=Command Options: Option 2 (change): Option 4 (delete): Option 5 (display): Change the security code Delete the security code Displays the security code To create a new security code entry simple press function key F6 (create). Document: DoFileMailV10e.doc (05.06.01) page 5/15 APOS Informatik AG
1.2.3 Display PTF-File FileMail will be constantly updated via PTFs. To have a look at the detailed PTF descriptions you have the possibility to run option 7 (Disaplay PTF File) from the main menu. 1.2.4 Display PTF-Level With option 8 (Display PTF-Level) from the main you can check the actual PTF-Level of FileMail. Document: DoFileMailV10e.doc (05.06.01) page 6/15 APOS Informatik AG
2 Setup SMTP on the System Depending on your system, network configuration and your intended usage, there are several manual set up steps you may need to perform in order to use SMTP. These are described here. 2.1 Installing SMTP and TCP Connectivity Utilities If you intend to deliver mail to SMTP users, SMTP support must be installed on your system. SMTP functions are delivered free of charge with OS/400 as part of a separately installed licensed program product: 5763-TC1 (V3 Cisc) or 5716-TC1 (V3 Risc) or 5769-TC1 (V4) TCP/IP Connectivity Utilities/400. Detailed installation information and instructions can be found in the AS/400 Licensed Programs and New Release Installation Guide SC41-9878. 2.2 Changing Local Domain and Host Names SMTP uses your system's local domain and host name to identify itself to remote SMTP hosts from which it is receiving mail or to which it is sending mail. To configure the names:?? Run the Configure TCP/IP (CFGTCP) command.?? Select option 12 (Change local domain and host names.)?? Enter a domain and host name for your system. 2.3 Creating a TCP Interface A TCP interface establishes your AS/400's identity (internet address) on a given line description. Typically the line description for a local area network is used. In order to add a TCP interface to a line description, you must determine the internet address and subnet mask to use. If you have a network administrator or other person responsible for assigning internet addresses (a.k.a. IP numbers), contact them. If you will connect your AS/400 directly to the Internet, you must request that the InterNIC assign you a network number. If you will not connect your AS/400 directly to the internet, and otherwise do not have an internet address for your system, you should use internet address "192.168.1.1" and subnet mask "255.255.255.0". This number is taken from the class B "192.168.0.0" network which is reserved for internal networks as described in RFC1597. To add an interface after you have determined an internet address and subnet mask, run the following command: ADDTCPIFC INTNETADR(192.168.1.1) LIND(line_description_name) SUBNETMASK(255.255.255.0) Substitute your values for the three parameters. 2.4 Setting Up Remote Users A remote user is someone who does not have a user profile (sign-on) on your AS/400. Document: DoFileMailV10e.doc (05.06.01) page 7/15 APOS Informatik AG
Unless you use the Send Spool Mail (SNDSPLMAIL) command's *GATEWAY function, an entry is required in the system distribution directory for every user that you want to send mail to. You do not however have to create a user profile for the remote user. To configure a directory entry for a remote user with the e-mail address "info@apos.ch", run the following command: ADDDIRE USRID(FM1 FILEMAIL) USRD('Sample entry 2') USER(*NONE) SYSNAME(TCPIP) MSFSRVLVL(*SYSMS) PREFADR(*SMTP) USRDFNFLD((SMTPAUSRID SMTP 'info') (SMTPDMN SMTP 'apos.ch')) Note: The choice of USRID(FM1 FILEMAIL) is arbitrary, select names that are convenient. The system name must be TCPIP. 2.5 Setting Up Local Users A local user is someone who has a user profile (sign-on) on your AS/400. An entry is required in the system distribution directory for every local user that you want to send mail to. To configure hypothetical user PETE CHAPOS00 (user profile PETE) for SMTP mail delivery as pete@apos.ch, perform the following:?? If SAMY already has a directory entry run: CHGDIRE USRID(PETE CHAPOS00) MSFSRVLVL(*SYSMS) PREFADR(*SMTP) USRDFNFLD((SMTPAUSRID SMTP 'pete') (SMTPDMN SMTP 'apos.ch'))?? If PETE doesn't have a directory entry run: ADDDIRE USRID(PETE CHAPOS00) USRD('Sample entry') USER(PETE) SYSNAME(*LCL) MSFSRVLVL(*SYSMS) PREFADR(*SMTP) USRDFNFLD((SMTPAUSRID SMTP 'pete') (SMTPDMN SMTP 'apos.ch')) The user is now ready to receive SMTP mail from your system as pete@apos.ch. 2.6 Changing The System Start Program You may wish to check your system's start up program to insure that the required subsystems are started automatically when your system IPLs. The following steps are recommended:?? Insure that the SMTP server starts automatically when the Start TCP/IP (STRTCP) command is run: CHGSMTPA AUTOSTART(*YES)?? Insure that your system start up program starts TCP/IP by including the command: STRTCP Document: DoFileMailV10e.doc (05.06.01) page 8/15 APOS Informatik AG
?? Insure that your system start up program starts the QSNADS subsystem by including the command: STRSBS SBSD(QSNADS)?? Insure that your system start up program starts the OS/400 Mail Server by including the command: STRMSF Document: DoFileMailV10e.doc (05.06.01) page 9/15 APOS Informatik AG
3 Lotus Notes considerations Lotus Notes Domino for AS/400 (installed native on the iseries System) uses the SMTP-task from the OS/400 (if SMTP is setup for the Lotus Notes Domino Server). In fact only one SMTP task can be active in a normal environment. That means, that by default only the Notes SMTP task or the native OS/400 SMTP task can be active (not both!). IBM now has implemented the ability to have multiple different SMTP tasks active at the same time. Follow the steps below to set up more than one SMTP task on your system. 3.1 Check if the required PTFs are installed (5769TC1) V4R2M0: SF55697, SF55704 V4R3M0: SF58661, SF59663 V4R4M0: SF60787, SF60764 V4R5M0: SF60827, SF61136 3.2 Obtain TCP/IP addresses After obtaining the appropriate PTF for binding to a specific TCP/IP address, it is important to read and understand the special instructions for completing the configuration. In our example of this configuration, we will bind the Domino SMTP server and client to the TCP/IP address of the AS/400, and configure one AS/400 SMTP server to use a different TCP/IP address. The following steps may be followed to assist in the process.?? Obtain all of the necessary TCP/IP addresses required for the configuration. One TCP/IP address is required for each Domino R5.0 for AS/400 SMTP server that will be configured. For our configuration, the name of our AS/400 is CHAPOS00 in domain APOS.CH and the name of our Domino Server is DOMINO01 in domain DOM- INO01.APOS.CH. CHAPOS00 will use the TCP/IP address of 192.168.58.101 and DOMINO01 will use the TCP/IP address of 192.168.58.100. Document: DoFileMailV10e.doc (05.06.01) page 10/15 APOS Informatik AG
3.3 Update the Host Table entries. Type in the command CFGTCP. Then choose option 10 (Work with TCP/IP host table entries) Work with TCP/IP Host Table Entries Type options, press Enter. 1=Add 2=Change 4=Remove 5=Display 7=Rename System: CHAPOS00 Internet Host Opt Address Name 127.0.0.1 LOOPBACK LOCALHOST 192.168.58.100 DOMINO01 DOMINO01.APOS.CH 192.168.58.101 CHAPOS00 APOS.CH 192.168.58.102 CHAPOSSA 3.4 Update domain information Type in the command CHGTCPDMN and then press function key F4. Type choices, press Enter. Change TCP/IP Domain (CHGTCPDMN) Host name........... HOSTNAME Domain name.......... DMNNAME CHAPOS00 APOS.CH Host name search priority... HOSTSCHPTY *LOCAL Domain name server: INTNETADR Internet address....... 195.50.224.11 195.50.224.10 3.5 Create the required data areas?? CRTDTAARA DTAARA(QUSRSYS/QTMSSBNDIP) TYPE(*CHAR) LEN(16) + VALUE( 192.168.58.101 ) AUT(*USE)?? CRTDTAARA DTAARA(QUSRSYS/QTMSCBNDIP) TYPE(*CHAR) LEN(16) + VALUE( 192.168.58.101 ) AUT(*USE) Document: DoFileMailV10e.doc (05.06.01) page 11/15 APOS Informatik AG
?? The SMTP task must be restarted (ENDTCPSVR SERVER(*SMTP) and STRTCPSVR SERVER (*SMTP)) Note: If you wish to control RELAY and CONNECTIONS please see PTF cover letters for more instructions. 3.6 Update notes.ini Bearbeit.: /notes/data/notes.ini...+...1...+...2...+...3...+...4...+...5...+...6...+...7...+...8... DST=1 TCPIP_TcpIpAddress=0,192.168.58.100 LOG_REPLICATION=1 LOG_SESSIONS=1 KeyFilename=server.id CertifierIDFile=/notes/data/cert.id MailServer=CN=CHAPOS00/O=APOS/C=CH Timezone=-1 To activate the changes the Lotus Notes Domino server must be restarted. Document: DoFileMailV10e.doc (05.06.01) page 12/15 APOS Informatik AG
4 Environment with external MailServer OS/400 SMTP support can be configured to deliver e-mail to an external mail router when SMTP cannot find the name and address of the recipient in the system or personal alias tables or when SMTP is not able to resolve the address of the recipient. An external mail router is a system that is running a mail application. Examples of mail applications include:?? Microsoft Exchange Server?? Lotus Notes Mail?? cc:mail Post Office?? Group Wise?? Or all other standard e-mail server If your configuration does not include a system running a mail application, you should not set up a mail router. If you intend to set up all mail recipients and their destinations on your AS/400 you do not need to set up a mail router. If you want the mail application to handle delivery for SMTP mail originating from the AS/400, then continue with this chapter. 4.1 Setup external MailServer The following steps must be performed in order to use an external mail server:?? An TCP/IP Host table entry must be added. Use command ADDTCPHTE INT- NETADR(<mail server tcp/ip address>) HOSTNAME(<mail server host name>)?? The SMTP attributes must be changed. Use command CHGSMTPA MAI L- ROUTER(<mail server host name>)?? Restart SMTP and MSF. Use commands ENDMSF and STRMSF, ENDTCPSVR SERVER(*SMTP) and STRTCPSVR SERVER(*SMTP) Document: DoFileMailV10e.doc (05.06.01) page 13/15 APOS Informatik AG
5 Integration The FileMail can be installed on every IBM AS/400 with V4R3 and higher. Document: DoFileMailV10e.doc (05.06.01) page 14/15 APOS Informatik AG
6 Technical Support If you encounter a problem with FileMail you should:?? Load the latest Program Temporary Fix (PTF) from our FTP site ftp.apos.ch (directory FileMail ). Use Readme.txt to see a description of the different files. If the problem remains unresolved, do not hesitate to conact us: Mailing address: APOS Informatik AG Industriestrasse 14 4658 Daeniken Switzerland Fax: ++41/62 288 66 67 Telephone: ++41/62 288 65 65 E-Mail: tools@apos.ch It would be very usefull for us if you send us your Release- and PTF level of FileMail along your mail or fax request. Document: DoFileMailV10e.doc (05.06.01) page 15/15 APOS Informatik AG