home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / SWAP20.ZIP / SWAP.DOC < prev    next >
Text File  |  1992-10-12  |  30KB  |  793 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.         What it does:
  18.         ============
  19.              SWAP is designed to be used on Wildcat! BBSs for rotation of
  20.         HELLO and/or GOODBYE ANSI and/or ASCII screens during events and/or
  21.         postcall. Special HOLIDAY screens can be rotated by specifying the
  22.         appropriate information in .CFG file(s). Because of it's simplicity
  23.         and versatility, this file may work with other BBSs. Even if you are
  24.         NOT running a BBS, you may find a use for it. Provision was made for
  25.         rotating screens based on variable date holidays or special events
  26.         such as Mother's Day, which falls on a different DAY each year.
  27.  
  28.  
  29.         How it does it:
  30.         ==============
  31.              When executed, SWAP looks for a configuration file in the current
  32.         directory (default called SWAP.CFG). The .CFG is read for information
  33.         on filenames and pathnames of various lists maintained and created by
  34.         you, the user. A BATch file is produced which does the work of copying
  35.         files from directories to files in other directories. Terse logging is
  36.         accomplished through an environment variable if desired and an
  37.         alternate .CFG file may be specified on the command line.
  38.  
  39.         What it will not do:
  40.         ===================
  41.              It will not PRODUCE a screen for you.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                                                   Page 1 of 12
  65.  
  66.  
  67.  
  68.  
  69.         SWAP v2.0                                                12 October 92
  70.  
  71.         File listing: 
  72.         ============
  73.              The NAME of this archive should be SWAP11.ZIP or .ARJ etc. 
  74.         SysOps - Please ensure this is name on YOUR BBS.
  75.         Suggested keywords: SWAP ROTATE SWITCH SCREEN ANSI ASCII BBS SCR
  76.  
  77.         Contents:           Purpose:
  78.         ========            =======
  79.         SWAP.EXE       -    Executable. You may rename it if you wish.
  80.         SWAP.CFG       -    Sample Configuration file. May be renamed on a
  81.                             command line as described below. In whatever form,
  82.                             a .CFG is REQUIRED.
  83.         HELLO1.LST      -   Sample listing of SCR/BBS files to swap to a
  84.                             HELLOx.xxx screen. Filename may be defined by
  85.                             user.
  86.         GOODBYE.LST    -    Sample listing of SCR/BBS files to swap to a
  87.                             GOODBYE.xxx screen. Filename may be defined by
  88.                             user.
  89.         HOLIDAYF.LST    -   Sample listing of SCR/BBS files to swap to a
  90.                             HELLOx.xxx screen on user specified FIXED DATE
  91.                             holidays and/or special events. Filename may be
  92.                             defined by user.
  93.         HOLIDAYV.LST   -    Sample listing of SCR/BBS files to swap to a
  94.                             HELLOx.xxx screen on user specified VARIABLE DATE
  95.                             holidays and/or special events. Filename may be
  96.                             defined by user.
  97.         COPYIT.BAT     -    Batch file which performs the work. Filename
  98.                             defined by user. This will be created/replaced
  99.                             each time you run SWAP.
  100.         HOLIDAYF.TXT   -    A listing of some of the major FIXED holidays
  101.                             throughout the world. This is NOT an all-inclusive
  102.                             listing. Use your own judgement. Not used by the
  103.                             program. Included for YOUR use as you see fit.
  104.         HOLIDAYV.TXT   -    A listing of some of the major VARIABLE DATE
  105.                             holidays throughout the world. Same notes as
  106.                             above.
  107.         SWAP.DOC       -    This file.
  108.         HOLIDAYV.DOC   -    Details on setting up a VARIABLE DATE holiday
  109.                             list. Separated from main documentation for
  110.                             readability.
  111.         DESC.SDI       -    File description for WILDCAT! BBSs.
  112.         FILE_ID.DIZ    -    File description for other BBSs.
  113.         SWAPNOTE.TXT   -    For WC BBSs if you want an extended description
  114.                             (entered manually).
  115.         SWAPCFG.EXE    -    Quick and dirty program to produce a configuration
  116.                             file for you. Allows default, edited or blank
  117.                             inputs for various fields. See SWAPCFG.DOC for
  118.                             more info.
  119.         SWAPCFG.DOC    -    Documents for SWAPCFG.EXE. Program is self-
  120.                             explanatory provided you have read THESE
  121.                             documents.
  122.         EXAMPLES.TXT   -    File with examples and explanations. Read if you
  123.                             are still confused after reading these docs.
  124.         VERSION.HIS    -    Read this file for changes to the program.
  125.         This ZIP file is -AV stamped. If there is no indication that the file
  126.         has an AV stamp as shown below, it may have been tampered with.  Get a
  127.         new file. If a "hacked" notice comes up, get a new file.
  128.         # OBH709   ADSUM Wildcat! BBS 902-434-3121/435-2455
  129.  
  130.                                                                   Page 2 of 12
  131.  
  132.  
  133.  
  134.  
  135.         SWAP v2.0                                                12 October 92
  136.  
  137.         Quick start
  138.         ===========
  139.              To get started, all you have to do is run SWAP.EXE. You may
  140.         safely do this at any time as NO CHANGES are made to ANY files
  141.         whatsoever. Ensure you have a backup copy of all the files in this
  142.         archive BEFORE you make any modifications. All this program does is
  143.         create a .BAT file in the same directory from which SWAP.EXE is run.
  144.  
  145.         The Configuration file   (default = SWAP.CFG)
  146.         ======================
  147.              The DEFAULT configuration file is "SWAP.CFG". You may change this
  148.         to anything you want, but you must then use a command line as follows:
  149.         SWAP MYCONFIG.TXT
  150.         where MYCONFIG.TXT is your own configuration filename vice SWAP.CFG.
  151.  
  152.              Given the ability for a command line .CFG file, you can obviously
  153.         have as many different configs as you wish, and can rotate many
  154.         different files depending on your system. (ie. HELLO1N.xxx, HELLO1.xxx
  155.         ad infinitum). With judicious use of a command line config file, you
  156.         could even get this program to swap holiday screens to a GOODBYE.BBS
  157.         screen.
  158.  
  159.              The 22 configuration items specified below MUST be syntactically
  160.         correct, although they need not exist at all - in which case a BLANK
  161.         LINE is required except where noted. Also, the first eight INPUT
  162.         paths, if used, MUST be terminated with a "\" or the program will
  163.         record an error and halt with a prompt for you to fix the .CFG file.
  164.         The prompt will let you know which line is at fault. You may leave the
  165.         COMMENTS in the file(s) as long as they are separated from the
  166.         configuration items by at least ONE space as shown below.
  167.  
  168.         CONFIGURATION ITEM            COMMENT
  169.         ==================            =======
  170.         C:\WC30\ROTATE\HELLO\    1.  Input Path - ASCII (.BBS)/HELLOx.BBS
  171.         C:\WC30\ROTATE\HELLO\    2.  Input Path - ANSI (.SCR)/HELLOx.SCR
  172.         C:\WC30\ROTATE\GOODBYE\  3.  Input Path - ASCII/GOODBYE.BBS
  173.         C:\WC30\ROTATE\GOODBYE\  4.  Input Path - ANSI/GOODBYE.SCR
  174.         C:\WC30\ROTATE\HOLIDAYS\ 5.  Input Path - ASCII/FIXED HOLIDAY BBS
  175.         C:\WC30\ROTATE\HOLIDAYS\ 6.  Input Path - ANSI/FIXED HOLIDAY SCR
  176.         C:\WC30\ROTATE\HOLIDAYS\ 7.  Input Path - ASCII/VARIABLE HOLIDAY BBS
  177.         C:\WC30\ROTATE\HOLIDAYS\ 8.  Input Path - ANSI/VARIABLE HOLIDAY SCR
  178.         C:\WC30\DISP\HELLO1.BBS  9.  Output Path/filename for HELLOx.BBS
  179.         C:\WC30\DISP\HELLO1.SCR  10. Output Path/filename for HELLOx.SCR
  180.         C:\WC30\DISP\GOODBYE.BBS 11. Output Path/filename for GOODBYE.BBS
  181.         C:\WC30\DISP\GOODBYE.SCR 12. Output Path/filename for GOODBYE.SCR
  182.         C:\WC30\DISP\HELLO1.BBS  13. Output Path/filename for HOLIDAYF BBS
  183.         C:\WC30\DISP\HELLO1.SCR  14. Output Path/filename for HOLIDAYF SCR
  184.         C:\WC30\DISP\HELLO1.BBS  15. Output Path/filename for HOLIDAYV BBS
  185.         C:\WC30\DISP\HELLO1.SCR  16. Output Path/filename for HOLIDAYV SCR
  186.         HELLO1.LST               17. List of HELLO screens for rotation.
  187.         GOODBYE.LST              18. List of GOODBYE screens for rotation.
  188.         HOLIDAYF.LST             19. List of FIXED HOLIDAY screens.
  189.         HOLIDAYV.LST             20. List of VARIABLE HOLIDAY screens.
  190.         COPYIT.BAT               21. Name of BATCH file to produce. It is      
  191.                                      MANDATORY that you have a BATCH file      
  192.                                      on line 21. It may be any name of YOUR    
  193.                                      choosing, but it must be specified.
  194.         C:\WC30\ACTIVITY.001     22.  Log file for TERSE logging.
  195.  
  196.                                                                   Page 3 of 12
  197.  
  198.  
  199.  
  200.  
  201.         SWAP v2.0                                                12 October 92
  202.  
  203.              Once you have the SWAP.CFG set up to point to the appropriate
  204.         files and file areas, the next step is to create your own listings for
  205.         files to rotate. [You can use SWAPCFG.EXE to modify the .CFG file!]
  206.  
  207.  
  208.         Example HOLIDAY (FIXED) rotation list (default - HOLIDAYF.LST)
  209.         =====================================
  210.         DATE SCREENS                     COMMENT
  211.         ==== =======                     =======
  212.         0101,NEWYEAR.BBS,NEWYEAR.SCR     For New Years day.
  213.         0401,APRFOOL.BBS,APRFOOL.SCR     For April Fools day
  214.         0601,CDNFLAG.BBS,CDNFLAG.SCR     For Canada Day
  215.         0604,USFLAG.BBS,USFLAG.SCR       For US Independence Day
  216.         1224,XMASEVE.BBS,XMASEVE.SCR     For Christmas Eve
  217.         1225,XMAS.BBS,XMAS.SCR           For Christmas Day
  218.  
  219.              The dates (ie. 1225 above) must be in the format MMDD. This
  220.         program will not work if not in this format. It does not affect the
  221.         remainder of the program. Your DOS must also return the date in the
  222.         standardized format of MM-DD-YYYY. You may put comments in the .LST
  223.         files providing they are separated from the file listing by at least
  224.         ONE space as shown above. This is handy for those who wish to NUMBER
  225.         their screens. i.e. 1.BBS, 2.BBS, 3.SCR,  109A44.BBS. Note that the
  226.         dates do NOT have to be in chronological order as the ENTIRE file is
  227.         read and checked for a date coincident with your system date. The
  228.         FIRST CORRECT DATE encountered will be used, and the program will
  229.         exit.
  230.  
  231.  
  232.         0101,NEWYEAR.BBS,NEWYEAR.SCR
  233.         0401,APRFOOL.BBS,APRFOOL.SCR
  234.         0601,CDNFLAG.BBS,CDNFLAG.SCR
  235.         0604,USFLAG.BBS,USFLAG.SCR
  236.         1224,XMASEVE.BBS,XMASEVE.SCR
  237.         1225,XMAS.BBS,XMAS.SCR
  238.  
  239.              The DATE and the BBS filename MUST be separated by a comma.
  240.         Likewise the BBS filename and the SCR filename. If either is not used,
  241.         put a comma in anyway. ie. [See example .LST files]
  242.         0101,,NEWYEAR.SCR        or 
  243.         0101,NEWYEAR.BBS,        or 
  244.         0101,,
  245.  
  246.              Those using only .BBS screens with "@" codes on a WC3.x system
  247.         will find this feature handy. You may have as many holiday screens as
  248.         you wish. The BBS filename and the SCR filename do not have to match,
  249.         ie.
  250.         0101,NEWYEAR.BBS,PICTURE.SCR
  251.  
  252.              You do not have to put dates before the files if you want to
  253.         maintain a list of available files for later assignment. See the
  254.         enclosed HOLIDAY.LST for examples.
  255.  
  256.              SWAP also has the capability of recognizing dates and days of the
  257.         week. See the HOLIDAYV.DOC file for more information.
  258.  
  259.  
  260.  
  261.  
  262.                                                                   Page 4 of 12
  263.  
  264.  
  265.  
  266.  
  267.         SWAP v2.0                                                12 October 92
  268.  
  269.         Example HELLO rotation list (default = HELLO1.LST)
  270.         ===========================
  271.         SCREENS                       COMMENTS
  272.         =======                       ========
  273.         55CHEV.BBS,55CHEV.SCR         Picture of a 55 Chevy
  274.         ODIE.BBS,ODIE.SCR             Odie doing his nut
  275.         YIKES!.BBS,YIKES!.SCR         Displays YIKES here comes @FIRST@
  276.         WELCOME.BBS,WELCOME.SCR       ADSUM's own welcome screen
  277.  
  278.              This list has only two fields separated by a mandatory comma. The
  279.         comma must be used even if you are not using both filenames, ie.
  280.         55CHEV.BBS,
  281.         ,ODIE.SCR
  282.  
  283.              In the event a HELLO screen and a HOLIDAY screen have the same
  284.         destination pathname AND filename, the HOLIDAY screen will be copied
  285.         but the HELLO screen will not. The HOLIDAY always takes precedence and
  286.         a FIXED Holiday takes precedence over the VARIABLE DATE Holiday. 
  287.         Hence, it is always best to either:
  288.  
  289.         1.   Make your HELLO screens as HELLO1.x and your HOLIDAY screens as 
  290.              HELLO2.x. Using this method, the onus is on YOU to ensure the
  291.              HELLO2.x screen is DELETED when no longer required. Otherwise,
  292.              the HELLO2.x will display for the next day as well.
  293.         2.   Make your HELLO screens and HOLIDAY screens as HELLO1.x. This
  294.              way, the HOLIDAY file will be overwritten, either by another
  295.              HOLIDAY screen or a standard HELLOx screen the next time it is
  296.              run.
  297.  
  298.              The item at the TOP of the list is the NEXT screen to be copied.
  299.         Each time SWAP is run, this list is rotated to put the TOP line at the
  300.         bottom of the list. In other words, the HELLO list, after running SWAP
  301.         will now be:
  302.  
  303.         ODIE.BBS,ODIE.SCR
  304.         YIKES!.BBS,YIKES!.SCR
  305.         WELCOME.BBS,WELCOME.SCR
  306.         55CHEV.BBS,55CHEV.SCR
  307.  
  308.  
  309.              You may have up to 365 of these files, one for each day of the
  310.         year if you are so inclined. The list is rotated EVERY TIME SWAP.EXE
  311.         is run.
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                                                   Page 5 of 12
  329.  
  330.  
  331.  
  332.  
  333.         SWAP v2.0                                                12 October 92
  334.  
  335.         Example GOODBYE rotation list (default = GOODBYE.LST)
  336.         =============================
  337.         SCREENS                       COMMENT
  338.         =======                       =======
  339.         STATS.BBS,STATS.SCR           General User Stats at logoff.
  340.         GOODBYE4.BBS,GOODBYE4.SCR     Picture of computer and modem
  341.         GOODBYE1.BBS,GOODBYE1.SCR     Tradewar 2000 scenes
  342.         GOODBYE2.BBS,GOODBYE2.SCR     User biography shown at logoff
  343.  
  344.              The GOODBYE.LST is functionally identical to the HELLO1.LST. This
  345.         is designed to rotate GOODBYE.BBS/SCR screens daily.  There are NO
  346.         HOLIDAY GOODBYE SCREENS, however, with judicious use of a command line
  347.         configuration file, this is entirely possible to do. I will leave it
  348.         to your imagination. Like the other lists, you may have COMMENTS in
  349.         the .LST. However, ensure you separate the screen names from the
  350.         comments by at least ONE space.
  351.  
  352.              This list has only two fields separated by a mandatory comma. The
  353.         comma must be used even if you are not using both filenames, ie.
  354.         STATS.BBS,
  355.         ,GOODBYE2.SCR
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                                                   Page 6 of 12
  395.  
  396.  
  397.  
  398.  
  399.         SWAP v2.0                                                12 October 92
  400.  
  401.         LOG FILE
  402.         ========
  403.  
  404.         IN THE CONFIGURATION FILE (LINE 22)
  405.         =========================
  406.              Line 22 specifies the full path and filename of a LOG file of
  407.         your choosing.  Optionally, you may put "NONE" on this line, ie:
  408.  
  409.         NONE                     No log file specified in the CFG.
  410.         ..or..
  411.         C:\WC30\ACTIVITY.001     Terse log to Activity.001 file.
  412.  
  413.              This is a TERSE log, opened in the append mode with file locking
  414.         in case you wish to log to activity logs or other files which may be
  415.         used by other programs on a multitasking system. Since it only takes a
  416.         second to write the information, this should not pose a problem
  417.         anyway.
  418.  
  419.         Via an ENVIRONMENT VARIABLE: (SET SWAPLOG=)
  420.         ===========================
  421.  
  422.              If you wish to log to a file using an environment variable:
  423.         "SET SWAPLOG=" and then the FULL PATH AND FILENAME FOR THE LOG. ie.
  424.         SET SWAPLOG=C:\WC30\ACTIVITY.003
  425.               ...or...
  426.         SET SWAPLOG=D:\SYSTEM\SWAPLOG.LOG
  427.  
  428.              Try it from the DOS prompt. If you get an "out of environment
  429.         space" error, you may have to temporarily remove something from your
  430.         environment and put it back again.  This can easily be accomplished
  431.         from within the batch file which calls SWAP.
  432.  
  433.              For example, I have a "SET PCPLUS=C:\PCPLUS". A batch file to
  434.         temporarily remove/reinstall it might look like:
  435.         @ECHO OFF                          Not necessary
  436.         SET PCPLUS=                        removes PCPLUS from the environment
  437.         SET SWAPLOG=C:\WC30\ACTIVITY.003   puts swaplog into the environment
  438.         SWAP                               executes SWAP.EXE
  439.         CALL COPYIT BAT                    copies the files
  440.         SET SWAPLOG=                       removes swaplog from environment
  441.         SET PCPLUS=C:\PCPLUS               reinstalls PCPLUS to environment
  442.         NODE2                              runs batch file for the BBS
  443.  
  444.  
  445.              Note: You may have a log specified in the .CFG file and at the
  446.         same time, have one specified in the ENVIRONMENT. However, the
  447.         ENVIRONMENT log will take precedence and the .CFG log will be ignored.
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                                                                   Page 7 of 12
  461.  
  462.  
  463.  
  464.  
  465.         SWAP v2.0                                                12 October 92
  466.  
  467.         Suggested setup
  468.         ===============
  469.         The "standard" setup is to have a subdirectory hanging off your
  470.         Wildcat! home directory (normally C:\WC30). Lets assume you name this
  471.         directory ROTATE (C:\WC30\ROTATE). Put SWAP.EXE, SWAP.CFG,
  472.         HOLIDAYF.LST, HOLIDAYV.LST, HELLO1.LST, GOODBYE.LST (or your specified
  473.         .LSTs and .CFGs) in this directory. COPYIT.BAT (or your specified
  474.         filename) will be created in this directory when SWAP.EXE is run
  475.         successfully.
  476.  
  477.         Put HOLIDAY (both kinds) screens in a subdirectory of the ROTATE
  478.         directory 
  479.         (ie. C:\WC30\ROTATE\HOLIDAY). 
  480.  
  481.         Put the HELLO screens in a subdirectory of the ROTATE directory 
  482.         (ie. C:\WC30\ROTATE\HELLO).
  483.  
  484.         Put the GOODBYE screens in a subdirectory of the ROTATE directory 
  485.         (ie. C:\WC30\ROTATE\GOODBYE).
  486.  
  487.         Note:     The above is NOT necessary. You may have them anywhere you
  488.         want as long as you point the .CFG to the proper directory for the
  489.         files. You may even have them in the \ROTATE directory if you wish.
  490.         However, this will make it quite cluttered if you have a lot of
  491.         display files. Also, the INPUT paths to files may be eliminated from
  492.         the .CFG file if they are in the same directory as the SWAP.EXE file -
  493.         and provided you leave a blank line in the .CFG file. You can make it
  494.         simple or make it hard ... your choice.
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                                                                   Page 8 of 12
  527.  
  528.  
  529.  
  530.  
  531.         SWAP v2.0                                                12 October 92
  532.  
  533.         Event or Postcall BATCH file
  534.         ============================
  535.              When SWAP is run, it creates a batch file based on your
  536.         configuration. The batch file will magically appear in the same
  537.         directory as SWAP.EXE. Default batch file is COPYIT.BAT.
  538.  
  539.              Your EVENT.BAT or POSTCALL.BAT must then CALL COPYIT.BAT file.
  540.         Again, you could even use it in a POSTCALL.BAT file to rotate screens
  541.         between calls.
  542.  
  543.         An example of an EVENT batch file to accomplish this is might be:
  544.  
  545.         @ECHO OFF           Not necessary
  546.         WCPRO NEWUSERS      Run a Wildcat! PRO utility
  547.         FLOP                Run Michael Conley's FLOP program
  548.         CD C:\WC30\ROTATE   Change to ROTATE DIRECTORY (where SWAP.EXE lives)
  549.         ECHO:
  550.         SET SWAPLOG=C:\WC30\ACTIVITY.001   Log details to a file
  551.         SWAP                Execute SWAP
  552.         SET SWAPLOG=        Remove swaplog from environment
  553.         CALL COPYIT.BAT     Execute the BAT file to copy the .BBS/.SCR files
  554.         ECHO:
  555.         CD C:\WC30          Go back to WC Home directory
  556.         WCPRO NEWFILES      Run a Wildcat! PRO utility
  557.         NODE1               Return to Wildcat! (your WC batch file goes here)
  558.  
  559.  
  560.              Using the supplied SWAP.CFG program, the BATch file might be as
  561.         shown below. This is a sample only. You can run the SWAP.EXE program
  562.         AT ANY TIME to produce your own batch file based on your
  563.         configuration. This is ideal for testing your setup.
  564.  
  565.         COPY C:\WC30\ROTATE\GOODBYE\GOODBYE2.BBS C:\WC30\DISP\GOODBYE.BBS
  566.         COPY C:\WC30\ROTATE\GOODBYE\GOODBYE2.SCR C:\WC30\DISP\GOODBYE.SCR
  567.         COPY C:\WC30\ROTATE\HOLIDAYS\LABOUR.BBS C:\WC30\DISP\HELLO1.BBS
  568.         COPY C:\WC30\ROTATE\HOLIDAYS\LABOUR.SCR C:\WC30\DISP\HELLO1.SCR
  569.  
  570.         Note the hierarchy. 
  571.              The GOODBYE screens are copied first. The HELLO1 screens are then
  572.         copied provided there is not a holiday AND the path/filenames are the
  573.         same. In the example above, there *IS* a holiday. Therefore the HELLO1
  574.         files will not be copied because on my system, they are directed to
  575.         the same output path/filename as the HOLIDAY screens.
  576.  
  577.              As an added note here; if there happens to be a VARIABLE HOLIDAY
  578.         falling on the SAME DAY as a FIXED HOLIDAY, the FIXED HOLIDAY screen
  579.         will be rotated UNLESS the VARIABLE HOLIDAY and the FIXED HOLIDAY
  580.         output paths are different. 
  581.  
  582.              A reminder that if the HOLIDAYs are going to a DIFFERENT filename
  583.         than the HELLO files, they will both be produced. Also, don't forget,
  584.         if you are using DIFFERENT filenames for the HOLIDAY screens (i.e.
  585.         HELLO2.BBS) then your nightly BATCH file must account for this.
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.                                                                   Page 9 of 12
  593.  
  594.  
  595.  
  596.  
  597.         SWAP v2.0                                                12 October 92
  598.  
  599.          In the batch example above, it might go like this:
  600.  
  601.         @ECHO OFF
  602.         WCPRO NEWUSERS
  603.         FLOP
  604.         CD C:\WC30\ROTATE
  605.         ECHO:
  606.         IF EXIST C:\WC30\DISP\HELLO2.BBS DEL C:\WC30\DISP\HELLO2.*
  607.         SET SWAPLOG=C:\FILES\SWAPLOG.LOG
  608.         SWAP
  609.         SET SWAPLOG=
  610.         CALL COPYIT.BAT
  611.         ECHO:
  612.         CD C:\WC30
  613.         WCPRO NEWFILES 
  614.  
  615.              Note the above example checks for the existence of HELLO2.BBS and
  616.         deletes both the .BBS and .SCR files and any other file with the
  617.         filename of HELLO2. (HELLO2, in this case, is a HOLIDAY screen).  Note
  618.         also that this must be done BEFORE SWAP is run - or at least before
  619.         you call the COPYIT.BAT.
  620.  
  621.                                                   
  622.                                      Almost done! 
  623.                                                   
  624.  
  625.         Just one more example. 
  626.  
  627.         Here is an example of a nightly EVENT batch file with a command line
  628.         specified configuration file:
  629.  
  630.         @ECHO OFF
  631.         WCPRO NEWUSERS
  632.         FLOP
  633.         CD C:\WC30\ROTATE
  634.         ECHO:
  635.         SET SWAPLOG=D:\SWAP.LOG
  636.         SWAP 1STNAME.CFG    Swap executed with specific items in 1STMAME.CFG
  637.         CALL MY1STBAT.BAT   Call the batch file (instead of COPYIT.BAT)
  638.         SWAP 2NDNAME.CFG    Swap executed with specific items in 2NDNAME.CFG
  639.         CALL MY2NDBAT.BAT   Call another batch file (instead of COPYIT.BAT)
  640.         SWAP                Swap executed with default .CFG (SWAP.CFG)
  641.         SET SWAPLOG=
  642.         CALL COPYIT.BAT     Call the default batch file
  643.         ECHO:
  644.         CD C:\WC30
  645.         WCPRO NEWFILES 
  646.  
  647.         (Note:    the .BAT files above are specified in the different .CFG
  648.                   files as explained earlier)
  649.  
  650.              If you are still confused, see the file called EXAMPLES.TXT for
  651.         further examples of .CFG .LST and other files.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.                                                                  Page 10 of 12
  659.  
  660.  
  661.  
  662.  
  663.         SWAP v2.0                                                12 October 92
  664.  
  665.         Support:
  666.         =======
  667.              Minimal.  This program does what I want it to do.  I am not a
  668.         prolific programmer, and SWAP will not likely be updated further
  669.         except if bugs are found. If you have a suggestion, feel free to drop
  670.         me a message in MSI's "3rd Party" conference or MSI's "OFF TOPIC
  671.         ECHO". If you have a question, please ensure you have read this wordy
  672.         documentation carefully and noted all the hazard areas (ie. no comma
  673.         delimiters, missing lines in .CFG files, etc). If you are convinced
  674.         you cannot solve the problem, ZIP me your .LST files and .CFG file and
  675.         a[t]tach it to a message for me. I will have a look at the files and
  676.         get back to you. If you intend using VARIABLE HOLIDAY lists, then
  677.         PLEASE PLEASE PLEASE read the HOLIDAYV.DOC file CAREFULLY.  I can't
  678.         stress this enough.
  679.  
  680.  
  681.         ERRORS
  682.         ======
  683.  
  684.         1.   Non-fatal errors and other comments, such as no HELLO.LST file
  685.              (blank line instead), are logged directly to the BATCH file. Read
  686.              the BATCH file after you have run the program to get an idea of
  687.              what I am talking about.
  688.  
  689.         2.   The SWAP.EXE program will HALT if there is:
  690.              a.   an INVALID filename specified for the .LST files (you need
  691.                   not have a .LST file, but you must have a blank line
  692.                   instead)
  693.              b.   an INVALID or NO batch file specified, or SWAP can't find it
  694.                   in the directory from which SWAP was run.
  695.              c.   an Illegal DOS filename for the .LST or .BAT file.
  696.  
  697.              This allows debugging a .CFG file BEFORE installation. If you
  698.         don't get anything else right -- make sure you set up the config
  699.         file(s) properly.
  700.  
  701.  
  702.         Beg for $$$
  703.         ===========
  704.              If you find this program useful, I would appreciate (who
  705.         wouldn't) a donation of a Nine dollars and 45 cents. ($9.45)
  706.         -=>or<=- 
  707.         send me a disk with some of your own specialized programming examples 
  708.         -=>OR<=- 
  709.         if you are as broke as I am, just send a postcard letting me know that
  710.         you are using and appreciate the program.
  711.  
  712.              Note that I am not going to go into the poor-house if I don't get
  713.         any monetary support on this. However, it could serve as encouragement
  714.         for me to update this program as ideas flow in, or even write more
  715.         programs??
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.                                                                  Page 11 of 12
  725.  
  726.  
  727.  
  728.  
  729.         SWAP v2.0                                                12 October 92
  730.  
  731.         My mailing address is:
  732.  
  733.              T.L. Atkinson
  734.              28 Savona Ct.
  735.              Dartmouth, NS
  736.              Canada B2W4R1
  737.  
  738.         You may contact me on CI$ at 75376,1277 or...
  739.  
  740.         Current updates to this file (if any) may be found on:
  741.         1.   ADSUM Wildcat! BBS 902-434-3121 HST DS v.32/435-2455 v.32,
  742.              Dartmouth. You must be a verified user to gain download access.
  743.         2.   MSI HQ (Mustang's BBS)
  744.         3.   Charlatan's Cabin BBS
  745.         4.   CI$ BBS Users Forum (GO IBMBBS) or CI$ PCVENA (Mustang Forum).
  746.  
  747.  
  748.         AGREEMENT TERMS
  749.         ===============
  750.  
  751.         o    You may not modify the program in any way, shape, or form
  752.  
  753.         o    You may redistribute the shareware version as long as all files,
  754.              including documentation, are included and the filename is entered
  755.              as SWAP12.xxx (xxx=ZIP, LZH, ARC, ARJ, etc)
  756.  
  757.         o    You may not SELL this program. A small fee may be charged for
  758.              distribution.
  759.  
  760.         o    If you find the program useful, you must register it as described
  761.              above.
  762.  
  763.         o    This software is provided "as-is" without warranty of any kind,
  764.              either expressed or implied.
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.                                                                  Page 12 of 12
  791.  
  792.  
  793.