home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / bye5 / whatsn05.lbr / WHATSN05.DQC / WHATSN05.DOC
Text File  |  1986-04-18  |  8KB  |  164 lines
  1.               WHATSNEW.ASM
  2.                    by
  3.               Irvin M. Hoff
  4.              (01 March 1986)
  5.  
  6. This program is really two-in-one.  It is for use with RCPM systems
  7. having a XMODEM.LOG (or LOG.SYS) of all file transfers created by the
  8. XMODEM file transfer program.  (If using MBYE, substitute the term
  9. LOG.SYS wherever appears and set the MBYE equate to YES.)
  10.  
  11.     Program 1 = shows the XMODEM.LOG in reverse order, newest first
  12.     Program 2 = shows only uploads in reverse, ignoring downloads
  13.  
  14. WARNING: Versions of XMODEM before 101 did not mark uploads to private
  15.      areas differently from normal uploads.
  16.  
  17.  03/01/86 - Added pagination, also allowed WHEEL users to specify
  18.    v05        WHATSNEW A to see uploads and downloads without maintaining
  19.         a second copy of program online.   - Michael Conley
  20.  
  21.     NOTE: Although the term XMODEM.LOG is discussed here, the
  22.     program has an MBYE equate which selects LOG.SYS in place of
  23.     XMODEM.LOG. Where the special XMDEL program is mentioned, there
  24.     is a XMLOG program for MBYE's LOG.SYS file.
  25.  
  26. WHATSNEW.ASM is Intel 8080 source code for a program that displays file
  27. transfers on RCPM systems.  It is really two programs in one:
  28.  
  29.    BYTE 0103H  00  shows XMODEM.LOG in inverse order, newest first
  30.            01  shows uploads only, for use as a WHATSNEW file
  31.  
  32.            If using DDT, then:   A>SAVE 5 WHATSNEW.COM
  33.  
  34. When assembled, it is 8 records or 1k long.  It replaces WHATSNEW.COM
  35. files created by D-32 and similar archive programs.
  36.  
  37. ALL FILES:
  38.  
  39. This shows the file transfers stored in XMODEM.LOG in reverse manner,
  40. newest first.  It allows SYSOPs to immediately view "who most recently
  41. did what".  It can be placed in any drive-user area the SYSOP can easily
  42. call from any location with his wheel byte set, (usually A15:) or left
  43. in A0: for all to use.    You might wish to call this version ALL.COM.
  44.  
  45. UPLOADS ONLY (should be called WHATSNEW.COM)
  46.  
  47. It sits in A0: and may be called by any user on the system, from any
  48. drive or user area.  (This in sharp contrast to the older WHATSNEW
  49. programs which had to be hidden in the same area all uploads go, and
  50. could not be called except when directly in that specific area.)
  51.  
  52. When called, it remembers the current drive/user area, then opens the
  53. XMODEM.LOG in A14: (or wherever you have it, if elsewhere, by setting
  54. the options for DRIVE, USER).  It reads the file, storing all the lines
  55. commencing with "R" (for uploads), into memory.  (If the wheel byte is
  56. set for the SYSOP's use, it includes the "P" (private uploads) as well.
  57. These are shown by a "*" after the drive/user area.)  When finished
  58. reading the file it then displays those lines in reverse order, showing
  59. most recent uploads first.  When finished (or aborted), it restores the
  60. original drive/user area.  It finishes the current line when aborting.
  61.  
  62. This allows people who call frequently to immediately see if any new
  63. files have been added and readily abort the rest of the display.  It
  64. also allows infrequent callers to continue as long as they wish, or the
  65. XMODEM.LOG is finished.  As a result, nobody should miss a recent entry
  66. which often happens with older WHATSNEW methods when the SYSOP has not
  67. recently updated his system.  (And then when he does update things, all
  68. recent files are "lost", making overall results unrealistic and often of
  69. spotty usefulness.)
  70.  
  71. This system also displays who uploaded the file.  This is beneficial as
  72. it gives credit for contributing to the RCPM system.  (Anything that
  73. encourages contributions appeals to most SYSOPs.)
  74.  
  75. When getting the program, there are three bytes that can be changed with
  76. DDT rather than reassemble the entire program (although that only takes
  77. a few moments).
  78.  
  79.   WARNING:
  80.  
  81.     Before XMODEM-101, uploads to a private area (such as B15:)
  82.     also had a "R" for received (they now show a "P").  In addition,
  83.     the XMODEM.LOG file did not show file length, etc. and used a
  84.     somewhat different format than current versions.
  85.  
  86.   INFO:
  87.  
  88.     A companion program currently called XMDEL automatically deletes
  89.     all downloaded files from XMODEM.LOG, keeping the uploads for
  90.     WHATSNEW.  This minimizes the length of the XMODEM.LOG file,
  91.     since "most" of the lines are for downloads.  The combination of
  92.     WHATSNEW and XMDEL make the entire new file display almost fully
  93.     self-maintaining.
  94.  
  95.   OPTIONS:
  96.  
  97.      0103H  00    shows XMODEM.LOG in inverse order, newest first (program 1)
  98.         01    shows uploads only, for use as a WHATSNEW file    (program 2)
  99.  
  100.      0104H  00 = No header, regardless of option below
  101.         01 = use header selected by option below
  102.  
  103.      0105H  00 = No header, shows "R" lines of XMODEM.LOG "as is".
  104.         01 = Header, uses example 1 below  (OxGate 001 system)
  105.         02 = Header, uses example 2 below  (Potpourri system)
  106.  
  107.         If using DDT, then:   A>SAVE 5 WHATSNEW.COM
  108.  
  109. It can be customized for a specific XMODEM.LOG display.  The following
  110. example shows a few actual entries from the Potpourri system followed by
  111. the display shown to any user asking for "WHATSNEW":
  112.  
  113. ------------------------------------------------------------------------
  114. (Partial XMODEM.LOG listing, note newest are last entered)
  115.  
  116. R5 02:30 B00>LSTCBAS1LBR          15K 01/06/85 00:35 Bill Rink
  117. R1 11:57 B00>Z-NEWS  1Q3          15k 01/13/85 16:26 Carl Eckenrode
  118. P5 09:41 B15>PATCH17+LBR          59k 01/14/85 00:06 Bill Rink
  119. L5 02:35 B00>LINSTALLCOM LEISURE2LBR  16K 01/15/85 12:05 Terry Hazen
  120. S1 10:18 C03>DBSECUR2LBR          17k 01/15/85 23:36 George Sofaly
  121. R6 04:55 B00>ROS25A  LBR          53k 01/16/85 16:30 Robert Blacher
  122. R5 00:13 B00>RSXDIR  DOC           2k 01/16/85 23:51 Richard Holmes
  123. S5 07:06 C01>XLATE5  LBR          43k 01/17/85 08:29 Charles Hart
  124. S1 11:55 A02>IF/SKIP LBR          20k 01/17/85 09:25 Ricky Litofsky
  125. L5 00:30 B00>DIRR    COM DIRR2     LBR   3k 01/17/85 17:10 Stanton Perry
  126.  
  127. (Partial WHATSNEW listing using ALL.COM, note newest are listed first)
  128.  
  129. NEW - CTL-X or CTL-K to abort, CTL-S to pause
  130.  
  131. D/U    Filename  Size    Speed       Date    Time   Uploaded by
  132.  
  133. B00: RSXDIR  DOC   2k  1200 bps  01/16/85  23:51  Richard Holmes
  134. B00: ROS25A  LBR  53k  2400 bps  01/16/85  16:30  Robert Blacher
  135. B00: Z-NEWS  1Q3  15k    300 bps  01/13/85  16:26  Carl Eckenrode
  136. B00: LSTCBAS1LBR  15K  1200 bps  01/06/85  00:35  Bill Rink
  137.  
  138. [End of listing]
  139.  
  140. ------------------------------------------------------------------------
  141.  
  142. This system is pretty much self-maintaining.  The operator has almost
  143. nothing to do.    The program can be called from any drive or user area.
  144. The SYSOP can easily move files to any other drive/user area and in a
  145. moment's time use his editor with XMODEM.LOG to change the "B00" to
  146. "C10" for example, allowing tremendous versatility.  He can also use the
  147. editor to erase recent downloads with "S" or "L" in front, keeping a log
  148. of uploads that can extend back as far as he wants to let it go.
  149. Occasional users can see everything that has been added in recent weeks
  150. or months,  The person calling "yesterday" can see in a moment's time
  151. what is new.  This encourages people to call more often as they can
  152. quickly and accurately check for new entries and hang up.
  153.  
  154.     NOTE:  If any SYSOP has a problem adapting this to his system,
  155.     just send a small portion of your current XMODEM.LOG file to
  156.     Potpourri (408) 378-7474 together with a message, and we should
  157.     be able to make a special .COM file for your particular system.
  158.  
  159. Thanks to Wayne Masters, SYSOP of Potpourri for cooking up the idea and
  160. to Chuck Metz, SYSOP of OxGate 001 for additional testing and comments.
  161.  
  162.                     - Irv Hoff W6FFC
  163.  
  164.