home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / OS / CONIX2.LBR / CHAPTER2.DQC / CHAPTER2.DOC
Text File  |  2000-06-30  |  10KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.                Chapter 2 - Getting Started
  6.  
  7.  
  8.     Instructions for ConIX installation and    system configuration.
  9.  
  10.  
  11.                    - CONTENTS -
  12.     __________________________________________________________________
  13.  
  14.  
  15.       2.  Getting Started........................................  2-1
  16.  
  17.         2.1     Installing ConIX....................................  2-1
  18.  
  19.         2.2     Loading ConIX from CP/M.............................  2-3
  20.  
  21.         2.3     Notes...............................................  2-4
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  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.                       -    i -
  63.  
  64.  
  65.  
  66.  
  67.  
  68.     ConIX Operating    System                   Getting Started
  69.  
  70.     2.  Getting Started
  71.  
  72.     It is very important that you immediately make two copies of the
  73.     ConIX distribution files which you have    received with this manual.
  74.     The first copy should be kept as a backup, to be used in the
  75.     future in place    of the original    which should not be touched unless
  76.     absolutely necessary.  The second will be for use as the working
  77.     copy.  It should also contain a    SYSGEN of CP/M on the operating
  78.     system tracks.    This will allow    you to use ConIX on drive A: and
  79.     reboot (reset or CTRL-C) as necessary.
  80.  
  81.     Next, you should put the working copy of the distribution disk
  82.     into drive A: and then cold boot your system (hit the reset
  83.     button).  Once CP/M is loaded you will be ready    to begin the
  84.     required installation procedure    as outlined below.
  85.  
  86.  
  87.     2.1  Installing    ConIX
  88.  
  89.     Take a look at the directory of    ConIX files, if    you haven't
  90.     already.  You should see two files, among many,    INSTALL.COM and
  91.     CONIXR.COM.  INSTALL is    used to    customize a copy of ConIX to your
  92.     system's memory    map.  CONIXR is    the ConIX Operating System stored
  93.     in a page relocatable form.  It    can be executed    just as    an
  94.     INSTALLed ConIX, except    Memory Management will not be operational.
  95.     This is    an extremely important feature and must    be available when
  96.     you actively use ConIX as a part of your system.
  97.  
  98.     The INSTALL program simply reads the relocatable ConIX file and
  99.     makes a    new version based upon the amount of memory available in
  100.     your system.  The new ConIX differs from the original in that it
  101.     is pre-relocated and will not have to recalculate its addresses
  102.     for relocation when started up (a somewhat time-consuming
  103.     operation).  Instead, ConIX will be moved by a built-in    loader to
  104.     the area in memory predetermined at the    time of    installation.
  105.  
  106.     Before you install ConIX, you must be sure that    your system's
  107.     memory map appears exactly as it will when you will be using ConIX
  108.     in the future.    Some systems require patch programs to be loaded
  109.     which permanently relocate themselves to the top of memory to
  110.     perform    some special function.    Some common patches are    RAM-disk
  111.     and format conversion software.     In such a case, be sure that all
  112.     patches    have been loaded into memory before INSTALL is executed
  113.     (as should also    be the case each time ConIX is initially loaded
  114.     into your system).
  115.  
  116.     To install ConIX, type:
  117.  
  118.         A>install
  119.  
  120.     at which point you will    be asked for the name of the relocatable
  121.     ConIX data file.  You may hit <RETURN>,    and the    default    CONIXR.COM
  122.     on the current disk will be assumed.  You may specify a    drive only
  123.     (as B:)    if the file is not on the current disk.
  124.  
  125.  
  126.  
  127.  
  128.                        2-1
  129.  
  130.  
  131.  
  132.  
  133.  
  134.     Getting    Started                    ConIX Operating System
  135.  
  136.     You will then be asked to specify the filename of the INSTALLed
  137.     version    of ConIX.  You may hit <RETURN>    for CONIX.COM, which will
  138.     be created on the current drive.  (Note    that you are required to
  139.     use this filename since    ConIX must access it when reloading during
  140.     Memory Management.)  To    create the output file on another drive,
  141.     simply specify the disk    code alone (such as B:).
  142.  
  143.     Next, you will be asked    for the    relocation address.  This value
  144.     will be    used to    determine the base relocation page, meaning that
  145.     ConIX will reside in memory from this point and    back toward
  146.     location 0000.    You would enter    an address here    if, for    some
  147.     reason,    you'd want a buffer space between CP/M and ConIX for
  148.     storage    of data    or machine code    routines and patches.  This memory
  149.     would be protected since it is unused and not part of the TPA.
  150.  
  151.     You should hit <RETURN>    for the    default    location, which    is the top
  152.     of memory as stored in memory at 0006h.     ConIX will then be
  153.     configured to reside directly next to CP/M, or any patches that
  154.     are present in memory.
  155.  
  156.     INSTALL    will then request the name of the default startup command.
  157.     This command will be executed automatically whenever ConIX is
  158.     initially loaded from CP/M.  By    default, this is set to
  159.     ``PROFILE'', which will    be maintained if <RETURN> is, and should
  160.     normally be, hit.
  161.  
  162.     INSTALL    also provides the user with the    ability    to disable certain
  163.     ConIX functions    that may cause incompatibility problems    with non-
  164.     standard CP/M 2.2 systems.  The    first is BIOS patching,    which
  165.     refers to the internal operation of ConIX to patch the BIOS in-
  166.     memory jump table.  This action    facilitates the    redirection of
  167.     programs that perform I/O directly through the BIOS, effectively
  168.     bypassing CP/M or ConIX, as the    case may be.
  169.  
  170.     The BIOS patching operation might cause    problems on some non-
  171.     conventional CP/M systems that do not fully support direct BIOS
  172.     access.     In such cases,    it may be necessary to disable BIOS
  173.     patching by entering ``off'' in    response to the    question asked by
  174.     INSTALL.  If BIOS patching is to remain    enabled, simply    hit
  175.     <RETURN>.
  176.  
  177.     The second possibly troublesome    feature    is the ExpanDisk Virtual
  178.     Disk System.  If BIOS patching has been    turned off, ExpanDisk will
  179.     automatically be disabled as well, since this feature must patch
  180.     the BIOS in order to work.
  181.  
  182.     Some systems, however, may allow standard BIOS patching, but not
  183.     the interference in disk I/O system calls.  (Standard patching
  184.     under ConIX only affects the CONIN, CONOUT, CONST, LISTST, and
  185.     LIST jumps.)  On such systems, BIOS patching can be enabled, with
  186.     the exception of ExpanDisk, which can be disabled by typing
  187.     ``off''    in response to the appropriate question.
  188.  
  189.     Another    ConIX operation    which may cause    system incompatibility is
  190.     BDOS Error Vector Patching.  This feature may cause problems if
  191.  
  192.  
  193.  
  194.                        2-2
  195.  
  196.  
  197.  
  198.  
  199.  
  200.     ConIX Operating    System                   Getting Started
  201.  
  202.     the target system does not implement the BDOS error vector, which
  203.     is a series of four addresses after the    first JMP DECODE
  204.     instruction at the top of the BDOS.  These addresses point to the
  205.     four routines that handle BDOS errors (File R/O, Disk R/O, Bad
  206.     Sector,    and Select).
  207.  
  208.     In order for these vectors to be implemented under ConIX, they
  209.     must be    patched    in the BDOS to point to    the duplicate vectors
  210.     within ConIX.  If this feature is disabled, programs which patch
  211.     the error vector to trap BDOS errors will no longer be able to do
  212.     so (this is not    really a very common practice).
  213.  
  214.     All other functions of ConIX are implemented using standard CP/M
  215.     conventions, and should    cause no incompatibility problems with
  216.     even the most complex systems.    The prime requirement is that the
  217.     resident operating system must support all CP/M    2.2 standard BDOS
  218.     operations.  If    this is    truly the case,    ConIX should be    compatible
  219.     with such a system.
  220.  
  221.     If you are performing a    first-time installation    of ConIX, you
  222.     should hit <RETURN> in response    to all the questions so    as to set
  223.     the default parameters.     INSTALL will then generate the    final
  224.     executable version of ConIX.
  225.  
  226.     The next step is to test the newly installed version (see the next
  227.     section) to see    if it performs properly.  Should ConIX blatantly
  228.     fail to    execute, you probably have a system which is not truly
  229.     CP/M 2.2 compatible.  If this is the case, you should re-run the
  230.     INSTALL    program    and try    disabling various combinations of ConIX
  231.     features.  Once    the installation procedure has produced    a working
  232.     copy of    ConIX, it will not have    to be repeated,    unless your
  233.     system's memory    map must be changed for    some reason.
  234.  
  235.  
  236.     2.2  Loading ConIX from    CP/M
  237.  
  238.     The syntax for loading ConIX from CP/M is:
  239.  
  240.         A>conix    (commands)
  241.  
  242.     If commands are    specified, ConIX will execute these commands
  243.     immediately after printing the signon message.    For example:
  244.  
  245.         A>conix    dir
  246.  
  247.         The ConIX Operating System Vxx.yyz
  248.         Copyright (C) 1985, Computer Helper Industries Inc.
  249.         All rights reserved worldwide!
  250.            .
  251.            .   directory will be listed
  252.            .
  253.         <A:00>
  254.  
  255.     where the directory command, DIR, was executed immediately after
  256.     ConIX was loaded.
  257.  
  258.  
  259.  
  260.                        2-3
  261.  
  262.  
  263.  
  264.  
  265.  
  266.     Getting    Started                    ConIX Operating System
  267.  
  268.     If you do not specify any commands for the initial load, ConIX
  269.     will execute the default startup command PROFILE.COM (or whatever
  270.     default    was set    by INSTALL).  This program is provided on the
  271.     distribution disk and, in its current form, simply prints a
  272.     welcome    message    to the screen as:
  273.  
  274.         A>conix
  275.  
  276.         The ConIX Operating System Vxx.yyz
  277.         Copyright (C) 1985, Computer Helper Industries Inc.
  278.         All rights reserved worldwide!
  279.  
  280.         Welcome    to ConIX System/One!
  281.         <A:00>
  282.  
  283.     Using the ConIX    Command    Language, you could write your own startup
  284.     procedure which    would automatically perform any    needed tasks each
  285.     time ConIX is initially    loaded from CP/M.  This    is discussed
  286.     further    in the ConIX Programming Manual.
  287.  
  288.  
  289.     2.3  Notes
  290.  
  291.     It is believed that most CP/M 3.0+ systems and,    in general,
  292.     systems    which do not use contiguous memory for the operating
  293.     system and system dependent routines (via bank-switching), require
  294.     some form of BIOS patching to be disabled.  Usually disabling
  295.     ExpanDisk is sufficient    but, in    some cases, it may be necessary    to
  296.     disable    all BIOS patching.
  297.  
  298.     Additionally, systems that do not use standard CP/M 2.2    often do
  299.     not implement the BDOS error vectors.  We have also found that
  300.     most in-memory patches (for ramdisk, format conversion software,
  301.     etc.) neglect to maintain error    vector compatibility.  Error
  302.     vector patching    should probably    be disabled on such computers.
  303.     CP/M 2.2 systems which have been implemented according to the
  304.     guidelines presented within the    Digital    Research documentation
  305.     should not require any customization customization via INSTALL.
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                        2-4
  327.  
  328.  
  329.  
  330.  
  331. σHAPTER3DOC ÇÇ