ADDTCPIFC (Add TCP/IP Interface)

ADDTCPIFC Command syntax diagram

 

Purpose

The Add TCP/IP Interface (ADDTCPIFC) command is used to define a new interface to the Transmission Control Protocol/Internet Protocol (TCP/IP) configuration. The interfaces defined by the ADDTCPIFC command are logical interfaces. They are not physical interfaces. Each interface is associated with a line description. The line description is the physical connection from the iSeries 400 to the TCP/IP network.

The iSeries 400 TCP/IP implementation supports multihoming. This allows you to specify either a single interface or multiple interfaces per line description. You can have your iSeries 400 appear as any one or combination of the following:

• A single host on a network over a communications line
• Multiple hosts on the same network over the same communications line
• Multiple hosts on different networks over the same communications line
• Multiple hosts on the same network over multiple communications lines
• Multiple hosts on different networks over multiple communications lines

 

Notes

1. Up to 128 logical interfaces can be defined and started per communications line.
   
2. In SNMP, the interface is a physical interface. The physical interface relates directly to an input/output processor (IOP).
   
3. The interface table is shipped with a default interface of 127.0.0.1. The line description value associated with the 127.0.0.1 interface is *LOOPBACK. The host table is also shipped with an entry that has an internet address of 127.0.0.1 and host names of LOOPBACK and LOCALHOST.

Attention

Before attempting to start an X.25 interface, ensure that the remote system information (RSI) for non-DDN X.25 interfaces that use a permanent virtual circuit (PVC) is configured. Use the Add TCP/IP Remote System Information (ADDTCPRSI) command to do this. Incoming data from a remote system on the X.25 network is not processed unless an RSI entry for the PVC is configured on the X.25 interface before the interface is started.

Restriction: You must have *IOSYSCFG special authority to use this command.

 

Required Parameters

INTNETADR

Specifies an internet address that the local system responds to on this interface. An interface is associated with a line description. The internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes.

LIND

Specifies the name of the line description associated with the new interface. The line description must be defined before the TCP/IP interface can be added. The following conditions are based on the interface type that the user defines:

Token-ring

The name must be previously defined on the Create Line Description (Token-Ring Network) (CRTLINTRN) command.

X.25

The name must be previously defined on the Create Line Description (X.25) (CRTLINX25) command.

Ethernet

The name must be previously defined on the Create Line Description (Ethernet) (CRTLINETH) command.

DDI

The name must be previously defined on the Create Line Description (DDI Network) (CRTLINDDI) command.

Frame relay

The name must be previously defined on the Create Line Description (Frame Relay Network) (CRTLINFR) command.

Wireless

The name must be previously defined on the Create Line Description (Wireless Network) (CRTLINWLS) command.

Twinax (TDLC)

The name must be previously defined on the Create Line Description (CRTLINTDLC) command.

TCP/IP can also be used on certain line descriptions attached to these network interfaces (NWI):

• An ISDN NWI using an X.25 line description.

  • The ISDN NWI is created using the Create Network Interface ISDN (CRTNWIISDN) command.
    
  • The X.25 line is created using the Create Line X.25 (CRTLINX25) command and attached to the ISDN NWI by specifying the NWI, NWICHLTYPE, NWICHLNBR, and SWTNWILST parameters.

  
  

• A frame relay NWI using a frame relay, token ring, Ethernet, or DDI line description.

  • The frame relay NWI is created using the Create Network Interface Frame Relay Network (CRTNWIFR) command.
    
  • The line description is created using the appropriate Create Line command and attached to the frame relay NWI by specifying the NWI and NWIDLCI parameters.

*LOOPBACK: This special value is used if and only if the first octet of the interface internet address is 127. This value indicates that the interface being added by this ADDTCPIFC command is the loopback or LOCALHOST interface. Because processing associated with loopback does not extend to a physical line, there is no line description associated with a loopback address.

