STRTCPIFC (Start TCP/IP Interface)

STRTCPIFC Command syntax diagram

 

Purpose

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.
• Start an interface while the system is in restricted state. This is supported for Token Ring, Ethernet, or FDDI LAN lines that are not attached to an NWI or an NWS, or an ATM line.

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.

 

Required Parameters

INTNETADR

Specifies the interface to be started.

internet-address: Specify the internet address of an interface that had previously been added to the TCP/IP configuration using the Add TCP/IP Interface (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.

Examples for STRTCPIFC

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.

Error messages for STRTCPIFC

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