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