DOS(1)

NAME
dos - SunView window for IBM PC/AT applications

SYNOPSIS
dos [ -b ] [ -p config ] [ -q ] [ -s ] [ -update time ] [ -w ] [ -c command ]

AVAILABILITY

Available only on Sun 386i systems running a SunOS 4.0.x release or earlier. Not a SunOS 4.1 release feature.

DESCRIPTION

A window created by dos looks and acts like the screen of an IBM PC/AT or compatible computer running MS-DOS 3.3, except that it has expanded features. It allows sharing of files with the SunOS operating system, copying and pasting data between windows, and piping and redirection. You may run any reasonable number of DOS windows simultaneously.

Shrinking or expanding the window will not change the contents to accommodate the new size.

USAGE

  Menu
The menu available in the window by pressing the right mouse button allows various controls over the work in the window. Edit allows you to copy and paste between windows. The Show Screen menu item selects the type of screen display—either Hercules, CGA, or Monochrome. Use the DOS MODE command to set the corresponding DOS display mode. See the Sun386i User's Guide or on-line help for more information. The Mouse menu item allows you to control whether the mouse operates like a Microsoft or compatible mouse or in normal SunView fashion (see Sun386i Advanced Skills for instructions on enabling Microsoft mouse driver software). The Send to printer menu item allows you to send queued jobs to the print spooler. Sound controls the volume of sounds from the DOS window. Device allows you to select which disks and other devices will be used and which are to be considered write only. The Reboot DOS Window item is equivalent to restarting the window. This can also be accomplished by pressing the CONTROL, ALT, and DELETE keys simultaneously.

  Printer Assignments
DOS uses three printer designations: LPT1, LPT2, and LPT3. The default settings are: files sent to LPT1 go to the default system printer. Files sent to LPT2 are appended to the file lpt-2 in your home directory. Epson-compatible print jobs can be sent to LPT3 to yield Epson FX-80 quality output on a Postscript printer.

  Drives

The DOS command FORMAT A: /S works only if the current working directory contains DOS files. This is usually Drive C and sometimes Drive A.

Drive A
    The Sun386i 3.5-inch diskette drive, used for reading PC format diskettes onto the hard disk and writing data to be stored on floppy. Drive A is not accessible across a network.

Drive B
    An optional 5.25-inch diskette drive. Same restrictions as Drive A.

Drive C
    A virtual disk stored in the ~/pc/C: file. Files written to Drive C cannot be accessed from the SunOS operating system. Drive C is generally intended for storage of applications and copy protected software but not data. To DOS, drive C is a 20-megabyte drive. You can install copy-protected software on drive C, but not on other drives.

Drives D through S
    Equivalents of the SunOS operating system directories. They can be accessed from either the DOS or SunOS operating systems, and can contain any number of files and other directories. The SunOS directories referenced by DOS drives other than D, H, and R (described below) are user-defined (using the DOS EXTEND command).

    Drive D
        The current SunOS directory when the DOS window was opened. May subsequently be changed to any other directory.

    Drive H
        The home directory of the user who opened the window. May subsequently be changed to any directory in the user's home directory tree.

    Drive R
        Initially equivalent to the root directory of the SunOS operating system.

  File Sharing between SunOS and DOS Systems
File names under DOS consist of 8 characters, a period, and a 3 character extension. When a SunOS filename does not comply with these rules, its name is modified by placing a tilde (~) in an appropriate location so that the file name conforms to DOS specifications while remaining unique. It is recommended that filenames conform to DOS requirements for files to be used in both the SunOS and DOS operating systems.

Because the SunOS and DOS operating systems use different conventions for RETURN characters, dos2unix and unix2dos are provided to convert text files between the two formats.

  Command Sharing between SunOS and DOS Systems
