DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
NeTraverse Merge User's Guide
Chapter 4, Configuring DOS and Windows sessions

Chapter 4

Configuring DOS and Windows sessions


In Chapter 3, `` Working in the NeTraverse Merge environment '', you learned about the default operating environment that NeTraverse Merge creates when you start a DOS or a Windows session. However, because NeTraverse Merge is fully configurable, you can change the default environment as well as create additional environment configurations, which will enable you to run many different kinds of DOS and Windows sessions.

This chapter tells you how to use the WinSetup utility to make some common changes to DOS and Windows environments to better suit your needs. In particular, it describes how to configure sessions to use resources such as printers and CD-ROMs; how to change the amount of memory available to you; and how to setup access to different parts of the UNIX filesystem.

You can create multiple named configurations so that, for example, one set of devices is automatically available when you start Windows with one configuration and a different set of devices is available when you start Windows with another configuration.

If a resource you want to use is not described in this chapter, a system administrator may need to define it. See Chapter 5, `` NeTraverse Merge resource administration '' for information. Also, refer to Chapter 6, `` Using NeTraverse Merge from the command line '' for a description of the more obscure configuration features available.

Using WinSetup to configure your environment

In a Desktop environment, you can use the WinSetup utility to configure your environment. If you really want to you can use UNIX command line utilities to accomplish exactly the same things. For information on the command-line interface, see Chapter 6, `` Using NeTraverse Merge from the command line ''.

To start the WinSetup graphical utility, use the command: "winsetup &". You can also use the WinSetup icon or button to start up the utility.

Note that a lot of the information in this chapter is also covered in the WinSetup "help" pages that you can access by clicking the Help buttons.

Configuration categories

NeTraverse Merge displays a list of configuration categories that you can select. The categories are:

To choose a category, select it by clicking on its name, and then click OK.

The rest of this chapter covers the Personal session configuration.

Personal session configuration window

The personal session configuration window allows you to examine and modify various characteristics of your DOS and Windows sessions.

This window has four views, which you can select by using buttons located across the top of the window:

Options
Drives & Filesystem
Devices
Display

  1. Options view

    You can configure the following items using the Options view:

    AUTOEXEC.BAT
    Lets you specify the autoexec.bat files you want executed for the session. See `` Interpreting config.sys and autoexec.bat ''.

    CONFIG.SYS
    Lets you specify the config.sys files you want executed for the session. See `` Interpreting config.sys and autoexec.bat ''.

    Windows Type
    This is not used anymore. It is set automatically.

    Memory
    Lets you specify the amount of memory the session is to use. See `` Configuring memory ''.

    Command
    Lets you specify a command that NeTraverse Merge is to run when a session starts.

  2. Drives & Filesystem view

    The Drives & Filesystem view lets you assign and configure DOS and UNIX volumes as specific drives in your environment. See `` Drives & Filesystems view ''.

  3. Devices view

    The Devices view lets you specify the hardware configuration you want for a specific environment.

    You can configure the following items using this view:

    COM ports
    Lets you attach serial ports. See `` COM ports ''.

    DOS printer
    For DOS sessions only, lets you redirect an LPT port to the UNIX printing system. See `` DOS printers ''.

    Other devices
    Lets you specify other devices (such as parallel ports) to be used by your sessions, and examine the configuration details for these devices. `` Other devices ''.

  4. Display view

    The "Display view" lets you specify the display features of a specific configuration.

    You can configure the following items using this view:

    Display
    Lets you specify font size, graphics scaling, and display type for DOS windows. See `` Specifying DOS fonts '', `` Scaling DOS graphics '', and `` Setting DOS display types ''.

    Colormap
    Lets you specify whether to use a shared or private colormap. See `` Colormap ''.

    Windows 3.1 Window Size
    This is not used anymore. (Windows 3.1 is not supported anymore.) See `` Setting the size of a NeTraverse Merge window '' for how to set the size of your Windows 95 or 98 window.

    Options
    Lets you specify whether to use any of the following options:

    Special Keys
    Lets you view or change the special keys:

Specifying the scope of configuration changes

To run a DOS or a Windows session immediately with your configuration changes in effect, click on Start when you finish modifying the settings.

