Specifying an X server, the configuration file, and parameters
To override a parameter setting that is in the configuration file you are using, enter:
C:\ DWDOSx86 filename.INI /param=setting
___________________ Note __________________ _ You must use either a slash (I) or a hyphen (-) before each parameter name.
5-2 Starting the X Server
Examples
Command Element DWDOSx86
filename.ini
param setting
Explanation
Either DWDOS286 or DWDOS386, depending on the X server you want to use.
If you named your configuration file something other than the default DWDOS.INI, filename represents the name of the configuration file.
For example, OTHER.INI. (It is not necessary to specify DWDOS.INI on this command line.)
The parameter you are setting.
The setting of the parameter that should take effect for the duration of this X server session.
Table 5-1 contains the following information for each parameter that you can specify on the command line when you start an X server:
• The correct syntax for entering parameters
• Settings you can specify for each parameter
_____________________ Note __________________ ___
Explanations for each parameter are provided in Chapter 3, Configuring Your Personal Computer for PC DECwindows Motif.
The following example starts DWDOS386; it uses the configuration file with the default name DWDOS.INI, and specifies the font path location L: \ NEWFONT:
c:\ DWDOS386 /FONT_PATH=L:\NEWFONT
The next example starts DWDOS286; it uses a configuration file named NEWINI.INI, and starts the XUI Window Manager located on SRVRl (user name USERl, password SECRET). Note that the quotation marks (") start before the slash (/) when you specify a parameter that has a space in it:
C:\ DWDOS286 NEWINI.INI "/APPLICATION=SRVR1/USER1/SECRET DECW$WINMGR"
Starting the X Server 5-3
Table 5-1 Syntax for Setting Parameters at the Command Line
Specify this Parameter Name on
the Command Line Parameter Setting Information
HELP To display the syntax and valid
settings for specifYing parameters at the command line. Specifying DWDOSx86 !HELP does not start the X server. For example, DWDOS286 !HELP.
VERSION To obtain the version number,
date, and time of the X server.
For example, DWDOS386
!VERSION.
TMP _DIRECTORY Specify drive: \ directory. For example, DWDOS286 ITMP _ DIRECTORY =C: \ SWAP.
FONT_PATH Specify drive:\ directory. For example, DWDOS386 IFONT_
PATH=F: \ FONTS 75.
KEYSYM_FILE Specify drive: \ directory, and file name. For example, DWDOS286 /KEYSYM_FILE=
F: \ KEYSYM\ LK250DUS.XKS.
MB3_EMULATION If you use a 2-button mouse, specify the key combination you want emulate MB3. Specify
o
for no emulation; 1 forI
CtrI/MB21; 2 forI
AltlMB2t
3 forI
Ctri/AltlMB2t
4 forI
ShiftlMB2t
5 forI
CtrilShiftlMB2 ~ 6 forI
AltlShiftlMB2t
7 for Ctri/AltlShiftlMB2 For examp e, 386 IMB3_
EMULATION = 1.
TELNET_PROMPT Enter the DCL prompt for the VMS account that uses TCPIIP. For example, DWDOS286
"ITELNET_PROMPT=PUBLIC" . (continued on next page)
Table 5-1 (Cont.) Syntax for Setting Parameters at the Command Line Corresponding
Parameter Name in Configuration Utility Application Startup Information
Controlling Hosts
Valid Nodes
Message Log File
Specify this Parameter Name on
the Command Line Parameter Setting Information APPLICATION Enclose the parameter, node,
username, password, and X application name in quotation marks. For example, DWDOS386
"/APPLICATION=
SRVRlIJONES/SECRET DECW$CALC".
CONTROLLING_HOSTS
To start more than one application, specify the full parameter for each application.
For example: DWDOS386
"/APPLICATION=SRVRlIJONES/
SECRET DECW$CALC"
"/APPLICATION= SRVRI/
JONES/SECRET DECW$CALENDAR".
Specify the node name.
For example, DWDOS286
/CONTROLLING_HOSTS=SRVR2.
You can specifY only one controlling host at the command line.
Specify the node name. For example, DWDOS386IVALID_
NODES=NODE4. You can specify only one valid node at the command line.
Specify the location and name for the log file. For example, DWDOS286 ILOG_
FILE=C: \ERRORS.LOG.
(continued on next page)
Starting the X Server 5-5
Table 5-1 (Cont.) Syntax for Setting Parameters at the Command Line
Specify this Parameter Name on
the Command Line Parameter Setting Information SCREEN_COLOR Specify a a valid color. Enclose
the parameter and color in quotation marks. Two examples are: DWDOS286 "/SCREEN_
COLOR=BLUE" and DWDOS286
"/SCREEN_COLOR=LIGHT BLUE".
SESSION_MANAGER
POINTER
You can use this parameter to specify a color from the DWDOS.RBG file that is not specified on the screen for the screen color parameter. For example, DWDOS286 /SCREEN_
COLOR=antiquewhite2.
Specify the amount in Kbytes of conventional memory you want to reserve. For example, DWDOS286 IDOS_RESERVE=20. example, DWDOS386 /SAVE_
UNDERS=1.
Specify 0 for OFF; 1 for ON. For example DWDOS286 IBACKING_
STORE=1.
Specify 1 for ON; 0 for OFF.
For example, DWDOS386 IPOINTER=O.
(continued on next page)
Table 5-1 (Cont.) Syntax for Setting Parameters at the Command Line Corresponding
Parameter Name In Configuration Utility Pointer Acceleration
Pointer Threshold
Keyboard Mouse Speed
Shift Lock State Interpretation
Bell Pitch
Bell Duration
Specify this Parameter Name on
the Command Line Parameter Setting Information POINTER_ACCELERATION Specify 1 for none; 2 for slow;
3 for medium; 4 for fast. For example, DWDOS286 IPOINTER_
ACCELERATION=3.
POINTER_THRESHOLD Specify a value from 1 to 100 where 1 is fastest and 100 is slowest. For example, DWDOS386 IPOINTER_
THRESHOLD=20.
KBDPOINTER_ACCELERATION Specify a value from 1 to 100 where 1 is no delay and 100 is longest delay. For example, DWDOS286 IKBDPOINTER_
ACCELERATION=90.
For shift lock key to shift entire keyboard, specify 1; for only alpha keys on main keyboard, specify O. For example, DWDOS386 /SHIFT_LOCK=O.
Specify a value from 0 to 2000 (in Hz). For example, DWDOS286 IBELL_PITCH=440.
Specify a value from 0 to 32000 (in milliseconds). For example, DWDOS386 IBELL_
DURATION=100.
(continued on next page)
Starting the X Server 5-7
Table 5-1 (Cont.) Syntax for Setting Parameters at the Command Line
Corresponding Parameter Name In Configuration Utility Screen Saver Timeout
Backward Compatibility
VMS TCP/IP Timeout
Next Step
Specify this Parameter Name on
the Command Line Parameter Setting Information SCREENSAVER_TIMEOUT Specify a value from 0 to 480
(in minutes). For example, DWDOS286 /SCREENSAVER_
TIMEOUT=30.
BUG_COMPATIBILITY Specify 1 for ON; 0 for OFF. For example, DWDOS386 IBUG_
COMPATIBILITY=O.
TELNET_TIMEOUT Specify the number of seconds before the attempt to start an X application on the VMS TCP/IP node times out. For example, DWDOS286 fI'ELNET_
TIMEOUT=60.
For information on starting X applications, see Chapter 6, Starting X Applications.
5-8 Starting the X Server
6
Starting X Applications
This chapter describes the following methods of starting X applications:
• From the PC Session Manager
• Automatically at startup
• From a terminal session
___________________ Note __________________ _ If you did not configure your workstation to automatically start a window manager when you start the X server, you should start a window manager as the first X application.
A window manager allows you to select, move, and change the size of windows; it also allows you to shrink windows to icons, expand icons to windows, and to stack overlapping windows.
Starting X Applications 6-1