*VIRTUALIP: This special value is used if you are adding a 'circuitless' interface. This means that this interface has a real IP address but is NOT tied to any physical hardware. Interfaces of this type are useful to identify the address of the iSeries 400 to remote systems over point-to-point links (PPP, SLIP, Frame Relay).

*OPC: This special value is used if you are adding an OptiConnect interface over TCP/IP. This interface is attached to the optical bus (OptiConnect).

line-description: Specify the line description to be used for this interface.

SUBNETMASK

Specifies the subnet mask, which is a bit mask that defines the part of the network where this interface attaches. The mask is a 32-bit combination that is logically ANDed with the internet address to determine a particular subnetwork. The bits of the mask set to the value one (1) determine the network and subnetwork portions of the address. The bits set to the value zero (0) determine the host portion of the address.

Note:

The network portion must be equal to one bits in the subnetmask. The host portion of an address must be at least two bits wide.

*HOST: The subnetmask value used will be 255.255.255.255.

subnet-mask: Specify the mask for the network subnet field and host address field of the internet address that defines a subnetwork. The subnet mask is in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. The subnet mask must mask off all bits of the network class's network ID portion of the internet address. For example, 255.255.255.0 could define a subnet mask for an interface with a Class B internet address. In this example, the first two octets must be 1 bits because these octets define the network ID portion of the Class B internet address. The third octet of this subnet mask defines the actual subnet mask ID portion of the interface's internet address. It is also all 1 bits. This leaves the fourth octet to define the host ID portion of the interface's internet address.

Note:

The bits that identify the subnetwork are not required to be adjacent in the address. However, it is strongly advised that the subnet bits be contiguous and located in the most significant bits of the host address.

 

Optional Parameters

LCLIFC

The local IP interface that the internet address defined in INTNETADR will be associated with.

The associated local interface is used to allow for transparent subnetting or unnumbered networks on the iSeries 400. Any local interface may be used for LCLIFC, except for interfaces defined for the X.25 or PPP linetypes.

*NONE: No associated local interface is used.

local-interface: Specify an associated local interface for the interface being added. Note that the specified associated local interface must already exist.

TOS

Specifies the type of service to be used. The type of service defines how the internet hosts and routers should make trade-offs between throughput, delay, reliability, and cost.

*NORMAL: Normal service is used for delivery of data.

*MINDELAY: Minimize delay means that prompt delivery is important for data on this connection.

*MAXTHRPUT: Maximize throughput means that a high data rate is important for data on this connection.

*MAXRLB: Maximize reliability means that a higher level of effort to ensure delivery is important for data on this connection.

*MINCOST: Minimize monetary cost means that lower cost is important for data on this connection.

MTU

Specifies the maximum size (in bytes) of IP datagrams that can be transmitted through this interface. A datagram is a basic unit of information passed over an internet network. The minimum size of any maximum transmission unit value is 576 bytes.

*LIND: The MTU is determined by the information specified in the line description. If *LIND is specified, the MTU will be equal to the largest amount of data that can be transmitted on the line. If the LIND parameter specifies *LOOPBACK, *VIRTUALIP, or *OPC, then the MTU value will be:

*LOOPBACK

576

*VIRTUALIP

576

*OPC

32768

maximum-transmission-unit: Specify a value for the maximum transmission unit in bytes. The maximum MTU that can be specified for this interface depends on the type of physical connection to the network. The following table lists the maximum MTU values that can be specified based on the line type:

X.25

4096

Token ring (4 meg)

4060

Token ring (16 meg)

16388

Ethernet 802.3

1492

Ethernet Version 2

1500

DDI

4352

Frame relay

8177

Wireless 802.3

1492

Wireless Version 2

1500

Twinax (TDLC)

4105

 

Notes

1. The actual MTU value used for an interface is resolved during interface activation. This value is the minimum of either the specified MTU value for the interface or the largest amount of data that can be transmitted on the line.
   
2. It is suggested (not required) that the same MTU values be used for all interfaces on the same network. However, all interfaces must have an MTU that does not exceed the value used when *LIND is specified for the interface MTU.
   