To save your changes for all future sessions started with this named configuration, click on Save.

To create a new named configuration, click on Save As and provide a name for your configuration. Legal names can contain the characters A to Z (either upper- or lowercase), the numbers 0 to 9, and the hyphen (-).

Doing this adds the following entry to the list of WinSetup categories:

Personal session configuration: your configuration name

The new named configuration also appears as one of the following:


Options view detail

Interpreting config.sys and autoexec.bat

By default, NeTraverse Merge interprets the system-wide config.sys file and any config.sys file found on your personal drive when DOS or Windows sessions are started. In addition, it executes the system-wide autoexec.bat startup file and any autoexec.bat file found on your personal drive.

You can specify in your Personal session configuration that one or more of these files not be interpreted or run; you can also edit them or specify that NeTraverse Merge use different or additional config.sys and autoexec.bat files. This is done in the AUTOEXEC.BAT and CONFIG.SYS areas of the Options view.

Select Run System Wide, Run Personal, or Other to enable the execution of the corresponding autoexec and config.sys file.

The Other file is any file you specify in the corresponding text box. Use UNIX syntax and specify the full path name for the file (for example, /tmp/startup).

If multiple files are enabled, they are executed in the listed sequence -- System Wide followed by Personal followed by Other.

Deselect the file to disable its execution.

You can click the Select File button to bring up the File Browser and then select the file name from a list. The file need not be named autoexec.bat or config.sys as long as it contains valid DOS commands.

Click the Edit Files button to view, edit, or create any of the three startup files. To edit a file, you must have write permission.

Windows Type

This control is not used anymore. The windows type is automatically set to "Windows 95/98" when you first install Windows 95 or Windows 98, so there is no need to make adjustments to this setting.

Configuring memory

Use procedures in this section to:

Setting standard (extended) memory for Windows

Under NeTraverse Merge, DOS and Windows sessions cannot make use of the whole physical memory space the same way they do on a stand-alone PC. Instead, the UNIX operating system manages physical memory and allocates a certain amount of virtual memory to each DOS and Windows session when it starts. By default, enough memory is allocated for most applications to run. However, certain Windows applications require more than the default memory allocation. In this case, you can configure your Windows sessions to start with more memory.

NeTraverse Merge refers to the memory given to Windows as "standard" memory. Standard memory refers to the aggregate of 1MB of conventional DOS RAM, plus as many megabytes of extended memory as you want to add, up to a maximum of 128MB. The default memory setting are different for the various versions of Windows. (In NeTraverse Merge, more than 1MB of this "standard" memory is only for Windows session, not DOS sessions. For DOS sessions you must use EMS to get more memory.)

You specify in your Personal session configuration how much memory to allocate to a Windows session. This is done in the Memory area of the Options view by clicking on the up or down arrow key next to Standard to select the amount of standard memory you want.

NOTE: Do not request more memory than you really need, because it wastes memory resources and in some cases can slow your session down. If you do not need additional memory every time you run Windows, do not change your default configuration; request additional memory only for those sessions in which you need it.

Note that you can also use a command line option to the win or dos command to override the memory allocation for a single session. Refer to `` Using dos and win commands with configuration options '' in Chapter 6.

Setting expanded memory (EMS) for DOS

NeTraverse Merge supports the Lotus/Intel/Microsoft Expanded Memory Specification (EMS), so you can run any DOS applications that use expanded memory and conform to this specification.

NeTraverse Merge simulates expanded memory by using standard UNIX system virtual memory.

You specify in your Personal session configuration how much EMS memory to allocate to a DOS session. This is done in the Memory area of the Options view by clicking on the up or down arrow key next to EMS to select the amount of standard memory you want.

NOTE: Do not request more memory than you really need. If you do not need additional memory every time you run DOS, do not change your default configuration; request additional memory only for those sessions in which you need it.


Drives & Filesystems view detail

NeTraverse Merge makes the UNIX file system, as well as any physical or virtual DOS volumes that exist on your hard disk, available to your DOS or Windows sessions. (A virtual DOS volume is a UNIX file that is formatted as a DOS file system and reserved exclusively for DOS files.)

