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

x_add_trm_120 Command

Purpose

Adds an Xstation 120 to the host.

Syntax

x_add_trm_120 120 Name TypeName Address Server Time Device PanShape Mode Host Language Keyboard File Font Location LPFkeyport

Description

The x_add_trm_120 command adds the Xstation 120 specified by the Name parameter to the current host, and stores the configuration in the /etc/x_st_mgr/x_st_mgrd.cf file, the /etc/x_st_mgr/x_st_mgrd.tmty file, and the /etc/bootptab file.

Parameters

Mandatory parameters are:

120 Specifies that this command is used only for an Xstation 120.
Name Specifies the name of the Xstation. The Name parameter can be up to eight characters long and include the uppercase or lowercase letters a through z, the numbers 0 through 9, the - (dash) and the . (period). Name can be a user name, such as taylor , or a group name with a number appended, such as graphs-2. The terminal name must be known to the host system.
Note: Name should not start with a uppercase or lowercase o or x, followed by an octal or hexadecimal numeric. These characters are interpreted as octal or hexadecimal numbers, instead of as a terminal name. In the examples x3 and xE4, the 3 and the E4 are hexadecimal numerics.
TypeName Specifies the name you defined for this network-Xstation model-subnet combination with the Define an Xstation Network Type option in SMIT or with the x_def_net command. Press the F4 key in SMIT to select the network type. An example is x_st_mgr.ether120 for Ethernet and an Xstation 120.
Address Specifies the Local Area Network (LAN) hardware address of the Xstation. This address appears on the LAN Statistics screen when you power-on the Xstation. Each Xstation has a unique 6-byte hexadecimal hardware address, in XXXXXXXXXXXX format, that cannot be changed by the user.
Server Specifies whether or not the host system is a primary boot server. A primary boot server responds immediately to a boot-protocol broadcast request from an Xstation; for other (secondary) boot servers, a delay time is imposed (see Time, listed next). Two options are valid: y if the server is a primary server, and n if the server is not a primary server. The default option is y.
Time Specifies the number of seconds a secondary boot server must wait before answering a boot-protocol broadcast request. (The valid number for a primary server is 0, because there is no delay time.) In SMIT, press the F4 key to see the recommended range of values. Generally, a value less than the minimum value does not distinguish between a primary and secondary server, and a secondary server may be selected even when the primary server is available. A value greater than the maximum value may lead to a time out.
Device Specifies the input device. Device must be mouse or tablet. In SMIT, press the F4 button to select the input device. The default option is mouse.

You can attach a 6093 tablet device (Model 11 or Model 12) to the Xstation serial port. A tablet uses absolute positioning, as opposed to the relative positioning of a mouse, and cannot change the initial cursor location. The threshold and acceleration parameters of the xset command apply only to the mouse.

X Windows protocol supports five button signals from a mouse or tablet. Buttons 1, 2, and 3 correspond to the left, middle, and right buttons respectively. Button 4 is used as an event generating button. If required by specific application programs, button 5 sends the required messages. Buttons 6 through 16, if present, are disabled.

PanShape Specifies how the hardware pan feature is to be used. Valid options are none, square, horizontal, and vertical. The default value is none.

With the hardware pan feature enabled, the physical screen shows a portion of a larger base window whose size is dependent on the amount of video memory (VRAM) installed on the Xstation. When the cursor is moved past the edge of the display, the screen will automatically scroll in that direction provided it has not already reached the edge of the base window.

Note: The window size for panning is always a power of 2. With minimum VRAM, expanding the window dimensions to a power of 2 may not leave enough memory for the shape selected.
Mode Specifies the mode used by X Display Manager Control Protocol (XDMCP). XDMCP uses the xdm program to facilitate the connection of an Xstation to a remote host. XDMCP also allows the user to turn an Xterminal off and on again and maintain an established connection to the remote host. Valid options are:
broadcast
Sends a message to the network and waits for an xdmcp host to respond.
direct
Directs a request to an xdmcp manager known to the Xstation.
indirect
Sends an indirect request to an xdmcp manager that maintains a list of xdmcp hosts. The manager assigns an xdmcp host to respond to the Xstation.
off
No X Display Manager Control Protocol (XDMCP). The default option is off.
Host Specifies the name of the xdmcp host used for direct or indirect communication with the Xstation. Valid options are none or the name of an xdmcp host. If XDMCP is not used or if broadcast mode is used, the value of Host is none. The name of an xdmcp host must be specified if Mode is direct or indirect. The default option is none.
Language Sets the language used for system messages, the LANG environment variable. Press the F4 key in SMIT to select an option.
Keyboard Sets the map for the keyboard layout. Press the F4 key in SMIT to select an option.
Font Sets the font used in the login window. Press the F4 key in SMIT to select an option.
File Sets the name of the keyboard file. The default is 'keyboard.' Some countries have a second keyboard file usually named 'keyboard.alt.'
Location Sets the position of the login window on the display. Press the F4 key in SMIT to select an option. Valid entries are Upper left, Upper right, Lower left, and Lower right.
LPFkeyport Specifies the serial port on an Xstation to which the LPF keys are attached. Press the F4 key to select an option. The valid options are none and com1.

Security

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

Example

To add Xstation taylor to the current host as a primary server, enter a command such as the following: 

x_add_trm_120 120 taylor x_st_mgr.ether 10005ac38e9 y \
00 mouse 'none' off none \
'English    (United States) IBM-850' 'English (United States)' \
'keyboard' Rom14 'Upper left' 'none'

Xstation taylor is added to the current host, as defined by the parameters: Model 120, a network type of x_st_mgr.ether , a hardware address of 10005ac38e9 , primary server status, no delay time, input from a mouse, no hardware pan feature, xdmcp mode off, no host name, United States English LANG environment variable, United States English keyboard layout, standard keyboard file, login window font Rom14, and the login window in the upper left corner of the screen, and no LPF keys.

Files

/usr/lpp/x_st_mgr/bin/x_add_trm_120 Contains the x_add_trm_120 command.
/etc/x_st_mgr/x_st_mgrd.cf Contains the Xstation Manager configuration file.
/etc/x_st_mgr/x_st_mgrd.tmty Contains the terminal type file.
/etc/bootptab Contains the boot protocol table.

Related Information

The aixterm command, bootpd daemon, login command, pclient command, x_add_nfs_fpe 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 ]