3. To view the MTU value actually used for an interface, do the following:

   1. Use the ADDTCPIFC command to add the interface.
      
   2. Use the Start TCP/IP Interface (STRTCPIFC) command to activate the interface.
      
   3. Use the Work with TCP/IP Status (WRKTCPSTS or NETSTAT) command to view the actual MTU value of the interface in bytes.

AUTOSTART

Specifies whether the interface is automatically started when the TCP/IP stack is activated with the Start TCP/IP (STRTCP) command.

*YES: The interface is automatically started when TCP/IP is started.

*NO: The interface is not started when TCP/IP is started.

Note:

The Start TCP/IP Interface (STRTCPIFC) command can be used to start an interface any time after TCP/IP has been activated.

PVCLGLCHLI

Specifies the permanent virtual circuit (PVC) logical channel identifiers that can be established on an X.25 interface by the TCP/IP protocol stack. Up to 64 unique channel identifiers may be specified. These logical channel identifiers must be included in the X.25 line description that is specified with the LIND parameter on the ADDTCPIFC command.

With this parameter you can share the line with other communications software, such as Systems Network Architecture (SNA). It prevents the TCP/IP protocol stack from monopolizing the PVCs defined for the line.

 

Notes

1. This parameter is valid only for an interface defined on a X.25 line description.
   
2. PVCs cannot be used in a DDN network.
   
3. When specifying PVCs for an X.25 interface, all interfaces on the same X.25 network should have the same set of PVC logical channel identifiers specified. This is especially important if one or more remote system information (RSI) entries will use a PVC to connect to the RSI entry's remote system on the X.25 network.
   
4. If the RSI entries are defined such that two or more remote internet addresses can be reached across the same PVC, that PVC is shared.
   
5. The sum of the maximum switched virtual circuits (MAXSVC) and the number of PVCs cannot exceed 64.

logical-channel-identifier: Specify the PVC logical channel identifier value. The value may be from 001 to FFF. Up to 64 PVC logical channel identifiers can be specified.

IDLVCTTIMO

Specifies the duration (in seconds) that TCP/IP waits before clearing an idle virtual circuit established on an X.25 interface. Clearing an idle virtual circuit frees resources on the network. TCP/IP automatically reestablishes virtual circuits when required to send or receive data. Virtual circuits are transparent to a TCP/IP client and have no noticeable effect on TCP connections.

Note:

This parameter is valid only for switched virtual circuits (SVCs) on an interface defined on an X.25 line description. It is not valid for permanent virtual circuits (PVCs).

60: The idle virtual circuit timeout is 60 seconds.

number-of-seconds: Specify the idle virtual circuit timeout. Valid values range from 1 through 600 seconds.

MAXSVC

Specifies the maximum number of concurrent switched virtual circuits (SVC) that can be established on an X.25 interface by the TCP/IP protocol stack.

With this parameter you can share the line with other communications software such as Systems Network Architecture (SNA). It prevents the TCP/IP protocol stack from monopolizing the SVCs defined for the line. This parameter is valid only for an interface defined on an X.25 line description.

Note:

The sum of the maximum switched virtual circuits (MAXSVC) and the number of PVCs cannot exceed 64.

64: If 64 is specified, the number of SVCs that are configured is the sum of the number of *SVCIN, *SVCOUT and *SVCBOTH SVCs defined for the line description (LIND) that is used by this interface. This is the maximum number of SVCs that can be authorized for processing by the TCP/IP protocol stack.

X.25-maximum-virtual-circuits: Specify the number of SVCs that TCP/IP protocol stack can use simultaneously. The valid values range from 0 through 64.

DDN

Specifies whether the X.25 interface is connected to the Defense Data Network (DDN). The DDN network is a special type of X.25 network used by TCP/IP customers with special security needs.

Note:

This parameter is valid only for switched virtual circuits (SVCs) on an interface defined on an X.25 line description. It is not valid for permanent virtual circuits (PVCs).