These file systems can be accessed through drive letters as under real DOS or Windows. See `` About drives and file systems '' in Chapter 3 for more information about the default drive configuration.

You can customize the drive letter assignments to access different parts of your UNIX file system and assign drive letters to physical and virtual DOS volumes. You specify the drive letter assignments in your Personal session configuration. This is done in the Drives & Filesystem view.

You can also assign drive letters to CD-ROM drives for use under DOS or Windows.

In the Drives & Filesystems view, you will see a list of drive letters and file system volumes that are currently attached to these drive letters. You can configure new drive letters to access parts of the UNIX file system, DOS file system, or CD-ROM drives.

Drive letter restrictions

Although the GUI gives the impression that almost any drive letter can be used for any purpose, that is not the case. Some of these restrictions cannot be changed, and some can: You can tune the GUI program to change the lowest drive letter that it allows to be use for CD-ROM drives. This is done via the "MERGE_CDROM_START" setting in "/etc/default/merge". This can be changed to specify a drive letter between "A" and "Z".

If you really have to, there is a way to change which drive letter is the highest allowed Unix and DOS volume drive. The procedure is too compilcated to cover in this User's guide. Later versions of the NeTraverse Merge documentation will cover the proceedure, perhaps in some "special topics" document.

Making changes

To change the configuration of a drive that is already attached, select the drive letter and click on the Properties button. A window with the current drive properties appears. Change the properties and click on OK.

To attach a new drive, click on the Add button. A drive properties window appears with defaults selected for UNIX file system access. Select the drive letter you want by clicking on the arrows next to the current drive letter and change the properties as required. Click OK and your new drive will appear in the list.

To detach a drive, select it from the list and click Detach.

You can also specify whether you want your DOS and Windows sessions to always start at the root of your personal drive as opposed to starting in your current UNIX working directory. See `` Specifying the initial drive '' for more information.

Drive properties

The drive properties window contains different information depending on the drive type you select: Unix File System, Dos Drive, or CD-ROM:

Advanced Unix file system options

There are two types of Advanced options for Unix filesystem access: file name mapping options and locking options.

File name mapping options

Refer to Chapter 3, `` File name issues '' for information about just what filename mapping is.

Refer to Appendix C, `` Filename mapping '' for more detailed information about about how the different mapping work and why you would choose a particular filename mapping.

The following only explains how to select the different options. (For normal situations you should use the default settings.)

One of the three file name mapping methods is selected in this "File Name Mapping" control:

Standard Mapping
This mapping method is the default for all Unix drives except your personal drive (normally, drive C).

Win95 Mapping
This mapping method is the default for your personal drive (normally, drive C).

Old-Style Mapping

Regardless of the mapping method that is selected, the Case Mapping checkbox enables or disables case mapping. The default is for case mapping to be disabled (unselected). Refer to `` Appendix C - Filename mapping '' for explanation of all these mapping types.

Unix file locking options

The other advanced option for Unix filesystem access is Unix locking.

This enables or disables the use of Unix file and record locking when NeTraverse Merge accesses the UNIX filesystem on behalf of DOS or Windows applications when they do DOS or Windows file and record locking operations.

File and record locking is necessary when two users want to make simultaneous updates to shared data files or to guarantee sequential access to data files. The applications that performs file access in this case must have been designed to use file and record locking to provide safe shared access. (So just by enabling "Unix locking" does not make any application play well with others. It has to be designed to be that way.) Many database applications, including spreadsheets, allow such shared access.

For multi-user versions of NeTraverse Merge, all DOS and Windows file and record locking operations are automatically handled between all DOS and Windows sessions running on the same UNIX system. But if the same files are being accessed from sessions from different machines over a network (such as NFS), or a UNIX application is accessing the same files, then this "Unix locking" option should be enabled.

However, Unix locking causes a decrease in the file system performance especially when files are accessed over the network. Consequently, you should not enable this option unless you have a specific need.

By default, Unix drives do not have Unix locking enabled.

File locking with NFS

