home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / dosutils / xdosman.arj / CHAPT8.DOC < prev    next >
Encoding:
Text File  |  1991-11-28  |  45.1 KB  |  1,099 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                    Chapter 8.
  10.  
  11.                             The X-DOS Shell Program
  12.  
  13.  
  14.      Introduction
  15.  
  16.           X-DOS provides a shell utility called XSHELL. The XSHELL program
  17.           is a special extension of the X-DOS operating system that
  18.           provides an easy to use menu driven interface. With XSHELL you
  19.           can carry out all your file management tasks using simple pull
  20.           down menus rather than having to remember lots of complicated
  21.           commands. The shell program is completely mouse driven too, so
  22.           you can move around the screen by clicking the mouse where you
  23.           want to go and run commands by clicking on them in the menus.
  24.  
  25.           For added convenience the DOS command line is still visible in
  26.           the shell and you can type in and run commands from the command
  27.           line just as normal. In addition, XSHELL provides a split screen
  28.           display allowing you to display two different directories on the
  29.           screen simultaneously and the files in those directories.
  30.           XSHELL also includes a special file application function which
  31.           allows you to set up menus from which you can run your favorite
  32.           programs simply by clicking on the program name with the mouse.
  33.           Once you get used to using XSHELL you may decide that you wish it
  34.           become the default screen display every time you load X-DOS. In
  35.           that case you can enter a command in your AUTOEXEC.BAT file to
  36.           automatically load XSHELL when you turn your computer on or set
  37.           the automatic XSHELL boot in the INSTALL program.
  38.  
  39.      Setting The XSHELL Path
  40.  
  41.           If, for some reason, you have moved the SHELL overlay files to
  42.           another directory than the DOS directory on the boot drive, you
  43.           must tell X-DOS where they are located. If, for example, you
  44.           decide to store the XSHELL overlay files in the \DOSSHELL
  45.           directory, you must type the following command at the DOS prompt:
  46.  
  47.                              SET XSHELL=C:\DOSSHELL
  48.  
  49.           This tells X-DOS to look in the DOSSHELL directory on the C:
  50.           drive for XSHELL. The statement you actually type may differ from
  51.           this example depending on which drive and in which directory you
  52.           have installed X-DOS.
  53.  
  54.           You should enter this statement in your AUTOEXEC.BAT file so you
  55.           do not have to type it every time you wish to use XSHELL.
  56.  
  57.      Loading XSHELL
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                       8-1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.           To load XSHELL simply boot up your computer with X-DOS, set the
  70.           shell path as described above if you have moved the SHELL files
  71.           form the default directory (if you have entered this statement in
  72.           your AUTOEXEC.BAT file you will not have to do this) and type HS
  73.           or XSHELL at the command line.
  74.  
  75.           Loading XSHELL Switches
  76.           Two switches are available with XSHELL to allow you to go
  77.           directly to the File functions mode or Applications mode. The
  78.           File functions mode is the default XSHELL mode in which you can
  79.           carry out your file management. The Applications mode allows you
  80.           to create a menu list of your programs and run these programs
  81.           with the click of a mouse.
  82.           To load XSHELL in the default mode, at the DOS prompt type: HS /F
  83.           or just HS. You can also use the XSHELL name.
  84.           To load XSHELL in the Applications mode, type: HS /A
  85.  
  86.      The XSHELL File Management Screen Display
  87.  
  88.           When in the file management mode, the XSHELL display consists of
  89.           a number of different areas, with each area containing important
  90.           information. Along the top of the screen is a list of the menus
  91.           and the function keys that access them, as listed below:
  92.                F1 - Help
  93.                F2 - File
  94.                F3 - Disk
  95.                F5 - Applications
  96.                F6 - Split
  97.                F7 - Zoom
  98.           In the main portion of the screen are four windows. The two
  99.           windows on the left show identical directory trees for the drive
  100.           from which you loaded XSHELL. The volume label of the drive will
  101.           also be shown. If no volume label was assigned to the drive
  102.           "None" will be displayed. The two windows on the right display
  103.           identical lists of the files contained in the directory from
  104.           which XSHELL was run. Each window also shows the number of files
  105.           in the current directory and the number of bytes of unused space
  106.           on the disk.
  107.  
  108.           In the bottom area of the screen, on the left is a list of the
  109.           drives installed on your system, with the current drive
  110.           highlighted. In the center is written 0 Files marked, and on the
  111.           right 0 Bytes.
  112.  
  113.           In the bottom left corner of the display is the DOS prompt with a
  114.           blinking cursor.
  115.  
  116.      Using XSHELL With a Mouse
  117.  
  118.           If you have a mouse installed on your system you will find it
  119.           extremely convenient to move around XSHELL and run commands.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.                                       8-2
  126.  
  127.  
  128.  
  129.  
  130.  
  131.           Calling Up Menus
  132.           To call up a menu, simply move the mouse cursor over the menu
  133.           name and click the left mouse button.
  134.  
  135.           Running Menu Commands
  136.           To run a menu command, simply move the mouse cursor over the
  137.           command you wish to execute and click the left mouse button. Many
  138.           of the menu commands require that you first select a file or
  139.           group of files to run this command on. If you click on a menu
  140.           item that requires file to have been selected the message No
  141.           File(s) are Selected will appear.
  142.  
  143.           Selecting the Active Window
  144.           To move between the windows in the main screen area, simply move
  145.           the mouse cursor to the window you wish to select and click the
  146.           left button. The selected window will become the active window
  147.           which is always surrounded by a double lined box.
  148.  
  149.           Selecting and De-selecting Files
  150.           To select a file for a certain action such as copying or
  151.           deleting, simply click on the file with your mouse. A marker will
  152.           appear next to this file indicating that it is currently
  153.           selected. You may select as many files as you want in this way to
  154.           perform actions on multiple files. To deselect a selected file
  155.           simply click on that file a second time.
  156.  
  157.           The Command Line
  158.           If you wish to enter a DOS command at the command line, simply
  159.           type the command on your keyboard in the normal way and the
  160.           command will appear at the command line in the bottom left corner
  161.           of your screen. When ever you type anything on the keyboard,
  162.           assuming you have not called up any menu functions, this will
  163.           automatically appear at the command line. To run any command
  164.           typed in at the command line, simply press [Enter] just as you do
  165.           when not running XSHELL. You can recall the previous command by
  166.           pressing the F10 key.
  167.  
  168.      Using XSHELL With the Keyboard
  169.  
  170.           If you do not have a mouse you can still access all the XSHELL
  171.           functions from the keyboard.
  172.  
  173.           Calling Up Menus
  174.           To call up a menu, simply press the relevant function key as
  175.           listed against the menu names at the top of your screen. For
  176.           example, to call up the Help menu, press F1; to call up the File
  177.           menu press F3.
  178.  
  179.           Running Menu Commands
  180.           To run a menu command, simply move the highlight bar over the
  181.           command you wish to execute with the cursor up/down keys and
  182.           press [Enter]. Many of the menu commands require that you first
  183.  
  184.  
  185.  
  186.  
  187.                                       8-3
  188.  
  189.  
  190.  
  191.  
  192.  
  193.           select a file or group of files to run this command on. If you
  194.           run a menu item that requires file to have been selected the
  195.           message No File(s) are Selected will appear.
  196.  
  197.           Selecting the Active Window
  198.           To move between the windows in the main screen area, press the
  199.           [Tab] key. This will move you between the windows on your screen
  200.           clockwise. The active window which is always surrounded by a
  201.           double lined box.
  202.  
  203.           Selecting and De-selecting Files
  204.           To select a file, use the cursor up/down keys to move the
  205.           highlight bar over the relevant file and press [Enter]. You may
  206.           select as many files as you want at the same time to perform
  207.           functions on multiple files. To deselect a previously selected
  208.           file, highlight that file and press [Enter] a second time.
  209.  
  210.           The Command Line
  211.           If you wish to enter a DOS command at the command line, simply
  212.           type the command on your keyboard in the normal way, press
  213.           [Enter] and the command will be executed.
  214.  
  215.      Guide to General Usage
  216.  
  217.           From within the shell you can carry out all your file management
  218.           functions, such as copying and deleting files etc., creating
  219.           directories, sorting files within directories and generally
  220.           manipulating all the data stored on your disks and diskettes. In
  221.           addition, the utilities menu includes many special functions
  222.           including a number of security features and a file transfer
  223.           utility which allows you to transmit data from your computer to
  224.           another computer via the serial interface.
  225.  
  226.           When you first enter XSHELL your screen is divided into two pairs
  227.           of identical windows. Whenever you want to perform an action on a
  228.           file, first click on the window containing that file information,
  229.           and then click on the file to mark it. You may then click on the
  230.           File menu and select the item of your choice, such as Copy or
  231.           Delete.
  232.  
  233.           To select multiple files, simply click on several files. Each
  234.           selected file will be marked. Note that at the bottom of your
  235.           screen the number of files currently marked will be shown and the
  236.           total number of bytes comprising those files.
  237.  
  238.           To display the directory tree of two different disks on your
  239.           screen, simply go to the Disk menu, click on Change Drive, click
  240.           on the drive letter to which you wish to change or type the drive
  241.           letter on the keyboard, and the active window will change to
  242.           displaying the directory tree of the new drive. The other
  243.           directory window will still show the directory tree of the
  244.           original drive and you have a clear visual image of the
  245.  
  246.  
  247.  
  248.  
  249.                                       8-4
  250.  
  251.  
  252.  
  253.  
  254.  
  255.           directories and files on two different drives.
  256.  
  257.           Use the Split and Zoom functions to change the screen display to
  258.           show just one directory and file window and to zoom in on one
  259.           window, allowing a full screen display of that window. Both the
  260.           Split and Zoom functions are instantaneous - click on them once
  261.           to change the screen display and click on them, a second time to
  262.           go back to the original display.
  263.  
  264.           For a full reference of all the commands in XSHELL please refer
  265.           to the XSHELL Command Reference, below.
  266.  
  267.      XSHELL Command Reference
  268.  
  269.           XSHELL consists of an application management section and a file
  270.           management section. Each section has a menu bar from which most
  271.           of the XSHELL functions can be accessed. To call up a menu press
  272.           the function key allocated to that menu or click the left mouse
  273.           button with the mouse cursor on the menu name. Get further
  274.           information on any of the menu bar items below by selecting them
  275.           and pressing F1 to call up help. This reference section is
  276.           divided into two parts. The first part deals with the File
  277.           Management function of XSHELL; the second part explains how to
  278.           use the Application function.
  279.  
  280.           The Menu Bar in the File Management Section of XSHELL:
  281.  
  282.           F1-Help           Displays context sensitive help everywhere in
  283.                             XSHELL.
  284.  
  285.           F2-File           Activates a pulldown menu with file related
  286.                             functions.
  287.  
  288.           F3-Disk           Activates a pulldown menu with disk related
  289.                             functions.
  290.  
  291.           F4-Utilities      Activates a pulldown menu with several
  292.                             utilities.
  293.  
  294.           F5-Applications   Loads the application section of XSHELL.
  295.  
  296.           F6-Split          Toggles between double and single directory
  297.                             display.
  298.  
  299.           F7-Zoom           Zooms in on the active window.
  300.  
  301.           The F2-File Pulldown Menu
  302.           You can display the F2-File pulldown menu from the menu bar in
  303.           one of two ways. Either click on the menu with your mouse or
  304.           press F2.
  305.  
  306.           The  pulldown menu contains the following functions:
  307.  
  308.  
  309.  
  310.  
  311.                                       8-5
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.                Run File                 AltR
  319.                Copy File(s)             AltC
  320.                Move File(s)             AltM
  321.                Delete File(s)           AltD
  322.                Locate File(s)           AltL
  323.                Rename File(s)           AltN
  324.                Edit File(s)             AltE
  325.                View File(s)             AltV
  326.                Compare Files            AltO
  327.                Print File(s)            AltP
  328.                Change Attributes        AltA
  329.                About XSHELL             AltI
  330.                Select Group             AltS
  331.                Unselect Group           AltU
  332.                Gateway to DOS           AltG
  333.                Exit XSHELL              AltX
  334.  
  335.           The F3-Disk Pulldown Menu
  336.           The F3 pulldown menu contains the following functions:
  337.  
  338.                Add Directory
  339.                Delete Directory
  340.                Rename Directory
  341.                Change Drive
  342.                Format Diskette
  343.                Make Bootable Disk
  344.                Copy Diskette
  345.                Check Disk
  346.                Search Disk for Text
  347.                Name/Rename Volume
  348.                Backup/Restore
  349.  
  350.           The F4-Utilities Pulldown Menu
  351.           The  F4 pulldown menu contains the following functions:
  352.  
  353.                Memory Status
  354.                Re-read Tree
  355.                Security Features
  356.                Setup Peripherals
  357.                System Time/Date
  358.                25/43 Line Display
  359.                Window Switch
  360.                File Display Format
  361.                Display Filter
  362.                Recall DOS Line
  363.                Directory Sort
  364.                Undelete File(s)
  365.                Format Recovery
  366.                Communications Program
  367.                File Transfer Link
  368.                Extension Associations
  369.  
  370.  
  371.  
  372.  
  373.                                       8-6
  374.  
  375.  
  376.  
  377.  
  378.  
  379.                Save Configuration
  380.  
  381.           The F5-Applications Menu Item
  382.           This menu activates the Application section of the shell.
  383.  
  384.           The F6-Split Menu Item
  385.           This function toggles the one/two drive format of the XSHELL
  386.           windows.
  387.  
  388.           The F7-Zoom Menu Item
  389.           This function will zoom the drive window to show one drive only
  390.           but will leave the two directory windows on the right.
  391.  
  392.      File Application Function Command Reference
  393.  
  394.           This section contains a reference of all the menu commands in the
  395.           file application section of XSHELL. The file application section
  396.           is the default display when you enter XSHELL.
  397.  
  398.           File Menu Functions (F2)
  399.                                     Run File
  400.           The Run File menu item executes a selected file. You must first
  401.           select a file before you can choose to execute a program. Place
  402.           the selector in the right portion of the screen over the file you
  403.           wish to execute. This function can only execute files with an
  404.           extension of .EXE, .COM or .BAT Upon execution, or with an
  405.           automatic file extension association. XSHELL will release all of
  406.           the memory occupied by itself so that you have plenty of room to
  407.           run even large application programs. When you exit the
  408.           application program, XSHELL reloads itself and returns you to the
  409.           file management main screen. You may enter parameters in the
  410.           provided window before the application is activated.
  411.  
  412.           Hot Key: AltR
  413.  
  414.           You can double click on a file with a mouse to run it.
  415.  
  416.                                   Copy File(s)
  417.           The Copy File(s) menu item makes it easy for you to copy one or
  418.           more files between different directories, even across different
  419.           drives. You select files in the highlighted directory window then
  420.           copy the files to a destination of your choice. By default,
  421.           XSHELL prompts you with the directory of the second window.
  422.  
  423.           Hot Key: AltC
  424.  
  425.                                   Move File(s)
  426.           The Move File(s) menu item makes it easy for you to move one or
  427.           more files between different directories, even across different
  428.           drives. The selection principle is similar to the copy files
  429.           function.
  430.  
  431.  
  432.  
  433.  
  434.  
  435.                                       8-7
  436.  
  437.  
  438.  
  439.  
  440.  
  441.           Hot Key: AltM
  442.  
  443.                                  Delete File(s)
  444.           The Delete File(s) menu item lets you delete one or more selected
  445.           files from the active file window. If you accidentally delete
  446.           files which you did not intend to delete, you can use the
  447.           Undelete File(s) menu item in the F4-Utilities pulldown menu to
  448.           recover the deleted file(s).
  449.  
  450.           Hot Key: AltD
  451.  
  452.                                  Locate File(s)
  453.           The Locate File(s) menu item lets you find the location of a file
  454.           or range of files anywhere on a drive. XSHELL offers the option
  455.           to view the files found. This function only works for the drive
  456.           selected by the left highlighted window.
  457.  
  458.           Hot Key: AltL
  459.  
  460.                                  Rename File(s)
  461.           The Rename File(s) menu item allows you to rename one or more
  462.           files. You must specify a name which does not already exist on
  463.           the current directory.
  464.  
  465.           Hot Key: AltN
  466.  
  467.                                   Edit File(s)
  468.           The Edit File(s) menu item lets you edit the contents of a file
  469.           or range of files.  The files you want to edit must be ASCII text
  470.           files. This function calls the X-DOS editor ED.
  471.  
  472.           Hot Key: AltE
  473.  
  474.                                   View File(s)
  475.           The View File(s) menu item lets you display the contents of a
  476.           file or range of files. You can scroll in the file and toggle
  477.           between ASCII or Hexadecimal mode display. At the bottom of the
  478.           display screen you have a list of functions available to move
  479.           around in the file.
  480.  
  481.           Hot Key: AltV
  482.  
  483.                                  Compare Files
  484.           The Compare Files menu item lets you compare the contents of a
  485.           file or group of files with the contents of another file or group
  486.           of files. This function activates the COMP utility. If you need
  487.           assistance on how this utility works, please refer to the COMP
  488.           command in Chapter 6. of this manual.
  489.  
  490.           Hot Key: AltO
  491.  
  492.                                  Print File(s)
  493.  
  494.  
  495.  
  496.  
  497.                                       8-8
  498.  
  499.  
  500.  
  501.  
  502.  
  503.           The Print File(s) menu item sends the contents of one or more
  504.           ASCII text files to a printer connected to the printer port
  505.           referenced by the PRN device (normally the LPT1 printer port).
  506.  
  507.           Hot Key: AltP
  508.  
  509.                                Change Attributes
  510.           The Change Attributes menu item lets you change the file
  511.           attributes and time and date stamps on an file or range of files.
  512.           XSHELL will display a screen with the files that have been
  513.           selected. The cursor will let you change the date and time of the
  514.           file as well as the attributes - system, hidden, archive, read-
  515.           only. To toggle each attribute on or off, simply press the space
  516.           bar. When you have finished, hit [Esc] and XSHELL will then ask
  517.           you to confirm the changes or not.
  518.  
  519.           Hot Key: AltA
  520.  
  521.                                  About X-SHELL
  522.           Select this item to get information on the X-SHELL version number
  523.           and the copyright message.
  524.  
  525.                                   Select Group
  526.           The Select Group menu item lets you select a group of files for
  527.           further manipulation such as copying, moving, or viewing. You can
  528.           specify a group of files like *.COM for instance.
  529.  
  530.           Hot Key: AltS
  531.  
  532.                                  Unselect Group
  533.           The Unselect Group menu item lets you unselect a group of files
  534.           from files which have previously been selected. The files that
  535.           were tagged previously and that correspond to the unselect
  536.           filters will be untagged.
  537.  
  538.           Hot Key: AltU
  539.  
  540.                                  Gateway to DOS
  541.           The Gateway to DOS menu item lets you exit XSHELL and access the
  542.           DOS command line while still keeping XSHELL in memory. Type EXIT
  543.           at the DOS prompt to return to XSHELL.
  544.  
  545.           Hot Key: AltG
  546.  
  547.                                   Exit XSHELL
  548.           The Exit XSHELL menu item lets you exit XSHELL and return to the
  549.           DOS command line. XSHELL will keep in its configuration file the
  550.           setup of XSHELL display for next time.
  551.  
  552.           Hot Key: AltX
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.                                       8-9
  560.  
  561.  
  562.  
  563.  
  564.  
  565.           The Disk Menu Commands (F3)
  566.                                  Add Directory
  567.           This function is equivalent to the MD or MKDIR function of X-DOS.
  568.           You must specify a name that does not currently exist in the
  569.           directory where you are.
  570.  
  571.                                 Delete Directory
  572.           This function is equivalent to the RD or RMDIR function of X-DOS.
  573.           Only empty directories can be deleted from the tree. Make sure
  574.           that when your selection is on the tree you want to delete, no
  575.           files are available in the file window.
  576.  
  577.                                 Rename Directory
  578.           This function is equivalent to the  RENDIR function of X-DOS. The
  579.           new name must not exist in the current directory.
  580.  
  581.                                   Change Drive
  582.           This function allows you to change the drive for the active drive
  583.           window. You can either click with the mouse on the drive list at
  584.           the bottom of the SHELL list or by using the left and right
  585.           arrows move to the desired drive and press ENTER.
  586.  
  587.                                 Format Diskette
  588.           This function lets you format a diskette from XSHELL. It simply
  589.           calls the format function with the appropriate floppy drive
  590.           number.
  591.  
  592.                              Make bootable diskette
  593.           This function will transfer the X-DOS system file and Command
  594.           Processor (as well as its overlay) to a diskette or disk. This
  595.           function is similar to the SYS function.
  596.  
  597.                                  Copy Diskette
  598.           This function will activate the DISKCOPY command and copy the
  599.           source diskette to the destination media.
  600.  
  601.                                    Check Disk
  602.           This function will call the CHKDSK command of X-DOS which will
  603.           perform a verification of the integrity of each file and
  604.           directory on the current drive.
  605.  
  606.                               Search Disk for text
  607.           This command is equivalent to the X-DOS find command and will
  608.           search in the selected drive for a string. It will prompt you for
  609.           case sensitivity, process sub directories, view files ...
  610.  
  611.                                Name/Rename Volume
  612.           This function is equivalent to the LABEL function in X-DOS.
  613.  
  614.                                 Backup/Restore.
  615.           This command will call the XBACK utility.
  616.  
  617.  
  618.  
  619.  
  620.  
  621.                                       8-10
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.           The Utilities Menu Commands (F4)
  629.  
  630.                                  Memory Status
  631.           This command gives the memory map of X-DOS. It calls the MAPMEM
  632.           internal command. The memory shown does not include the SHELL
  633.           memory which is discarded when a command is run.
  634.  
  635.                                   Re-read tree
  636.           This command reprocesses the tree in case one application created
  637.           a directory that XSHELL could not detect. If you have created or
  638.           destroyed a lot of directories either manually at the command
  639.           line or through other applications, it is a good idea to
  640.           sometimes re-read the tree to update the SHELL's image of your
  641.           disk.
  642.  
  643.                                Security Features
  644.           The XSHELL security features are divided into two categories:
  645.           EncryptionXSHELL lets you encrypt files by modifying their
  646.           content using a password you must specify. XSHELL will encrypt
  647.           the files that have been selected with the same password. It will
  648.           prompt you for an extension (by default .PWD) that will replace
  649.           the extension of the files you wish to encrypt. Remember that the
  650.           process of encrypting a file does not alter the contents of the
  651.           original files.
  652.  
  653.           You will be requested to type a password up to 20 characters
  654.           long. Then, one by one, XSHELL will encrypt the selected files
  655.           and give them their original name plus the extension .PWD or a
  656.           new extension as specified by the user.
  657.  
  658.           If you wish to decrypt files that have been encrypted with the
  659.           XSHELL utility or the X-DOS ENCODE command, select the file and
  660.           type in the destination extension (.DCD by default). Type in the
  661.           original password and after decryption check that the file(s) are
  662.           OK by viewing the contents. Please note that if you try to
  663.           decrypt a file that was not encrypted, the destination file will
  664.           be scrambled garbage.
  665.  
  666.           Disk Locking
  667.           XSHELL also lets you protect your hard disk partitions by locking
  668.           them so that no unauthorized individuals can pry into their
  669.           contents when you are not around. You can only lock or unlock
  670.           partitions if they have been programmed to support locking mode
  671.           using the FDISK utility. Refer to the explanation of the FDISK
  672.           utility for more information on this feature.
  673.  
  674.                                 Setup Peripheral
  675.           XSHELL will call the MODE program and let you change some
  676.           parameters of your PC.
  677.  
  678.                                 System Time/Date
  679.  
  680.  
  681.  
  682.  
  683.                                       8-11
  684.  
  685.  
  686.  
  687.  
  688.  
  689.           This command helps you to change the date and time of the system.
  690.  
  691.                                 25/43 Line Video
  692.           If you have an EGA or VGA video card that supports 43 line mode,
  693.           you can use this command to use the shell in 43 line mode or go
  694.           back to the normal 25 line mode.
  695.  
  696.                                  Window Switch
  697.           Like the TAB key, you can change the active window by clicking on
  698.           this function. The switch is circular.
  699.  
  700.           Hot Key : TAB
  701.  
  702.                               File display format
  703.           This function toggles the file display format in the directory
  704.           window from extended display of files (with file size, date ...)
  705.           to simple display (only file name). In simple display, more file
  706.           names can be contained in the window.
  707.  
  708.           Hot Key : F8
  709.  
  710.                                  Display filter
  711.           The display filter enables you to select what files will be
  712.           displayed in the directory window. By default all files are
  713.           displayed but you can tune this filter to restrict the number of
  714.           files displayed.
  715.  
  716.                                 Recall Dos Line
  717.           By pressing F10 you can also recall the command previously typed
  718.           in the command line.
  719.  
  720.           Hot Key : F10
  721.  
  722.                                  Directory sort
  723.           This command will let you sort the directory display according to
  724.           different filters : name, extension date and size.
  725.  
  726.                                 Undelete file(s)
  727.           If you have accidentally erased a file or files, you can use the
  728.           UNDELETE feature to recover these files if they have not been
  729.           overwritten by another file. You must specify a filespec on entry
  730.           and XSHELL will call the X-DOS UNDEL command.
  731.  
  732.                                 Format recovery
  733.           X-DOS offers the possibility to unformat a disk that was
  734.           previously formatted with the safe switch. This feature calls the
  735.           format command with the recover switch turned on.
  736.  
  737.                                File transfer link
  738.           XSHELL lets you transfer files from one PC to another if both are
  739.           running XSHELL and connected through the serial port by a Null
  740.           Modem cable.
  741.  
  742.  
  743.  
  744.  
  745.                                       8-12
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.           Configuration
  753.           Each machine must be running at the same of speed in order to
  754.           communicate. The speed can be adjusted by the change
  755.           Configuration command and you may select High or Low speed. In
  756.           case you experience problems using the file link utility at high
  757.           speed, try using the low speed. The important thing is that both
  758.           machines are running at the same speed. The communication link
  759.           can be set to COM1 or COM2 using the standard serial ports.
  760.           Transmission ProcedureThe machine that contains the files to send
  761.           is called the master and the machine to receive the data, the
  762.           slave. When operating the file link function, you should put the
  763.           slave in receiving mode by activating the Receive File command. A
  764.           screen indicating that it is waiting for the master to send files
  765.           will be displayed. If for some reason you wish to abort the
  766.           procedure, simply hit [Esc].
  767.  
  768.           In order to send files to the slave, you must first select a file
  769.           or files just as you do when using the COPY function. Having
  770.           selected the files you wish to transmit, select the function Send
  771.           Selected Files in the file link menu. The master will first
  772.           establish the connection with the slave in order to test the
  773.           speed to be used in the transmission. The file transfer will then
  774.           be started and a window monitoring which file(s) are being
  775.           transferred will be displayed.
  776.  
  777.           If, having activated the Send Selected Files, the screen display
  778.           on the master shows the window Attempting Connection with
  779.           Receiver for longer than 15 seconds there must be some
  780.           communication problem. In this case the following problems may be
  781.           the cause:
  782.  
  783.           1.The null modem is incorrectly installed.
  784.           2.The serial interface is faulty.
  785.           3.The communications ports are incorrectly defined.
  786.           4.The speed setting is not the same on both the master and the
  787.              slave.
  788.           5.The high speed setting is selected on both machines, so try the
  789.              low speed setting.
  790.           6.The slave computer is not in waiting mode.
  791.  
  792.                              Communication Program
  793.           This item calls X-COM, the built-in full function data
  794.           communications program. If you have a modem installed in your PC
  795.           you will be able to use this program to send and receive files
  796.           over the telephone line. For full details of how to use the X-COM
  797.           communications program, please refer to Chapter 12.
  798.  
  799.                              Extension association.
  800.           XSHELL will only activate files with the extensions .EXE, .COM
  801.           and .BAT. and will issue an error message if files have a
  802.           different extension. However, XSHELL has an extended feature that
  803.  
  804.  
  805.  
  806.  
  807.                                       8-13
  808.  
  809.  
  810.  
  811.  
  812.  
  813.           allows you to associate files with certain extensions with a
  814.           command.
  815.  
  816.           When you decide to activate a file that is not recognized as a
  817.           directly executable file (for instance a file with the extension
  818.           .DOC), XSHELL will check whether this file's extension is
  819.           associated with a command. If this is the case, XSHELL will
  820.           activate the command with the selected file as a parameter.
  821.           Extension associations are user programmable and are saved in a
  822.           file called XASSOC.EXT. When you activate the extension
  823.           association command, XSHELL will load the editor internally and
  824.           let you interactively modify the extension and the command
  825.           associated with them. If you need assistance on how to use ED,
  826.           please refer to Chapter 9. in this manual. You can specify one
  827.           extension association per line, with each line consisting of the
  828.           following format:
  829.  
  830.                           [D:][PATH] COMMAND     .EXT
  831.  
  832.           For example, if you want all the .TXT files to be associated with
  833.           the X-DOS editor, you would type:
  834.  
  835.                                    ED   .TXT
  836.  
  837.                                        or
  838.  
  839.                                 C:\DOS\ED   .TXT
  840.  
  841.           having made your selection of extension associations, you must
  842.           save the extension file. In ED simply press [Alt] W or use the
  843.           Write File function in the main menu to save the file. Then exit
  844.           the editor and return to XSHELL.
  845.  
  846.           Now try running a file with an associated extension by clicking
  847.           twice on the file name or by typing [Alt] R when the file name is
  848.           highlighted. You should see XSHELL loading the application you
  849.           put in the extension application file and updating the program
  850.           activation parameter with the file name selected.
  851.  
  852.                               Save configuration.
  853.           Once you are satisfied with the setting of XSHELL such as the
  854.           window split, directory display ...etc. you can save that
  855.           configuration for later.
  856.  
  857.      The Applications Function
  858.  
  859.           The Application section of XSHELL can be used to collect often
  860.           accessed programs in groups of similar programs and can record
  861.           information about each program's type, location on the disk,
  862.           default associated parameters etc. Those programs, once organized
  863.           in a small program database can be activated very easily just by
  864.           clicking on them. You will not even have to remember the name
  865.  
  866.  
  867.  
  868.  
  869.                                       8-14
  870.  
  871.  
  872.  
  873.  
  874.  
  875.           given to the binary file corresponding to the program. You could,
  876.           for example, reference ED.EXE as the X-DOS Editor and then just
  877.           click on that name to activate it.
  878.  
  879.           When you activate the Application section of the SHELL you will
  880.           see the menu bar at the top of the screen and two main menus. The
  881.           left hand menu is called the application menu. It will normally
  882.           contain the  program group names you have decided to create. For
  883.           instance, you could have entries such as Editors, Database,
  884.           Compilers, DOS Utilities, etc.
  885.  
  886.           The menu on the right contains the sub menu referring to each
  887.           entry in the main application menu. For example, if the first
  888.           entry you type in the main application menu is Editors, the sub
  889.           menu will contain a list of the editors you frequently use, such
  890.           as Wordstar, Xywrite, Brief etc.
  891.           When the left hand application window is the currently selected
  892.           window, by moving down the list of application group names you
  893.           can see the list of programs associated with that group name in
  894.           the right hand window. The sub menu directory will always carry
  895.           the name of the main menu.
  896.  
  897.           Use the [Tab] key to toggle between the two windows or simply
  898.           position the mouse pointer in the desired window and click the
  899.           left button. By clicking on one of the entries or by hitting
  900.           [Enter] you can activate the utility described by its title
  901.           without having to remember the actual name of the executable file
  902.           which you would normally have to type at the command line.
  903.           The functions of the Applications mode are detailed below.
  904.           The Menu Bar in the Application Section of XSHELL
  905.  
  906.           F1-Help             Displays context sensitive help everywhere in
  907.                               XSHELL.
  908.  
  909.           F2-Applications     Activates a pulldown menu with application
  910.                               functions.
  911.  
  912.           F3-Memory Status    Displays a detailed map of memory usage.
  913.  
  914.           F5-File Management  Loads the file management section of XSHELL.
  915.  
  916.  
  917.           The F2-Applications Pulldown Menu
  918.           The pulldown menu contains the following functions:
  919.  
  920.                Add/Edit Menu Item       INS
  921.  
  922.                Delete Menu Item         DEL
  923.  
  924.                Reorder Menu Item        Alt-R
  925.  
  926.                Gateway to DOS           Alt-G
  927.  
  928.  
  929.  
  930.  
  931.                                       8-15
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.                Exit Shell               Alt-X
  939.  
  940.                                Add/Edit Menu Item
  941.           The Add/Edit Menu Item menu item lets you set up and modify
  942.           applications in the application menus.
  943.  
  944.           Setting Up New Applications:
  945.           1. Place the highlight bar on an empty entry in the Application
  946.              Main Menu.
  947.  
  948.           2. Choose the Add/Edit Menu Item menu item from the F2-
  949.              Applications pulldown menu. A menu is displayed in which you
  950.              must specify if you want to create a sub-menu or an
  951.              application menu item.
  952.  
  953.              Note: A sub-menu allows you to set up multiple menu items
  954.              under a main menu item, grouping related programs under a main
  955.              heading. An application menu item allows you to directly
  956.              execute a application program.
  957.  
  958.           3. If you choose to create a sub-menu you are prompted to enter
  959.              the name for the heading in the Applications Main Menu and you
  960.              can also specify a password for the user to enter before
  961.              he/she can access the related sub-menu. When you have done
  962.              this press the <>   key. You are then returned to the
  963.              applications main screen and a Applications Main Menu menu
  964.              item is created with the name you specified.
  965.           If you choose to set up an application program you are prompted
  966.           with an entry box in which you must specify information which
  967.           will execute an application program directly. Following is a
  968.           description of each of the entries in the entry box:
  969.  
  970.           Application Title
  971.           Enter the title of the application you are setting up the way you
  972.           want it to appear in the menu.
  973.  
  974.           Application Directory
  975.           Enter the directory, including drive, in which the executable
  976.           file for the application program is located.
  977.  
  978.           Application to Run
  979.           Enter the name of the executable file which will start your
  980.           application. It is normally a good idea to include the filename
  981.           extension of the file which starts your program but it is seldom
  982.           a necessity.
  983.  
  984.           Application Parameters
  985.           Enter any parameters, such as start-up switches, which you may
  986.           want to pass onto the program every time it executes.
  987.  
  988.           Required Password
  989.  
  990.  
  991.  
  992.  
  993.                                       8-16
  994.  
  995.  
  996.  
  997.  
  998.  
  999.           If you wish to limit access to the application or the application
  1000.           sub-menu, you can assign a password in this entry. The user will
  1001.           then have to enter the password every time the application is
  1002.           executed.
  1003.  
  1004.           Pause After Execution
  1005.           If you want to make a pause before returning to XSHELL after
  1006.           terminating your application, you should type 'Y' for Yes in this
  1007.           entry. This is useful if your application displays important
  1008.           information on the screen and does not automatically pause
  1009.           itself.
  1010.  
  1011.           Prompt for Parameters
  1012.           If you want to application to prompt for parameters before
  1013.           executing, type 'Y' for Yes in this entry. This is often useful
  1014.           with applications such as word processors which often accept
  1015.           different parameters every time they execute such as a filename.
  1016.  
  1017.           4. After you have entered the necessary information in the entry
  1018.              box place the highlight bar on top of the last entry, Prompt
  1019.              for Parameters, and press the <> key. The application menu
  1020.              item is set up and you are returned to the Applications main
  1021.              screen.
  1022.  
  1023.           To modify an existing application, follow the procedure below:
  1024.           1. Place the highlight bar on top of the menu item you want to
  1025.              change.
  1026.  
  1027.           2. Choose the Add/Edit Menu item menu item from the F2-
  1028.              Applications pulldown menu. If the highlighted menu item is a
  1029.              sub-menu heading, an entry box is displayed in which you can
  1030.              change the name of the sub-menu and the optional password.
  1031.  
  1032.             If the highlighted menu item is an application, an entry box is
  1033.              displayed in which you can change a range of information as
  1034.              described in step 3 under Setting Up New Applications.
  1035.  
  1036.           3. When you have made the necessary modifications in the
  1037.              displayed entry box press the [Enter]       key. Your changes
  1038.              are saved and you are returned to the applications main
  1039.              screen.
  1040.  
  1041.                                 Delete Menu Item
  1042.           The Delete Menu Item menu item lets you delete menu items from
  1043.           the Applications Main Menu and from the applications sub-menus.
  1044.  
  1045.           1. Place the highlight bar on top of the menu item you want to
  1046.              delete.
  1047.  
  1048.           2. Choose the Delete Menu Item menu item from the F2-Applications
  1049.              pulldown menu.
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.                                       8-17
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.           3. You will be prompted to confirm that you want to delete the
  1062.              highlighted menu item. Select 'Yes' to delete the menu item.
  1063.              You are returned to the applications main screen and the menu
  1064.              item is gone.
  1065.  
  1066.                                Reorder Menu Item
  1067.           You may sometimes want to change the order in which the
  1068.           applications and sub-menus are arranged in the Application Main
  1069.           Menu or in any of the sub-menus. You can use this menu item to
  1070.           perform this task.
  1071.  
  1072.           1. Place the highlight bar on top of the menu item you want to
  1073.              move to another location.
  1074.  
  1075.           2. Choose the Reorder Menu Item menu item from the F2-
  1076.              Applications pulldown menu. An entry box is displayed in which
  1077.              you must specify the new location for the highlighted menu
  1078.              item.
  1079.  
  1080.           3. You have to type the quick key letter of the entry to which
  1081.              you want to move the highlighted menu item (a letter from A to
  1082.              O). If the location to which you want to move the highlighted
  1083.              menu item already contains another application or sub-menu
  1084.              entry, the two menu items will change places.
  1085.  
  1086.              Note: You cannot move a menu item to another menu than the one
  1087.              the menu item is currently residing in.
  1088.  
  1089.           4. When you have typed the quick key letter press the <> 
  1090.              key. The highlighted menu item is moved to the location of
  1091.              your specified quick key letter and you are returned to the
  1092.              applications main screen.
  1093.  
  1094.                                  Gateway to DOS
  1095.           Select this item to temporarily quit XSHELL and return to DOS
  1096.           without removing XSHELL from memory. To go back to XSHELL, type
  1097.           EXIT at the DOS prompt.
  1098.  
  1099.                                    Exit Shell
  1100.           Select this item to quit the XSHELL program and return to DOS.
  1101.  
  1102.  
  1103.           The F3-Memory Status Menu Item
  1104.           This function shows the remaining memory available to your
  1105.           application not including the Shell which is unloaded when you
  1106.           activate a program.
  1107.  
  1108.           The F5-File Management Menu Item
  1109.           Press F5 to return or go to the File Management section of the
  1110.           shell.
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.                                       8-18
  1118.  
  1119.