IBM i TCP/IP Configuration

This small guide may help in configuring your IBM i TCP/IP.

Contents Configuring Ethernet Configuring TCP/IP Defining names and tables Autostarting the TCP/IP servers Autostarting TCP/IP at IPL time

1. Configuring Ethernet Power on your IBM i Signon as QSECOFR on a 5250 workstation Enter command wrkhdwrsc *cmn to find out what Ethernet adapter is installed and the resource name assigned to it Work with Communication Resources Type options, press Enter. 5=Work with configuration descriptions   7=Display resource detail Opt Resource Type Status Text   CMB01 675A Operational Combined function IOP     LIN01 2720 Operational Communication Adapter       CMN01 2720 Operational Communication Port     LIN02 2720 Operational LAN Adapter       CMN02 2838 Operational Ethernet Port 2723=10MbEthernet  2838=10/100MbEthernet Figure 1 - Work with Communication Resources Enter the following command to create an Ethernet line crtlineth lind(ETHLINE) rsrcname(CMN02) linespeed(100M) Check the Ethernet cable. One side should be connected to the IBM i, the other side should be connected to the Ethernet hub. Enter the following command to vary on the line vrycfg cfgobj(ETHLINE) cfgtype(*lin) status(*on) To check the line status enter command wrkcfgsts cfgtype(*lin) cfgd(ETHLINE) Note that the line will display the VARIED ON status until TCP/IP is started.

2. Configuring TCP/IP Enter command cfgtcp to receive the following menu Configure TCP/IP Select one of the following:    1. Work with TCP/IP interfaces 2. Work with TCP/IP routes 3. Change TCP/IP attributes 4. Work with TCP/IP port restrictions 5. Work with TCP/IP remote system information   10. Work with TCP/IP host table entries 11. Merge TCP/IP host table 12. Change TCP/IP domain information   20. Configure TCP/IP applications 21. Configure related tables 22. Configure point-to-point TCP/IP   Figure 2 - Configure TCP/IP To assign an IP address to the IBM i, select 1: Work with TCP/IP Interfaces Type options, press Enter. 1=Add 2=Change 4=Remove 5=Display 9=Start 10=End Opt Internet Address Subnet Mask Line Description Line Type                                                          Figure 3 - Work with TCP/IP Interfaces Type 1 and press Enter to define your TCP/IP interface (substitute our sample values with your; see your checklist): Add TCP/IP Interface (ADDTCPIFC) Type choices, press Enter. Internet address . . . . . . . .  >  192.168.0.2     Line description . . . . . . . . ethline    Name, *LOOPBACK... Subnet mask. . . . . . . . . . . 255.255.255.0   Associated local interface . . . *NONE           Type of service. . . . . . . . . *NORMAL    *MINDELAY, *MAXTHRPUT... Maximum transmission unit. . . . *LIND       576-16388, *LIND Autostart. . . . . . . . . . . . *YES *YES, *NO PVC logical channel identifier     001-FFF + for more values     X.25 idle circuit timeout. . . . 60     1-600 X.25 maximum virtual circuits. . 64     0-64 X.25 DDN interface . . . . . . . *NO  *YES, *NO TRLAN bit sequencing . . . . . . *MSB *MSB, *LSB Figure 4 - Add TCP/IP Interface As an alternative, you may define the IP address of your IBM i by entering the following command addtcpifc intnetadr('192.168.0.2') lind(ethline)      subnetmask('255.255.255.0') To start this TCP/IP interface, select it with 9=Start from the screen in Figure 3, or just enter command strtcpifc intnetadr('192.168.0.2') You should now add a Default Gateway (or route) to your IBM i configuration. This would allow the IBM i to route to your Internet service provider the conversations which cannot be handled on the local network. From the menu in Figure 2 select option 2. Work with TCP/IP routes: Work with TCP/IP Routes Type options, press Enter.    1=Add 2=Change 4=Remove 5=Display Opt Route Destination Subnet Mask Next Hop Preferred Interface                                                                   Figure 5 - Work with TCP/IP Routes select option 1=Add to add a default route (substitute our sample value with your; see your checklist): Add TCP/IP Route (ADDTCPRTE) Type choices, press Enter. Route destination. . . . . . . .  >  *dftroute         Subnet mask. . . . . . . . . . .  >  *none            Type of service. . . . . . . . .   *NORMAL    *MINDELAY, *MAXTHRPUT... Next hop . . . . . . . . . . . .  >  192.168.0.1     Preferred binding interface. . .   *NONE           Maximum transmission unit. . . .   *IFC        576-16388, *IFC Route metric . . . . . . . . . .   1      1-16 Route redistribution . . . . . .   *NO;  *YES, *NO Duplicate route priority . . . .   5      1-10 Figure 6 - Add TCP/IP Route after this, the screen Work with TCP/IP routes looks as follow: Work with TCP/IP Routes Type options, press Enter.    1=Add 2=Change 4=Remove 5=Display Opt Route Destination Subnet Mask Next Hop Preferpurple Interface                                                                   *DFTROUTE         *NONE             192.168.0.1     *NONE   Figure 7 - Work with TCP/IP Routes