Attention:

If you specify multiple interfaces to the same X.25 network, the DDN value should be equal for all of those interfaces. This is not enforced by the ADDTCPIFC or CHGTCPIFC commands.

If the X.25 network is on the DDN network, do not define the remote system information for any of the remote systems on the network. The remote system information for the DDN X.25 network is determined from the destination IP address.

*NO: The X.25 interface is not connected to the Defense Data Network.

*YES: The X.25 interface is connected to the Defense Data Network.

BITSEQ

Specifies the order, most or least significant bit first, in which the Address Resolution Protocol (ARP) places the bits in the hardware address. This parameter is valid only for a token-ring local area network (TRLAN) line.

Note:

All interfaces defined to a single token-ring line must have the same BITSEQ value. This is checked by the ADDTCPIFC code to ensure consistent values.

*MSB: The most significant bit is placed first.

*LSB: The least significant bit is placed first.

Examples for ADDTCPIFC

Example 1: Adding a Non-AUTOSTART Interface

ADDTCPIFC   INTNETADR('130.14.3.5')
  LIND(COTTAGELAN) AUTOSTART(*NO)
  SUBNETMASK('255.255.255.0')

This command assumes that an Ethernet line has been created named COTTAGELAN using the CRTLINETH command. This command adds the interface 130.14.3.5 to the TCP/IP configuration. This interface uses the line description named COTTAGELAN. It is not automatically started when the STRTCP command is run. This interface must be started using the Start TCP/IP Interface (STRTCPIFC) command. The STRTCPIFC can be issued either directly from a command line or by using option 9 from either of the following lists:

• The Work with TCP/IP Interface Status list. Use menu option 1 from the menu displayed when the Work With TCP/IP Status (WRKTCPSTS) command is issued to display this list.
  
• The Work with TCP/IP Interfaces list. Use menu option 1 from the menu displayed when the Configure TCP/IP (CFGTCP) command is issued to display this list.

Example 2: Adding an AUTOSTART Interface

ADDTCPIFC   INTNETADR('8.77.0.21')
  LIND(COTTAGEX25) IDLVCTTIMO(45)
  MAXSVC(15) DDN(*YES)
  SUBNETMASK('255.255.255.0')

This command assumes that an X.25 line has been created named COTTAGEX25 using the CRTLINX25 command. This command adds interface 8.77.0.21 to the TCP/IP configuration. This interface uses the line description named COTTAGEX25. When TCP/IP is started using the Start TCP/IP (STRTCP) command, the interface is automatically started. The idle virtual circuit timeout is 45 seconds. The maximum number of concurrent SVCs allowed to be used by TCP/IP on this interface is 15. This interface is connected to the Defense Data Network. You do not need to define any remote system information (RSI) entries for this X.25 network because it is a DDN network.

Example 3: Adding an Interface for a twinax line that is using an associated local interface

ADDTCPIFC   INTNETADR('199.1.1.99')
  LIND(TDLCLINE) SUBNETMASK(255.255.255.0)
  LCLIFC('199.1.1.1')

This command will add a TCP/IP interface for the twinax line named TDLCLINE. This interface will be associated with local interface 199.1.1.1. This means that the devices attached to twinax line 199.1.1.99 can take advantage of 'appearing' to be on the same network as the local 199.1.1.1 interface (transparent subnetting). No special routing is required to ensure packets from the twinax connnected hosts can travel to the local 199.1.1.0 network. Also, hosts on the 199.1.1.0 network can also reach the twinax hosts without any additional routing on the host systems.

Error messages for ADDTCPIFC

*ESCAPE Messages

TCP1D03

&1 member record length not correct.

TCP1D04

Error occurred processing member &1 of &2/&3.

TCP1901

Internet address &1 not valid.

TCP1902

Internet address &1 not valid.

TCP1908

Internet address &1 not valid.

TCP8050

*IOSYSCFG authority required to use &1.

TCP9999

Internal system error in program &1.