Start TCP/IP Interface (STRTCPIFC)
| Where allowed to run: All environments (*ALL) Threadsafe: Conditional |
Parameters Examples Error messages |
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 (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.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| INTNETADR | Internet address | Character value, *AUTOSTART, *IP4DHCP, *IP6SAC | Optional, Positional 1 |
| ALIASNAME | Alias name | Simple name | Optional |
| LIND | Line description | Single values: *ADRALIAS Other values: Element list |
Optional |
| Element 1: Line description | Name | ||
| Element 2: Virtual LAN identifier | 1-4094, *NONE |
| Top |
Internet address (INTNETADR)
Specifies the internet address of the interface that had previously been added to the TCP/IP configuration with the Add TCP/IP Interface (ADDTCPIFC) command.
Note: Either the INTNETADR or the ALIASNAME parameter must be specified for the command, but not both of them.
- *AUTOSTART
- Start the TCP/IP interfaces that have the AUTOSTART value set to *YES by using the Add TCP/IP Interface (ADDTCPIFC) or the Change TCP/IP Interface (CHGTCPIFC) commands.
- *IP4DHCP
- Specify that Dynamic Host Configuration Protocol should start for the associated line description. A line description name must be specified for the LIND parameter.
- *IP6SAC
- Specify that IPv6 stateless address auto-configuration should start for the associated line description. A line description name must be specified for the LIND parameter.
- character-value
- Specifies the internet address with the interface to be started.
An IPv4 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.
An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address.
An IPv6 internet address must be a unicast address and must not contain an imbedded IPv4 address (compatibility or mapped). If the IPv6 address is a link-local unicast address, a line description name must be specified for the LIND parameter.
If the internet address is entered from a command line, the address must be enclosed in apostrophes.
| Top |
Alias name (ALIASNAME)
Specifies the name of the interface to be started. The alias name specified may be for an IPv4 or IPv6 interface.
Note: Either the INTNETADR or the ALIASNAME parameter must be specified for the command, but not both of them.
- simple-name
- Specify the name of the interface to be started.
| Top |
Line description (LIND)
Specifies the name of the line description associated with the interface being started.
Single values
- *ADRALIAS
- The line description is determined from either the INTNETADR value or the ALIASNAME value.
Element 1: Line description
- name
- Specify the name of the line description associated with the interface being started. The line description must be specified if the INTNETADR value is *IP4DHCP, *IP6SAC, or an IPv6 link-local unicast address.
Element 2: Virtual LAN identifier Specifies the virtual LAN identifier of the associated line. This identifies the virtual LAN to which this interface belongs according to IEEE standard 802.1Q. This parameter is only valid for interfaces defined for Ethernet adapters that support the 802.1Q standard.
- *NONE
- This interface is not part of a virtual LAN.
- 1-4094
- Specify the virtual LAN identifier of the associated line.
| Top |
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.
Example 5: Starting an Ethernet IPv6 Interface
STRTCPIFC INTNETADR('1234:5678:9ABC:DEF0:1111:2222:3333:4444')
This command causes the TCP/IP protocol stack to start the IPv6 interface associated with address 1234:5678:9ABC:DEF0:1111:2222:3333:4444.
Example 6: Starting an Ethernet IPv6 Link-Local Interface
STRTCPIFC INTNETADR('FE80::1234') LIND(ETHLINE)
This command causes the TCP/IP protocol stack to start the IPv6 link-local interface associated with address FE80::1234 and line description ETHLINE.
Example 7: Starting IPv6 Stateless Address Auto-Configuration on an Ethernet Line with a Virtual LAN
STRTCPIFC INTNETADR(*IP6SAC) LIND(ETHLINE2 23)
This command causes the TCP/IP protocol stack to start IPv6 stateless address auto-configuration for line ETHLINE2 on virtual LAN 23.
| Top |
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.
| Top |