Add TCP/IP Remote System (ADDTCPRSI)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Add TCP/IP Remote System (ADDTCPRSI) command is used to associate an internet address with an X.25 network address or a local permanent virtual circuit (PVC) logical channel identifier in the TCP/IP configuration.
When the user works with an X.25 public or private data network, the internet address and the network address of each remote system or local (PVC) logical channel identifier needs to be specified.
ATTENTION:
- Do not specify the X.25 network address for systems on the X.25 Defense Data Network (DDN). The X.25 DDN has a built-in conversion algorithm that converts an IP address to the remote DTE address. If you specify an X.25 network address for remote systems on an X.25 DDN, the DDN conversion algorithm is bypassed. In this case it is possible that you will not be able to connect to the requested host.
- 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 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.
- Attempts to change or remove a route or interface that is required to reach an existing RSI entry will fail.
Restrictions:
- You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
Note: If specific values are entered for DFTPKTSIZE and DFTWDWSIZE and the interfaces or routes are changed, conflicts could result. If *LIND is used, these values are adjusted accordingly if changes occur at the interface and route level.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| INTNETADR | Internet address | Character value | Required, Positional 1 |
| NETADR | Network address | Character value | Optional, Positional 2 |
| PVCLGLCHLI | PVC logical channel identifier | Character value | Optional, Positional 3 |
| RVSCRG | X.25 reverse charge | *NONE, *REQUEST, *ACCEPT, *BOTH | Optional |
| DFTPKTSIZE | Default packet size | Element list | Optional |
| Element 1: Transmit packet size | *LIND, 64, 128, 256, 512, 1024, 2048, 4096 | ||
| Element 2: Receive packet size | *LIND, *TRANSMIT, 64, 128, 256, 512, 1024, 2048, 4096 | ||
| DFTWDWSIZE | Default window size | Element list | Optional |
| Element 1: Transmit window size | 1-15, *LIND | ||
| Element 2: Receive window size | 1-15, *LIND, *TRANSMIT |
| Top |
Internet address (INTNETADR)
Specifies the internet address of the remote system. 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.
This is a required parameter.
| Top |
Network address (NETADR)
Specifies the X.25 network address or the DTE that is to be associated with the X.25 internet address. The user can specify a decimal number that is 1 through 17 digits in length.
Note: If you specify a value for this parameter, the PVCLGLCHLI parameter value cannot be specified.
- network-address
- Specify the X.25 network address of a remote X.25 system.
| Top |
PVC logical channel identifier (PVCLGLCHLI)
Specifies the local permanent virtual circuit (PVC) logical channel identifier that is used to establish an X.25 PVC interface to the specified remote internet address. One unique channel identifier may be specified. This unique channel identifier must have been previously identified in the ADDTCPIFC or CHGTCPIFC command that defined a TCP/IP X.25 interface. The TCP/IP X.25 PVC logical channel identifier is used to establish the circuit between this system's TCP/IP X.25 interface and the host defined by the remote internet address. The logical channel identifier must also exist in the X.25 line description used for the TCP/IP X.25 interface.
Notes:
- If this parameter's value is specified, the NETADR parameter value cannot be specified.
- When specifying a PVC, consider which interface or set of interfaces this RSI entry could use to connect to the remote system. Each of the interfaces that could be used to reach this RSI entry's remote system must have the specified PVC logical channel ID configured as part of the interface.
- logical-channel-identifier
- Specify the PVC logical channel identifier value. The value may be from 001 to FFF. Only 1 PVC logical channel identifier can be specified.
| Top |
X.25 reverse charge (RVSCRG)
Specifies whether reverse charges are accepted or requested on an X.25 remote system basis.
- *NONE
- Reverse charges are not accepted or requested.
- *REQUEST
- Reverse charges are requested on outgoing call request packets. Reverse charges are not accepted on incoming call request packets.
- *ACCEPT
- Reverse charges are accepted on incoming call request packets. Reverse charges are not requested on outgoing call request packets.
- *BOTH
- Reverse charges are requested for outgoing call request packets and are accepted on incoming call request packets.
| Top |
Default packet size (DFTPKTSIZE)
Specifies the default packet size used by the X.25 network for transmission and reception. The values specified here should match the default values used by the X.25 network.
Element 1: Transmit packet size
- *LIND
- The value specified in the line description associated with the X.25 interface used to reach the remote system is used as the default packet size.
- transmit-packet-size
- Specify a default packet size for transmission. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.
Element 2: Receive packet size
- *LIND
- The value specified in the line description associated with the X.25 interface used to reach the remote system is used as the default packet size.
- *TRANSMIT
- The value specified as the packet size for transmission is used as the default for reception.
- receive-packet-size
- Specify a default packet size for reception. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.
| Top |
Default window size (DFTWDWSIZE)
Specifies the default packet window size for transmission to and reception from remote systems attached to the X.25 line.
Element 1: Transmit window size
- *LIND
- The value specified in the line description associated with the X.25 interface used to reach the remote system is used as the default window size.
- 1-15
- Specify the appropriate default window size. Valid values range from 1 through 7 for networks that use modulus 8 packet numbering. Valid values range from 1 through 15 for networks that use 128 packet numbering. The modulus value is specified on the X.25 line description.
Element 2: Receive window size
- *LIND
- The value specified in the line description associated with the X.25 interface used to reach the remote system is used as the default window size.
- *TRANSMIT
- The value specified as the default window size for transmission is used as the default for reception.
- receive-window-size
- Specify the appropriate default window size. Valid values range from 1 through 7 for networks that use modulus 8 packet numbering. Valid values range from 1 through 15 for networks that use 128 packet numbering. The modulus is specified on the X.25 line description.
| Top |
Examples
Example 1: Adding RSI with NETADR
ADDTCPRSI INTNETADR('8.76.0.12') NETADR(4005)
This command allows the TCP/IP protocol stack to associate the internet address of 8.76.0.12 with the X.25 network address of 4005. Defaults are used for the remaining parameters.
Example 2: Adding RSI with PVCLGLCHLI
ADDTCPRSI INTNETADR('145.9.43.188') PVCLGLCHLI(231)
This command allows the TCP/IP protocol stack to associate the internet address of 145.9.43.188 with the X.25 PVC local logical channel identifier 231. Defaults are used for the remaining parameters.
Example 3: Adding RSI with Additional Parameters
ADDTCPRSI INTNETADR('135.63.45.23') NETADR(6031546)
RVSCRG(*BOTH) DFTPKTSIZE(1024 *TRANSMIT)
DFTWDWSIZE(*LIND *TRANSMIT)
This command allows the TCP/IP protocol stack to associate the internet address of 135.63.45.23 with the X.25 network address of 6031546. The reverse charges are used for both outgoing and incoming call request packets. The default packet size is set to 1024, and the default window size is set to the value specified in the line description associated with the X.25 interface used to reach the remote system.
| Top |
Error messages
*ESCAPE Messages
- TCP1D03
- &1 member record length not correct.
- TCP1D04
- Error occurred processing member &1 of &2/&3.
- TCP1901
- Internet address &2 not valid.
- TCP1902
- Internet address &1 not valid.
- TCP1908
- Internet address &1 not valid.
- TCP26D5
- Error occurred processing file.
- TCP8050
- *IOSYSCFG authority required to use &1.
- TCP9999
- Internal system error in program &1.
| Top |