DOS(1) — USER COMMANDS

NAME

dos − SunView window for IBM PC/AT applications

SYNOPSIS

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

AVAILABILITY

Sun386i systems only.

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 SunOS, 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

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 read 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 your default printer, as long as it is Postscript-compatible.

Drives

The DOS command FORMAT A: /S works only if the current working directory contains DOS system files (is bootable). This usually applies to Drive C and sometimes to 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 SunOS. 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 SunOS directories. They can be accessed from either DOS or SunOS, and can contain any number of files and other directories. You cannot install copy-protected software on drives D through S (install it on drive C instead). 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
Through drive D you can access all files on the SunOS file system. When a DOS window is opened using dos, drive D is the current directory, and can then be changed to any other directory. If you open a DOS window from the Desktop menu, Drive D’s current directory is your home directory.

Drive H
Your home directory when you open a DOS window. You can subsequently change to any directory in your home directory tree. Files or directories changed or created while in Drive H can only be stored in your home directory or in the directories below it.

Drive R
Initially equivalent to the root directory of SunOS.

File Sharing between SunOS and DOS

File names under DOS consist of 8 characters, a period, and a 3 character extension. When a SunOS file name 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 file names conform to DOS requirements for files to be used in both SunOS and DOS.

Because SunOS and DOS use different conventions for carriage returns, dos2unix(1) and unix2dos(1) are provided to convert text files between the two formats.

Command Sharing between SunOS and DOS

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 file name conventions and DOS commands always use DOS file name conventions, regardless of whether either type of command is executed from SunOS or DOS. 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. Normally, DOS boots from settings in .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 SunOS. 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
Master .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
Master 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:
Master 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 SunOS, except by using dos.

D:AUTOEXEC.BAT
If an AUTOEXEC.BAT file exists in the current directory (represented by drive D), DOS executes it after running C:AUTOEXEC.BAT.

C:CONFIG.SYS
Specifies device drivers and other system parameters. C:CONFIG.SYS is not accessible from SunOS, except by using dos.

~/pc/setup.pc
Defines printers, standard PC devices, and drive C. One or more of these files may exist, under various names that 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.

Museum

Related Articles