PCjs Machines

Home of the original IBM PC emulator for browsers.

Logo

PC-SIG Diskette Library (Disk #1151)

[PCjs Machine "ibm5170"]

Waiting for machine "ibm5170" to load....

Information about “ROAM A DOS SHELL”

ROAM is a DOS shell, an easy-to-use interface that insulates you
from the complexities of DOS.  It makes it easier to enter commands and
manage files.  ROAM helps organize and control a hard disk and makes it
possible for you customize its organization to fit individual user
needs.

Instead of displaying confusing information, (e.g., cluster size and
other technobabble), ROAM breaks down the process into two distinct
modes, depending on what you are doing.  The first is an enhanced
command line, similar to, but easier to use than the DOS command line
and the second is a directory/file screen where you can easily
navigate through disk directories, files, and drives.

ROAM grows with you as you develop your computer skills.  While an
experienced programmer can make use of its more advanced capabilities,
a newcomer immediately gains a beneficial, easy-to-use tool.

FILE1151.TXT

Disk No  1151
Program Title:  ROAM
PC-SIG version 1

ROAM is a DOS shell, an easy-to-use interface that insulates the user 
from the complexities of DOS.  It makes it easier to enter commands and 
manage files.  ROAM helps organize and control a hard disk and makes it 
possible for the user to customize its organization to fit individual 
user needs. 

Instead of displaying confusing information (e.g. cluster size and other
technogabble), ROAM breaks down the process into two distinct modes,
depending on what the user is doing.  The first is an enhanced command
line, similar to, but easier to use than, the DOS command line, and the
second is a directory/file screen where one can easily navigate through
disk directories, files and drives.

ROAM grows with the user as he develops his computer skills.  While an
experienced programmer can make use of its more advanced capabilities, a
newcomer immediately gains a beneficial, easy-to-use tool.

Usage:  DOS Shell Interface.

Special Requirements:  None.

How to Start:  Type GO (press enter).

Suggested Registration:  $44.95

File Descriptions:

#FILES        Description of files included on disk from author.
#READ    ME   Last minute changes, instructions, info on shareware.
INSTALL  EXE  Installs ROAM on the hard disk.
LOOK     EXE  File browser used by ROAM.
REBOOT   COM  Reboots a PC compatible (including some difficult ones).
ROAM     DOC  ROAM manual on disk.
ROAM     EXE  Main program used to start ROAM.
ROAMINIT EXE  Used by ROAM for initialization.
VIEW     EXE  Peephole into a DOS redirection pipe.

PC-SIG
1030D E Duane Avenue
Sunnyvale CA 94086
(408) 730-9291
(c) Copyright 1988 PC-SIG, Inc.


GO.TXT

╔═════════════════════════════════════════════════════════════════════════╗
║                    <<<<  Disk No 1151 ROAM  >>>>                        ║
╠═════════════════════════════════════════════════════════════════════════╣
║ To install ROAM to your hard disk, type INSTALL (press enter)           ║
║                                                                         ║
║ To view the documentation for ROAM, type LOOK ROAM.DOC (press enter)    ║
╚═════════════════════════════════════════════════════════════════════════╝

ROAM.DOC

                                April 1, 1988

                                 FINAL DRAFT

                       Intermedia Design Systems, Inc.
                            15 Century Hill Drive
                              Latham, New York

                               (518) 783-1661



FRONTISPIECE

Design by Intermedia Design Systems, Inc.

Copyright (c)  1988 by  Intermedia Design Systems, Inc.  All rights reserved.
Published in the United States of America.  Reproduction or translation of any
part of  this work  beyond that  permitted in  Section 117  of the 1976 United
States Copyright Act without the express  written permission  of the copyright
owner is  unlawful.   Requests for permission or further information should be
addressed to the Permission Department of Intermedia Design Systems, Inc.

IBM, IBM PC and PC DOS are registered  trademarks of  International Businesses
Machines  Corporation.    MS  DOS  is  a  registered  trademark  of  Microsoft
Corporation,  Compaq  is  registered   trademark   of   the   Compaq  Computer
Corporation.

THE  PURCHASER  MAY  MAKE  A  BACK-UP  COPY  FOR  HIS/HER USE ONLY AND NOT FOR
DISTRIBUTION OR RESALE.

THE PUBLISHER AND AUTHORS ASSUME NO RESPONSIBILITIES FOR ERRORS, OMISSIONS, OR
DAMAGES,  INCLUDING  WITHOUT  LIMITATION  DAMAGES  CAUSED  BY THE USE OF THESE
PROGRAMS OR FROM THE USE OF THE INFORMATION CONTAINED THEREIN.  BY USING THESE
PROGRAMS, THE  USER ACCEPTS  ALL RESPONSIBILITY  FOR THE USE OF THE RESULTS OF
THE OUTPUT.  IF ANY ERRORS ARE DISCOVERED IN THE PROGRAMS, CORRECTIONS WILL BE
SUPPLIED BY IDS TO THE ORIGINAL PURCHASER.  THIS IS THE EXTENT OF ANY WARRANTY
WHICH IS GIVEN OR IMPLIED.

Printed in the United States of America



USER ASSISTANCE

Intermedia Design Systems, Inc. is pleased to provide  assistance to  users of
our software.   We provide technical assistance to all users who register with
Intermedia Design Systems, Inc. by filling out and returning the  postage paid
USER'S  REGISTRATION  AGREEMENT  in  this  package.  Users who have registered
should direct any  questions  about  running  this  program  to  our technical
service  number  (518)  783-1661.    Please have your registered serial number
(which you can find either on the screen  when you  start up  ROAM, or  on the
distribution  disk  which  you  received from Intermedia Design Systems) handy
when you call the above number.

This software documentation is designed to provide accurate  and authoritative
information in regard to the subject matter covered.

The computer  program for  ROAM is  delivered to you on a diskette that is not
electronically copy-protected.  As  a licensed  user of  this program  you are
entitled to  make a  backup copy of these programs, to protect your investment
should the originals become damaged.



WHAT CAN ROAM DO FOR YOU?

ROAM is a DOS shell, an interface to the computer that insulates  you from the
complexities of DOS.  The program makes it easier to enter commands and manage
files.  All commands generated by ROAM are passed through  to DOS  without you
having to  type them  yourself.  ROAM helps you organize and control your hard
disk by letting you choose the  means to  quickly access  often used programs,
DOS commands and batch files.

ROAM is  also a disk management program which handles large capacity hard disk
systems, simplifying maintenance tasks such as file deletion,  copying, moving
files, and creating and renaming subdirectories.

Instead  of  displaying  superfluous  information (e.g. cluster size and other
technogabble), ROAM's  philosophy  is  to  break  down  the  process  into two
principal modes.   Depending on what you are doing, it might be easier for you
to work in one or the other.   Most operations  can be  carried out  in either
mode, but  you will most likely find one better suited for what you are trying
to accomplish.  The first mode is an  enhanced command  line, similar  to, but
easier to  use than  the DOS  command line, and the second is a directory/file
screen where you can  easily navigate  through all  your disk  directories and
files, effortlessly switching from drive to drive.

ROAM grows with you as you develop your computer skills.  While an experienced
programer  can  make  use  of  its  more  advanced  capabilities,  a  newcomer
immediately gets a beneficial tool.

ROAM is  not a  "memory resident"  program which gobbles up your valuable RAM.
ROAM uses only the memory it needs and then returns the memory to DOS  when it
is not needed.



GETTING STARTED

Although ROAM can be used if you only have a floppy drive system, its features
do not warrant it.   Therefore  this documentation  and installation procedure
are aimed at a HARD DISK SYSTEM.  In the instructions that follow, the various
"special" keys and key  combinations,  are  enclosed  in  angle  brackets, for
example <ENTER>, <F2>, <Alt-U>, <Alt-F2>, etc.  Do not type < E N T E R >.

To Install Roam

     After DOS  has been  installed on your system, take the distribution disk
     and insert it in the A: drive of your computer.  Switch to the  C: drive,
     if you are not there already.  Type:

          C: <ENTER>

     to do this.  At the C> prompt type the following line:

          A:INSTALL <ENTER>

     If you have an AUTOEXEC.BAT file with a path already defined, you will be
     prompted by ROAM INSTALL for the directory in which you wish to have ROAM
     install  itself.    Move  the  cursor  to the directory where you wish to
     install ROAM and press  the <ENTER>  Key.   ROAM will  then automatically
     install itself and its adjunct programs in that directory.  You will also
     have the option to  install ROAM  in its  own subdirectory.   Once ROAM's
     installation   procedure   is   complete,   reboot   your   computer  (by
     simultaneously pressing <Ctrl-Alt-Del>).

     You may want to add ROAM as the  last item  executed in  the AUTOEXEC.BAT
     file,  so  that  it  will  automatically  load  itself when you boot your
     machine.  If you would like ROAM to  "lock" itself  into memory,  so that
     you or  a user can not inadvertently EXIT to DOS, include the phrase ROAM
     SHELL  rather  than  ROAM.    If  you  do   not  want   ROAM  to  execute
     automatically, do  not include  it in  your AUTOEXEC.BAT file, but simply
     type ROAM at the C> prompt and ROAM will load itself.   Press any  key to
     move  into  ROAM's  DIRECTORY/FILE  mode  after the title page is on your
     screen.   NOTE:  If you need assistance and have registered  your copy of
     ROAM, you  may use  the Technical Assistance telephone number which is on
     this title screen.

Getting out of ROAM

     If you wish to get out of ROAM for any reason (if you have not started it
     with the  ROAM SHELL  option in AUTOEXEC.BAT), simply type EXIT in ROAM's
     COMMAND LINE mode and you be at the DOS command line.



ROAM HAS THREE SCREEN MODES - DIRECTORY/FILE, AUTOMENU and COMMAND LINE

ROAM has three modes of which  two, DIRECTORY/FILE  and COMMAND  LINE, are the
most important.   Depending  on what you are doing, it might be easier to work
in one or the  other of  these two.   Most  operations can  be carried  out in
either mode,  but you will most likely find one better suited for what you are
trying to accomplish.

Screen Mode Toggle

     The <TAB> key  will  allow  you  to  move  between  ROAM's  screen modes.
     Normally  it  will  toggle  you  between  the COMMAND LINE screen and the
     DIRECTORY/FILE screen unless you  have created  an AUTOMENU.BAT  in which
     case, the <TAB> key will toggle you through three modes (DIRECTORY/FILE -
     COMMAND LINE  - AUTOMENU).   To  facilitate setting  up such  a menu, see
     CHOOSE in the ADJUNCT PROGRAMS listing.

When in ROAM, you always know where you are!

     Whether you  are in the COMMAND LINE mode or the DIRECTORY/FILE mode, the
     current path is always  present,  so  you  know  what  directory  you are
     currently in.

     An example of ROAM's Current Path prompt might look like this:

          C:\BUSINESS\LETTERS\1987\



COMMAND LINE MODE

The screen  has a  bar of  light in  which you  enter commands, similar to the
command line in DOS with some very big differences:

Command Line Editor

     You can edit the line without erasing everything you have typed, by using
     ROAM's Command Line Editor:

     All of  ROAM's editing  functions operated in an "Insert Mode", i.e. each
     character typed is inserted into the line at the cursor position, and any
     characters to the right of that position are moved to the right.

     The following  special keys  are available in ROAM's Command Line Editor,
     as well as in any other line where ROAM request you to  edit a  line (the
     Pattern, customizing items, etc.).

          <DEL>               Deletes the character at the cursor.

          <BACKSPACE>         Moves  the  cursor  one  space  to  the left and
                              deletes the character that was there.

          <Ctrl-X>            Erases the entire line.

          <LEFT ARROW>        Moves the cursor one  position to  the left non-
                              destructively (unlike <BACKSPACE>.

          <RIGHT ARROW>       Moves the cursor one position to the right.

          <Ctrl-LEFT ARROW>   Moves the cursor one word to the left.

          <Ctrl-RIGHT ARROW>  Moves the cursor one word to the right.

          <HOME>              Moves the  cursor to  the first  position in the
                              line.

          <END>               Moves the  cursor to  the last  character in the
                              line.

          <TAB>               Changes  to   AUTOMENU  mode,  if  \AUTOMENU.BAT
                              exists, otherwise to the COMMAND LINE mode.

Recalling Previous Commands

     You may instantly recall  previous  commands  by  pressing  <DOWN ARROW>,
     bringing to  the screen up to 20 of the last commands.  These can then be
     reexecuted by moving  the  bar  of  light  to  the  appropriate  item and
     pressing <ENTER>.

Function Key Assignment

     You may  temporarily assign the function keys <F1> through <F10> to carry
     out specific commands, either by typing the command  at the  command line
     or by  moving the  bar of  light to the command (in the PREVIOUS COMMANDS
     window) and pressing <Alt> and the  selected  function  key  at  the same
     time, e.g.  <Alt-F1>.   A note  will appear  in the  lower portion of the
     screen stating that the command has been stored to whichever function key
     you have  designated.   Unlike the Alphabetic Key assignments, these keys
     lose their memory when you EXIT ROAM or turn off the computer.

Adjunct Programs

     You can make use of ROAM's special functions by incorporating the Adjunct
     Programs in  your command.   For  example, you can use MOVE to move files
     from one directory to another.   You  can  also  use  the  "marked items"
     shortcut (^M) the "bar-of-light" shortcut (^B), etc. with these programs,
     other utilities or DOS commands such as COPY.  (SEE ADJUNCT PROGRAMS)

Marking and Unmarking Files

     ROAM gives you the ability to identify individual  files so  that you may
     take  action  on  them  as  a  group.    You  can  only mark files in one
     subdirectory at a time.  Marking files in  the COMMAND  LINE Mode  can be
     accomplished in several ways.

     For example, typing the following command:

          MARK *.BAT     <ENTER>

     will mark all files with the extension .BAT in the current directory.

     You may  consecutively add  files to  the MARKED  group, by repeating the
     above command for file name pattern you wish to add.

          MARK *.BAT     <ENTER>
          MARK *.TXT     <ENTER>
          MARK BUSLTR.*  <ENTER>
          MARK RO*.*     <ENTER>

     Unmarking files can also be achieved in the  COMMAND LINE  mode.   If you
     wish to  selectively remove certain files from the marked group, type the
     following command:

          UNMARK *.BAT   <ENTER>

     to unmark all those files with the extension .BAT.

     After you have carried out the  activity  that  involved  all  the marked
     files,  you  can  remove  all  the  marking  from the files by typing the
     following:

          UNMARK *.*     <ENTER>

Multiple Commands on a Single Command Line

     You can specify a series of actions to  be carried  out by  dividing them
     with the  "grave" accent  mark `  (not the apostrophe ').  Let us suppose
     you have been editing several .DAT files, littering  your hard  disk with
     .BAK backup files in the process.

          DEL *.BAK`COPY *.DAT`A:`A:`DIR

     This command  deletes all the backup files, copies your data files to the
     A: drive, changes to that drive, and displays its directory.

<Ctrl> Key Shortcuts

     A series of key combinations have been set aside to  make life  in ROAM a
     little more  pleasant.   When you  type one of these keys the character ^
     appears along with the  corresponding letter.   You  may also  enter them
     that way, e.g. <Ctrl-B> is the same as <^> <B>.  These short cuts can not
     be included in batch files, as batch files are interpreted by COMMAND.COM
     rather than by ROAM.

     <Ctrl-B>:  the Bar of Light

          Using the ^B shortcut tells ROAM that you want to do something using
          the  file  or  subdirectory  marked  by  the  bar  of  light  on the
          DIRECTORY/FILE screen.   For  example, if  you wish to have standard
          DOS directory information for  an item,  you would  move the  bar of
          light to  that item (a file or subdirectory), toggle (with <TAB>) to
          the COMMAND LINE mode and type:

               DIR <Ctrl-B>        <ENTER>

          For another example, let's copy the file in the bar of light  to the
          A: drive:

               COPY <Ctrl-B> A:    <ENTER>

     <Ctrl-M>:  the Marked Items

          The ^M  shortcut lets  you specify an arbitrary group of files to be
          processed together, referencing all  items  which  you  have marked.
          Using  this  shortcut,  in  conjunction  with  a specific program or
          command, will allow you to have the specific action taken on all the
          items you have marked.  For example, you can MOVE all the files that
          you  have  marked  in  the  current  directory  into  the  directory
          C:\BUSINESS by typing:

               MOVE <Ctrl-M> C:\BUSINESS  <ENTER>

          On the  other hand,  you can  MOVE all  the files you marked in some
          other directory into the current one by typing:

               MOVE <Ctrl-M>  <ENTER>

     <Ctrl-I>:  User Input

          The ^I shortcut will open a small one-line  window at  the bottom of
          the screen,  to request input of a parameter which might be required
          by the program you  are  executing.    An  example  of  this  is the
          preconfigured <N>  key in the DIRECTORY/FILE mode where ROAM makes a
          new subdirectory and takes you there.  ROAM  requests USER  INPUT in
          naming the  new subdirectory.   You could have accomplished the same
          thing in the COMMAND LINE mode by typing:

               MD <Ctrl-I>`CD <Ctrl-J> <ENTER>

          The first command, MD <Ctrl-I>, pauses for you to supply the name of
          the new subdirectory, and then creates it once you type the name and
          press <ENTER>.  The second command, CD <Ctrl-J>, takes the input you
          just typed for ^I and repeats it as the parameter for CD, taking you
          there (See below).

     <Ctrl-J>:  What You JUST Input in the ^I Window

          The ^J shortcut is especially useful if you wish to carry out two or
          more actions on the same user input.  See the example above for ^I.

     <Ctrl-P>: The PATH in Which ROAM is Installed

          The shortcut  ^P is  replaced by the  name of the directory in which
          ROAM has been installed.  For example, the alphabetic key <H> is set
          up as a  Help key  to LOOK  at the  #READ.ME and ROAM.DOC files.  It
          is defined as:

               LOOK ^P\#READ.ME ` LOOK ^P\ROAM.DOC

          assuming that your distribution  diskette included a #READ.ME  file,
          otherwise:

               LOOK ^P\ROAM.DOC

DIRECTORY/FILE MODE

The second mode is the DIRECTORY/FILE mode.  Unlike other  DOS shell programs,
ROAM's DIRECTORY/FILE  mode fills  the screen  with directories and files, not
superfluous information that is not required on the screen all the time.   You
can scroll through all the subdirectories and files.

ROAMing in the DIRECTORY/FILE mode, you may

     Using a  "point and shoot" methodology, move from file to file, directory
     to directory, drive to drive,

     Easily execute programs by moving a  bar  of  light  to  the  program and
     striking the <ENTER> key,

     Selectively mark  a file or group of files to be moved, copied, looked at
     or anything else you wish to do,

     Permanently assign a single alphabetic key to carry out commands  such as
     moving  to  another  drive  or  executing  a certain program.  Unlike the
     function keys <F1> to <F10>, these  assignments are  not erased  when you
     turn off the computer.

Layout of the DIRECTORY/FILE Window

     This screen is made up of the following components:

          A status line comprised of the current path, Pattern (if active) and
          Del Safety indicator,

          The Directories  window  displaying  the  subdirectories  within the
          current directory,

          The Files window, displaying the files within the current directory,

          And the user-definable Key to available commands.

     The first  part of  the status line is the current path, which shows your
     location in the branches of the DOS directory "tree".   Below it,  is the
     Pattern used  for determining  which files  will be  visible in the Files
     window.  In the  top  right  corner  of  the  screen  is  the  Del Safety
     indicator which  tells you whether "the safety" is ON or OFF for deleting
     files or empty  subdirectories.    If  it  is  ON,  ROAM  always requests
     verification before deleting.

     The Directories  and Files  windows are of the "point and shoot" type, in
     which a bar highlights an  item,  and  the  user  chooses  it  by hitting
     <ENTER> or  a user-definable  alphabetic key.   The numbers at the bottom
     right corner of  both  the  Directories  and  Files  windows respectively
     represent the number of directories and files in the current directory.

     The Key  is located  at the  bottom of  the screen.  It consists of three
     lines of user-editable text, usually a  key of  available commands.   The
     Key comes  preconfigured, just  like certain  of the  alphabetic keys, in
     order to give you a head start in setting up your own Personal Guide.

Navigation in the DIRECTORY/FILE Mode

     <ENTER>        If the bar of light is in the Directories window,  you are
                    taken to  the directory  that was in the bar of light when
                    you pressed <ENTER>.

                    If the extension of the file in the bar of  light has been
                    defined (by  us, or  by you), the corresponding command or
                    program is executed.  For example, the extension  .EXE (as
                    well as  .COM and  .BAT) is associated with the command ^B
                    (the item in the bar of  light itself),  therefore feeding
                    that item  to DOS as a command.  If the bar of light is on
                    CHKDSK.COM, then DOS executes  CHKDSK.COM.   The extension
                    .BAS  is  associated  with  BASICA  ^B.   If the bar is on
                    SAMPLES.BAS,  then  DOS   executes   the   command  BASICA
                    SAMPLES.BAT,  just  as  if  that  had been typed in at the
                    command line.

                    If an extension has  not  been  defined,  then  some other
                    user-definable  action  takes  place.    The preconfigured
                    command is LOOK ^B, so that pressing <ENTER>  when the bar
                    is  on  CONFIG.SYS  will  show you the current contents of
                    CONFIG.SYS.  (SEE YOUR PERSONAL GUIDE)

     \              When you press this key it will bring you back to the root
                    directory  no   matter  how   deeply  nested  you  are  in
                    subdirectories.

     .              Drops "down" one subdirectory toward the root directory.

     *              Opens the  Edit  Pattern  window.    (See:    You  Set The
                    Pattern)

     <LEFT ARROW>   Moves one  column to  the left.   If  the bar of light had
                    been in  the first  column of  the Files  window, it moves
                    into the  Directories window.   If the bar had been on the
                    rightmost visible  column of  the Files  window, and there
                    were one  or more  columns not  visible at the left of the
                    window, the window scrolls one column to the right, hiding
                    the  rightmost  column  and  making the next column to the
                    left visible.

     <RIGHT ARROW>  Moves one column to the right.   If  the bar  of light had
                    been in  the Directories  window, it moves to the leftmost
                    column of the Files window.   If the  bar had  been on the
                    rightmost visible  column of  the Files  window, and there
                    were one or more columns not visible, the  windows scrolls
                    one  column  to  the  left, hiding the leftmost column and
                    making the next column to the right visible.

     <UP ARROW>     Moves one row upward.  If the bar of light is in the Files
                    window, it can not move past the first row.  If the bar is
                    in the Directories window, and there were rows  above that
                    were   not   visible,   the  window  scrolls  downward  16
                    directories, hiding the current  group of  directories and
                    making the previous group visible.

     <DOWN ARROW>   Moves one  row downward.   If  the bar  of light is in the
                    Files window, it can not move past the  last row.   If the
                    bar  is  in  the  Directories  window, and there were rows
                    below that were not visible, the window scrolls  upward 16
                    directories, hiding  the current  group of directories and
                    making the next group visible.

     <Home>         Moves the bar of  light to  the leftmost  column, i.e. the
                    Directories window in the same row.  If the current row is
                    below the  last directory  in the  Directories window, the
                    bar moves to the last directory in the window.

     <End>          Moves  the  bar  of  light  to the rightmost column in the
                    Files window in the same row.  If the current row is below
                    the last  directory in  the Files window, the bar moves to
                    the bottom row of that window.

     <PgUp>         Moves the bar of light to the top row in  the window.   If
                    the  bar  is  already  in  the  top  visible  row  of  the
                    Directories  window,   the  window   scrolls  downward  16
                    directories, hiding  the current  group of directories and
                    making the previous group visible.

     <PgDn>         Moves the bar of light to  the bottom  row in  the window.
                    If the  bar is  already in  the bottom  visible row of the
                    Directories  window,   the   window   scrolls   upward  16
                    directories, hiding  the current  group of directories and
                    making the next group visible.

     <Ctrl-PgUp>    Moves the bar of light to the first  (visible or  not) row
                    of the  Directories window.   An alternative key that does
                    the same thing is <Ctrl-Home>.

     <Ctrl-PgDn>    Moves the bar of light to the last (visible or not) row of
                    the Directories  window.  An alternative key that does the
                    same thing is <Ctrl-End>.

     <TAB>          Changes to the COMMAND LINE mode.

     <Shft-TAB>     Customizes the DIRECTORY/FILE mode.

You Set the Pattern

     ROAM gives you the ability to see only the files you want,  by using Edit
     Pattern.   For example,  if you  wish only  to see  the files that end in
     (.COM), you can.  To choose Edit Pattern, press the  <*> key  (either the
     <Shft-8> from  the row  of numbers,  or the separate <*> near the numeric
     keypad will work.  A box with flashing  borders will  replace the  KEY at
     the bottom  of the  screen and you will be able to input whatever pattern
     you  would  like.    You  may  use  DOS  wildcards  such  as  *   and  ?.
     Additionally, you may use ! (e.g. *.!) to indicate that you want to match
     all executable file extensions (.COM), (.EXE) and (.BAT).

     Whenever  you  have  created  a  special  matching  pattern,  it  will be
     displayed right below the Current Path at the top of your screen, so that
     when you say to yourself, "I thought I had more files in this directory",
     look  to  the  display  to  make  sure  that  you have not set a limiting
     pattern.  To reset the pattern, so that all files are present, simply get
     to the  Edit Pattern  box again,  and this time clear the box by pressing
     <Ctrl-X><ENTER>.  This sets the pattern to the default *.*.

Deleting Files and Subdirectories

     One of the biggest problems  when  using  DOS  is  trying  to SELECTIVELY
     delete more  than one  file at a time.  We have made it easy when you are
     in ROAM.

     To delete a file, move the bar of light to  it and  press the  <Del> key.
     The file is erased and vanishes from the screen.  If the file is "locked"
     (i.e. is read-only) an error is reported instead.

     To remove a subdirectory, move the  bar  to  it  and  press  <Del>.   The
     subdirectory is  removed and  vanishes.  If the subdirectory is "locked",
     or has files  and/or  subdirectories  within  it,  an  error  is reported
     instead.

     The DEL SAFETY Toggle

          We know  that there  are times when you don't want it easy to delete
          files, so we have provided a safety toggle switch.  If the switch is
          ON, you  are prompted  to verify  that you  wish to delete a file or
          remove a subdirectory.   When it  is OFF,  you can  take the express
          route and  rapidly delete  those files  you wish to remove from your
          disk.

          To  change  this  toggle,  simply  press  the  <Ins>  key,  which is
          (usually) next  to the  <Del> key.  Each time you press this key you
          will toggle the Del Safety ON  or OFF.   ROAM   will  always let you
          know the status of this toggle in the upper right hand corner of the
          screen.  But remember,  when  you  do  delete  a  file,  it  is gone
          forever, unless you have a special program to retrieve it.

          If the  Del Safety  is OFF,  and you are deleting files, you will be
          dropped one subdirectory toward  the  root  when  the  last  file is
          deleted.    Additionally,  the  bar  of  light is on the name of the
          subdirectory in which you had  been  deleting,  and  the  Del Safety
          toggle  is  returned  to  ON.    This  is  to  protect trigger-happy
          Deleters!

Marking Files

     ROAM  gives  you  the   ability   to   identify   individual   files  and
     subdirectories so  that you  may take specific action on them as a group,
     even though they may not have  similar names.   Files  and subdirectories
     may be  marked in  one directory  at a  time.  If you mark an item in the
     current  directory,  having  already  marked  something  in  another, the
     marking will vanish in the original directory.

     To mark files and subdirectories, you simply move the bar of light to the
     item you wish to mark and press the <+> key (either the <Shft-=> from the
     top row  of keys,  or the  separate <+>  key near  the numeric keypad and
     cursor control keys may be used - using that <+> as well as <-> is easier
     on the  fingers).  Depending on your computer screen, marking will either
     underline the item or turn it a different color.

     If you move to another directory  and wish  to take  a look  at the files
     that you  have marked  in the other directory, you can toggle between the
     two directories by pressing <Alt-M>.  This works across drives.

Unmarking Files

     To unmark an item, move the bar of light cursor to it  and press  the <->
     key.  You can unmark all files at once by typing <Alt-U>.

The Easy Route:  User-Definable Keys - the Alphabetic Keys A to Z

     These keys,  which are  ONLY used in the DIRECTORY/FILE mode, can be used
     to permanently save instructions.  ROAM comes with several of  these keys
     predefined.  However, you can change any of these predefined keys, if you
     wish them to do other things.  SEE YOUR PERSONAL GUIDE.

     For example, your preconfigured Key shows <K>opy [sic] and <T>ransfer:

          You have several files, with nothing particular in common - at least
          in their names, to copy from the C: drive to A:.  Move to each file,
          pressing <+> to mark each one.  Unmark  any (with  <->) if  you were
          "trigger-happy" or  change your mind.  When you are satisfied, press
          the <A> key, which changes you to the A: drive, and then  press <K>.
          Each of the files you marked are copied and that fact is reported on
          the screen.  The original files are unmarked.   Press  <C> to return
          to the  C: drive.   This was equivalent to the following commands in
          the COMMAND LINE mode (after the files were marked):

               A:         <ENTER>
               COPY ^M    <ENTER>
               UNMARK *.* <ENTER>
               C:         <ENTER>

          As a matter of fact, those  exact  instructions  were  fed  into the
          COMMAND LINE!

          Lets try  another.   You have  the same problem with file names, but
          this time  you want  to MOVE  them to  another directory.   Mark the
          files you  want, the same way as last time.  Go to the directory you
          want (let's say \BUSINESS).   Do  this  by  pressing  <\>  (have you
          noticed that  </> works  also?), move to BUSINESS in the Directories
          window, and  press <ENTER>.   Next  hit the  <T> key  and watch your
          files move!   This  was equivalent  to the following commands in the
          COMMAND LINE mode (after the files where marked)

               CD \BUSINESS  <ENTER>
               MOVE ^M       <ENTER>

          or, as COMMAND LINE actually got it:

               CD \          <ENTER>
               CD BUSINESS   <ENTER>
               MOVE ^M       <ENTER>



ACTIVITIES USING BOTH MODES

Copying and Moving Files from One Directory to Another

     ROAM allows you to  move and  copy files  from one  directory to another.
     When you  MOVE a file or files, you can only move them within directories
     on the same drive, i.e. you can move a group of files  from one directory
     to another  on your hard disk, but you can not use ROAM's MOVE command to
     move them from your hard disk  to your  A: Drive.   When  you wish  to do
     this,  you  must  use  the  COPY  command and then return to the original
     directory and delete them (see example below).

     If you move a file to  another subdirectory  and there  is a  file by the
     same name  in that  subdirectory as  the file  you are  moving, ROAM will
     alert you and request directions on what to do.

Moving and Copying, when You Know Where You Are Going

     When you wish to move or copy files  from one  directory to  another, the
     following commands can be used in the COMMAND LINE mode.  The Control Key
     combinations can be used to make your work easier as shown below.

          COPY <Ctrl-B> A:    This would copy the file currently in the bar of
                              light to the A: drive

          COPY <Ctrl-M> \FUN  This would  copy the  files which  are marked to
                              the \FUN subdirectory.

Packing Your Bags and Taking the Files with You

     ROAM's other way of moving and copying  files  -  by  moving  to  the new
     directory and  calling for the program to deliver the files to you.  This
     method is similar to checking into a hotel, going to your room and having
     the porter  bring your  bags to  your room.  You would take the following
     steps.

          1.   In the DIRECTORY/FILE mode, mark the  files you  wished to move
               or copy.

          2.   Remaining  in  the  DIRECTORY/FILE  mode, move to the directory
               where you wish to copy or move the files.

          3.   When you are in the new  directory, <TAB>  to the  COMMAND LINE
               mode and  type either  of the  following, depending on what you
               wish to do:

               COPY ^M   <ENTER>

               MOVE ^M   <ENTER>

          ROAM will then take  over  and  carry  out  your  wishes,  moving or
          copying all the marked files to the new directory.



YOUR PERSONAL GUIDE TO ROAM - CONFIGURATION OF THE DIRECTORY/FILE MODE

ROAM allows you to customize several facets of the DIRECTORY/FILE mode to make
ROAM adapt to your needs.   To  set  up  your  personal  guide,  <TAB>  to the
DIRECTORY/FILE mode and then press <Shft-Tab>.  You will be presented with the
following menu:

      Customizations Available
      Alphabetic keys
      Default command for undefined extensions
      File extensions associated with commands
      Key at bottom of screen

      Quit


Move the bar of light to one your choices and press <ENTER>.


Alphabetic Keys

     ROAM is  distributed with  several keys  predefined to  carry out certain
     commands.    You  may  keep  these  as they are, or change them using the
     personalization process shown in this chapter.  Some of ROAM's predefined
     keys are:

          <A>  Switches you to drive A:

          <B>  Switches you to drive B:

          <C>  Switches you to drive C:

          <D>  Lets you  view the  familiar DOS-type listing for the directory
               that you are currently in, including expanded information, e.g.
               File  Name  and  Extension,  File  Size,  Date,  Time.   If the
               directory is longer than can be fit on the screen  at one time,
               you can  scroll through  it using  the <UP>, <DOWN>, <PgUp> and
               <PgDn> keys.  When  you are  finished, use  <Esc> to  return to
               ROAM (See VIEW under ADJUNCT PROGRAMS).

          <E>  Activates the  DOS line  editor Edlin.  If the bar of light was
               on AUTOEXEC.BAT, then DOS is told  EDLIN AUTOEXEC.BAT,  to edit
               that file.

          <F>  Uses WHEREIS  to Find  files for  you, no matter where they are
               and then counts and lists them.   As  with <D>,  you can scroll
               through the resulting listing.

          <G>  Go  back  to  the  previous  subdirectory  (if  you used <R> to
               remember your place.

          <H>  Uses LOOK to browse through the #READ.ME file ROAM manual.

          <K>  Kopy [sic] marked files.  This  will copy  any files  which are
               marked into the current directory.

          <L>  Executes the  LOOK program  which allows  you to  view, but not
               edit any ASCII file and some word processing files.

          <N>  Prompts you for a subdirectory name,  creates it  and moves you
               there.

          <R>  Tells ROAM  that you wish to remember where you were before you
               move out of a directory.

          <T>  Transfer (i.e. MOVE) files  which are  marked into  the current
               subdirectory.

     You can  assign specific commands to an individual key.  After you are in
     the Alphabetic Keys menu, select the letter key you wish to configure.  A
     listing  of  the  alphabetic  keys  which  have already been selected are
     displayed at the top of the menu.  If the key you  wish to  configure has
     already been  chosen, you  will see  its assignment  on the editing line.
     You can either reassign it or exit without editing the line.

Default Command for Undefined Extensions

     You can specify a command to execute when you press <ENTER> with  the bar
     of  light   on  a  file  whose  extension  (the  extension  of  the  file
     AUTOEXEC.BAT is BAT) is not  otherwise  defined  in  ROAM  (See  the next
     section).   ROAM comes  preconfigured to execute LOOK ^B.  If you want to
     see the contents of CONFIG.SYS, move  the  bar  to  that  file  and press
     <ENTER>.

File Extensions Associated with Commands

     In this  screen you  are presented  with two columns.  The left column is
     for file extensions and  the right  is for  the commands  associated with
     those extensions, for example:

          BAS:basica ^B
          BAT:^B
          COM:^B
          EXE:^B
          DFX:DFX ^B
          PAS:TURBO ^B
          WP:WP ^B

     When the  bar of light is on a file with one of the above extensions, the
     command associated with that extension is executed.

KEY at screen bottom

     Using the ROAM's editing instructions  printed  on  the  screen,  you may
     design your  own Personal  Guide screen to reflect the decisions that you
     made in the first three menu selections.



AUTOMENU

If you have a set of operations which you would  like to  choose from  a batch
file (See CHOOSE below) create the batch file and name it AUTOMENU.BAT, making
sure that it is in the root directory.   It  would usually  be a  menu of some
sort, but  it could be any batch file.  The next time ROAM is started, it will
find \AUTOMENU.BAT and incorporate it as the third "mode".



ROAM ADJUNCT PROGRAMS

ROAM has several unique programs which can be run from ROAM, when you are at a
command  line   or  incorporated  into  your  personal  configuration  of  the
DIRECTORY/FILE mode.  These programs have  been selected  to make  life easier
for  you  when  you  are  using  ROAM  to  travel about your directories.  The
DIRECTORY/FILE mode comes preconfigured to automatically carry out  several of
these programs.

     CHOOSE    This program  can be used to create a menu, which can be either
               toggled  on  when  using  the  <TAB>   key  (if   it  is  named
               \AUTOMENU.BAT,  or  can  be  called  by  defining  one  of  the
               alphabetic keys with the name of the batch file.

               CHOOSE waits for keyboard  input  and,  provided  that  the key
               struck is in that set of letters in CHOOSE's parameter, the DOS
               ERRORLEVEL is set according to the order of that letter  in the
               parameter.

               EXAMPLE OF MENU.BAT FILE that you can create using CHOOSE:

                    echo off
                    :START
                    cls
                    echo E)dit
                    echo P)rint
                    echo Q)uit                    [SEE NOTE BELOW]
                    choose EPQ
                    if ERRORLEVEL 3 goto Q
                    if ERRORLEVEL 2 goto P
                    EditIt
                    goto START
                    :P
                    PrintIt
                    goto START
                    :Q
                    echo Goodbye!

          NOTE:  If you wish to use a similar AUTOMENU.BAT as one of the three
          modes in ROAM, you should use the ASCII  <TAB> character  instead of
          the <Q>  for Quit.   The  ASCII <TAB>  can be  created in most ASCII
          editors, e.g. EDLIN.   For the above  example you  would replace the
          line

               Echo Q)uit

          above with

               Echo [TAB] from this menu

          This  will  enable  you  to  rapidly  switch between the three modes
          without taking your finger off the <TAB> key.  Note that we  did not
          enclose the  name TAB  between angle  brackets.  This is because the
          angle brackets < > have a special meaning to DOS.

          DAY       If a batch file needs to know what day of the month it is,
                    the ERRORLEVEL returned by DAY can be used:

                         echo OFF
                         cls
                         DAY
                         if ERRORLEVEL 15 goto SECOND_HALF
                         echo This is the first half of the month.
                         goto THE_END
                         :SECOND_HALF
                         echo This is the second half of the month.
                         :THE_END

                    If the date if more than or equal to 15 the second message
                    is displayed, otherwise the  first is  shown.   Any set of
                    commands could be substituted for the messages.

          EACHDIR   This program  will carry  out a command on every directory
                    on the current drive.  If you wanted  to remove  or delete
                    every  backup   file  called  .BAK,  you  would  type  the
                    following:

                         EACHDIR DEL *.BAK

                    Similarly, if you wished  to look  at each  .BAT file, you
                    would type:

                         EACHDIR LOOK *.BAT

                    Never type something like:

                         EACHDIR DEL *.*

                    Unless, of course, that is what you meant!

          HOUR      This  program  tells  a  batch  file  the  hour of the day
                    through ERRORLEVEL:

                         echo OFF
                         cls
                         HOUR
                         if ERRORLEVEL 12 goto PM
                         echo It's early!
                         goto THE_END
                         :PM
                         echo It's late!
                         :THE_END

                    If the hour is more than or equal  to 12  than the message
                    at :PM  is displayed,  otherwise control  falls through to
                    the A.M.  Any set of commands could be substituted for the
                    messages.

          LOOK      This program,  allows you  to look  at files, if the files
                    are ASCII.  You can not make any  changes in  these files,
                    only look  at them.  The cursor control keys listed at the
                    top of LOOK's screen will move you about the file  and the
                    <Esc> key will drop you back into ROAM.  For example:

                         LOOK THISFILE.TXT

                    The Key  at the  bottom of  the DIRECTORY/FILE mode screen
                    comes  preconfigured  to  automatically  carry  out  LOOK.
                    Striking the <L> Key when in DIRECTORY/FILE mode, will let
                    you look at the file which  is currently  highlighted with
                    the bar of light.

                    As LOOK reads in a file,  you will see the number of lines
                    read appear at the bottom right corner of the screen.  You
                    can start moving about within the already read  portion of
                    the file  before the  rest of  the file  is finished being
                    read.   The bottom left corner of the screen tells you the
                    line number of the text at the top of the screen.

          MARK &    These commands will mark and unmark specified files (See
          UNMARK    COMMAND LINE - Marking Files.  The following sequence

                         MARK *.BAT
                         UNMARK R*.*

                    marks  all  the  batch  files in the current directory and
                    then unmarks any of  those marked  files which  begin with
                    the letter  "R".   Like MEM,  PUSHD and POPD, the commands
                    MARK and UNMARK are commands internal to ROAM  and can not
                    be included in batch files.

          MEM       This program  will give  you the  available memory of your
                    computer's current RAM memory.  The  Key at  the bottom of
                    the  DIRECTORY/FILE   mode  screen   comes  configured  to
                    automatically carry out MEM, when you  press the  <M> key.
                    This  is  actually  an  "internal"  command, rather than a
                    separate MEM.EXE.  This means that you can  not include it
                    in a batch (.BAT) file.

          MONTH     This  program  tells  a  batch  file the month of the year
                    through ERRORLEVEL numbering January as 1:

                         echo OFF
                         cls
                         MONTH
                         if ERRORLEVEL 4 goto APRIL_OR_LATER
                         if ERRORLEVEL 3 goto MARCH
                         if ERRORLEVEL 2 goto FEBRUARY
                         echo January!
                         goto THE_END
                         :FEBRUARY
                         echo February!
                         goto THE_END
                         :MARCH
                         echo March!
                         goto THE_END
                         :APRIL_OR_LATER
                         echo April or later!
                         goto THE_END
                         :THE_END

                    If the day of the week is more than or equal to 6 than the
                    message  at  :WEEKEND  is  displayed, if it's more than or
                    equal to 5,  we  talk  about  Friday,  etc.    Any  set of
                    commands could be substituted for the messages.

          MOVE      The MOVE  program is  used by ROAM to relocate a file from
                    one directory to another on the same drive.

                         MOVE THISFILE.TXT \ROAM

                    would  move  the  file   THISFILE.TXT  into   the  C:\ROAM
                    directory from the current directory.

                    Or you can type this command:

                         MOVE \ROAM\THISFILE.TXT

                    which   would   move   the   file  THISFILE.TXT  from  the
                    subdirectory \ROAM  into the  current directory.   You may
                    also use  the ^M  and ^B  functions of ROAM in conjunction
                    with MOVE to transfer a file or group of files.

          PUSHD &   These, like MEM, are internal commands and may not be
          POPD      included in batch files.   They  do not  exist as separate
                    .EXE  files.    In  the  COMMAND LINE mode, if you wish to
                    travel to another directory to  see  or  do  something and
                    want to return quickly to the drive and directory that you
                    were in before leaving the first directory, type:

                         PUSHD

                    Move to where you wish to  go.   When you  want to return,
                    simply type:

                         POPD

                    The Key  at the  bottom of  the DIRECTORY/FILE mode screen
                    comes preconfigured configured to  automatically carry out
                    PUSHD and POPD.  Type <R> for Remember, before you leave a
                    directory and when you wish  to  return  type  <G>  for Go
                    back.

          RENDIR    This program is used to rename a subdirectory:

                         RENDIR THISDIR THATDIR

                    will rename the subdirectory called THISDIR, to THATDIR.

          VIEW      This is  a filter  program, similar to LOOK except that it
                    gets its input from  the standard  output of  the previous
                    program in a pipe, and passes that input unchanged through
                    its standard output.  For example:

                         DIR | VIEW >NUL

                    which is the default definition of the alphabetic key <D>.
                    The DOS  command DIR is executed.  Rather than sending its
                    output to the screen it is redirected (see your DOS manual
                    for  more  information)  it  is  "piped" into the standard
                    input of VIEW.  When you are done  looking about  in VIEW,
                    it copies  its total input to standard output, which again
                    would normally be the screen.  Instead we  are redirecting
                    it  into  the  DOS  device  NUL,  which  is where you send
                    anything you don't want!  This program is of more interest
                    to advanced users of DOS.

          WEEK      This  program  tells  a  batch  file  the  day of the week
                    through ERRORLEVEL, numbering Monday as 1:

                         echo OFF
                         cls
                         WEEK
                         if ERRORLEVEL 6 goto WEEK_END
                         if ERRORLEVEL 5 goto FRIDAY
                         if ERRORLEVEL 2 goto REST_OF_WEEK
                         echo I hate Mondays!
                         goto THE_END
                         :WEEK_END
                         echo What are you doing here on a weekend?
                         goto THE_END
                         :FRIDAY
                         echo Thank God it's Friday!
                         goto THE_END
                         :REST_OF_WEEK
                         echo Get to work!
                         :THE_END

                    If the day of the week is more than or equal to 6 than the
                    message  at  :WEEKEND  is  displayed, if it's more than or
                    equal to 5,  we  talk  about  Friday,  etc.    Any  set of
                    commands could be substituted for the messages.

          WHEREIS   At the  COMMAND LINE,  you can  use this program to find a
                    file which might be  in another  directory of  the current
                    drive.  You can use DOS wildcards.  For example,

                         WHEREIS ROA*.*

                    The answer that WHEREIS might return is

                         C:\ROAM\ROAMINT.EXE
                         C:\ROAM\ROAMCUST.EXE
                         C:\ROAM\ROAM.EXE

                         3 Files Found

                    The <F>  key comes  configured to  automatically carry out
                    WHEREIS.  Pressing the  <F> Key  will prompt  you for user
                    input, which  is the file name you wish to search for.  It
                    then searches the whole disk, redirecting  its output into
                    VIEW, in case the report is a long one.

          YEAR      This program tells a batch file the last two digits of the
                    year through ERRORLEVEL:

                         echo OFF
                         cls
                         YEAR
                         if ERRORLEVEL 89 goto FUTURE
                         if ERRORLEVEL 88 goto PRESENT
                         echo The Past
                         goto THE_END
                         :FUTURE
                         echo The Future
                         goto THE_END
                         :PRESENT
                         echo The Present
                         :THE_END

                    If the year is more than or equal  to 89  than the message
                    at :FUTURE is displayed, if it's more than or equal to 88,
                    the message at :PRESENT, etc.   Any set  of commands could
                    be substituted for the messages.


******************************************************************************


Directory of PC-SIG Library Disk #1151

 Volume in drive A has no label
 Directory of A:\

#FILES            1442   4-18-88   3:36p
#READ    ME       4054   4-01-88  11:36a
INSTALL  EXE     23568   4-01-88   2:39p
LOOK     EXE     15472   2-23-88  11:57p
REBOOT   COM        26  11-29-87   9:00p
ROAM     DOC     53888   4-01-88   2:37p
ROAM     EXE     43472   4-05-88   3:54p
ROAMINIT EXE     51968   4-01-88   2:41p
VIEW     EXE     15536   2-18-88   5:23a
FILE1151 TXT      1725  10-20-88  12:23p
GO       BAT        38   1-18-88   1:38p
GO       TXT       540  10-05-88   2:23p
       12 file(s)     211729 bytes
                      103424 bytes free