Syntax

winconfig config set option=value

winconfig config delete customdev=value

addwinconfig existing_config [copyto] new_config

delwinconfig config

listwinconfig

Description

addwinconfig - create a new Merge configuration

delwinconfig - delete a Merge configuration

listwinconfig - list Merge configurations

The winconfig and related commands allow you to configure the characteristics of NeTraverse Win4Lin Terminal Server sessions and save those configurations for future use.

Each user starts with one standard DOS configuration and one standard Windows configuration, dos and win, respectively. You can modify the standard configurations, create and modify new named configurations, list configurations, and delete configurations.

Most of these commands are alternatives to the Merge Setup utility, which is accessible on the X Desktop. You can use Merge Setup instead of winconfig to specify and save configuration options. The Merge Setup Save As button has the same effect as addwinconfig. Merge Setup also lists the names of saved configurations and allows you to delete them.

The winconfig command displays, sets, or deletes configuration options that customize NeTraverse Win4Lin Terminal Server sessions.

config is either the standard dos or win configuration names or the name of a saved, customized NeTraverse Win4Lin Terminal Server configuration.

Use the winconfig list command to display option values, the winconfig set command to set option values, and the winconfig delete command to remove option definitions. delete can be used only to remove customdev settings from a configuration.

option can be any of the options listed below, which affect the operation of NeTraverse Win4Lin Terminal Server sessions.

Use addwinconfig to create and save new Merge configurations. A new configuration starts as a copy of an existing configuration. Select an existing DOS or Windows NeTraverse Win4Lin Terminal Server configuration depending on whether your new configuration is for a DOS or Windows environment. Once you create a new configuration, you can use winconfig to customize it any way you want.

Configuration names can contain up to 10 characters including A through Z (uppercase or lowercase), 0 through 9, and the hyphen (-).

You can start NeTraverse Win4Lin Terminal Server sessions using saved configurations by using Merge Setup (on the X Desktop) or by using the Linux command-line +k option as follows:

dos +k[user:]config

or

win +k[user:]config

The user option allows you to share configurations with other users. When you specify user, you use the named configuration that belongs to the specified user.

Note: You cannot use the +kuser:config option to specify a configuration belonging to an NIS-administered user other than yourself.

The dos and win commands with no arguments are equivalent to dos +kdos and win +kwin, respectively.

The delwinconfig command deletes a saved configuration. You cannot delete the standard dos or win configurations.

The listwinconfig command displays the names of all configurations.

The winconfig options and their legal values are listed below. Some values are tokens. (A token is a brief name for a hardware device that is either predefined by Merge or added by the system administrator. See winadmin(1) for additional information on tokens.)

autoexecglobal=

Specifies whether the file J:\autoexec.bat is used when you start a NeTraverse Win4Lin Terminal Server session. Values are true or false.

autoexeclocal=

Specifies whether the /autoexec.bat file on your personal drive is used when you start a NeTraverse Win4Lin Terminal Server session. Values are true or false.

autoexecprivate=

Specifies an autoexec.bat file used when you start a NeTraverse Win4Lin Terminal Server session. The value is the full Linux path name to the file or blank.

autofreeze=

Specifies whether your session is temporarily suspended while the input focus is switched away from your session's window to another window. Values are true or false.

autozoom=

Not used in this version of NeTraverse Win4Lin Terminal Server. Values are true or false.

com1=

Specifies the serial port to attach for COM1 during a NeTraverse Win4Lin Terminal Server session. The value is a com1 class token.

com2=

Specifies the serial port to attach for COM2 during a NeTraverse Win4Lin Terminal Server session. The value is a com2 class token.

configglobal=

Specifies whether the file J:\config.sys is used when you start a NeTraverse Win4Lin Terminal Server session. Values are true or false.

configlocal=

Specifies whether the /config.sys file on your personal drive is used when you start a NeTraverse Win4Lin Terminal Server session. Values are true or false.

configprivate=

Specifies a config.sys file to use when you start a NeTraverse Win4Lin Terminal Server session. The value is the full Linux path name to the file or blank.

customdev=

Specifies a device to attach during a NeTraverse Win4Lin Terminal Server session. The value is a custom class token.

displaytype=

Specifies the display type to be used for a DOS session. The values are auto, vga, cga, mono, herc.

dosfont=