3. Defining names and tables You are now going to define the IBM i host name, its domain name, and its DNS server addresses. From the menu in Figure 2 select option 12. Change TCP/IP domain information (or prompt command chgtcpdmn); please substitute our sample values with your; see your checklist. Change TCP/IP Domain (CHGTCPDMN) Type choices, press Enter.   Host name. . . . . . . . . . . .   'myas400'                Domain name. . . . . . . . . . .   'mydomain.it'         Host name search priority. . . .   *LOCAL  *REMOTE, *LOCAL, *SAME   Domain name server: Internet address . . . . . . .   '194.20.8.1'        '194.20.8.4'        Figure 8 - Change TCP/IP Domain Please note that the host name is up to you; it may be different from the one you display with command dspneta. Now you have to update the host table with the host name of your IBM i. From the menu in Figure 2 select option 10. Work with TCP/IP host table entries (or use command addtcphte, see Figure 10): Work with TCP/IP Host Table Entries Type options, press Enter.    1=Add 2=Change 4=Remove 5=Display 7=Rename Opt Internet Address Host Name                       127.0.0.1 LOOPBACK LOCALHOST   Figure 9 - Work with TCP/IP Host Table Entries Type 1=Add on the first line and press Enter. Add TCP/IP Host Table Entry (ADDTCPHTE) Type choices, press Enter.   Internet address . . . . . . . .   > '192.168.0.2'      Host names   Name . . . . . . . . . . . . .     'myas400.mydomain.it'    Name . . . . . . . . . . . . .     'mydomain.it'            + for more values      Text 'description' . . . . . .                                  Figure 10 - Add TCP/IP Host Table Entry It's important that you specify two host names: the full one, in the format host_name.domain_name and the domain_name by itself to allow a correct routing of the electronic mail from the service provider. after this, the screen Work with TCP/IP Host Table Entries looks as follow: Work with TCP/IP Host Table Entries Type options, press Enter.    1=Add 2=Change 4=Remove 5=Display 7=Rename Opt Internet Address Host Name                       127.0.0.1 LOOPBACK LOCALHOST   192.168.0.2 MYAS400.MYDOMAIN.IT MYDOMAIN.IT   Figure 11 - Work with TCP/IP Host Table Entries You should now specify the User ID and Address that the mail services will use to route mail that have an internet address as recipients. Operate as follow: Enter command chgdsta (Change Distribution Attributes) and press F4. Make sure that the Distribution Attributes are as follow: Change Distribution Attributes (CHGDSTA) Type choices, press Enter. Keep recipients . . . . . . . .    *BCC       *SAME, *BCC, *ALL, *NONE Use MSF for local . . . . . . . *NO   *SAME, *NO, *YES Route to SMTP gateway:   User ID . . . . . . . . . . . INTERNET Character value, *SAME, *NONE   Address . . . . . . . . . . . SMTPRTE  Character value Figure 12 - Change Distribution Attributes Then use command wrkdire and use option 1 to add the following system directory entry: Add Directory Entry Type choices, press Enter. User ID/Address . . . .   INTERNET   SMTPRTE  Description . . . . . . user id to route internet mail   System name/Group . . . INTERNET              F4 for list User profile . . . . .                       F4 for list Network user ID . . . . INTERNET SMTPRTE                 ... etc. ... System name and group not found. Press Enter to confirm. Figure 13 - Add Directory Entry, part 1 page fown four times, then enter the following data Add Directory Entry Mail service level  . .  1      1=User index Preferred address . . .  9      9=Other preferred address  Address type . . . .   ATCONTXT  For choice 9=Other preferred address:   Field name . . . .    NETUSRID    *IBM    Figure 14 - Add Directory Entry, part 2

