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 Information (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:

  1. 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.
  2. 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.
  3. Attempts to change or remove a route or interface that is required to reach an existing RSI entry will fail.

Restrictions:

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:

  1. If this parameter's value is specified, the NETADR parameter value cannot be specified.
  2. 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 &1 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