[ Previous | Next | Contents | Search ]
AIXLink/X.25 1.1 for AIX: Guide and Reference

x25ip Command

Purpose

Updates or displays translate information in the IP/X.25 translate table.

Syntax

x25ip [ -h Host ] [ -a ] [ -o Options ] [ -d ] [ -s ] [ -z ]

Description

The x25ip command updates or displays IP/X.25 translate information. The translate table allows Internet addresses used by the Internet Protocol (IP) to be mapped to specific X.25 virtual circuits with specific X.25 circuit characteristics. New entries and updates to existing entries are written to or deleted from the IP/X.25 translate table.

Note: Users must have root authority to issue the x25ip command.

The x25ip command uses the gethostbyname subroutine to obtain the IP address of a specified host. The host name specified should exist in the /etc/hosts file or be retrievable from a name server. However, the IP address can be used instead of a host name.

If the command is completed successfully, a value of 0 is returned. If the command is unsuccessful, a value of -1 is returned.

The IP/X25 translate table can be updated using the System Management Interface Tool (SMIT).

Flags

-a Adds or changes the specified options for the given host name.
-d Deletes the specified host.
-h HostName Specifies the host name to use for add, delete and show flags.
-o Options Specifies options for the given host name. Valid values are:
vc_type Specifies the X.25 virtual circuit type: switched virtual circuit (SVC), or permanent virtual circuit (PVC). Valid values are 1 for SVC and 2 for PVC. The parameters for SVC and PVC are as follows:
SVC Parameters (vc_type=1)
remote_dte Specifies the X.25 address of the remote DTE. Valid values consist of 1 to 15 ASCII decimal digits (X.121 address). Valid values are 0 through 9. rcv_wndsiz Specifies the maximum receive window size to be used with the virtual circuit. Valid values are 1 through 127. xmit_wndsiz Specifies the maximum transmit window size to be used with the virtual circuit. Valid values are 1 through 127. rcv_pktsiz Specifies the maximum receive packet size to be used with the virtual circuit. Valid values are 64, 128, 256, 512, 1024, 2048, 4096. xmit_pktsiz Specifies the maximum transmit packet size to be used with the virtual circuit. Valid values are 64, 128, 256, 512, 1024, 2048, 4096. callusr_data Specifies the optional user-defined facilities to be used in the call request packet. Valid values consist of 1 through 16 HEX digits, with digit values 0 through F. RPOA_selec Specifies the data network identification code or codes identifying a requested RPOA transit network. Valid values consist of 4 ASCII digits, with digit values 0 through 9. Up to 10 groups of 4 digits may be specified. cug_indx Specifies the closed user group index to be used with the closed user group facility. Valid values are 0 through 9999.
cug_indxout Specifies the closed user group index to be used with the closed user group outgoing access facility. Valid values are 0 through 9999.
PVC Parameters (vc_type=2)
logical_chann Specifies the X.25 logical channel to be used for the PVC. Valid values are 1 through 4095.
port_nam Specifies the port name (sx25a0, sx25a1, ...) that is used by this PVC. -s Shows current options for the given host or display list of host names. -z Displays output in dotted decimal format. This flag is not normally used if the command is issued from the command line.

Examples

  1. To initialize the IP/X.25 translate table, issue the following command: 
    x25ip
  2. To show the current IP/X25 translate values for host node1 , issue the following command: 
    x25ip -h node1 -s
  3. To add options to the host node2 , issue the following command: 
    x25ip -h node2 -a -ovc_type=1,remote_dte=31060164,callusr_data=CC,rcv_pktsize=1024,xmit_pktsize=10

Related Information

The gethostbyname subroutine.

The /etc/hosts file format.

TCP/IP Network Interfaces, TCP/IP Name Resolution, How to Configure a Network Interface, The SMIT Interface for TCP/IP in AIX Version 4.3 System Management Guide: Communications and Networks.

Object Data Manager (ODM) Overview for Programmers in General Programming Concepts.

[ Previous | Next | Contents | Search ]