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 / BBS / KMD23.LBR / KMD23.IZF / KMD23.INF
Text File  |  2000-06-30  |  12KB  |  282 lines
  1.  
  2. TOPIC    : KMD23 AND PERIPHERAL PGMS
  3.  
  4. FROM    : IRV HOFF W6FFC
  5.  
  6. DATE    : 11 JAN 88
  7.  
  8.  
  9.        NOTE: KMD23 allows the user to select individual drive
  10.          and user areas for the FOR and KMD.LOG files for
  11.          both CP/M and MS-DOS files.
  12.  
  13.          If you do NOT have the MSDOS equate set YES, you
  14.          would have no reason to change from KMD22.
  15.  
  16.     WARNING: If using any version of PBBS (current is v4.0),
  17.          you will likely want to stay with KMD22.  The
  18.          selecton of "WHATSNEW" or "WHATSFOR" from the
  19.          PBBS command line is not compatible with these
  20.          new changes.  Subsequent versions of PBBS will
  21.          likely add the routines necessary to use KMD23
  22.          advantageously.
  23.  
  24.  
  25. INSTALLING KMD23:
  26. ----------------
  27.    Extract KMD23.COM and KMD23OVL.AZM from the library file.  Edit
  28.    the options and assemble to KMD23OVL.HEX after uncrunching.    Then
  29.    use MLOAD to merge the overlay with KMD23.COM.  All finished.  It
  30.    can easily be done in 15-20 minutes or less.  The options most
  31.    likely to be changed are marked with an '*' in the comment area.
  32.    Install on A0: of your system to work with BYE5.
  33.  
  34.  
  35. GENERAL INTEREST:
  36. ----------------
  37.    (All programs discussed below are dated 11 Jan 88 except the dis-
  38.    cussion of new features of KMD22, whose features are inluded for
  39.    general interest.  The date of any of these may be verified by
  40.    loading them via DDT and then dumping the area starting at 0100
  41.    to see what you have the current version.)
  42.  
  43.     KMD23 features:
  44.     ---------------
  45.       The location of both the CP/M and MS-DOS 'FOR' and
  46.       KMD.LOG files may now be placed on any drive/user
  47.       area selected by the Sysop.  This takes care of the
  48.       problem caused by insufficient room on the drive used
  49.       to upload new files.    Prior versions of KMD place the
  50.       'FOR' and KMD.LOG files on the same drive as the new
  51.       MS-DOS uploads go.  This did not allow those files
  52.       to expand properly if the disk filled.
  53.  
  54.       As an example, say your BBS system is on A14: and you
  55.       make a habit of keeping spare room on the A: drive for
  56.       new messages to be added to the BBS.    In this case it
  57.       would be beneficial to put the FOR and KMD.LOG files
  58.       on perhaps A14: and those for MS-DOS on perhaps A13:
  59.       then.  Now evrything can work properly even if the
  60.       new file upload area is filled.
  61.  
  62.       If of interest, on the PRACSA Sysop RCPM, we have:
  63.  
  64.          J14:  BBS system, LASTCALR, CP/M FOR, KMD.LOG, etc.
  65.          J13:  FOR, KMD.LOG (MS-DOS section)
  66.  
  67.       This allows us to fill the A: drive with normal files.
  68.  
  69. (from KMD23:)
  70.  
  71. MSDOS:    DB    yes    ;*Yes if using separate area for MS-DOS files
  72. IBMDRV: DB    'D'    ; Drive to upload MS-DOS, NEW and FOR files
  73. IBMUSR: DB    0    ; User area for IBM files
  74. NEWLST: DB    YES    ; Yes to put MSDOS "NEW" and "FOR" lists on new
  75.             ;    new drive, NO to keep them on CP/M lists
  76. NIBMDR: DB    'A'    ; Drive to store the IBM 'FOR' and KMD.LOG on
  77. NIBMUS: DB    13    ; User area to store the IBM 'FOR' and KMD.LOG
  78.  
  79.  
  80. PERIPHERAL PROGRAMS FOR USE WITH KMD23:
  81. --------------------------------------
  82.  
  83.   Pages to save if using DDT.  See below for user-choices.
  84.  /
  85. (6)  FOR.COM    A0:   Displays the file descriptions.
  86. (7)  NEW.COM    A0:   Displays newest uploads, most recent first.
  87. (7)  KFOR.COM    A15:  For Sysop's use to hand enter a file description.
  88. (7)  KNEW.COM    A15:  For Sysop's use to hand enter a KMD.LOG entry
  89. (6)  KMDEL.COM    A15:  For Sysop's use to delete downloads from KMD.LOG
  90.  
  91.    These files have been used previously by KMD users.    The following
  92.    will show how each may be very easily modified using DDT to change
  93.    any of the options as needed.  Each of these files is under 1k long.
  94.    FOR and NEW files have [more] pauses for pagination.  Use $N to dis-
  95.    able this feature for copying to disk, etc.    (Similar to the control
  96.    character used with SD for the same purpose.)
  97.  
  98.       Note: The FOR.COM and NEW.COM should go on A0: but the
  99.         other three can go anywhere your flow path could
  100.         call them from.  For example on the PRACSA Sysop
  101.         RCPM, they are on J15:    Change bytes 103 and 104
  102.         accordingly (shown below).
  103.  
  104.  
  105. User choices, 'G' drive for MS-DOS would be 47h, etc.
  106.  
  107.   0103 41   'A'  DRIVE     Drive to place CP/M FOR and KMD.LOG files
  108.   0104 0E   14     CPMUSR  User area to place CP/M FOR and KMD.LOG files
  109.   0105 00   00     MSDOS     01 or FF if using special area, else 00
  110.   0106 44   'D'  IBMDRV  Drive for new MS-DOS uploads
  111.   0107 41   'A'  NIBMDR  Drive to place MS-DOS FOR and KMD.LOG files
  112.   0108 0E   14     NIBMUS  User area to place MS-DOS FOR and KMD.LOG files
  113. * 0109 3E         Wheel byte, '3E' portion of 003Eh
  114. * 010A 00         Wheel byte, '00' portion of 003Eh
  115.  
  116. * Wheel byte, most systems use 003Eh, some systems use a higher address
  117.  
  118.  
  119. ========================================================================
  120.  
  121.     (The following section is included for general interest,
  122.     describing the features in the previous versions of KMD.)
  123.  
  124.  
  125. KMD22 INFORMATION OF GENERAL INTEREST:
  126. -------------------------------------
  127.  
  128.     1) Can extract member files from .ARC, .ARK or .LBR groups
  129.         (does not "unprocess them" thus minimizing on-line
  130.         transfer time).  First file transfer program having
  131.         this capability.
  132.     2) Rewritten for more robust use with satelite networking
  133.         systems such as PC Pursuit.
  134.     3) Batch send mode rewritten for better use with PROCOMM and
  135.         other MS-DOS YMODEM-type programs on PC Pursuit.
  136.     4) Can be used as a self-standing program with slightly
  137.         modified XMODEM overlays, otherwise uses BYE5 for
  138.         I/O and time-clock (if used) information.
  139.     5) Shows name of file being transferred.
  140.     6) File description area rewritten for more uniform entries.
  141.     7) Full source code available (although not used or needed for
  142.         normal use).
  143.     8) Other changes to improve overall performance.
  144.  
  145.  
  146. KMD21 INFORMATION OF GENERAL INTEREST:
  147. -------------------------------------
  148.  
  149.     1) Optional area for MS-DOS files.
  150.     2) 'I' command for local Sysop use (see below).
  151.     3) 'RM' command for MBBS read message file.
  152.     4) Requires a 'Y' or 'N' for accepting file description.
  153.     5) Accepts '$' in file description.
  154.     6) Delete key acts as backspace writing file description.
  155.  
  156.  
  157. 'I' COMMAND FOR SYSOP USE
  158. -------------------------
  159.    The Sysop can use an "I" ahead of any "R", "S" or "L" instructions.
  160.    This in effect gives him a second program but with no additional loss
  161.    of disk space.  This:
  162.  
  163.     a) does not ask for file description on uploads
  164.     b) does not make a KMD.LOG entry
  165.     c) does not affect time on system
  166.     d) does not increment the up or down counters
  167.  
  168.     EXAMPLE:
  169.              A15>KMD IR HELLO.DOC <ret>
  170.  
  171.         This lets the Sysop upload replacement files anywhere
  172.         on the system without needing a second "Sysop version"
  173.         of the KMD program on A15:.
  174.  
  175.  
  176. 'RM' OPTION
  177. -----------
  178.    This is used only by MBBS systems to enable users to pretype a series
  179.    of messages then upload them as a CP/M file to be appended to the
  180.    message base.  Most other BBS systems use compression techniques that
  181.    require pretyped messages to be uploaded individually to the BBS.
  182.  
  183.  
  184. OPTIONAL MS-DOS AREA
  185. --------------------
  186.    The following options were added to the program and are found in the
  187.    overlay area:
  188.  
  189. ;-----------------------------------------------------------------------
  190. ;
  191. MSDOS:    DB    YES    ; Yes if using separate area for MS-DOS files
  192. IBMDRV: DB    'D'    ; Drive to upload MS-DOS, NEW and FOR files
  193. IBMUSR: DB    0    ; User area for IBM file uploads (normally 0)
  194. ;
  195. ; (NOTE: this area changed somewhat for KMD23, see "KMD23 features".)
  196. ;
  197. ;-----------------------------------------------------------------------
  198.  
  199.    On many RCPM systems, 50-60-70% of the uploads are now for MS-DOS.  A
  200.    few Sysops discourage such files, but most either do not mind or even
  201.    solicit MS-DOS programs.  (Many have MS-DOS computers themselves and
  202.    welcome the new programs.)
  203.  
  204.    Some Sysops with large disk systems are dividing their systems into
  205.    CP/M and MS-DOS areas.  KMD21 and its peripheral programs now support
  206.    such a move.  If you have divided your system into two areas, keep
  207.    reading, else skip this entire section as KMD21 and the other files
  208.    will keep working like in the past.
  209.  
  210.    If you say YES to the MSDOS option, KMD looks at the current drive.
  211.    If it's "D" or higher (in this example) it assumes you want the
  212.    upload to go to "D0:" rather than your CP/M drive (usually B0:)  It
  213.    then puts the information into a KMD.LOG file it makes on that same
  214.    drive.
  215.  
  216.    If the user types NEW while on "D0:" or higher drive, he sees the
  217.    new MS-DOS files, if he types NEW while on any drive up to "D0:" he
  218.    gets the CP/M files.  The same thing happens when typing "FOR".  (Of
  219.    course this assumes you have also changed the "MSDOS" option in the
  220.    perhiperhal files, mentioned below.)
  221.  
  222.    All this is done with a single KMD21 file on A0: and with single
  223.    NEW.COM and FOR.COM files also on A0:  The same holds true for the
  224.    Sysop's special files called KFOR.COM, KMDEL.COM and KNEW.COM.
  225.  
  226.     Note: If any of this is not adequately explained in
  227.           these few sentences, feel free to phone voice
  228.           for additional information, the number is given
  229.           at the end of this discussion.
  230.  
  231.  
  232. PBBS AND MS-DOS AREA
  233. --------------------
  234.    The PBBS bulletin board system has a special user parameter that
  235.    can be used to automatically place the user on any drive/user area
  236.    the Sysop selects.  We have added a routine to the PBBS.MAC file that
  237.    looks to see if that byte is 0.  If yes (defaults that way for each
  238.    user when you install the program), it looks to see if you have the
  239.    MSDOS option (added to the PBBSHDR.MAC file) YES or NO.  If YES, it
  240.    asks:
  241.  
  242.     Are you primarily:  1) CP/M  or  2) MS-DOS ?
  243.  
  244.    and waits for an answer.  It puts the correct information into the
  245.    byte, which is then no longer zero and the question will not be asked
  246.    again.  This enables the program to automatically place the user on
  247.    either the CP/M or MS-DOS area when he goes to the databank.  This in
  248.    effect puts him where he wants to be for any uploads, to see what is
  249.    new, see the file description, etc. without having to sift through
  250.    the files for the "other system".  KMD21 works very nicely with this
  251.    arrangement although it is totally independent of PBBS.  The combina-
  252.    tion of KMD21 and PBBS with the new routine adds a very powerful tool
  253.    to the RCPM system, should the Sysop wish to have a special MS-DOS
  254.    section.  Both the CP/M people and the MS-DOS people have expressed
  255.    delight at segregating the files in this manner.
  256.  
  257.      Note:    A program called NOAH has been developed by Bob
  258.         Freed.    This permits CP/M computers to compress
  259.         files for minimin storage space using the same
  260.         algorithms and techniques MS-DOS computers use.
  261.         Since the files for MS-DOS use are then given an
  262.         .ARC extension (to show they are compressed),
  263.         those for use with CP/M are then given a .ARK
  264.         extent to better identify them.  These files are
  265.         substantially shorter than "squeezed" files and
  266.         slightly shorter than "crunched" files.
  267.  
  268.         By using different extents but with the same
  269.         basic compression techniques, compability is
  270.         insured.  This allows people having both CP/M
  271.         and MS-DOS capability to interchange programs
  272.         of general interest, such as ASCII text files,
  273.         etc.  You can even mix MS-DOS files and those
  274.         intended for use with CP/M use on the same drive
  275.         and user area, without conflict or confusion.
  276.  
  277. ------------------------------------------------------------------------
  278.  
  279.                     - Irv Hoff
  280.                       Los Altos Hills, CA
  281.                       (415) 948-2166  voice
  282.