back to main page    IBM i TCP/IP Configuration
This small guide may help in configuring your IBM i TCP/IP.

Contents
  1. Configuring Ethernet
  2. Configuring TCP/IP
  3. Defining names and tables
  4. Autostarting the TCP/IP servers
  5. Autostarting TCP/IP at IPL time
  just another service by Giovanni B. Perotti, IBM Italy
1. Configuring Ethernet
  1. Power on your IBM i
  2. Signon as QSECOFR on a 5250 workstation
  3. 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

  4. Enter the following command to create an Ethernet line
    crtlineth lind(ETHLINE) rsrcname(CMN02) linespeed(100M)
  5. Check the Ethernet cable. One side should be connected to the IBM i, the other side should be connected to the Ethernet hub.
  6. Enter the following command to vary on the line
    vrycfg cfgobj(ETHLINE) cfgtype(*lin) status(*on)
  7. 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

  1. 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

  2. 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

  3. 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')


  4. 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')

  5. 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.

3. Defining names and tables

  1. 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.

  2. Now you have to update the host table with the host name of your IBM i.
  3. 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:

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.
  1. 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

  2. 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

  3. 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

  4. 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

  5. Once this is done, enter command
        strtcp
    to start TCP/IP.

  6. 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
  1. grtobjaut obj(qsys/strtcp) objtype(*cmd) user(qpgmr) aut(*use)
  2. chgjobd jobd(qsys/qtocstrtcp) jobq(qsys/qsysnomax)
  3. addaje sbsd(qsys/qsyswrk) job(struptcpip) jobd(qsys/qtocstrtcp)