There are some special cautions with using Unix locking with files accessed over NFS. In addtion to the performance problems when you enable file and record locking for NFS, DOS and Windows programs can perform file locking operations (called high locks) that are not fully supported over NFS. One of the most problematical locking operations not supported by NFS is referred to as "high locks" or "negative locks". NeTraverse Merge provides a workaround, which involves creating and using hidden directories (.lock_dos_high) in the directories where the files are being locked this way. But this cannot work if you do not have permission to create subdirectories.

You can turn off the use of this workaround by setting the MERGE_AUTOCREATE_LOCKDIR variable to off in your UNIX environment or in the /etc/default/merge file.)

You can also create the hidden directories yourself as needed. If a .lock_dos_high subdirectory exists in a directory, it is used regardless of the setting of the MERGE_AUTOCREATE_LOCKDIR environment variable. The variable only governs automatic creation when a directory does not already exist.

NOTE: If you are sure that no DOS or Windows processes are using files in a directory that has a .lock_dos_high directory, you can safely remove the directory.
NOTE: In NeTraverse Merge version 5.0 and earlier, the lock directories were named ".lock_pci". So if other UNIX systems on your network are using such an old version, and you are using locking over NFS with sessions on those other systems with this workaround, then you should upgrade the other systems to a later version of NeTraverse Merge.

Specifying the initial drive

When your DOS or Windows session starts, the initial drive and directory are determined by the option Start on personal drive:


Devices view detail

COM ports

The NeTraverse Merge DOS and Windows environments can use the COM1 and COM2 serial ports. NeTraverse Merge does not support the COM3 and COM4 ports.

The COM Ports area of the Devices view has a drop down list for both COM1 and COM2 that lets you specify the COM1 and COM2 port attachment for the NeTraverse Merge session.

When None is selected then no COM port will be made available.

By default, in addition to "None", there are several selections available. To access the COM port via the UNIX COM1 or COM2 driver, choose a selection that corresponds to the UNIX device name. (Normally /dev/tty1a and /dev/tty2a on OpenServer systems, and /dev/tty00t and /dev/tty01t on UnixWare/OpenUNIX systems).

On systems that support direct attach of COM ports, there will also be the selection "COM port 1 + IRQ 4" or "COM port 2 + IRQ 3".

If there are more selections, then the system administrator has added these.


NOTE: NeTraverse Merge does not support all serial cards beyond the basic COM1 and COM2 ports. For restrictions on multiport serial cards, see `` Serial Port Administration '' in Chapter 5.

In the UNIX environment, the serial (COM) ports can be shared among UNIX and DOS/Windows processes, but only one process (either UNIX or DOS) can access a particular serial port at one time. If you plan to use a serial port in your DOS or Windows session, the port must not otherwise be in use, (such as with a mouse, terminal or modem), and UNIX device permissions must set to make it accessible to the user.

If a terminal has been in use on the serial line you may have to reconfigure the serial line.

For example, on OpenServer systems you use the disable(C) command to stop the serial line from being used for a terminal. (You have to be logged in as root or become the super user to use this command.) To disable the login process on /dev/tty1a, for example, you use the command: "disable /dev/tty1a".

The UNIX serial device must be readable and writeable by the user that wants to attach the serial line. The easiest way is to make sure the device is readable and writeable by everyone. The chmod(1) command is used to set permissions of the device. (You have to be logged in as root or become the super user to use this command.)

For example, if you want to use /dev/tty1, type:

chmod 666 /dev/tty1

For systems where you you have a choice between using the COM port via the UNIX driver and "direct attachment" (e.g. "COM port1 + IRQ 4"), both methods are available because depending on circumstances one way might work better than the other. You will have to try both ways to see which works best for your situation.


Note: When you attach a serial port to your DOS or Windows environment, that port becomes unavailable to other system users and applications. For this reason, you should request a serial port for only the single session in which you actually need it. We recommended that you do not make the attachment of a serial port the default for your DOS or Windows environment configuration.

The reliability of data transfer over an attached serial port depends on many factors, including line quality, transfer speed, and system load. If you use serial ports to transfer files at speeds greater than 4800 baud, use an error-correcting protocol to perform the transfer. Error-correcting protocols help ensure the integrity of data during transfer.

DOS printer

To print from a DOS session via the UNIX printing system you have print via a "redirected LPT port". This is set up in the "DOS Printer" sections of the "Devices" view of a Personal DOS session configuration.

