home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1996 December / CD_shareware_12-96.iso / DOS / Comunic / CIDNPOP2.ZIP / CIDNPOP.DOC < prev    next >
Encoding:
Text File  |  1996-07-31  |  5.7 KB  |  141 lines
  1.                     CIDNPOP v2.0 (BETA) by Don Ludington
  2.  
  3. CIDNPOP is a small utility that will extract the CID number from the Portal
  4. of Power log file, and allow you to pass it to your BBS program via the
  5. BBSBATCH.BAT file.
  6.  
  7.  
  8. SETTING UP YOUR SYSTEM TO USE CIDNPOP:
  9. --------------------------------------
  10.  
  11. For CIDNPOP to operate, you will need to modify the batch file that controls
  12. Portal of Power when a human caller calls into the BBS.  First of all, you
  13. must have Portal create a BBSBATCH.BAT file to load your BBS program. Then
  14. you must modify your POP.BAT file to run CIDNPOP before running BBSBATCH.BAT,
  15. like so:
  16.  
  17. <Extracted from POP.BAT file>
  18.  
  19.     If ERRORLEVEL 201 Goto Human  <-This is the errorlevel that I use.
  20.  
  21.     :Human
  22.         CIDNPOP        <- This runs CIDNPOP to add the CID # to BBSBATCH.BAT!
  23.         BBSBATCH       <- This runs BBSBATCH.BAT to load the BBS program.
  24.         Goto Start     <- Returns to load Portal if something goes wrong.
  25.  
  26.  
  27. Sample BBSBATCH.BAT file:
  28. ------------------------
  29.  
  30.     SPAWNBBS 14400 2 695 0 38400 ARQ
  31.  
  32.  
  33.         (SPAWNBBS.BAT documentation explaining the Portal variables)
  34.  
  35.    ╒═══════════════════════════════════════════════════════════════════════╕
  36.    │                         SAMPLE SPAWNBBS.BAT                           │
  37.    │                        Portal Of Power 0.62Γ                          │
  38.    ├───────────────────────────────────────────────────────────────────────┤
  39.    │                   THIS EXAMPLE IS BASED ON MAXIMUS                    │
  40.    ╞═══════════════════════════════════════════════════════════════════════╡
  41.    │ NOTE: To optimize the execution-speed of this batch-file, you can     │
  42.    │ remove all REM lines. (But do keep a backup of the original file for  │
  43.    │ future reference)                                                     │
  44.    │                                                                       │
  45.    │ Var  Description               Example                                │
  46.    │ ───────────────────────────────────────────────────────────────────── │
  47.    │ %1   Baud rate                 9600      2400                         │
  48.    │ %2   Port number               1         1                            │
  49.    │ %3   Time to next event (min)  60        40                           │
  50.    │ %4   Task number               0         0                            │
  51.    │ %5   DTE Speed                 19200     2400                         │
  52.    │ %6   Rest of connect string    /ARQ                                   │
  53.    ╘═══════════════════════════════════════════════════════════════════════╛
  54.  
  55.  
  56. Sample SPAWNBBS.BAT File:
  57. ------------------------
  58.  
  59.     @ECHO OFF
  60.     CD\RG
  61.     RENEGADE -B%1/%6 -X%3 -Q -N1 -I%7   <- Here I load my BBS program.
  62.     If ERRORLEVEL 2 Goto EchoMail          The -I%7 is the CID string.
  63.     Goto End
  64.     :EchoMail
  65.        (Here I handle mail entered while the user was online)
  66.     Goto End
  67.     :End
  68.         CD\
  69.         C:\RUNPOP          <- Here I run RUNPOP.BAT to reload Portal.
  70.  
  71. Notice that when Renegade is loaded above, I use -I%7 in the command line.
  72. This is the command switch to load the CID number from the commandline, and
  73. where CIDNPOP stores the CID number extracted from the Portal log file. All
  74. you need to do is add the proper switch for your BBS program to your
  75. SPAWNBBS.BAT file, plus the %7, and you should be off and running with the
  76. CID number being passed to your BBS program.
  77.  
  78.  
  79. CIDNPOP.CFG File:
  80. ---------------
  81.  
  82. Here is the format and explanation of the CIDNPOP.CFG file that makes the
  83. program work:
  84.  
  85.     C:\POP\PORTAL.LOG   <- Full path and name of your Portal log file.
  86.     C:\POP\BBSBATCH.BAT <- Full path and name of your BBSBATCH.BAT file.
  87.     ARQ                 <- The string that your modem sends to indicate that
  88.                            a reliable error correcting session has been made
  89.                            with the remote system.  Most systems will use
  90.                            ARQ or REL. CIDNPOP uses this to decide if a dummy
  91.                            argument needs to be used in the BBSBATCH.BAT
  92.                            file.
  93.  
  94. The program does check for the existance of the config file, and it verifies
  95. the existance of the portal.log and the bbsbatch.bat path/name as entered in
  96. the config file.  If there is an error, the system will BEEP, but the BBS
  97. will load and run uninterupted.  However the CID info will not be processed.
  98. I did this to make sure that the program wouldn't hang your system for hours
  99. with an error message on the screen, so if you hear it beep, there is a
  100. problem.  You will need to verify that the config file is in the directory
  101. that the exe is called from, and that the information in the config file is
  102. correct.
  103.  
  104. Output Examples (with and without using CIDNPOP):
  105.  
  106. 1)  BBSBATCH.BAT for a 2400 baud non-error correcting modem without CIDNPOP:
  107.  
  108.         SPAWNBBS 2400 2 120 0 38400
  109.  
  110.     Using CIDNPOP:
  111.  
  112.         SPAWNBBS 2400 2 120 0 38400 BBS ###-###-####
  113.  
  114. 2)  BBSBATCH.BAT for a 14.4 baud error correcting connection without CIDNPOP:
  115.  
  116.         SPAWNBBS 14400 2 345 0 38400 ARQ
  117.  
  118.     Using CIDNPOP:
  119.  
  120.         SPAWNBBS 14400 2 345 0 38400 ARQ ###-###-####
  121.  
  122.  
  123.  
  124.                         -= CONTACTING THE AUTHOR =-
  125.  
  126. The best method of contact is via The Rebel's Yell BBS, 1-703-494-4470.
  127.  
  128.     My network addresses are:
  129.  
  130.             FidoNet   1:265/0 or 1:265/118
  131.             RGSNet    50:57/0 or 50:520/0 or 50:520/104
  132.             ITCNet    85:887/0 or 85:887/84
  133.             Internet  don_ludington@f118.n265.z1.fidonet.org
  134.  
  135.     Of course, you can also reach me via "snail mail" at:
  136.  
  137.             Don Ludington
  138.             1605 Lakewood Drive
  139.             Woodbridge, VA 22192
  140.  
  141.