4. Autostarting the TCP/IP servers While some TCP/IP servers are already configured for autostarting at the TCP/IP start, some other are not. These are: the HTTP server (WEB server), the SMTP server (e-mailer towards the Internet), and the POP3 server (e-mailer towards the internal users). This is how you may autostart these three servers. Use command go tcpadm to display the TCP/IP Administration menu TCP/IP Administration Select one of the following:    1. Configure TCP/IP 2. Configure TCP/IP applications 3. Start TCP/IP 4. End TCP/IP 5. Start TCP/IP servers 6. End TCP/IP servers 7. Work with TCP/IP network status 8. Verify TCP/IP connection 9. Start TCP/IP FTP session 10. Start TCP/IP TELNET session 11. Send TCP/IP spooled file   20. Work with TCP/IP jobs in QSYSWRK subsystem   Figure 15 - TCP/IP Administration then select option 2 to display the Configure TCP/IP Applications menu Configure TCP/IP Applications Select one of the following:    1. Configure SNMP agent 2. Configure RouteD 3. Change Trivial FTP Attributes 4. Configure BOOTP 5. Change DDM TCP attributes 6. Change DHCP attributes   10. Change FTP attributes 11. Configure TELNET 12. Configure SMTP 13. Change LPD attributes 14. Configure HTTP   15. Configure workstation gateway 16. Change POP attributes 17. Change REXEC attributes 18. Change DNS attributes   Figure 16 - Configure TCP/IP Applications To change the HTTP server select option 14. Configure HTTP from the menu in Figure 17, then select option 1. Change HTTP attributes (or just prompt command chghttpa): Change HTTP Attributes (CHGHTTPA) Type choices, press Enter. Autostart. . . . . . . . . . . .   *YES *YES, *NO, *SAME Number of server threads: Minimum. . . . . . . . . . . . 10   1-999, *SAME, *DFT Maximum. . . . . . . . . . . . 40   1-999, *SAME, *DFT, *NOMAX Coded character set identifier 00819  1-65533, *SAME, *DFT Server mapping tables: Outgoing EBCDIC/ASCII table. . *CCSID     Name, *SAME, *CCSID, *DFT Library. . . . . . . . . . .            Name, *LIBL, *CURLIB   Incoming EBCDIC/ASCII table. . *CCSID     Name, *SAME, *CCSID, *DFT Library. . . . . . . . . . .            Name, *LIBL, *CURLIB   Figure 17 - Change HTTP Attributes To change the SMTP server select option 12. Configure SMTP from the menu in Figure 16, then select option 3. Change SMTP attributes (or just prompt command chgsmtpa): Change SMTP Attributes (CHGSMTPA) Type choices, press Enter. Autostart. . . . . . . . . . . .   *YES *YES, *NO, *SAME   ... etc ...     Figure 18 - Change SMTP Attributes To change the POP server select option 16. Change POP attributes from the menu in Figure 16 (or just prompt command chgpopa): Change POP Server Attributes (CHGPOPA) Type choices, press Enter. Autostart. . . . . . . . . . . .   *YES *YES, *NO, *SAME   ... etc ...     Figure 19 - Change POP Server Attributes Once this is done, enter command     strtcp to start TCP/IP. About Mail Service Framework (MSF) MSF controls the IBM i mail services. It starts at IPL time. However, as you just changed the TCP/IP configuration, you have to restart it by entering the following commands     endmsf option(*immed)     strmsf For more information about MSF, please check IBM IBM i redbook SG24-4703 IBM i Electronic-Mail Capabilities .

5. Autostarting TCP/IP at IPL time Before OS/400 V4R4, to autostart your TCP/IP at IPL time, you have to add some instructions for the QSTRUP startup program. Starting with V4R4, you may obtain the same by adding an autostart job entry to subsystem QSYSWRK. Enter the following commands grtobjaut obj(qsys/strtcp) objtype(*cmd) user(qpgmr) aut(*use) chgjobd jobd(qsys/qtocstrtcp) jobq(qsys/qsysnomax) addaje sbsd(qsys/qsyswrk) job(struptcpip) jobd(qsys/qtocstrtcp)