NeTraverse Merge stores printer output to any of the DOS LPT ports in a temporary file. It prints this output when more than 15 seconds have elapsed since the application sent a character to be printed. The timeout is needed because when DOS applications print to the LPT port there is no standard indication as to when the application has finished printing. If an application has normal delays of more than 15 seconds then your printout can get split up or otherwise not print correctly. You can use the "DOS Printer" control to change that timeout to make it longer or shorter as needed.

To print via a UNIX printer, there must be a "printer definition" that specifies the UNIX command to be used. During installation, NeTraverse Merge creates a printer definition with the name default, which provides for printing to the default UNIX printer. (For this to work as is, there must be a default printer set up on your UNIX system.)

To adjust the "default" definition or to create or modify other UNIX printers definitions, for use with NeTraverse Merge, see `` Printer administration '' in Chapter 5.

For the three possible LPT ports you use this to specify which, if any, are to be redirected to a UNIX printer:

Other devices

The "Other Devices" section of the "Devices" view of a Personal session configuration allows you to select devices (other than COM ports and DOS printers) to use with your NeTraverse Merge sessions.

All the possible devices appear in the list and can be individually selected. (When NeTraverse Merge is first installed the default selections in the list are for the parallel ports and the game port.)

If you pick two devices that use a resource in common a warning is displayed indicating the conflict and you will not be able to save or use the configuration until you de-select a device to clear the conflict. Each device definition includes an "Access" field which specifies if normal users are allows to use that device or not.

NOTE:
For security reasons, by default all definitions have their "Access" fields set to "Root Only".

The "Access" field is also known as the "Usable by" field. If you try to start a NeTraverse Merge session with access to a device that you do not have permission to use, the session will fail to start with an error message about the device or "token" not being usable.

Click on the "Detail" button to bring up the "Custom Devices Detail Viewer" which allows you easily find out what the definition for each device is, including the "Access" setting.

The View/Create/Modify Device Definitions part of the WinSetup "System-Wide Administration" GUI is used to update the device definitions. The system administrator will have to use this to change the "Access" setting to make appropriate devices available for use by normal users.

See `` Custom device administration '' in Chapter 5 for more information about updating or adding to the items that appear in the "Other Devices" list.


Display view detail

The "Display view" lets you specify the display features of a specific configuration. There are five areas, "Display" , "Colormap" , "Options" , "Special Keys" and "Window Resize".

"Display"

Use the following options to configure advanced display features for your DOS sessions:

These options are described below:

DOS Font

By default, NeTraverse Merge automatically sets the size of the fonts used in the DOS window if you are working in the Desktop environment. This size is based on the resolution of your X Window display and is either 6x13 (small) or 8x14 (medium).

If you do not like the automatic selection, you use this control to to choose the size you want. Note that this only for DOS windows, and not Windows windows.

You can also set your DOS fonts while you are running a DOS session by using the Options menu at the top of the NeTraverse Merge window. (See the `` Controlling the NeTraverse Merge window '' topic in Chapter 1.)

Scaling DOS graphics

When you run a CGA or Hercules graphics DOS application on the Desktop, NeTraverse Merge displays it in the DOS window either with in original or double size, automatically. If you do not like the automatic selection, you use this control to to choose the scaling you want, "1x" or "2x"..

Display Type

On the X desktop, NeTraverse Merge is supports the DOS graphics CGA and Hercules modes and the DOS monochrome (a.k.a. "MDA") text mode. On systems that support "Zooming" on the system console standard VGA graphics (640x480, 16 colors) are supported via "zooming". ("Zooming" is when the NeTraverse Merge session takes over the display hardware.)

NeTraverse Merge automatically selects the virtual display mode for each NeTraverse Merge session. For Windows sessions, you should leave the setting on "Automatic". For DOS sessions you can use this control to specify a specific virtual display type. One reason you might want to do this is if you have a DOS application that requires a specific display type.

"Colormap"

Because your Windows session is being displayed via the X Window system, the number of colors available in your Window session is at most the number of colors available on your X display. If the X display is using "8 bit" color or less (i.e. 256 shades or less) then generally there are not enough colors for X applications and Windows applications to use without some conflict. The "Colormap" controls are for use in this situation. By default, the setting is "Use Shared Colormap", and should be left at that unless you have some color problems.

