home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / STATUS25.ZIP / STATUS.DOC < prev    next >
Encoding:
Text File  |  1993-01-09  |  15.5 KB  |  345 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                    Network Mail Status (Postlink Software Version)
  9.           =================================================================
  10.  
  11.                First  off I  would like  to thank  those users  who offered
  12.           suggestions  and  made comments.  Some functions/diplays  are the
  13.           result of this imput.
  14.  
  15.                This program generates a network import mail status bulletin
  16.           showing  each conference, 1000  maximum, and the  total number of
  17.           messages imported for  current date  and total to  date for  each
  18.           conferences,  the last import date and the total messages to date
  19.           for the  specified network.  Also generates last  import bulletin
  20.           showing imported current date as well as total to date.
  21.  
  22.                It also generates a network export mail status bulletin with
  23.           the  same format as the  above import bulletin.  Since the export
  24.           routine  contains all  conference names  it is  run first  to get
  25.           those names  so  that conferences  with  zero imports  are  still
  26.           displayed in the import bulletin. I could not find another way to
  27.           get all conference names.
  28.  
  29.                Supports  multiple  networks. This  program  uses Postlink's
  30.           export / import log(s). It does a monthly rollover of the  LOG(s)
  31.           using  PKZIP.EXE.  There  is   an  eighteen  character  limit  on
  32.           conference names, names longer than that are truncated.
  33.  
  34.                Starting with version 2.4 there are major changes in the way
  35.           the program runs. Command line parameters have changed once again
  36.           and options are now  in a nine line configuration  file. Requires
  37.           registration to remove "Unregistered BBS" from bulletins.
  38.  
  39.  
  40.                This archive should contain the following files:
  41.  
  42.                STATUS.EXE............ Actual program
  43.                STATUS.DOC............ This file
  44.                STATUS.CFG............ Sample configuration file     
  45.                STATUS2.CFG........... Sample configuration file
  46.                STATUS3.CFG........... Sample configuration file
  47.                READ.ME............... Update/changes information
  48.                STATUS.BAT............ Sample batch file
  49.                FILE_ID.DIZ........... BBS description file
  50.                SUPPORT.TXT........... Location of Support BBS
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                Syntax is pretty straight forward:
  59.  
  60.                                   STATUS STATUS.CFG
  61.  
  62.                "STATUS.CFG" and be the name of any configuration  file with
  63.           the following format:
  64.  
  65.                          (1) Unregistered BBS
  66.                          (2) 0000
  67.                          (3) Postlink
  68.                          (4) C:\POST1.LOG
  69.                          (5) C:\BLT7
  70.                          (6) C:\POST2.LOG
  71.                          (7) C:\BLT77
  72.                          (8) C:\BLT777
  73.                          (9) PCB
  74.  
  75.                                      .CFG line #1
  76.  
  77.                "Unregistered BBS", system name if registered
  78.  
  79.                                      .CFG line #2
  80.  
  81.                "0000" serial number if registered.
  82.  
  83.                                      .CFG line #3
  84.  
  85.                "Postlink"  should be the name of the actual network you are
  86.           using,  one word  and case  sensitive. 18 characters  max, longer
  87.           names are  truncated. Say  you are  making two  different network
  88.           mail runs with the same software, you would use those names here,
  89.           each in it's own configuration file.
  90.            
  91.                                      .CFG line #4
  92.  
  93.                "C:\POST1.LOG" is the path and name of  your Postlink Export
  94.           log.  Lines #4  and #6  can contain  the same  file name  if your
  95.           Export and Import logs are in one file.
  96.  
  97.                                      .CFG line #5
  98.  
  99.                "C:\BLT7" is the path and name for your Export bulletin.
  100.  
  101.                                      .CFG line #6
  102.  
  103.                "C:\POST2.LOG" is the path and name of your Postlink  Import
  104.           log.  Lines #4  and #6  can contain  the same  file name  if your
  105.           Export and Import logs are in one file.
  106.  
  107.                                      .CFG line #7
  108.  
  109.                "C:\BLT77" is the path and name for your Import bulletin.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                                      .CFG line #8
  118.  
  119.                "C:\BLT777"  is  the path  and  name  for your  Last  Import
  120.           bulletin.
  121.  
  122.                                      .CFG line #9
  123.  
  124.                Color  and characters used are  as follows and  are setup to
  125.           give the sysop  as much control over the output  as possible. Not
  126.           all  users can  read and handle  IBM extended  graphic characters
  127.           (like sight impaired users  and voice hardware). Program can  use
  128.           either "=/-" or IBM's extended  graphic characters "═/─". Line #9
  129.           should contain one of the following options:
  130.  
  131.                "PCB" use IBM extended  graphic characters and PCBoard's @X0
  132.           colorizing codes.
  133.  
  134.                "PCB0" use no IBM  extended graphic characters and PCBoard's
  135.           @X0 colorizing codes.
  136.  
  137.                "ANSI"  use   colorizing   and  no   IBM  extended   graphic
  138.           characters.
  139.  
  140.                "ANSI2" use colorizing and IBM extended graphic characters.
  141.  
  142.                "ASCII"  use  no  colorizing  and no  IBM  extended  graphic
  143.           characters.
  144.  
  145.                "ASCII2"  use   no  colorizing  and  IBM   extended  graphic
  146.           characters.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.                          PKZIP.EXE used by the Status Program
  155.  
  156.                "PKZIP.EXE" must be somewhere in your path or in the current
  157.           directory. When  the month  changes in the  export/import.log the
  158.           program  archives the  current log  into a  file using  'ML'+ the
  159.           current date  (ML010193.ZIP, etc.). It also  includes the current
  160.           logs  (1 or  2), all three  bulletins, and  writes it  out to the
  161.           directory that contains  the log file. The  program then rewrites
  162.           the log using  only the current new month's data.  This way there
  163.           is  only  one  month's log  data  in  your  Postlink log(s).  The
  164.           bulletins are added to the archive so that sysops  wanting to see
  165.           totals would have the  last ones generated prior to  the rollover
  166.           without having to do so manually.
  167.  
  168.                If you do not want the previous month's log(s) simply delete
  169.           the archive from your hard drive. In your  calling batch file you
  170.           can  add "IF EXIST ML*.ZIP DEL ML*.ZIP" and this will auto-delete
  171.           the  archive. If there  are no imported/export4r  messages on the
  172.           day of the rollover then a bulletin reflecting same is generated.
  173.           There must be at least one meg of free disk space for the archive
  174.           to be executed. I have  no idea the possible sizes and  if anyone
  175.           has problems with the archive with one meg as  the minimum please
  176.           let  me know  and I  will  increase the  size of  the free  space
  177.           needed.
  178.  
  179.                It should be noted that when  you start using Status if your
  180.           Postlink log(s) are not  the current month's logs that  they will
  181.           not roll over until the month rolls over inside the log. Say your
  182.           log(s) are dated 01-15-93 and you start using Status in 02-93, no
  183.           messages since  01-15-93, the  log will  still show  the messages
  184.           imported up till 01-15-93.  If your log contains  multiple months
  185.           of  logs when it rolls  them over you  will only end  up with the
  186.           previous month's log, the  others will have been over  written by
  187.           the  last one in the archive. Either  that or you can archive the
  188.           log(s) and delete everything  up to the current month  before you
  189.           run Status for the first time.
  190.  
  191.                If  you are making two  or more DIFFERENT  network mail runs
  192.           the  only thing  you  must  do  is make  two  or  more  different
  193.           POSTLINK.CFG  files, one with the  name of the  LOG file for each
  194.           network so that ALL logs are not put into  one file. I would have
  195.           no way of  knowing what messages came from what  network in order
  196.           to separate them. You would then just have a TEMP1.CFG, TEMP2.CFG
  197.           and when you call postlink  you just copy TEMP1.CFG POSTLINK.CFG,
  198.           then on next run you might copy TEMP2.CFG POSTLINK.CFG, etc.
  199.  
  200.                A simple batch file might look like one of these:
  201.  
  202.                     CD \POSTLINK
  203.                     COPY TEMP1.CFG POSTLINK.CFG
  204.                     POSTLINK CALLER.CFG
  205.                     STATUS STATUS.CFG
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.                     CD \POSTLINK
  214.                     Copy TEMP2.CFG POSTLINK.CFG
  215.                     POSTLINK CALLER2.CFG
  216.                     STATUS STATUS2.CFG
  217.  
  218.                Perhaps you want  to make  a bulletin with  the PCBoard  @X0
  219.           codes  and one using straight  ASCII codes and  yet another using
  220.           ANSI codes. The .CFG  files would contain the bulletin  names and
  221.           the form setting (#9):
  222.  
  223.                STATUS STATUS.CFG
  224.                (.CFG with PCB, uses ANSI codes and IBM extended graphic
  225.                 characters)
  226.  
  227.                STATUS STATUS2.CFG
  228.                (.CFG with ASCII, ASCII and no IBM extended graphic
  229.                 characters)
  230.  
  231.                STATUS STATUS3.CFG
  232.                (.CFG with ANSI, ANSI colors and no IBM extended graphic
  233.                 characters)
  234.  
  235.                You just call  STATUS as many times as  needed, with as many
  236.           .CFG files as needed,  to generate whatever formats you  want. On
  237.           my 386/33 it takes less than twenty seconds to run the program on
  238.           a 6,500 line test log (from three BBS systems).
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.                If you don't like the program please write to me and explain
  247.           why. Send  me any suggestions you might have. If they enhance the
  248.           overall program I will try to incorporate part, some, all, in the
  249.           next release.
  250.  
  251.                Current versions (01-04-93) of James  Huckabey door/Postlink
  252.           programs.  The doors are Door Patch 3.8 doors and now support the
  253.           following  BBS drop  files:  DOOR.SYS, PCBOARD.SYS,  SFDOORS.DAT,
  254.           CALLINFO.BBS, DORINFO1.DEF, DORINFO2.DEF and CHAIN.TXT. Converter
  255.           needed for other  BBS software. Current  releases also reflect  a
  256.           reduction in registration fees.  Send me a diskette covering  one
  257.           meg, with  return postage, and I will return it with all my doors
  258.           and Postlink  software on it/them and as any of my other software
  259.           programs that might fit in any free space.
  260.  
  261.           BBS Doors:
  262.  
  263.           BK14-400 ZIP  Book Review door
  264.           BR14-300 ZIP  BBS Review door
  265.           CS14-500 ZIP  Community Service door
  266.           DR14-300 ZIP  BBS Door Review door
  267.           GO14-400 ZIP  Gotcha game door (enhanced)
  268.           GTPL-400 ZIP  GT Power List door for GT Power BBS
  269.           MR14-300 ZIP  Music Review door
  270.           MV14-300 ZIP  Movie View door
  271.           PCOVE501 ZIP  Pirate's Cove game door (all new release)
  272.           RR14-400 ZIP  Restaurant Review door
  273.           TRLD-901 ZIP  The Rime List Door (name change from PCRL)
  274.           SW14-600 ZIP  Software Review door
  275.           WR14-300 ZIP  Wine Review door
  276.  
  277.           Postlink:
  278.  
  279.           LT100392 ZIP  Lasttime, Generates bulletin when successful
  280.                         Postlink mail transfer. Supports ASCII, ANSI and
  281.                         PCBoard codes. Freeware! (not a door). Filename is
  282.                         compile date.
  283.           STATUS24 ZIP  Generates Postlink bulletin showing total messages
  284.                         to date for each conference, total conferences,
  285.                         total messages, and monthly rollover. Optional last
  286.                         import mail transfer bulletin. Supports straight
  287.                         ASCII, ANSI and PCBoard colorizing.
  288.  
  289.                                      Registration
  290.  
  291.                If  you find this program useful please send BBS information
  292.           and one of the following in U.S. funds only:
  293.  
  294.                Registration only.................................. $10
  295.                (outside U.S. please add $2)
  296.  
  297.                Registration and latest version.................... $12
  298.                (outside U.S. please add $3) Include diskette size.
  299.  
  300.                 I  had  expected support  without  having  to  resort to  a
  301.           registration  system, but of course  I was wrong.  I just put too
  302.           much time and  effort into this program to release it as freeware
  303.           like  I did my  Lasttime program. The  program package represents
  304.           many  long  hours  of  programming, testing,  updating  and  more
  305.           testing,  as well  as  LD telephone  calls  to get  it tested  or
  306.           distribute the beta and release copies. Please support my efforts
  307.           and register your copy.
  308.  
  309.           FROM: 
  310.                   Name: 
  311.                        ---------------------------------------------------
  312.                Address:  
  313.                        ---------------------------------------------------
  314.                   City: 
  315.                        ---------------------------------------------------
  316.            State & Zip: 
  317.                        ---------------------------------------------------
  318.                 HUB ID:                       NODE ID:
  319.                        ----------------------         --------------------
  320.           Phone(voice):                        (data)
  321.                        ---------------------         ---------------------
  322.  
  323.           Diskette type if registration includes current version
  324.                                            (360, 1.2, 720, 1.44) ---------
  325.  
  326.           Version number you have if registration includes current version.
  327.           If  you have  current version  your version  request fee  will be
  328.           returned. 
  329.                                                                  ---------
  330.  
  331.              Please  supply name  of BBS  to be  added to  program. It  may
  332.           include other data up  to sixty characters. Anything longer  than
  333.           that will  be truncated, no exceptions. This is to be on one line
  334.           of  code and must be legible since  the serial number is based on
  335.           exact syntax. I cannot be responsible for unreadable data. Please
  336.           print. Case sensitive!
  337.  
  338.           Example:  "Jim's  Graphic BBS".  In Status  it  comes out  as the
  339.           following in all bulletins generated (example is  no IBM extended
  340.           graphic characters):
  341.  
  342.                ==================:Jim's Graphic BBS:==================
  343.  
  344.  
  345.           ----------------------------------------------------------------
  346.  
  347.                Your registration number, and diskette if requesting current
  348.           version, are be sent by return mail.
  349.  
  350.                     James Huckabey
  351.                     3621-A Fraser Street
  352.                     Bellingham, Washington 98226 U.S.A.
  353.                     (206) 671-2868 (voice) I do have a USR 14.4 DS!
  354.  
  355.                You can also contact me at:
  356.  
  357.                     Corporate Headquarters BBS
  358.                     Sysop: Bob Neal
  359.                     RelayNet (tm): CHQBBS (#1255)
  360.                     (815) 886-3233 / (815) 886-9381 (14400 V32bis)
  361.