Start TCP/IP Interface (STRTCPIFC)

The Start TCP/IP Interface (STRTCPIFC) command starts a Transmission Control Protocol/Internet Protocol (TCP/IP) interface. The line associated with the interface is varied on, if required.

This command can be used to:

Start interfaces that have been specified with the AUTOSTART(*NO) value on the Add TCP/IP Interface (ADDTCPIFC) and Change TCP/IP Interface (CHGTCPIFC) commands.
Start an interface that was previously ended by the End TCP/IP Interface (ENDTCPIFC) command.

Routes are bound to interfaces using a best match first algorithm. This algorithm is based on the state of the interface and on the type of service (TOS) specified for the route and interface. When starting an interface, routes associated with an inactive interface can move to the interface started provided that interface can be used to reach the next hop gateway of the route for the requested TOS.

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.

Keyword	Description	Choices	Notes
INTNETADR	Internet address	Character value, *AUTOSTART	Optional, Positional 1
ALIASNAME	Alias name	Simple name	Optional

Internet address (INTNETADR)

Specifies the interface to be started.

Note: Either the INTNETADR or the ALIASNAME parameter should be specified for the command, but not both of them.

character-value: Specifies the internet address of an interface that had previously been added to the TCP/IP configuration with the ADDTCPIFC command. 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.
*AUTOSTART: The TCP/IP interfaces that are started are those that have set the AUTOSTART parameter to a value of *YES using the Add TCP/IP Interface (ADDTCPIFC) or the Change TCP/IP Interface (CHGTCPIFC) commands.

Alias name (ALIASNAME)

Specifies the name of the interface to be started. The alias name specified must be for an IPv4 interface. If the alias name is for an IPv6 interface, an error message will be returned.

Note: Either the INTNETADR or the ALIASNAME parameter should be specified for the command, but not both of them.

simple-name: Specify the name associated with the interface to be started.

Examples

Example 1: Starting an Interface

STRTCPIFC   INTNETADR('9.5.11.125')

This command causes the TCP/IP protocol stack to activate the interface associated with the internet address 9.5.11.125.

Example 2: Starting another Interface

STRTCPIFC   INTNETADR('156.93.81.7')

This command causes the TCP/IP protocol stack to activate the interface associated with the internet address 156.93.81.7.

Example 3: Starting AUTOSTART(*YES) Interfaces

STRTCPIFC   INTNETADR(*AUTOSTART)

This command causes the TCP/IP protocol stack to activate all interfaces that have the AUTOSTART parameter set to *YES using the Add TCP/IP Interface (ADDTCPIFC) or Change TCP/IP Interface (CHGTCPIFC) commands.

Example 4: Starting an Interface with the Alias Name

STRTCPIFC   ALIASNAME(TEST_NETWORK)

This command causes the TCP/IP protocol stack to activate the interface associated with the alias name TEST_NETWORK.

Error messages

*ESCAPE Messages

TCP1B01: Unable to determine if &1 interface started.
TCP1B02: Cannot determine if &1 interface started.
TCP1B05: &2 interface not started. Reason &1.
TCP1B10: &2 interface not started.
TCP1B11: Interface &1 line &2 not started. Maximum &7 active interfaces allowed.
TCP1B12: &1 interface not started. &1 interface already active.
TCP1B13: &1 interface not started. &1 interface not defined in the TCP/IP configuration.
TCP1B14: &1 interface not started. Line description &2 not found.
TCP1B15: Line description &2 unusable. Internal errors encountered.
TCP1B16: &2 interface not started.
TCP1B25: &1 interface not started.
TCP1B26: &1 interface not started
TCP1B27: &1 interface not started for *TDLC line description &2.
TCP265F: INTNETADR parameter value &2 not valid.
TCP9999: Internal system error in program &1.