Using the Operations Interface (OI) to Configure OSI-TCP/IP Address Pairs

The following commands enable you to configure, modify, and inquire on OSI-TCP/IP address pairs:

  • ADD NETWORK ADDRESS PAIR

  • DELETE NETWORK ADDRESS PAIR

  • NETWORK ADDRESS PAIR

  • OSITCP CONNECTION

For a complete description of each command, refer to the Networking Commands and Inquiries Help.

For more information about basic OSI commands, refer to the OSI Software Operations Guide.

Note: If you make any changes to your network using these commands, those changes are only in effect until the next initialization of your network.

Mapping a TCP/IP Host's IP Address to Its OSI NSAP Address

For a local or remote TCP/IP host to run OSI applications, you must identify a pairing between the host's IP address (when configuring a destination host you can use a domain name in place of, or with, the destination host's IP address) and its NSAP address. To do so, issue the following commands:

  • When configuring a local host, enter one of the following commands at the system console:

    NW ADD NETWORKADDRESSPAIR NSAPADDRESS = <NSAP address> TO IPADDRESS = <IP address>

    NW ADD NETWORKADDRESSPAIR NSAPADDRESS = <NSAP address> TO IPADDRESS = <IP address> DOMAINNAME = <domain name>

The variables are described as follows.

Variable

Description

<NSAP address>

The OSI NSAP address configured for the local host.

<IP address>

The TCP/IP IP address configured for the local host.

<domain name> Optional

The TCP/IP domain name configured for the local host.

This value must be entered enclosed in double quotation marks (") when entered as part of the command syntax.

  • When configuring a remote host, enter one of the following commands at the system console:

    NW ADD NETWORKADDRESSPAIR NSAPADDRESS = <NSAP address> TO IPADDRESS = <IP address>

    NW ADD NETWORKADDRESSPAIR NSAPADDRESS = <NSAP address> TO IPADDRESS = <IP address> DOMAINNAME = <domain name>

    NW ADD NETWORKADDRESSPAIR NSAPADDRESS = <NSAP address> TO DOMAINNAME = <domain name>

Note: If the local TCP/IP host in your network is configured with multiple network paths (multiple IP addresses), you might want to issue one of the following commands as a means of controlling the specific outbound connection (network path) that will be used by the local host when communicating with the remote host.

NW ADD NETWORKADDRESSPAIR NSAPADDRESS = <NSAP address> TO IPADDRESS = <IP address> DOMAINNAME = <domain name> LOCALIPADDRESS = <local IP address>

NW ADD NETWORKADDRESSPAIR NSAPADDRESS = <NSAP address> TO DOMAINNAME = <domain name> LOCALIPADDRESS = <local IP address>

The variables are described as follows.

Variable

Description

<NSAP address>

The OSI NSAP address configured for the remote host.

<IP address>

The TCP/IP IP address configured for the remote host.

<domain name>

The TCP/IP domain name configured for the remote host.

This value must be entered enclosed in double quotation marks (") when entered as part of the command syntax.

<local IP address>

The TCP/IP IP address of the local host that identifies the outbound connection you want the local host to use in communication with the remote host.

If the command is successful, the system responds with the following response:

NETWORK ADDRESS PAIRING ADDED

Deleting the Mapping Between an OSI-TCP/IP Address Pair

Use the DELETE NETWORK ADDRESS PAIR command to delete a previously configured OSI‑TCP/IP address pair. To delete an OSI-TCP/IP address pair, issue one of the following commands at the system console:

  • To delete all the OSI-TCP/IP address pairs configured in your network, issue the following command at the system console:

    NW DELETE NETWORKADDRESSPAIR *ALL

  • There are many variations of the command syntax that are acceptable when you have a specific OSI-TCP/IP address pair that you want to delete from the network. For a complete syntax diagram illustrating all of your options, refer to the Networking Commands and Inquiries Help.

The following table lists several command syntax options that are available for deleting a specific OSI-TCP/IP address pair.

To delete . . .

Issue this command at the system console . . .

All OSI-TCP/IP address pairings associated with a specific NSAP address

NW DELETE NETWORKADDRESSPAIR NSAPA = <NSAP address> TO *ALL

An OSI-TCP/IP address pair associated with a specific NSAP address and domain name

NW DELETE NETWORKADDRESSPAIR NSAPA = <NSAP address> TO DOMAINNAME = <domain name>

All OSI-TCP/IP address pairings associated with a specific IP address

NW DELETE NETWORKADDRESSPAIR IPADDRESS = <IP address> TO *ALL

An OSI-TCP/IP address pair associated with a specific domain name

NW DELETE NETWORKADDRESSPAIR DOMAINNAME = <domain name>

All OSI-TCP/IP address pairings associated with a local host's local IP address

NW DELETE NETWORKADDRESSPAIR LOCALIPADDRESS= <local IP address>