The /etc/dos/unix directory contains a list of SunOS commands accessible from DOS. Other SunOS commands not in this list can be executed from DOS with the command `unix command'. SunOS commands always use SunOS filename conventions and DOS commands always use DOS filename conventions, regardless of whether either type of command is executed from the SunOS or DOS operating system. Only DOS commands can use drives A and C.

OPTIONS

-b  Boots (loads) DOS and opens a window using the AUTOEXEC.BAT and CONFIG.SYS files instead of ~/pc/.quickpc. A DOS sign-on message is displayed in the window.

-s  Boot DOS and save a new .quickpc unless C:AUTOEXEC.BAT, C:CONFIG.SYS, or /etc/dos/defaults/rom has a date newer than the .quickpc file (see the -s option).

-p config
    Loads an alternate file instead of setup.pc.

-q  Forces dos to read settings from the .quickpc file (as specified in setup.pc) even if C:AUTOEXEC.BAT, C:CONFIG.SYS, or /etc/dos/defaults/rom have been updated since you last typed dos -s.

-s  Boot DOS and save a new .quickpc file under the name specified on the SAVE line in ~/pc/setup.pc. Use this option after making changes to drive C's AUTOEXEC.BAT or CONFIG.SYS. Exits DOS after saving the .quickpc file.

-update
    Gives you a new drive C and a new setup.pc using the settings from /etc/dos/defaults/C: and /etc/dos/defaults/setup.pc, respectively.

-w  Runs DOS text-only commands and applications in the current SunView Commands window.

-c command
    Executes the given DOS command in the newly created window. If you use the -c option, -c and the command that follows it must be the last items on the command line.

ENVIRONMENT

DOS_LOCKING
    This environment variable determines which locking service is used to lock drive C for write access. If it is set to on, DOS uses the locking service on the server where the home directory is located. This locks drive C for access from any DOS window on the network. If it is set to off, DOS uses the local system's locking service. This locks drive C only for access from DOS windows running on the local system. The default is on. Some servers (for example, some VAX/Ultrix systems) do not provide an NFS locking service. For home directories stored on these servers, set the variable to off to avoid an error message when a DOS window starts up.

DOS_PRINTER
    The value of this environment variable indicates the timeout (in seconds) for printing. A value of 20 (the default) indicates that jobs will be sent to the UNIX print spooler after 20 seconds of no printing activity from DOS to that printer. A value of 0 indicates that the spooler must be flushed manually from the menu in the window.

DOSLOOKUP
    If on, this environment variable indicates that a command should be tried as a DOS command if not recognized by the SunOS system. If DOS supports the command, a DOS window is created and the command executed in that window. If the command does not exist, the normal SunOS error message results.

FILES
/etc/dos/unix
    Files in this directory indicate which SunOS commands are accessible from DOS.
/etc/dos/defaults/.quickpc
    Default .quickpc file copied into a user's home PC directory (~/pc) the first time a DOS window is started. Not used by DOS in this location.
/etc/dos/defaults/setup.pc
    Default setup.pc file copied into a user's home DOS directory (~/pc) the first time a DOS window is started. Not used by DOS in this location.
/etc/dos/defaults/boards.pc
    Stores information about IBM PC/XT/AT -compatible boards installed in your system.
/etc/dos/defaults/C:
    Default drive C file copied into a user's home PC directory the first time a DOS window is started.
~/pc/autoexec.bat
    Contains drive assignments, search paths, and other startup commands. Searched after C:AUTOEXEC.BAT and D:AUTOEXEC.BAT.
C:AUTOEXEC.BAT
    Contains commands to access system printers and special drives. You should not need to change the AUTOEXEC.BAT on drive C. Put your changes in the AUTOEXEC.BAT on drive H (in your home directory). C:AUTOEXEC.BAT is not accessible from the SunOS system.
D:AUTOEXEC.BAT
    If an AUTOEXEC.BAT file exists in the current directory, DOS tries execute faster running C:AUTOEXEC.BAT.
C:CONFIG.SYS
    Specifies device drivers and other system parameters. C:CONFIG.SYS is not accessible from the SunOS system.
~/pc/setup.pc
    Defines printers, standard PC devices, and drive C. One or more of these files may exist, under various names which you assign.
~/pc/.quickpc
    An image of DOS as last saved with dos -s, including all DOS environment variables and drivers that were in effect at that time. DOS normally reads this file at startup.
~/pc/C:
    A user's personal copy of drive C.

DIAGNOSTICS

Cannot save filename quick-start file.
    The dos command was unable to save the specified quick-start file. Check the SAVE setting in your PC setup file (normally ~/pc/setup.pc). Also check file access permissions on the specified quick-start file.

Cannot load filename quick-start file.
    dos was unable to read the specified quick-start file. Check the SAVE setting in your setup.pc file. Also check file access permissions on the specified quick-start file.

Possible software incompatibility. Unsupported 286 instruction instruction at address.
Possible software incompatibility. Unsupported 386 instruction.
Possible software incompatibility. Segment wrap.
Possible software incompatibility. Two-byte opcode.
    The application you are running was written specifically for 80286 or 80386 machines. Software run from a DOS window must be compatible with 8086 systems.
Copying default configuration files into your home directory.
    This is the first time you have run the dos command. A ~/pc directory is being set up, and DOS-related files are being copied into it.
Another DOS window already has access to device
IRQ level number is still in use by another DOS window.
    Your PC configuration file (normally ~/pc/setup.pc) is requesting access to a physical device that another DOS window is using.
Port number number out of range for board board.
    The port number specified in the /etc/dos/defaults/boards.pc is invalid.
IRQ value number out of range for board board.
    The interrupt level specified in the /etc/dos/defaults/boards.pc is invalid.
IRQ level number is in use by a Unix driver.
    There is a Unix driver servicing the board you are trying to attach to DOS. You are using the wrong IRQ level or you should use the driver instead.
Interrupt level number is used by DOS to support device
    The interrupt level specified in the /etc/dos/defaults/boards.pc conflicts with an interrupt value currently being used by either a physical or emulated DOS device.
I/O address range address-address requested for name board already in use by device.
    The address range specified in the /etc/dos/defaults/boards.pc conflicts with range currently being used by either a physical or emulated DOS device.
Cannot share device with a hardware interrupt or DMA channel.
    A shared device specified in the /etc/dos/defaults/boards.pc was also assigned an interrupt level in this file. Shared devices cannot be assigned interrupt levels.
Couldn't find name board in boards.pc.
    A file specified in the PC setup file (normally ~/pc/setup.pc) is not listed in the /etc/dos/defaults/boards.pc file. Check the setup.pc file, or add an entry for the board in boards.pc.
ROM is newer than .quickpc. Rebooting program_name.
    Save a new .quickpc file by issuing the command dos -s.
Warning: Your personal drive C (pathname) is not protected against simultaneous access by more than one workstation. Ask your system administrator to upgrade server to use the lock manager. Until your home directory server is updated with this program, do not use program_name when you are logged into more than one workstation.

    The system on the network where your drive C is stored has not protected the drive against access by DOS windows in other workstations on the network. This usually means that the server where your home directory is stored does not provide an NFS locking service. To avoid this error message, set the environment variable DOS_LOCKING to off.

SEE ALSO
dos2unix(1), unix2dos(1)
Sun386i User's Guide
Sun386i Advanced Skills
Sun MS-DOS Reference Manual