x_chg_net Command

Commands Reference, Volume 6

x_chg_net Command

Purpose

Changes an existing Xstation network type.

Syntax

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

Description

The x_chg_net command changes, for the current host, the characteristics of the Xstation network type specified by the TypeName parameter, and stores the changed definition in the /etc/bootptab file. The TypeName parameter must contain x_st_mgr. as a prefix, for example, x_st_mgr.ether, and be used with the -n flag.

Flags

-bFile	Specifies the name of the bootfile. Because the bootfile program is downloaded into the Xstation, the bootfile entry differs for each Xstation model. Press the F4 key in SMIT to select a bootfile. The valid option for an Xstation 120 is bootfile3. The valid 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, or tokenring or ieee802. The default 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.
-nTypeName	Specifies the name you choose to identify a network type for a specific network-Xstation model-subnet combination. An example is x_st_mgr.ether130 for an Ethernet-Xstation 130 combination.
-sNumber	Specifies the number of the server port. This number must be in the /etc/services file. The default value is 9000.
-uAddress	Specifies the full Internet address of the machine that performs name resolution for the Xstation.

Security

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

Example

To change the characteristics of a network type named x_st_mgr.ether, enter a command such as the following:

x_chg_net -nx_st_mgr.ether -bbootfile3 \
-d/etc/x_st_mgr -hethernet -s9000

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

Files

/usr/lpp/x_st_mgr/bin/x_chg_net	Contains the x_chg_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.