home *** CD-ROM | disk | FTP | other *** search
/ Lion Share / lionsharecd.iso / utils_mz / xdosman.zip / CHAPT5.DOC < prev    next >
Text File  |  1992-02-13  |  35KB  |  1,343 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                   Chapter 5.
  7.  
  8.  
  9.  
  10.                         Internal Configuration Commands
  11.  
  12.      Introduction
  13.  
  14.           Chapter 4. explained how the AUTOEXEC.BAT and CONFIG.SYS files
  15.           can be configured using the install program provided with X-DOS.
  16.           The various commands which can be entered into the AUTOEXEC.BAT
  17.           and CONFIG.SYS files, called the Internal Configuration Commands,
  18.           were briefly introduced to help you decide which of these
  19.           commands you should use during installation. In this chapter, a
  20.           detailed explanation of the functions of all the internal
  21.           configuration commands, and the various parameters and switches
  22.           that can be used with these commands, is given.
  23.  
  24.           We suggest that after you have been using X-DOS for a while and
  25.           are ready to start taking advantage of the full power offered by
  26.           this operating system, you read through this chapter to get a
  27.           good understanding of what you can do with the internal
  28.           configuration commands. You may then use the install program to
  29.           configure these commands in your AUTOEXEC.BAT and CONFIG.SYS
  30.           files. Please note that you can also edit the AUTOEXEC.BAT and
  31.           CONFIG.SYS files directly using the editor provided with X-DOS.
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                       5-1
  63.  
  64.  
  65.  
  66.  
  67.      The ANSI.SYS Device Driver
  68.  
  69.           Purpose     This device driver enables you to use ANSI escape
  70.                       sequences to extend your control of the screen and
  71.                       keyboard. ANSI escape sequences are tedious to use
  72.                       but they can create quite remarkable results when
  73.                       used properly. You can, for example, totally remap
  74.                       your keyboard, make fancy command line prompts, and
  75.                       much more.
  76.  
  77.           Type        External Device Driver
  78.  
  79.           Syntax      DEVICE=[d:][path]ANSI.SYS [Inserted in your
  80.                       CONFIG.SYS file
  81.  
  82.           Where       d:path - is the drive and path to the directory in
  83.                       which the ANSI.SYS device driver resides.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.                                       5-2
  124.  
  125.  
  126.  
  127.  
  128.      BREAK Configuration Command
  129.  
  130.           Purpose     his configuration command is used to set the
  131.                       circumstances under which [Ctrl]-C and [Ctrl][Break]
  132.                       are allowed to terminate program execution.
  133.  
  134.           Type        Internal Configuration Command
  135.  
  136.           Syntax      BREAK [ON | OFF]
  137.  
  138.           Where       ON - specifies that BREAK mode will be turned ON.
  139.                       OFF - specifies that BREAK mode will be turned OFF.
  140.  
  141.           Remarks     X-DOS's default setting is BREAK = OFF. Therefore, X-
  142.                       DOS only checks for a [Ctrl]-C or [Ctrl][Break]
  143.                       sequence during:
  144.  
  145.                               *  Standard input functions
  146.                               *  Standard output functions
  147.                               *  Print operations
  148.                               *  Auxiliary operations
  149.  
  150.           To make X-DOS check for [Ctrl]-C and [Ctrl][Break] whenever it is
  151.           requested set BREAK = ON in the CONFIG.SYS file.
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.                                       5-3
  185.  
  186.  
  187.  
  188.  
  189.      BUFFERS Configuration Command
  190.  
  191.           Purpose     This configuration command specifies the number of
  192.                       disk buffers that X-DOS allocates. A larger number
  193.                       normally increases the speed of disk intensive
  194.                       applications but also consumes more memory.
  195.  
  196.           Type        Internal Configuration Command
  197.  
  198.           Syntax      BUFFERS=xx [/E][/A]
  199.  
  200.           Where       xx - is the number of buffers that X-DOS will
  201.                       allocate in memory. The default value for xx is 20
  202.                       and must be in the range of 5 to 4,095. If you
  203.                       install X-DOS with the INSTALL command, the default
  204.                       value is set to 20.
  205.  
  206.                       /E - tells X-DOS to put the buffers in extended
  207.                       memory
  208.                       /A - tells X-DOS to put the buffers in expanded
  209.                       memory
  210.  
  211.           Remarks:    Please note that the buffers cannot be put in
  212.                       extended or expanded memory in the evaluation version
  213.                       of X-DOS.
  214.  
  215.                       The Extended Memory allocation requires the XMS
  216.                       driver loader. Either the internal X-DOS XMS driver
  217.                       can be used (see below) or any other commercial
  218.                       product. Please note that though BUFFERS can be put
  219.                       in extended or expanded memory, some buffers have to
  220.                       remain in lower memory for DMA transfer.
  221.  
  222.           Examples:   If you want to modify the BUFFERS size to 15, you
  223.                       should load the CONFIG.SYS file into ED and add the
  224.                       following line:
  225.  
  226.                       BUFFERS = 15
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.                                       5-4
  246.  
  247.  
  248.  
  249.  
  250.      The CACHE Configuration Command
  251.  
  252.           Purpose     This configuration command increases the speed of
  253.                       disk intensive programs. It works best if you have
  254.                       extended memory or expanded memory available and
  255.                       normally gives better results than increasing the
  256.                       number of disk buffers. The cache only works on hard
  257.                       disks.
  258.  
  259.           Type        Internal Configuration Command
  260.  
  261.           Syntax      CACHE=/D0 [/D1] [/Mxxxx] [/E] [/A]
  262.  
  263.           Where       /D0 - specifies that you want to cache the first
  264.                       physical disk, including all partitions on that disk.
  265.                       /D1 - lets you optionally cache a second physical
  266.                       disk if your computer has two hard disks installed.
  267.                       /Mxxxx - sets the amount of memory that CACHE will
  268.                       use for disk caching. You can specify a cache size up
  269.                       to 8,192K in size. You must enter the cache size in K
  270.                       (kilobytes). If you do not specify a CACHE size with
  271.                       the /Mxxxx parameter, CACHE automatically sets up a
  272.                       64K cache.
  273.  
  274.                       /E - sets up a disk cache in extended memory.
  275.                       /A - sets up a disk cache in expanded memory.
  276.  
  277.           Remarks:    Please note that the CACHE command cannot be
  278.                       activated in the evaluation version of X-DOS.
  279.  
  280.                       CACHE uses the memory you allocate for caching to
  281.                       store data most recently read from the disks.
  282.                       Additionally, CACHE reads more data into memory than
  283.                       is actually needed, forecasting which data may be
  284.                       needed on the following disk access. By doing this,
  285.                       there is a good possibility that the next data your
  286.                       program needs to read from the disk is already in the
  287.                       memory area of your cache. Since reading from memory
  288.                       is much faster than reading from even the fastest
  289.                       hard disk, a cache will dramatically improve the
  290.                       performance of disk intensive programs. The larger
  291.                       the cache, the better the probability is that the
  292.                       needed data is already in memory. You can only cache
  293.                       hard disks. The CACHE statement does not support
  294.                       caching of removable media.
  295.  
  296.                       You must always specify at least one physical drive
  297.                       to cache or you will get an error message. It is
  298.                       important that you understand what a physical drive
  299.                       is. A physical drive refers to a complete hard disk,
  300.                       including all partitions on that hard disk. If your
  301.                       computer has one hard disk with three partitions set
  302.  
  303.  
  304.  
  305.  
  306.                                       5-5
  307.  
  308.  
  309.  
  310.  
  311.                       up as drive C:, drive D:, and drive E:, you only need
  312.                       to specify the /D0 parameter after the CACHE
  313.                       statement to cache all of the three drives since they
  314.                       all reside on your first, and only, physical disk. If
  315.                       your computer has two hard disks installed and you
  316.                       choose to install a cache for both of them, the total
  317.                       amount of memory used by CACHE (as specified with the
  318.                       /Mxxxx parameter) will double.
  319.  
  320.                       If you set up a cache for your hard disk(s), you may
  321.                       want to reduce the number of buffers you have set up
  322.                       with the BUFFERS statement since CACHE essentially
  323.                       does the same job as BUFFERS but in a much more
  324.                       efficient way. By reducing the amount of buffers, you
  325.                       can save some precious memory. Just keep in mind that
  326.                       CACHE does not support floppy drives so you should
  327.                       not set the number of BUFFERS too low since this can
  328.                       dramatically decrease the performance on floppy
  329.                       drives.
  330.  
  331.                       If you specify more memory for caching than is
  332.                       available in your system, CACHE will display an error
  333.                       message and remain un-installed. Since certain
  334.                       programs such as backup programs may have problems
  335.                       working with a cache in memory, X-DOS provides a way
  336.                       of disabling CACHE from the command line. The X-DOS
  337.                       cache is a write through cache which means that it
  338.                       will increase the speed of the reading process while
  339.                       not affecting writing operations.
  340.  
  341.           Examples:   If your computer has one hard disk installed and you
  342.                       want to set up a cache of 2MB in XMS memory for your
  343.                       hard disk, you should include the following statement
  344.                       in your CONFIG.SYS configuration file:
  345.  
  346.                       CACHE = /D0/M2048/E
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.                                       5-6
  368.  
  369.  
  370.  
  371.  
  372.      The COUNTRY Configuration Command
  373.  
  374.           Purpose     This configuration command sets the time format and
  375.                       date format for the selected country.
  376.  
  377.           Type        Internal Configuration Command
  378.  
  379.           Syntax      COUNTRY=xxx
  380.  
  381.           Where       xxx - is the international telephone code for your
  382.                       country.
  383.  
  384.           Remarks:    The default value for COUNTRY is 001 which is the
  385.                       international country code for the United States. The
  386.                       following list shows the countries supported by X-
  387.                       DOS:
  388.  
  389.                               COUNTRY           INT. CODE
  390.                               Australia         061
  391.                               Belgium           032
  392.                               Canada-French     002
  393.                               Denmark           045
  394.                               Finland           358
  395.                               France            033
  396.                               Germany           049
  397.                               Italy             039
  398.                               Israel            972
  399.                               Middle East       785
  400.                               Netherlands       031
  401.                               Norway            047
  402.                               Portugal          351
  403.                               Spain             034
  404.                               Sweden            046
  405.                               Switzerland       041
  406.                               United Kingdom    044
  407.                               United States     001
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.                                       5-7
  429.  
  430.  
  431.  
  432.  
  433.      The DEVICE Configuration Command
  434.  
  435.           Purpose     This configuration command makes X-DOS install device
  436.                       drivers during start-up.
  437.  
  438.           Type        Internal Configuration Command
  439.  
  440.           Syntax      DEVICE=[d:][path]filename
  441.  
  442.           Where       d:path - is the drive and path to the directory which
  443.                       contains the device driver you want to install.
  444.  
  445.                       filename - is the name of the device driver to
  446.                       install.
  447.  
  448.           Remarks:    Device drivers are normally used to control certain
  449.                       parts of hardware on your computer. X-DOS supplies
  450.                       you with three device drivers on the X-DOS disk.
  451.  
  452.                       These drivers have the following functions:
  453.  
  454.           ANSI.SYS : is a console driver which can be used to enhance
  455.                       standard input and output. Since X-DOS already
  456.                       implements enhancements for standard input and
  457.                       output, this device driver is normally not required.
  458.           VDISK.SYS : is the virtual disk driver which can be used to
  459.                       install disks in either conventional memory, extended
  460.                       memory, or expanded memory.
  461.  
  462.                       Virtual disks are often referred to as RAM disks and
  463.                       are a much faster storage media than normal disk
  464.                       drives. You can set up several virtual disks, each of
  465.                       which can be a maximum of 16,384K (16 megabytes) in
  466.                       size. If you purchase certain hardware add-on
  467.                       products for your computer, you may have to install a
  468.                       device driver in the CONFIG.SYS file to use this
  469.                       product.
  470.  
  471.                       Just include the name of that particular products
  472.                       device driver in your CONFIG.SYS file including drive
  473.                       specification and path and this driver will
  474.                       automatically be installed the next time you boot
  475.                       your computer.
  476.  
  477.           Examples:   If you want to create a RAM disk in extended memory
  478.                       with the size 384K and assuming that the VDISK.SYS
  479.                       device driver is located in the C:\DOS directory then
  480.                       you should add the following statement on a separate
  481.                       line in your CONFIG.SYS file.
  482.  
  483.                       DEVICE=C:\DOS\VDISK.SYS 384 /E
  484.  
  485.  
  486.  
  487.  
  488.  
  489.                                       5-8
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.                                       5-9
  551.  
  552.  
  553.  
  554.  
  555.      The DOS Configuration Command
  556.  
  557.           Purpose     This configuration command will load the kernel of X-
  558.                       DOS in the High Memory Area.
  559.  
  560.           Type        Internal Configuration Command
  561.  
  562.           Syntax      DOS=HIGH
  563.  
  564.           Where       HIGH - is the parameter for relocating the X-DOS
  565.                       kernel into HMA
  566.  
  567.           Remarks:    Please note that the DOS relocation into HMA is not
  568.                       provided in the evaluation version of X-DOS.
  569.  
  570.                       High Memory Area is only available on 286, 386 and
  571.                       486 computers. It consists of the first 64K (- 16
  572.                       bytes) of the extended memory area.
  573.  
  574.                       This segment of memory has the particularity of being
  575.                       in extended memory but still being accessible in real
  576.                       mode, thus allowing it to be viewed as memory by DOS.
  577.  
  578.                       By setting the DOS switch to HIGH, the kernel will
  579.                       attempt to detect the availability of the HMA and
  580.                       relocate itself in this portion of memory. It will
  581.                       leave in the low memory some data used by DOS that
  582.                       cannot be put in HMA.
  583.  
  584.                       Upon activation of the DOS=HIGH switch, X-DOS will
  585.                       also activate the internal XMS driver, that manages
  586.                       the rest of the Extended Memory (see below).
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.                                       5-10
  612.  
  613.  
  614.  
  615.  
  616.      The FCBS Configuration Command
  617.  
  618.           Purpose     This configuration command sets the number of files
  619.                       that the file control blocks can open at one time.
  620.  
  621.           Type        Internal Configuration Command
  622.  
  623.           Syntax      FCBS=x
  624.  
  625.           Where       x - is the number of files that the file control
  626.                       blocks can open at one time. The default value for x
  627.                       is 4 and must be in the range of 1 to 255.
  628.  
  629.           Remarks:    File control blocks are used to control open files.
  630.                       Programs that use file control blocks to access files
  631.                       will have one file control block assigned to each
  632.                       open file.
  633.  
  634.                       File control blocks were originally implemented in
  635.                       the first version of the MS-DOS operating system for
  636.                       compatibility with the old CP/M operating system.
  637.  
  638.                       Now, programs mostly use the more powerful file
  639.                       handles to control open files. X-DOS, however,
  640.                       support file control blocks for compatibility with
  641.                       older programs.
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.                                       5-11
  673.  
  674.  
  675.  
  676.  
  677.      The FILES Configuration Command
  678.  
  679.           Purpose     This configuration command sets the number of file
  680.                       handles which can be opened at one time.
  681.  
  682.           Type        Internal Configuration Command
  683.  
  684.           Syntax      FILES=xxx
  685.  
  686.           Where       xxx - is the number of file handles which can be
  687.                       opened at the same time. The default value for xxx is
  688.                       20 and must be in the range of 8 to 255.
  689.  
  690.           Remarks:    The default setting of FILES = 20 is enough in most
  691.                       cases but certain programs like accounting programs,
  692.                       database programs, and desktop publishing programs
  693.                       often need to be able to open a larger amount of file
  694.                       handles at the same time. If you encounter an error
  695.                       message, stating that there are not enough file
  696.                       handles available, you will have to increase the
  697.                       number of file handles with the FILES statement in
  698.                       CONFIG.SYS. You can do this either by using the X-DOS
  699.                       program INSTALL or by editing the CONFIG.SYS file and
  700.                       adding the FILES = statement.
  701.  
  702.           Examples:   If you want to modify the number of file handles in
  703.                       the FILES statement to 30, you should load the
  704.                       CONFIG.SYS file into ED and insert a line with the
  705.                       following contents:
  706.  
  707.                       FILES=30
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.                                       5-12
  734.  
  735.  
  736.  
  737.  
  738.      The FKEY Configuration Command
  739.  
  740.           Purpose     This configuration command is used to turn off the
  741.                       default X-DOS function key definitions.
  742.  
  743.           Type        Internal Configuration Command
  744.  
  745.           Syntax      FKEY=ON
  746.  
  747.           Where       ON - enables the use of the default function key
  748.                       definitions and redefinition of function keys from
  749.                       the command line with the ALIAS command.
  750.  
  751.           Remarks:    You can ask X-DOS to assign commands to some of the
  752.                       function keys and redefine function keys to execute
  753.                       different commands. You can even combine the [Shift],
  754.                       [Ctrl], or [Alt] keys with the function keys so you
  755.                       can define a total of 39 commands to be executed by
  756.                       the touch of a hot key.
  757.  
  758.                       You may wonder why you can only define 39 commands,
  759.                       not 40 commands. The reason for this is
  760.                       compatibility. X-DOS does not allow you to redefine
  761.                       the [F3] function key, which is used by MS-DOS to
  762.                       recall the previous command.
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.                                       5-13
  795.  
  796.  
  797.  
  798.  
  799.      The HISTORY Configuration Command
  800.  
  801.           Purpose     This configuration command sets the amount of memory
  802.                       allocated for the command line history buffer. The
  803.                       history buffer allows you to recall and edit
  804.                       previously executed commands.
  805.  
  806.           Type        Internal Configuration Command
  807.  
  808.           Syntax      HISTORY=xxxx
  809.  
  810.           Where       xxxx - is the number of bytes which will be allocated
  811.                       to the history buffer. The default value for xxxx is
  812.                       256 and must be in the range of 256 to 2,048.
  813.  
  814.           Remarks:    The default setting of HISTORY = 256 should be enough
  815.                       in most cases since this amount of memory can hold
  816.                       about 15 to 20 previously executed commands.
  817.  
  818.                       You can increase the history buffer so it will be
  819.                       able to hold more than 100 commands. Just keep in
  820.                       mind that if you have to scroll through dozens of
  821.                       commands to find a particular command it would
  822.                       probably be faster to type it again. Also, when you
  823.                       allocate memory for the history buffer you are using
  824.                       precious memory which will not be available for
  825.                       application program.
  826.  
  827.           Examples:   If you want to increase the amount of memory
  828.                       allocated for the history buffer to 512 bytes, you
  829.                       should load the CONFIG.SYS file into ED and insert a
  830.                       line with the following contents:
  831.  
  832.                       HISTORY = 512
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                       5-14
  856.  
  857.  
  858.  
  859.  
  860.      The LASTDRIVE Configuration Command
  861.  
  862.           Purpose     This configuration command sets the last available
  863.                       drive letter X-DOS can access. You only need to
  864.                       change this if you plan to use the SUBST command or a
  865.                       similar utility.
  866.  
  867.           Type        Internal Configuration Command
  868.  
  869.           Syntax      LASTDRIVE=x
  870.  
  871.           Where       x - is a character between A and Z, describing a
  872.                       drive  letter. This drive letter will be the last
  873.                       available  drive that you can access with X-DOS.
  874.  
  875.           Remarks:    You can never set LASTDRIVE equal to a drive letter
  876.                       less than the number of drives that you have
  877.                       installed in your computer. If you do set the
  878.                       LASTDRIVE equal to a drive letter less than the
  879.                       number of installed drives, X-DOS will ignore this
  880.                       statement in the CONFIG.SYS file.
  881.  
  882.           Examples:   If you want to set the number of available drives to
  883.                       10 which is the drive letter J, you should include
  884.                       the following command in the CONFIG.SYS file:
  885.  
  886.                       LASTDRIVE = J
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.                                       5-15
  917.  
  918.  
  919.  
  920.  
  921.      The SHELL Configuration Command
  922.  
  923.           Purpose     This configuration command sets the name and location
  924.                       of the primary command processor. It can also be used
  925.                       to specify the size of the environment of the primary
  926.                       X-DOS command processor, COMMAND.COM.
  927.  
  928.           Type        Internal Configuration Command
  929.  
  930.           Syntax      SHELL=[d:][path]COMMAND.COM [/P] [/E:xxxx]
  931.  
  932.                       or
  933.  
  934.                       SHELL=[d:][path]filename [params]
  935.  
  936.           Where       d:path - is the drive and path to the directory in
  937.                       which the command processor is located.
  938.  
  939.                       /P - is a parameter used by COMMAND.COM which makes
  940.                       the current command processor permanent.
  941.  
  942.                       /E:xxxx - is the number of bytes allocated to the
  943.                       environment of the COMMAND.COM command processor. The
  944.                       default value for xxxx is 384 and must be in the
  945.                       range of 160 to 9,999.
  946.  
  947.                       filename - is the filename of a new command
  948.                       processor.
  949.  
  950.                       params - are any valid parameters used by the new
  951.                       command processor.
  952.  
  953.           Remarks:    The SHELL command can be used for several purposes
  954.                       which are split into two main areas; using SHELL with
  955.                       COMMAND.COM and using SHELL with a new command
  956.                       processor.
  957.  
  958.                       Using the SHELL command with COMMAND.COM allows the
  959.                       user to copy the COMMAND.COM file to a different
  960.                       location, i.e. a virtual disk, and tell X-DOS where
  961.                       to find it. Also, it is often used to set a different
  962.                       size for the environment. Since X-DOS lets the user
  963.                       set environment variables for some of its commands,
  964.                       and many application programs also use the
  965.                       environment, it may be necessary to use the SHELL
  966.                       command to extend the environment size.
  967.  
  968.                       The second major purpose of the SHELL command is to
  969.                       install a new command processor which takes over the
  970.                       job of COMMAND.COM. Note that you can theoretically
  971.                       replace the X-DOS command processor with a command
  972.                       processor supplied by another vendor, such as the 4-
  973.  
  974.  
  975.  
  976.  
  977.                                       5-16
  978.  
  979.  
  980.  
  981.  
  982.                       DOS COMMAND.COM from JP Software. However, please
  983.                       note that such products may not work with the second
  984.                       command overlay and the SHELL. As such we advise you
  985.                       to always use the X-DOS command processor.
  986.  
  987.           Examples    If you want to relocate the COMMAND.COM file to the
  988.                       D:\DOS directory and make it permanent, and also want
  989.                       to extend the size of the environment to 512 bytes,
  990.                       you should include the following statement in your
  991.                       CONFIG.SYS file:
  992.  
  993.                       SHELL=D:\DOS\COMMAND.COM /P /E:512
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.                                       5-17
  1039.  
  1040.  
  1041.  
  1042.  
  1043.      The TBOPCOD Switch
  1044.  
  1045.           Purpose     This switch will force X-DOS to trap any bad opcodes.
  1046.                       When enabled, if a bad opcode is encountered X-DOS
  1047.                       will terminate the task and exit cleanly without
  1048.                       hanging the machine.
  1049.  
  1050.           Type        Internal Configuration Command
  1051.  
  1052.           Syntax      TBOPCOD = [ON][OFF]
  1053.  
  1054.           Where       ON - enables the TBOPCOD switch
  1055.  
  1056.                       OFF - disables the TBOPCOD switch
  1057.  
  1058.           Remarks     By default TBOPCOD is set to OFF in order to maintain
  1059.                       compatibility with some DOS applications. Note that
  1060.                       this command can only be used with 286 machines and
  1061.                       above.
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.                                       5-18
  1100.  
  1101.  
  1102.  
  1103.  
  1104.      The VDISK.SYS Device Driver
  1105.  
  1106.           Purpose     This device driver lets you to set up temporary,
  1107.                       simulated disk drives in conventional memory,
  1108.                       extended memory, or expanded memory.
  1109.  
  1110.           Type        External Device Driver
  1111.  
  1112.           Syntax      DEVICE=[d:][path]VDISK.SYS [mem] [/E] [/A]
  1113.  
  1114.           Where       d:path - is the drive and path to the directory in
  1115.                       which the  VDISK.SYS device driver resides.
  1116.  
  1117.                       mem - is the amount of Kilobytes of memory that you
  1118.                       wish to allocate to the VDISK. The default is 64K.
  1119.  
  1120.                       /E - tells VDISK to use Extended Memory (XMS)
  1121.                       /A - tells VDISK to use Expanded Memory
  1122.  
  1123.           Remarks:    Virtual Disks are much faster than hard disks since
  1124.                       the data resides in RAM rather than on the disk.
  1125.  
  1126.                       X-DOS's VDISK can take advantage of XMS Memory or
  1127.                       Expanded Memory to store data.
  1128.  
  1129.                       Note that, unlike MS-DOS's RAMDRIVE.SYS, X-DOS's
  1130.                       VDISK only uses Extended Memory provided by the XMS
  1131.                       driver, thus avoiding conflict with other programs
  1132.                       that take over the extended memory resources.
  1133.  
  1134.           Examples:   Suppose that you wish to have a VDISK of 1 MB of
  1135.                       memory in Extended Memory, you would add the
  1136.                       following statement in your CONFIG.SYS file:
  1137.  
  1138.                       DEVICE=C:\DOS\VDISK.SYS 1024 /E
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.                                       5-19
  1161.  
  1162.  
  1163.  
  1164.  
  1165.      The VERSION Configuration Command
  1166.  
  1167.           Purpose     This configuration command sets the DOS version that
  1168.                       X-DOS should emulate. X-DOS emulates a DOS version of
  1169.                       3.3 as default.
  1170.  
  1171.           Type        Internal Configuration Command
  1172.  
  1173.           Syntax      VERSION=x.yy
  1174.  
  1175.           Where       x - is the major version number that X-DOS should
  1176.                       emulate.
  1177.                       yy - is the minor version number that X-DOS should
  1178.                       emulate.
  1179.  
  1180.           Remarks:    Certain application programs and device drivers may
  1181.                       look for, and expect, a certain version number of the
  1182.                       disk operating system in order for them to execute.
  1183.                       If they do not find an expected disk operating system
  1184.                       version number, they will normally terminate
  1185.                       execution and display an error message similar to
  1186.                       "Wrong version number". To prevent any kind of
  1187.                       version number problems, X-DOS provides the VERSION
  1188.                       command.
  1189.  
  1190.                       If for any reason, you decide to change the version
  1191.                       number at boot time do not forget to reset it to 3.3
  1192.                       before loading the command processor of X-DOS. X-DOS
  1193.                       has a data structure format similar to DOS 3.3 but
  1194.                       has capabilities included in DOS 4.x and 5.0. The
  1195.                       choice for 3.3 compatibility was made due to the
  1196.                       reliability of this version and its subsequent
  1197.                       popularity with many users.
  1198.  
  1199.           Examples:   If you want to change the emulated disk operating
  1200.                       system version number in your CONFIG.SYS file to the
  1201.                       version number 3.10, then include the following
  1202.                       statement in the beginning of your CONFIG.SYS file:
  1203.  
  1204.                       VERSION = 3.10
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.                                       5-20
  1222.  
  1223.  
  1224.  
  1225.  
  1226.      The VIDEO Configuration Command
  1227.  
  1228.           Purpose     This configuration command greatly increases the
  1229.                       speed of screen updating in text mode.
  1230.  
  1231.           Type        Internal Configuration Command
  1232.  
  1233.           Syntax      VIDEO=ON
  1234.  
  1235.           Where       ON - enables fast screen updating by allowing X-DOS
  1236.                       to bypass the video BIOS when reading and writing to
  1237.                       the screen.
  1238.  
  1239.           Remarks:    If you choose to set VIDEO=ON in your CONFIG.SYS
  1240.                       file, you should notice a remarkable increase in the
  1241.                       speed with which text based programs display
  1242.                       information on the screen. The only penalty this
  1243.                       increase in speed brings is a slight delay in cursor
  1244.                       positioning.
  1245.  
  1246.                       If you are using a very fast VGA display card you
  1247.                       will not need to use the VIDEO=ON option. However,
  1248.                       for CGA, EGA and 8-bit VGA display cards the
  1249.                       difference in speed is very noticeable.
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.                                       5-21
  1283.  
  1284.  
  1285.  
  1286.  
  1287.      The XMS Configuration Command
  1288.  
  1289.           Purpose     This configuration command activates X-DOS's internal
  1290.                       XMS driver.
  1291.  
  1292.                       X-DOS's XMS driver is compatible with the HIMEM.SYS
  1293.                       driver available with MS-DOS 5.0. It has the
  1294.                       particularity of being directly integrated in the DOS
  1295.                       kernel.
  1296.  
  1297.           Syntax      XMS=ON
  1298.  
  1299.           Where       ON - is the parameter for activating the X-DOS XMS
  1300.                       driver
  1301.  
  1302.           Remarks:    The XMS driver manages the Extended Memory the way
  1303.                       EMS drivers manage expanded memory. The XMS driver
  1304.                       allows real mode application programs to use extended
  1305.                       memory in a cooperative and hardware independent
  1306.                       manner. It also manages the A20 line that enables the
  1307.                       use of the High Memory Area.
  1308.  
  1309.                       If you relocate the X-DOS kernel in HMA, the XMS
  1310.                       driver will be activated automatically.
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.                                       5-22