unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

DOS(1)                      General Commands Manual                     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 direc-
       tory.  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 direc-
       tory 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 accessi-
                         ble across a network.

       Drive B           An optional 5.25-inch diskette drive.  Same  restric-
                         tions 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 directo-
                         ries.  They can be accessed from either  the  DOS  or
                         SunOS  operating  systems, and can contain any number
                         of files and other directories.  The  SunOS  directo-
                         ries  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 win-
                                dow 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 charac-
       ter 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 accessi-
       ble 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  mes-
              sage is displayed in the window.

       -s     Boot  DOS  and save a new .quickpc unless C:AUTOEXEC.BAT, C:CON-
              FIG.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 Sun-
              View 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  ser-
                      vice  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 run-
                      ning  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 com-
                      mand 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  win-
                      dow.   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-compati-
                                ble 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 spec-
              ified 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 instruc-
       tion 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  request-
              ing  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  pro-
       gram_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 work-
              stations  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 environ-
              ment variable DOS_LOCKING to off.
SEE ALSO
       dos2unix(1), unix2dos(1)
       Sun386i User's Guide
       Sun386i Advanced Skills
       Sun MS-DOS Reference Manual



                               19 February 1988                         DOS(1)