home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / SWAP20.ZIP / HOLIDAYV.DOC < prev    next >
Text File  |  1992-10-12  |  11KB  |  265 lines
  1.  
  2.  
  3.         SWAP v2.0                                                12 October 92
  4.  
  5.                                *****  SWAP v2.0  *****
  6.                                    (12 October 92)
  7.  
  8.                   GOODBYE/HELLO/HOLIDAY Screen Rotator for Wildcat!
  9.  
  10.                               Written By: Terry Atkinson
  11.                                   Adsum Wildcat! BBS
  12.                                     Dartmouth, NS
  13.  
  14.                         NODE 1 902-434-3121 (Intel 9600ex v32)
  15.                         NODE 2 902-435-2455 (HST DS 14.4k v32)
  16.  
  17.                                  ===================
  18.                                    SPECIAL DOCUMENT
  19.                             USE OF VARIABLE HOLIDAY LISTS
  20.                                  ====================
  21.  
  22.  
  23.         Review of SWAP.CFG (default name)
  24.         ==================
  25.  
  26.         CONFIGURATION ITEM            COMMENT
  27.         ==================            =======
  28.         C:\WC30\ROTATE\HELLO\    1.  Input Path - ASCII (.BBS)/HELLOx.BBS
  29.         C:\WC30\ROTATE\HELLO\    2.  Input Path - ANSI (.SCR)/HELLOx.SCR
  30.         C:\WC30\ROTATE\GOODBYE\  3.  Input Path - ASCII/GOODBYE.BBS
  31.         C:\WC30\ROTATE\GOODBYE\  4.  Input Path - ANSI/GOODBYE.SCR
  32.         C:\WC30\ROTATE\HOLIDAYS\ 5.  Input Path - ASCII/FIXED HOLIDAY BBS
  33.         C:\WC30\ROTATE\HOLIDAYS\ 6.  Input Path - ANSI/FIXED HOLIDAY SCR
  34.         C:\WC30\ROTATE\HOLIDAYS\ 7.  Input Path - ASCII/VARIABLE HOLIDAY BBS
  35.         C:\WC30\ROTATE\HOLIDAYS\ 8.  Input Path - ANSI/VARIABLE HOLIDAY SCR
  36.         C:\WC30\DISP\HELLO1.BBS  9.  Output Path/filename for HELLOx.BBS
  37.         C:\WC30\DISP\HELLO1.SCR  10. Output Path/filename for HELLOx.SCR
  38.         C:\WC30\DISP\GOODBYE.BBS 11. Output Path/filename for GOODBYE.BBS
  39.         C:\WC30\DISP\GOODBYE.SCR 12. Output Path/filename for GOODBYE.SCR
  40.         C:\WC30\DISP\HELLO2.BBS  13. Output Path/filename for HOLIDAYF BBS
  41.         C:\WC30\DISP\HELLO2.SCR  14. Output Path/filename for HOLIDAYF SCR
  42.         C:\WC30\DISP\HELLO2.BBS  15. Output Path/filename for HOLIDAYV BBS
  43.         C:\WC30\DISP\HELLO2.SCR  16. Output Path/filename for HOLIDAYV SCR
  44.         HELLO1.LST               17. List of HELLO screens for rotation.
  45.         GOODBYE.LST              18. List of GOODBYE screens for rotation.
  46.         HOLIDAY.LST              19. List of FIXED HOLIDAY screens.
  47.         HOLIDAY.LST              20. List of VARIABLE HOLIDAY screens.
  48.         COPYIT.BAT               21. Name of BATCH file to produce. It is      
  49.                                      MANDATORY that you have a BATCH file      
  50.                                      on line 21. It may be any name of YOUR    
  51.                                      choosing, but it must be specified.
  52.         C:\WC30\ACTIVITY.003     22. Path/filename to LOG file.
  53.  
  54.              In this document, DAYofWEEK will refer to a number corresponding
  55.         to the name of the DAY of the week as follows:
  56.         SUN=1, MON=2, TUE=3, WED=4, THU=5, FRI=6, SAT=7
  57.  
  58.              If you are conversant with Michael Conley's TODAYBBS program and
  59.         associated TODAY.xxx files, this is going to be a snap. If you are not
  60.         familiar with it, don't worry about it. You probably won't have a
  61.         difficult time grasping the concepts presented below anyway. They are
  62.         straight forward.
  63.  
  64.                                                                    Page 1 of 4
  65.  
  66.  
  67.  
  68.  
  69.         SWAP v2.0                                                12 October 92
  70.  
  71.         My definition of HOLIDAY:
  72.         ========================
  73.  
  74.              As far as this program and documentation goes, HOLIDAY refers to
  75.         ANY DAY for which you want to rotate a screen. It could be Christmas
  76.         Day, Labour Day, Mother's/Father's Day or even your own birthday or
  77.         anniversary.
  78.  
  79.              There are two types of HOLIDAYS. One type is the old familiar
  80.         FIXED-DATE holidays such as Christmas Day, New Year's Day, Halloween,
  81.         etc. They always fall on the same DATE every year (ie. 25 Dec, 1 Jan,
  82.         31 Oct respectively). These types of holidays are put into the
  83.         HOLIDAYF.LST (default filename). See the SWAP.DOC file for more
  84.         information.
  85.  
  86.              The second kind is a VARIABLE-DATE holiday - such as Mother's Day
  87.         (falling on the 2nd Sunday in May) or Labour Day (falling on the 1st
  88.         Monday in September). They do NOT fall on the same DATE every year.
  89.         This document explains how to set up a HOLIDAYV.LST (default filename)
  90.         to compensate for variable date holidays.
  91.  
  92.              A text file called HOLIDAYV.TXT is included with this archive. It
  93.         gives some major variable date holidays and when they occur. You might
  94.         want to get a copy of this to your printer for quick reference as we
  95.         go along. (Note: HOLIDAYF.TXT is a file giving major FIXED holidays).
  96.  
  97.  
  98.         Example HOLIDAY (VARIABLE) rotation list (default - HOLIDAYV.LST)
  99.         ========================================
  100.         DATE   SCREENS                     COMMENT
  101.         ====   =======                     =======
  102.         01152,MLKING.BBS,MLKING.SCR        Martin L. King Day [3rd Mon in Jan]
  103.         05081,MOTHRDAY.BBS,MOTHRDAY.SCR    Mother's Day [2nd Sun in May]
  104.  
  105.         Explanation:
  106.              Martin Luther King day falls on the 3rd Monday in January. Find
  107.         the MAXIMUM date by assuming that the 1st of the month is a TUESDAY.
  108.         This makes the 3rd Monday fall on 21 Jan.  Note this date.
  109.         Then assume the 1st of the month is on a Monday.  MLK day would then
  110.         fall on the 15th of Jan. Note this date.  Of course you can now
  111.         realize that the 3rd Monday *could* fall on any DATE between the 15th
  112.         and 21st of Jan inclusive. Your VARIABLE DATE HOLIDAY LIST must
  113.         compensate for this by REPRODUCING the range of dates with a qualifier
  114.         following it.
  115.  
  116.              The example above for MLK is 01152. This is to say:
  117.         01 = January (leading zeros are necessary)
  118.         15 = date
  119.         2 = qualifier -- day 2 is MONDAY (see above)
  120.         , = separator
  121.         MLKING.BBS = BBS (ASCII) screen to rotate today IF it is a Monday
  122.         , = separator
  123.         MLKING.SCR = SCR (ANSI) screen to rotate today IF it is a Monday
  124.  
  125.              You may have comments in this file providing they are separated
  126.         from the filenames by AT LEAST one space. "Martin L. King Day [3rd Mon
  127.         in Jan]" is a comment. Given this example, the entire listing for this
  128.         day would look as shown below:
  129.  
  130.                                                                    Page 2 of 4
  131.  
  132.  
  133.  
  134.  
  135.         SWAP v2.0                                                12 October 92
  136.  
  137.         DATE   SCREENS                     COMMENT
  138.         ====   =======                     =======
  139.         01152,MLKING.BBS,MLKING.SCR        Martin L. King Day [3rd Mon in Jan]
  140.         01162,MLKING.BBS,MLKING.SCR
  141.         01172,MLKING.BBS,MLKING.SCR
  142.         01182,MLKING.BBS,MLKING.SCR
  143.         01192,MLKING.BBS,MLKING.SCR
  144.         01202,MLKING.BBS,MLKING.SCR
  145.         01212,MLKING.BBS,MLKING.SCR
  146.         05081,MOTHRDAY.BBS,MOTHRDAY.SCR    Mother's Day [2nd Sun in May]
  147.  
  148.              Our second example is Mother's Day falling on the 2nd Sunday in
  149.         May. Assuming that the 1st of the month is on a MONDAY, the 2nd Sunday
  150.         would be on the 14th of May. Assume that a SUNDAY is the 1st day of
  151.         the week. Mother's Day would then fall on the 8th. Your "Mother's Day"
  152.         entries must reflect that range of dates: 8th to the 14th inclusive. 
  153.  
  154.         The entire listing for Mother's Day would look something like:
  155.  
  156.         05081,MOTHRDAY.BBS,MOTHRDAY.SCR    Mother's Day [2nd Sun in May]
  157.         05091,MOTHRDAY.BBS,MOTHRDAY.SCR
  158.         05101,MOTHRDAY.BBS,MOTHRDAY.SCR
  159.         05111,MOTHRDAY.BBS,MOTHRDAY.SCR
  160.         05121,MOTHRDAY.BBS,MOTHRDAY.SCR
  161.         05131,MOTHRDAY.BBS,MOTHRDAY.SCR
  162.         05141,MOTHRDAY.BBS,MOTHRDAY.SCR
  163.  
  164.              Given those examples, I'm sure you can work out almost any
  165.         variable holiday. 
  166.  
  167.              The dates (ie. 0508x above) must be in the format MMDDx. This
  168.         program will not work if not in this format. It does not affect the
  169.         remainder of the program. Your DOS must also return the date in the
  170.         standardized format of MM-DD-YYYY. You may put comments in the .LST
  171.         files providing they are separated from the file listing by at least
  172.         ONE space as shown above. This is handy for those who wish to NUMBER
  173.         their screens. i.e. 1.BBS, 2.BBS, 3.SCR,  109A44.BBS, and want to make
  174.         a small comment of what these are. Note that the dates do NOT have to
  175.         be in chronological order as the ENTIRE file is read and checked for a
  176.         date coincident with your system date. The FIRST CORRECT DATE
  177.         encountered will be used, and the program will exit.
  178.  
  179.              The DATE/DAYofWEEK flag and the BBS filename MUST be separated by
  180.         a comma. Likewise the BBS filename and the SCR filename. If either are
  181.         not used, insert a comma anyway. ie. [See example .LST files]
  182.  
  183.         01152,,MLKING.SCR             Martin L. King Day [3rd Mon in Jan]
  184.         05081,MOTHRDAY.BBS,           Mother's Day [2nd Sun in May]
  185.  
  186.         (MLKING.SCR will be used by no .BBS file will be used, MOTHRDAY.BBS
  187.         file will be used by there is no .SCR file.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                                    Page 3 of 4
  197.  
  198.  
  199.  
  200.  
  201.         SWAP v2.0                                                12 October 92
  202.  
  203.              Those using only .BBS screens with "@" codes on a WC3.x system
  204.         will find this feature handy. You may have as many holiday screens as
  205.         you wish. The BBS filename and the SCR filename do not have to match,
  206.         ie.
  207.  
  208.         05081,MOTHER1.BBS,MOTHRDAY.SCR     Mother's Day [2nd Sun in May]
  209.  
  210.              You do not have to put dates before the files if you want to
  211.         maintain a list of available files for later assignment. Those files
  212.         will be ignored, ie.
  213.  
  214.         EASTRMON.BBS,EASTERMON.SCR         Easter Monday
  215.         FATHRDAY.BBS,FATHRDAY.SCR          Father's Day
  216.  
  217.  
  218.         Beg for $$$
  219.         ===========
  220.              Details for registering are in the SWAP.DOC file.
  221.  
  222.         My address and/or where I can be contacted is in the SWAP.DOC file.
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                                                    Page 4 of 4
  263.  
  264.  
  265.