Specifies the font size to be used for a DOS session running inside an X window. The values are auto, small, and medium.

drive=

Specifies how drive letters are mapped. This option has the following form:

   drive=driveletter,drive_name[,readonly][,exclusive]

Here, driveletter is the DOS drive letter; drive_name can be none, indicating that the drive is not mapped to anything, a DOS fixed disk in the form dosn, or a token for a virtual drive.

ems=

Specifies the amount of expanded memory to be attached to a NeTraverse Win4Lin Terminal Server session. The value is a number of megabytes of expanded memory from 0 through 8.

installcolormap=

Specifies whether a private color map is used for NeTraverse Win4Lin Terminal Server sessions running on the Desktop. Values are true and false. (This option is useful only when the Desktop display can only show 16 or 256 colors.)

lptn=

Specifies the DOS printer ports for NeTraverse Win4Lin Terminal Server sessions (LPT1, LPT2, or LPT3). The value is a printer class token, followed by a timeout value t from 5 through 3600 (or 0, which means printing never occurs as the result of a timeout), as follows:

   lpt1=token,t

maxcolors=

Value is low, medium, or high. Specifies the maximum number of colors NeTraverse Win4Lin Terminal Server allocates to a Windows session. low allocates only 20 colors. medium reserves an additional 49 colors. high reserves the original 20 colors, plus 109 more. (This option is useful only when using a shared colormap, i.e. installcolormap is set to false, and the Desktop display has 256 colors.)

memory=

Specifies the amount of standard memory to be attached to a Windows session. The value is a number of megabytes of standard memory from 1 through 64.

mouse=

Specifies the mouse definition for the NeTraverse Win4Lin Terminal Server session. The value is a mouse class token.

personaldrive=

Specifies the DOS drive letter to be used as your personal drive.

run=

Specifies an optional command that NeTraverse Win4Lin Terminal Server is to run when a session starts.

scaledosgraphics=

Specifies the graphics scaling factor to be used for DOS sessions running on the Desktop in Hercules or CGA modes. Values are auto, 1, and 2.

session=

Specifies the type of NeTraverse Win4Lin Terminal Server session this configuration is used for. Values are dos, win3x, or win9x. (For backwards compatibility, win95 can be used an alias for win9x.)

showmenukey=

Specifies the key combination that brings the menu and status bars your NeTraverse Win4Lin Terminal Server window back into view or unfocuses the mouse when it is focused to the DOS NeTraverse Win4Lin Terminal Server window. You can set the key combination to any combination of <Ctrl>, <Alt>, and <Shift> keys plus another key, which you specify with the X key symbol name. When you specify more than one key, separate them with spaces and surround the combination with quotes. For example, to set the key combination to <Ctrl><Alt><Shift><F10>:

showmenukey="ctrl alt shift F10"

To set the showmenu key to be just the <Home> key:

showmenukey=Home

By default, NeTraverse Win4Lin Terminal Server defines <Shift><F12> as the key sequence.

startzoomed=

Not used in this version of NeTraverse Win4Lin Terminal Server. The value is true or false.

unzoomkey=

Not used in this version of NeTraverse Win4Lin Terminal Server.

windowsdir=

Specifies the subdirectory on your personal drive where Windows is installed. A typical setting is "windows". When not set, "windows" is assumed.

windowsizeauto=

Specifies that NeTraverse Win4Lin Terminal Server should automatically compute the window size when a Windows 3.1 session starts. (Obsolete) Values are true and false. When set to true, the windowswidth= and windowsheight= commands are ignored.

windowswidth=

Specifies the width of the Windows 3.1 window in pixels. (Obsolete) The minimum width is 600. This option is ignored when the value for windowsizeauto= is true.

windowsheight=

Specifies the height of the Windows 3.1 window in pixels. (Obsolete) The minimum height is 400. This option is ignored when the value for windowsizeauto= is true.

windowsmode=

Specifies whether your Windows 3.1 environments start in standard mode or in enhanced mode. (Obsolete) The values are standard and enhanced.

windowspaging=

Specifies whether or not Windows 3.1 environments that run in enhanced mode should use the Virtual Memory features of Windows. (Obsolete) Values are true and false.

xcutandpaste=

Specifies whether or not your Windows environments start with the X Cut and Paste feature turned on or off. Values are true and false.

See also

© 2000 NeTraverse, Inc.

2000/01/10