CL Command Reference - CHGTCPIFC
CL Command List > CHGTCPIFC Reference
Description:
The Change TCP/IP Interface (CHGTCPIFC) command is used to change an existing interface in the Transmission Control Protocol/Internet Protocol (TCP/IP) configuration. The interfaces defined by the CHGTCPIFC 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 system to the TCP/IP network.
The i5/OS TCP/IP implementation supports multihoming. This allows you to specify either a single interface or multiple interfaces per line description. You can have your system 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. If you attempt to change a value for an interface that will invalidate a route or remote system information (RSI) associated with the interface, the change will not be allowed.
2. In SNMP, an 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.
Restrictions:
. You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
. Only certain values can be changed using this command. The values that can be changed depend on the status of the interface, the status of the dependent routes, and the remote system information configured.
Examples:
Example 1: Changing Autostart Value
CHGTCPIFC INTNETADR(¡¯130.14.3.5¡¯) AUTOSTART(*NO)
Assuming that an interface identified by 130.14.3.5 exists, this command changes the autostart value from *YES to *NO. The interface is not automatically started when the STRTCP command is entered.
Example 2: Changing MAXSVC and IDLVCTTIMO
CHGTCPIFC INTNETADR(¡¯8.77.0.21¡¯) INDLVCTTIMO(45) MAXSVC(15)
This command changes the idle virtual circuit time-out to 45 seconds and the maximum number of concurrent SVCs allowed to be used by TCP/IP on this interface to 15.
Example 3: Change an Interface for a Twinax Line that is Using an Associated Local Interface
CHGTCPIFC INTNETADR(¡¯199.1.1.99¡¯) LCLIFC(¡¯199.1.1.1¡¯)
This command will change the 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.
Example 4: Changing ALIASNAME
CHGTCPIFC INTNETADR(¡¯132.15.7.32¡¯) ALIASNAME(TEST_NETWORK)
This command changes the alias name for this interface to TEST_NETWORK.
Example 5: Changing the interface using the ALIASNAME
CHGTCPIFC ALIASNAME(TEST_NETWORK) AUTOSTART(*YES)
This command changes the auto start value for the interface named TEST_NETWORK.