[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Commands Reference, Volume 6

x_def_net Command


Defines an Xstation network type.


x_def_net -bFile -dDirectory-gAddress ] -hType [-mMask ] -nTypeName -sNumber -uAddress


The x_def_net command defines, for the current host, the Xstation network type specified by the TypeName parameter, and stores the definition in the /etc/bootptab file. The TypeName parameter must contain x_st_mgr. as a prefix, for example, x_st_mgr.ether. Use the -n flag with the TypeName parameter.

You can use this network type when you add an Xstation to the host with the x_add_trm_120 command or the x_add_trm_130 command.


-bFile Specifies the name of the bootfile. Because the bootfile program is downloaded into the Xstation, the bootfile entry differs for each Xstation model. The valid option for an Xstation 120 is bootfile3. The option for an Xstation 130 is bootfile4.
-dDirectory Specifies the directory where the Xstation Network Type configuration files reside. This directory must exist, with root having write permission. The default home directory is /etc/x_st_mgr.
-gAddress This optional parameter specifies the gateway address. The default option is the Internet address of the host system that establishes a communication connection to another Ethernet, IEEE 802.3, or token-ring system. This address is an Internet address unique to the gateway, in dotted decimal format: ddd.ddd.ddd.ddd, where 0<ddd<255.

To designate a default gateway, select a gateway that is on the same local network as the Xstation. If the Xstation has more than one network connection, you can set a gateway for each network.

When multiple gateways are defined for an Xstation, only one default gateway can be used. The configured gateway is determined during the boot process for the Xstation. If the Xstation is booted from a token-ring network, the token-ring gateway is selected; otherwise, the Ethernet gateway address is selected.

-hType Specifies the type of physical network connection used for the terminal, Ethernet, or token-ring or IEEE802.3. Press the F4 key in SMIT to select a network type. Valid options are ethernet, tokenring or ieee802. The default option is ethernet.

An Xstation network type must be defined for each network. The same Xstation can be on multiple networks, but must be configured with a different name and Internet address for each network.

-mMask Specifies the subnet mask. A network subnet mask is required for each gateway entry to tell the system what the subnet partitioning scheme is. This 4-byte bit mask, in dotted decimal format, consists of the Network Address portion and the Subnet Address portion of the Internet address. The Xstation uses the subnet mask to determine if the destination address is on the local network. If the destination address is not local, then the Xstation directs the packet to the gateway. The gateway then forwards the packet. For more information, refer to Subnet Masks in "TCP/IP Addressing" in AIX Version 4.3 System Management Guide: Communications and Networks.
-nTypeName Specifies the name you choose to identify a network type for a specific network-Xstation model-subnet combination. The TypeName parameter must begin with the prefix x_st_mgr. and have a unique postfix, which can include the uppercase and lowercase letters a through z, the numbers 0 through 9, the _ (underscore), the - (dash) and the . (period). An example is x_st_mgr.ether130 for an Ethernet-Xstation 130 combination.
-sNumber Specifies the number of the server port. The default value is 9000. This value must match the value in /etc/services file.
-uAddress Specifies the full Internet address of the machine that performs name resolution for the Xstation.


Access Control: Only the root user should have execute (x) access to this command.


To add a network type named x_st_mgr.ether , enter a command like the following:

x_def_net -nx_st_mgr.ether -bbootfile4 \
-d/etc/x_st_mgr -hethernet -s9000 

In this example, the characteristics include the following: the bootfile name is bootfile4 , the home directory is /etc/x_st_mgr , the network type is ethernet and the server port number is 9000.


/usr/lpp/x_st_mgr/bin/x_def_net Contains the x_def_net command.
/etc/bootptab Contains the boot protocol table.
/etc/x_st_mgr/<TypeName>.cf Contains the network configuration file.

Related Information

The aixterm command, bootpd daemon, login command, pclient command, x_add_nfs_fpe command, x_add_trm_120 command, x_add_trm_130 command, x_add_trm_140 command, x_add_trm_150 command, x_add_trm_160 command, x_add_xst_fpe command, x_chg_net command, x_chg_trm_120 command, x_chg_trm_130 command, x_chg_trm_140 command, x_chg_trm_150 command, x_chg_trm_160 command, x_def_net command, x_ls_net command, x_ls_net_fp command, x_ls_trm command, x_rm_fpe command, x_rm_net command, x_rm_trm command.

[ Previous | Next | Contents | Glossary | Home | Search ]