Fil User Manual. Version: 1.0 Document: DoFil V10e.doc Printdate: 05. Juni 2001

Transcription

1 Fil User Manual Version: 1.0 Document: DoFil V10e.doc Printdate: 05. Juni 2001 Author: Andreas Steiner Andreas Woodtli APOS Informatik AG Industriestrasse 14 CH-4658 Däniken

2 Contents 1 Fil Key features Menu Fil Send file as Set authority code Display PTF-File Display PTF-Level Setup SMTP on the System Installing SMTP and TCP Connectivity Utilities Changing Local Domain and Host Names Creating a TCP Interface Setting Up Remote Users Setting Up Local Users Changing The System Start Program Lotus Notes considerations Check if the required PTFs are installed (5769TC1) Obtain TCP/IP addresses Update the Host Table entries Update domain information Create the required data areas Update notes.ini Environment with external MailServer Setup external MailServer Integration Technical Support...15 Document: DoFil V10e.doc ( ) page 2/15 APOS Informatik AG

3 1 Fil Fil gives you the possibility to database files directly out of an iseries. Fil 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: DoFil V10e.doc ( ) page 3/15 APOS Informatik AG

4 1.2 Menu Fil The Fil menu is accessed by command GO FIL . Or simple type in the command FIL . FIL APOS Fil :55:18 Select one of the following: 1. Send file as 6. Set authority code (XSRLSET) 7. Display PTF-File (RUNQRY) 8. Display PTF-Level (XPTF) 90. Signoff Selection or command ===> Send file as If you select option 1 (Send file as ) the following screen appears: Send Database File as :58:10 Sender: STA Address: CHAPOS00 to...: cc...:. bcc..: Database file: Library: Message...: Close program after sending Y,N Y F3=Exit F10=Send F12=Cancel Document: DoFil V10e.doc ( ) page 4/15 APOS Informatik AG

5 Sender: Address: to: cc: bcc: Database file: Library: Message: Close program after sending sender (AS/400 user) Hostaddress (AS/400 Systemname) 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 message. 256 characters max. Close the program after sending the Set authority code Fil is protected by a 20 digit security code. If you don t set the security code Fil will not work. With option 6 from the main menu (Set authority code) the following screen appears: Work with authoritycode (c) APosco STA QPADEV0011 FIMABA10 XSRLD3 Enter Option and press Enter 2=change 4=delete 5=display S Module Description / Application Authoritycode FIMABA10 Fil Version A 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: DoFil V10e.doc ( ) page 5/15 APOS Informatik AG

6 1.2.3 Display PTF-File Fil 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 Display PTF-Level With option 8 (Display PTF-Level) from the main you can check the actual PTF-Level of Fil . Document: DoFil V10e.doc ( ) page 6/15 APOS Informatik AG

7 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 SC 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 " " and subnet mask " ". This number is taken from the class B " " 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( ) LIND(line_description_name) SUBNETMASK( ) 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: DoFil V10e.doc ( ) page 7/15 APOS Informatik AG

8 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 address "info@apos.ch", run the following command: ADDDIRE USRID(FM1 FIL ) 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 FIL ) 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: DoFil V10e.doc ( ) page 8/15 APOS Informatik AG

9 ?? 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: DoFil V10e.doc ( ) page 9/15 APOS Informatik AG

10 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, SF 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 and DOMINO01 will use the TCP/IP address of Document: DoFil V10e.doc ( ) page 10/15 APOS Informatik AG

11 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 LOOPBACK LOCALHOST DOMINO01 DOMINO01.APOS.CH CHAPOS00 APOS.CH 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 Create the required data areas?? CRTDTAARA DTAARA(QUSRSYS/QTMSSBNDIP) TYPE(*CHAR) LEN(16) + VALUE( ) AUT(*USE)?? CRTDTAARA DTAARA(QUSRSYS/QTMSCBNDIP) TYPE(*CHAR) LEN(16) + VALUE( ) AUT(*USE) Document: DoFil V10e.doc ( ) page 11/15 APOS Informatik AG

12 ?? 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 DST=1 TCPIP_TcpIpAddress=0, 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: DoFil V10e.doc ( ) page 12/15 APOS Informatik AG

13 4 Environment with external MailServer OS/400 SMTP support can be configured to deliver 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 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: DoFil V10e.doc ( ) page 13/15 APOS Informatik AG

14 5 Integration The Fil can be installed on every IBM AS/400 with V4R3 and higher. Document: DoFil V10e.doc ( ) page 14/15 APOS Informatik AG

15 6 Technical Support If you encounter a problem with Fil you should:?? Load the latest Program Temporary Fix (PTF) from our FTP site ftp.apos.ch (directory Fil ). 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 Daeniken Switzerland Fax: ++41/ Telephone: ++41/ tools@apos.ch It would be very usefull for us if you send us your Release- and PTF level of Fil along your mail or fax request. Document: DoFil V10e.doc ( ) page 15/15 APOS Informatik AG