home *** CD-ROM | disk | FTP | other *** search
/ Carsten's PPE Collection / Carstens_PPE_Collection_2007.zip / T / TCLC_100.ZIP / TCLC.DOC < prev    next >
Text File  |  1994-04-10  |  27KB  |  627 lines
  1.  
  2.  
  3.        ───╥───     ╥                      Total Control LastCallers
  4.           ║ ╓────╖ ║      ╓────╖               For PCBoard 15.x
  5.           ║ ║      ║      ║                      Version 1.00
  6.           ║ ║      ║      ║
  7.           ╨ ╙────╜ ╙───── ╙────╜     (C) Copyright 1994 Olivier Reubens
  8.  
  9.  
  10.  
  11.                                 Courtesy of:
  12.                                FUN-derbird BBS
  13.                    Node 1: +32-(0)50-620.112 (ZyXEL 19200)
  14.         Node 2: +32-(0)50-625.717 (USRobotics Courier Dual Standard)
  15.                            FidoNet: 2:291/1800.20
  16.                                CDN: 94:801/108
  17.  
  18.  
  19.                                Olivier Reubens
  20.                                Lippenslaan 205
  21.                              B-8300 Knokke-Heist
  22.                                    BELGIUM
  23.  
  24.  
  25.      Introduction
  26.      ────────────
  27.  
  28.      TCLC was born out of a need for a better Last Callers generator.
  29.      There are many alternative systems available.  In all kinds of
  30.      varieties (Doors, PPE...) But they are all limited to a fixed
  31.      layout of the generated last callers list.  Most of them allow you
  32.      to define a personalized header and footer, a few allow you to
  33.      change the colors of the listed fields, but that's as far as
  34.      configurability goes for the average Last Caller.  TCLC is
  35.      different....  As far as I know, TCLC is capable of creating a last
  36.      callers list which resembles any other last caller program
  37.      currently available, and it goes even way beyond that.
  38.  
  39.      If you currently use a last caller program, you should really
  40.      consider using TCLC.  If you have been looking for one which does
  41.      what you want it to do, TCLC is probably the choice for you too.
  42.  
  43.      TCLC is not like most last caller programs currently available.
  44.      Over 75% of them are PPE.  Most of the rest are DOORs.  TCLC is
  45.      neither of the two.  TCLC is a caller log analysing program which
  46.      creates a bulletin file which you can display either at login, or
  47.      by selecting the bulletin command.
  48.  
  49.  
  50.      Features of TCLC
  51.      ────────────────
  52.  
  53.      - Generate last caller lists up to last 100 callers, any number
  54.        from 0 to 100 is possible.
  55.      - Last callers TODAY.  Alternatively, you could limit the list to
  56.        display ONLY calls made today.
  57.      - Last 50 days list.  List activity on a day to day basis.  Again,
  58.        any number from 0 to 50 is possible.
  59.      - Last 50 months list.  List activity on a month to month basis.
  60.        (Any number from 0 to 50)
  61.      - List calls with last caller on top, or last caller at the bottom.
  62.      - Node-specific or system lastcaller, and even combinations of
  63.        these.
  64.      - TOTAL CONTROL over the layout of the generated listing, you pick
  65.        any of the possible fields, and display them in any order, any
  66.        color, and even multiple colors per field.
  67.      - Multi-format.  You can create multiple lists with different
  68.        layouts, all in one single run of TCLC.
  69.      - FAST.  Even though the entire process of TCLC may seem complex,
  70.        a single run of TCLC takes only a couple of seconds to complete.
  71.      - NON CRIPPLED, fully functional shareware.  TCLC is not crippled
  72.        in any way, it has NO delays or begmessages.  It only displays
  73.        '<UNREGISTERED>' at the end of the bulletin.  Registered owners
  74.        of TCLC can make use of some added features.
  75.  
  76.      For Registered users only.
  77.      - Level names.  In stead of having a security level like 10, 100...
  78.        you can define names like 'New User', 'Co-sysop' or 'Elite' for
  79.        each security level possible.
  80.      - Local call faking.  Fake local calls as being remote ones.  Not
  81.        only will the last caller list display a connect rate (as
  82.        opposedd to 'LOCAL') but also the caller log will reflect the
  83.        'faked' status, so other caller log analysing programs will be
  84.        fooled too.
  85.      - Call hiding.  Hides certain users or security levels.  These
  86.        users will NOT be listed in the last caller bulletin.  Their
  87.        download, upload, online time and call will be accounted for in
  88.        the daily and monthly statistics however.
  89.      - No Statistics.  The upload, download, online time, and call will
  90.        not be accounted in the daily and monthly statistics.  This also
  91.        on a name or security level basis.
  92.      - Log deleting.  Deletes the log entries for certain users or
  93.        security levels.
  94.  
  95.  
  96.      Files included in the TCLC distribution archive
  97.      ───────────────────────────────────────────────
  98.  
  99.        TCLC.EXE     The main executable.
  100.        TCLC.DOC     This file.
  101.        TCLC.INI     Sample INI file and description.
  102.        TCLC.LAY     Sample Layout & description.
  103.        REGISTER.FRM Registration form for TCLC.
  104.        FILE_ID.DIZ  Internal description file.
  105.        *.LAY        Sample layout files.  Thanks go out to their
  106.                     respective creators.
  107.  
  108.  
  109.      Program requirements
  110.      ────────────────────
  111.  
  112.      TCLC was designed to work on PCBoard 15.1 most of the operation of
  113.      TCLC is compatible with version 14.5a and 15.0 of PCBoard, but some
  114.      of the collected statistics will be incomplete.
  115.  
  116.      TCLC requires DOS 3.x or later, as it uses DOS SHARE-compatible
  117.      file reads and writes.
  118.  
  119.      TCLC's memory requirements are moderate (about 328Kb).
  120.  
  121.      USERS file, and USERS indexfiles accessible in the same path.
  122.      (You can define this in PCBSetup, Filelocations)
  123.  
  124.      You may need to swap out when executing the $$LOGOFF.BAT when
  125.      you're running in a limited memory environment. (PCBSetup)
  126.  
  127.      Recommended settings in TCLC are
  128.        - PCBSetup
  129.          - A  Sysop information
  130.            - Use Real Name (Yes=Use name found in USERS File)   _Y_
  131.            Not having this setting can result in TCLC failing to
  132.            locate the user record.
  133.  
  134.          - G  Configuration Options
  135.            - E  Logging Options
  136.              - Log Caller Number to Disk :                      _Y_
  137.              Not having this section will result in not being able to
  138.              use the caller number in the bulletins.
  139.  
  140.  
  141.      Updates & Bugfixes
  142.      ──────────────────
  143.  
  144.      The newest version of TCLC is always available on my BBS.
  145.  
  146.         FUN-derbird  +32-(0)50-620.112 ZyXEL 19200
  147.                      +32-(0)50-625.717 USRobotics 16800 Dual
  148.  
  149.      On top of that, I will try to always have the most current version
  150.      available on following BBSes
  151.  
  152.         CoreLand          +32-50-393.482    ZyXEL 19200
  153.         Triplex BBS      +358-05062277      Dolphin 19200
  154.         The End of Time   +1-803-855-0783   USR 21.6 DS
  155.         Ground Zero       +1-803-855-9848   Zoom 28800
  156.         Salt Air BBS      +1-801-261-8976   USR 16800 DS
  157.                           +1-801-261-8979   Hayes Ultra
  158.  
  159.      If you want to be an active distributor of TCLC and any other
  160.      programs I created give my board a call, and we can discus terms.
  161.  
  162.  
  163.      Greetings & Thanks
  164.      ──────────────────
  165.  
  166.      The TCLC Beta Testing team :
  167.        Olivier Vanbiervliet,
  168.           Cosysop of my BBS, and sysop of CoreLand BBS.
  169.        Royal,
  170.           TET Member, and sysop of Triplex BBS.
  171.  
  172.      Other Thanks :
  173.        Clark Development Company,
  174.           For providing us with the best BBS program available.
  175.        Borland International,
  176.           For providing us with an outstanding line of compilers.
  177.  
  178.  
  179.      Registration
  180.      ────────────
  181.  
  182.      TCLC is not free; nor is TCLC crippled to force registration.  TCLC
  183.      is fully functional, and will always remain so.  The only variation
  184.      with the registered copies is with the extra features.  You have
  185.      the right (in fact, I encourage you) to copy this program and use
  186.      it in any way you see fit.  There is no cost for the use of this
  187.      program nor is there any restriction on the time you are allowed to
  188.      use it.
  189.  
  190.      Why register? Besides a clean conscience, you will get a
  191.      registration key that will work for all future versions of TCLC,
  192.      and will enable the extra features of TCLC.  It will also replace
  193.      the <UNREGISTERED> message by a registered to message.
  194.  
  195.      Why fully functional ?  Well... seing the amount of software piracy
  196.      around these days there's little use in trying to protect your
  197.      program against illegal use, as no program is crack-proof.  So why
  198.      should I bother spending hours of time trying to find a clever
  199.      protection technique a pirate will crack in a couple of minutes.
  200.      With the idea in mind of "You can't crack what's not there", I
  201.      decided to tackle this problem in another way.
  202.  
  203.      The registration key will be sent to you :
  204.         - by mail (snail-mail).
  205.         - by message/file on your BBS.
  206.         - by netmail.
  207.  
  208.      The registration fee for your unique code is 15US$.  Because not
  209.      everyone can easily get dollars, you can also send me the money in
  210.      your local currency.  Just approximate the 15US$ in your local
  211.      currency in banknotes only.  Send the money and a filled in
  212.      registration form to the above mentionned address.  The
  213.      registration key will be ready for you as soon as possible.
  214.  
  215.  
  216.      License, Warranty and disclaimer
  217.      ────────────────────────────────
  218.  
  219.      I'll keep this part short and sweet, and dispense with the
  220.      legal-ese:
  221.  
  222.      License: You are allowed to use TCLC for as long as you wish, at the
  223.         point you decide you need the extra features, or decide I
  224.         deserve credit for my work, you need to register.  TCLC
  225.         registration is a license for your use of TCLC; I retain
  226.         ownership of the software.  A single registration applies to a
  227.         single BBS system, regardless of the number of computers used in
  228.         the system.  If you run two or more distinct BBS systems on the
  229.         same computer or network (with different names), you require two
  230.         or more TCLC registrations.  Refer to the registration form for
  231.         the currect pricing structure.
  232.  
  233.      Warranty: There isn't one. The only thing I'll guarantee is that
  234.         TCLC will take up disk space, and will disappear when deleted.
  235.  
  236.      Disclaimer: I'm not responsible for anything bad that happens.  TCLC
  237.         works here, but I cannot be held responsible for it not working
  238.         on your computer or doing any damage to hardware or software.
  239.  
  240.      If these aren't agreeable with you, then the best thing to do is
  241.      delete TCLC right now.  I'll do my best to help any user
  242.      (registered or not) that wants to use TCLC, and I'll act on bug
  243.      reports quickly, but I simply cannot and will not be responsible
  244.      for anything bad, like lost data, disk crashes, or whatever else
  245.      you can think of.
  246.  
  247.  
  248.      Installation
  249.      ────────────
  250.  
  251.      Copy TCLC.EXE to a location accessible by all nodes you want to
  252.      collect last caller information from.
  253.  
  254.      Create a new, or edit the provided sample INI file (TCLC.INI).  Use a
  255.      normal text editor to edit this INI file, do not use a word processor.
  256.      You can use any name you like, although I would suggest leaving the
  257.      extention to INI.  TCLC.INI has full explanation on the possible
  258.      settings and switches so you'll need to refer to TCLC.INI for more
  259.      explnation on the format and switches/settings.  The layout definition
  260.      however is explained in detail furtheron in this document.
  261.  
  262.      Add TCLC to $$LOGOFF.BAT :
  263.  
  264.        TCLC <INIFILE> <CALLERLOG>
  265.  
  266.      You should replace <INIFILE> with the appropriate filename (preferably
  267.      with a full path) of the INI file to use, and replace the <CALLERLOG>
  268.      with the filename (full path) of the caller log to process.
  269.      When running a multinode BBS, you may want to create a $$LOGOFF.BAT for
  270.      each node in use.  See multinode operation.
  271.  
  272.      Create the TCLC Datafile :
  273.  
  274.        TCLC <INIFILE> /NEW
  275.  
  276.      Again, replace <INIFILE> by the respective INI file to use.
  277.  
  278.  
  279.      The INI & Layout File
  280.      ─────────────────────
  281.  
  282.      The Layout definition file, is basically also an INI file, all
  283.      references to INI file in this section of the manual also apply to the
  284.      layout file(s).
  285.  
  286.      The INI file informs TCLC where it can find certain PCBoard files, and
  287.      how it should create the last caller bulletins.  The INI file is a
  288.      standard ASCII file which you should create and/or modify using a text
  289.      editor.
  290.  
  291.      Empty lines and lines starting with a ';' are considered to be comment
  292.      lines and they are skipped without any action taken.
  293.      Comment lines can have any length.  Keyword lines however are limited
  294.      to 254 characters (including the keyword itself).  In the layout
  295.      definition however it's possible to create layout lines longer than
  296.      254 characters.  You need to end the line before position 254, end the
  297.      line with a backslash ('\').  You can then CONTINUE the layout
  298.      definition on the NEXT line.
  299.  
  300.      You can define how TCLC should behave by defining certain keywords.
  301.      You cannot create keywords, you can only change their value.  A set of
  302.      keywords is available, and define how TCLC should work by giving the
  303.      keywords specific values.  A value is given with a textline
  304.      similar to the following.
  305.  
  306.        KEYWORD=value[,value,...]
  307.  
  308.      The keyword itself is case insensitive.  Some keywords require a
  309.      single parameter. Others require more than one parameter,
  310.      parameters are separated with commas.
  311.  
  312.      Usually one keyword defines the value for one variable in the
  313.      program.  When defining a keyword twice, you will get an error.  In
  314.      some cases the keywords define values in an array, in this case you
  315.      can define the same keyword several times.  There are two ways to
  316.      define multiple lines of an array keyword.
  317.  
  318.      - You define several lines with the same keyword
  319.         KEYWORD=value1
  320.         KEYWORD=value2
  321.         KEYWORD=value3
  322.      - You define several lines for one keyword.  This is done by
  323.        listing the values one by one in between curly brackets.
  324.         KEYWORD={
  325.         value1
  326.         value2
  327.         value3
  328.         }
  329.  
  330.      You can list keywords in any order you like, note however that you
  331.      should have specified a KEY= before using any of the
  332.      registered-version-only-keywords (LOCALUSER, HIDEUSER,
  333.      NOSTATUSER...).
  334.  
  335.      The INI file is checked when loading, you will get appropriate
  336.      error messages when certain keyword definitions do not match the
  337.      required format.
  338.  
  339.      - A description of all the possible keywords in the TCLC INI file are
  340.        available in the TCLC.INI sample INI file.
  341.  
  342.      - A set of sample layouts are provided in the *.LAY files.  see
  343.        TCLC.LAY for a complete description of all possible fields in
  344.        the Layout files.
  345.  
  346.      In the layout file, it is quite possible the line length limit of 254
  347.      characters won't allow you to achive what you really want, if this is
  348.      the case, end the line with a backslash '\', and continue the layout
  349.      defnition on the NEXT line.  Be sure your editor does not accidently
  350.      append traling spaces after the backslash.
  351.  
  352.  
  353.      Running TCLC
  354.      ────────────
  355.  
  356.      The command syntax for TCLC is
  357.  
  358.        TCLC INIFile /NEW
  359.  
  360.      This will create a new empty datafile for TCLC.  Use this option
  361.      with care as it will erase any statistics collected so far.  You
  362.      will need to create a new file when starting to use TCLC.  You
  363.      usually will not need to do this again.
  364.  
  365.        TCLC INIFile [CallerLog]
  366.  
  367.      This is the normal processing mode for TCLC.  TCLC reads the
  368.      INI file.  If a callerlog is specified, it is analysed, and the TCLC
  369.      datafile is updated to reflect the newly gathered statistics.  TCLC
  370.      then continues to create the requested bulletins with the layout
  371.      defined in the INI file.
  372.  
  373.  
  374.      Multinode operation
  375.      ───────────────────
  376.  
  377.      When setting up TCLC for multinode, it is important to decide
  378.      whether you want systemwide lastcallers, or a node specific
  379.      lastcaller.
  380.  
  381.      - Systemwide
  382.        Create ONE TCLC Datafile in a location accessible by all nodes.
  383.        Use the SAME INI file on each node.  In the $$LOGOFF.BAT you
  384.        specify which node's caller log to process.  The $$LOGOFF.BAT
  385.        of node 1 would have :
  386.  
  387.          TCLC TCLC.INI C:\PCB\MAIN\CALLER1.
  388.  
  389.        The $$LOGOFF.BAT of node 2 would have :
  390.  
  391.          TCLC TCLC.INI C:\PCB\MAIN\CALLER2.
  392.  
  393.        And so on for the other nodes.
  394.  
  395.      - Node specific
  396.        Create a TCLC Datafile for each node, and use a different INI
  397.        file for each node.  The $$LOGOFF.BAT of node 1 would have :
  398.  
  399.          TCLC TCLC1.INI C:\PCB\MAIN\CALLER1.
  400.  
  401.        The $$LOGOFF.BAT of node 2 would have :
  402.  
  403.          TCLC TCLC2.INI C:\PCB\MAIN\CALLER2.
  404.  
  405.        And so on for the other nodes.
  406.  
  407.      - Combination
  408.        If you want to create systemwide AND node specific last callers,
  409.        all you need to do is create a TCLC Datafile for all nodes, and
  410.        one for each node you want separate lastcallers for.
  411.        The $$LOGOFF.BAT will in that case have two entries one to update
  412.        the node specific datafile, and one to update the systemwide
  413.        datafile.
  414.  
  415.        ! NOTE.  When using LOCALUSER or DELETEUSER (registered version
  416.          only) care should be taken with the order in which the two (or
  417.          more) INI files are processed.  If the first INI file deletes
  418.          the user, the following INI files will reprocess the previous
  419.          caller.  This will not cause any problems as TCLC will detect
  420.          this, but the call, daily and monthly statistic will not be
  421.          entirely correct.  The first INI file should take care of all
  422.          LOCALUSER entries, while the last INI file should take care of
  423.          all DELETEUSER entries.
  424.  
  425.  
  426.      Multi-layout operation
  427.      ──────────────────────
  428.  
  429.      You can generate several bulletins with one run of TCLC.  All you
  430.      need to do is have multiple CREATE= entries in the INI file.  You
  431.      can define a separate Layout file for each CREATE entry.
  432.      TCLC allows you to create up to 10 different types of bulletins in
  433.      one go.  If you need more, you will need to create several INI
  434.      files, and have TCLC process those INI files one by one.  The first
  435.      TCLC entry in the $$LOGOFF.BAT will need to process the caller log.
  436.      The subsequent entries do not need to do this.  You will get
  437.      something like this in the $$LOGOFF.BAT :
  438.  
  439.        TCLC TCLC1.INI CALLER1.
  440.        TCLC TCLC2.INI
  441.        TCLC TCLC3.INI
  442.  
  443.      ! Note, here also, the note of the LOCALUSER and DELETEUSER as
  444.        specified above applies.
  445.  
  446.  
  447.      Creating a personalized layout
  448.      ──────────────────────────────
  449.  
  450.      TCLC comes with a set of sample layouts which can be found in the
  451.      *.LAY files.  These are either layouts designed for TCLC or are
  452.      carbon-copy layout definitions from some of the other available
  453.      last caller lists.
  454.  
  455.      You'll probably want to change the provided layouts or change the
  456.      colors to better match with the other screens of your board.  But
  457.      it's also possible you want to create something totally new.
  458.  
  459.      When looking at a finished last caller bulletin, you will notice it
  460.      has three distinctive parts :
  461.  
  462.      Example (color codes removed for ease of use) :
  463.  
  464.       1│ Last few callers on this BBS
  465.       2│
  466.       3│ Alias/Name          Location            Speed Node DL Kb  Time
  467.       4│ ------------------- ------------------- ----- ---- ------ -----
  468.       5│ Jake Smith          New York City       14400    1  1,167 12:15
  469.       6│ Carol Young         Atlanta              2400    2        12:27
  470.       7│ Dark Angel          - Somewhere -       16800    1  3,679 13:08
  471.       8│
  472.       9│
  473.      10│ Last few days
  474.      11│
  475.      12│ Date     #Calls UL Kb   UL File DL Kb   DL File Busy
  476.      13│ -------- ------ ------- ------- ------- ------- ---------
  477.      14│ 04-03-94     13     697       2   4,275      10    94Min.
  478.      15│ 03-03-94     48   5,198      12  28,347      49   719Min.
  479.      16│ 02-03-94     51   3,679       7  22,721      42   653Min.
  480.      17│
  481.      18│
  482.      19│ Total Control Last Callers V1.00.  Registered to: Olivier Reubens
  483.  
  484.  
  485.      These three parts are :
  486.       - Fixed information. (Lines 1, 2, 3, 4, 8, 9, 10, 11, 12, 13, 17,
  487.         18).  Usually headers and footers
  488.       - Variable information records. (Lines 5, 6, 7, 14, 15, 16)
  489.         Last caller data, daily and monthly statistics.
  490.       - Copyright banner. (Line 19)
  491.  
  492.      You can change the contents of the fixed and variable information,
  493.      but you can only change the color of the copyright banner.
  494.  
  495.      Fixed information
  496.      ─────────────────
  497.  
  498.      You specify the headers, footers and where to insert the last
  499.      callers, daily and/or monthly statistics in the LAYOUT= section of
  500.      the INI File. This LAYOUT= consists of a maximum of 64 lines. It's
  501.      a direct copy of what you would find in the bulletin itself.  You
  502.      can use PCBoard @X color codes and even PCBoard macro's.  You can
  503.      also use ANSi codes, but I would definitely recommend using ONLY
  504.      PCBoard color codes as you immediately have a bulletin for color
  505.      and mono. Although I haven't tried myself (YET), it should even be
  506.      possible to create a layout using RIP codes.
  507.      You also specify where TCLC should insert last caller, daily or
  508.      monthly statistics.  You do not need to use all three.  You can
  509.      choose any combination in any order you like.  To specify where
  510.      TCLC should insert the variable information, you specify a line
  511.      with :
  512.       #USER# to insert last caller information.
  513.       #DAY#  to insert daily statistics
  514.       #MONTH# to insert monthly statistics.
  515.  
  516.      For the above example the layout specification in the INI file would
  517.      look like this :
  518.  
  519.      │LAYOUT={
  520.      │Last few callers on this BBS
  521.      │
  522.      │ Alias/Name          Location            Speed Node DL Kb  Time
  523.      │ ------------------- ------------------- ----- ---- ------ -----
  524.      │#USER#
  525.      │
  526.      │
  527.      │ Last few days
  528.      │
  529.      │ Date     #Calls UL Kb   UL File DL Kb   DL File Busy
  530.      │ -------- ------ ------- ------- ------- ------- ---------
  531.      │#DAY#
  532.      │
  533.      │}
  534.  
  535.  
  536.      Variable information
  537.      ────────────────────
  538.      Variable information is a little harder to understand.
  539.      When creating the bulletin, TCLC replaces the #USER#, #DAY# and
  540.      #MONTH# with multiple variable information records.  The amount of
  541.      records it uses depends on the CREATE= (see INI File) used.
  542.      Each variable information record can be up to 8 lines high.  The
  543.      variable information layout is specified in the INI File.
  544.        USERSTATS=  specifies the last caller statistics layout.
  545.        DAYSTATS=   specifies the daily statistics layout.
  546.        MONTHSTATS= specifies the monthly statistics layout.
  547.  
  548.      The fields in the records are represented with alphabetical
  549.      characters.  The 'A' for example represents the user alias in a last
  550.      caller record.  It doesn't stop there however.  Since the user alias
  551.      has 25 characters, so will it's field representation.  To include
  552.      every character of the alias, you would need to specify
  553.      "AAAAAAAAAAAAAAAAAAAAAAAAA".  Because each consecutive 'A'
  554.      character is replaced with a consecutive character of the user
  555.      alias.  You can change colors INSIDE the alias, and thus have
  556.      'fading' fields ("@X0FAA@X0BAA@X03AA@X07AA@X08AAAAAAAAAAAAAAAAA").
  557.      You do not need to specify a full field.  The uploaded bytes for
  558.      example could be used without the last three digits thus giving you
  559.      a downloaded kilobytes field.  Take away the last 6 digits, and you
  560.      have a downloaded megabytes field.
  561.  
  562.      There's more...
  563.      When using a lowercase character instead of an uppercase one, TCLC
  564.      will skip a character from the variable information record. This
  565.      allows you to delete leading characters and characters in the
  566.      middle of a field.  The numerical fields are formatted with
  567.      separators for thousands, milions...  You can use lowercase
  568.      characters to have unformatted fields.  The character 'D'
  569.      represents Downloaded bytes in the last caller record, and ALWAYS
  570.      has the following format 999,999,999.  Here are some examples of
  571.      how you could use this downloaded bytes field (example: downloaded
  572.      bytes is 2,641,157 bytes)
  573.  
  574.       Layout        Bulletin      Description
  575.       ───────────── ───────────── ──────────────────────────────────────
  576.       "DDDDDDDDDDD" "  2,641,157" Normal.
  577.       "DDDdDDDdDDD" "  2641157"   No commas.
  578.       "ddDDDDDDDDD" "2,641,157"   Skip 100-milion and 10-Milion digit.
  579.                                   This can be useful to reduce the
  580.                                   width of the field.  If no-one on the
  581.                                   BBS can ever download more than
  582.                                   9,999,999 bytes in a single day this
  583.                                   can safely limit field width.
  584.       "ddddDDDdDDD" "641157"      Oops.  Digits removed.
  585.       "DDDdDDD"     "  2641"      Kilobytes downloaded, no comma.
  586.       "ddDdDDD"     "2641"        Kilobytes downloaded, no comma, width
  587.                                   reduced (see above for use).
  588.  
  589.      There's just one problem left to deal with.
  590.      Since the alphabetical characters are used for representing the
  591.      variable record fields you can no longer use them to display text
  592.      in a variable record, at least, not without some effort.  TCLC is
  593.      smart enough to recognize PCBoard color codes, so you don't need to
  594.      do extra work to use those.  To include text or use the '@'
  595.      character in a variable record, you need to put that text in
  596.      between quotes (') or double quotes (").  Continuing the example,
  597.      to have " 2,641Kb" in the bulletin you would use dDDDDDD"Kb" or
  598.      dDDDDDD'Kb'. Alternatively, if you only need to display ONE
  599.      character you can precede the single character with a tilde ('~')
  600.      (Alt-126).  So, dDDDDDD~K~b is also valid.
  601.  
  602.      In the example layout definition, the following was used
  603.  
  604.      │USERSTATS={
  605.      │ AAAAAAAAAAAAAAAAAAA LLLLLLLLLLLLLLLLLLL CCCCC  RRR dDDDDDD ZZZZZ
  606.      │}
  607.  
  608.  
  609.      │DAYSTATS={
  610.      │ YYYYYYYY MMMMMM uuuUUUUUUU VVVVVVV dddDDDDDDD EEEEEEE oOOOOO"Min."
  611.      │}
  612.  
  613.  
  614.      End of manual.
  615.  
  616.      See :
  617.      TCLC.INI   For a complete description of the contents and settings
  618.                 of the INI file.
  619.      TCLC.LAY   For a description of the layout definition and available
  620.                 fields.
  621.      *.LAY      For sample layout definitions.
  622.                 Each file contains a colored sample of a generated
  623.                 bulletin with the settings 10 last caller, 5 last days,
  624.                 5 last months.  You should use PCBEDIT or another
  625.                 program which displays the PCBoard @X color codes to see
  626.                 what the resulting bulletin looks like.
  627.