It is strongly recommended to use at least 16 bit color (64K shades), but if that is not possible, refer to the help topic for this configuration view for instructions on how and why to configure the "Colormap" controls. Click here to go to that help topic.

"Options"

About the Zooming options

Zooming a NeTraverse Merge session window causes it to take over the display hardware over from the X desktop.

When you run a VGA (640x480 16 color) graphics program, you must zoom the window because VGA graphics are not emulated in an X window. If zooming is not possible, for instance if you are not using the system console, then all that can be done is to abort your NeTraverse Merge session.

By default, when your application switches into VGA graphics mode, a message appears on your screen telling you that you must zoom in order to continue. At that point, use the Window menu in your NeTraverse Merge window and select the Zoom option. (See the `` Controlling the NeTraverse Merge window '' topic in Chapter 1.)

If you want to avoid having to zoom the window manually, you can set one of two options here: Start Zoomed or Autozoom "Start Zoomed" means just that, when your NeTraverse Merge session is started it automatically starts it already zoomed.``` Similary "Autozoom" makes NeTraverse Merge automatically zoom as needed without making you used the "Zoom" option.

You can also set the Autozoom option while you're running a DOS or a Windows session by using the Options menu at the top of the NeTraverse Merge window. (See the `` Controlling the NeTraverse Merge window '' topic in Chapter 1.)

Window Resize

This control only applies to Windows configurations. When this is selected the above "Window Resize" control is activated, and each time Windows is started, the Windows size is automatically set accordingly.

Full Screen Resize

When this "Full Screen Resize" option is checked, when you start a "full screen" session with the "fwin" command, Windows is resized as needed to completely fill the screen.

Autofreeze

If an X application currently has input focus and is running unacceptably slow, one or more DOS or Windows sessions running in the background may be consuming too many system resources. In this case, you can force NeTraverse Merge to temporarily suspend your NeTraverse Merge session when the input focus changes to make more system resources available to other applications or users. This is done by selecting the "Autofreeze" option here.

You can also set the Autofreeze option while you're running a DOS or a Windows session by using the Options menu at the top of the NeTraverse Merge window. (See the `` Controlling the NeTraverse Merge window '' topic in Chapter 1.)

X Cut & Paste

The explanation of just what "X Cut & Paste" is and how to use it is in the `` Cutting and pasting '' topic in chapter 3. The "X Cut & Paste" option in the "Display" view of the Personal configuration sets what the initial state of the feature (enabled or disabled) when a NeTraverse Merge session is started.

While using your Windows session you can enable and disable the X Cut & Paste feature by using the Options menu at the top of the NeTraverse Merge window. (See the `` Controlling the NeTraverse Merge window '' topic in Chapter 1.)

By default, the X Cut & Paste feature is disabled. If for some reason you want to change the default (not recommended), you select the "X Cut & Paste" option in the Options area of the Display view.

"Special Keys"

The special Show Menu and Unzoom keys are both, by default, <Shift><F12>. You can redefine these keys if the current settings are not convenient or conflicts with your application. (The Show Menu key causes the menu to be shown if it is hidden and unfocuses the mouse if it is focused to DOS. The Unzoom key undoes the effect of Zoom.)

To change the keys used for these functions, click on the Show Menu or Unzoom button in the Special Keys section. This displays a Key Properties dialog box where you can select the key combination you want.

You can also change the keys for these actions while using your DOS or Windows session (but only for that session) via the Options menu at the top of the NeTraverse Merge window. (See the `` Controlling the NeTraverse Merge window '' topic in Chapter 1.)

"Window Resize"

When the Window Resize option is selected then this control becomes active, and you use it to specify how the Windows window size is to be automatically set when you start up your Windows session. There are two settings, "Automatic" and "Custom". When Automatic is selected the Windows window size is automatically set to be the next smaller standard size resolution from the real display resolution. And when Custom is checked you control exactly what the Window size will be either by using the slider bars (either with the mouse or the keyboard arrow keys), or by using the "Manual Resize" control.