home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / WILDCAT / ISCALLN1.ZIP / ISCALLN.DOC < prev    next >
Text File  |  1994-03-05  |  7KB  |  161 lines
  1.                                     IsCallN
  2.      A Public Domain Utility for DOOR.SYS-Supporting Bulletin Board Systems 
  3.        (Source Code available on the UniNova Support BBS: [509] 925-3893)
  4.  
  5.      DISCLAIMER:
  6.      -----------
  7. This software is public domain; the original publisher (UniNova Services
  8. Corporation) hereby refuses liability for your use, misuse, or inability
  9. to use the program in any manner.  By using the software, you agree to
  10. accept full liability and responsibility for any effects of the software
  11. on your system.  
  12.  
  13.      COPYRIGHT:
  14.      ----------
  15. There is no copyright associated with this program -- it is truly in the
  16. public domain and you may do with it as you please.  If you distribute it
  17. without modifications, you are -requested- to include this document with
  18. the program.  There is no legal requirement for this, however, as the
  19. nature of property in the public domain excludes such requirements.
  20.  
  21.      PURPOSE:
  22.      --------
  23. By using this program, you can determine whether or not the caller currently
  24. in the door, for which the DOOR.SYS file was created, is logged on to the
  25. BBS for the nth time.  As an example, using Wildcat! 3.90, you could use
  26. this program to perform certain processing from the LOGIN1.BAT file on a
  27. caller's first call -- or 100th call.  Perhaps a welcoming message, or a
  28. "Thank you for being so loyal" message, could be sent on a specific call,
  29. using a product such as PostMaster to import the message.
  30.  
  31. The program is general enough to allow you some creativity with it.  If you
  32. feel you have found a new and unusual use for it, UniNova is curious to hear
  33. how people will use it.  You may log on to the UniNova Support BBS at the
  34. number shown above, or send a FAX to the same number, to tell your story.
  35. You can also send a letter or postcard to the address appearing at the end
  36. of this document.  Obviously, there is no requirement for this; however, if
  37. you do relate a story, it should be done with the understanding that your
  38. tale may be retold in the UniNote (UniNova's quarterly newsletter) unless
  39. you specify otherwise.
  40.  
  41.      INSTALLATION:
  42.      -------------
  43. Simply place a copy of ISCALLN.EXE in the directory of your choice; a general
  44. utility directory, your BBS "home" directory, or any other location -- just
  45. remember where you put it.
  46.  
  47.      USAGE:
  48.      ------
  49. From within the door batch file of your choice, simply add a call to the
  50. program, and check the DOS ERRORLEVEL after the program exits.  (If the
  51. idea of checking errorlevels is unfamiliar to you, you may wish to review
  52. the topic in your DOS manual.  However, the examples here may suffice.)
  53.  
  54. The syntax is:
  55.  
  56.      ISCALLN # d:\path\door.sys
  57.  
  58.      # : This is a number indicating the call you want to take action on.
  59.          If, for example, you want to send a "Thank you" message to every
  60.          caller on their 100th call, you would use 100 for this parameter.  
  61.      
  62.      d:\path\door.sys :  This is the complete path (including drive if
  63.          need be) and filename for DOOR.SYS.  If the program can't open
  64.          the file as you specify it here, it'll let you know.
  65.  
  66. The error levels returned by the program are:
  67.  
  68.      0 : This is NOT the caller's nth call
  69.      1 : This IS the caller's nth call
  70.      5 : Error: Insufficient parameters
  71.      6 : Error: Couldn't open DOOR.SYS
  72.      7 : Error: End of DOOR.SYS reached unexpectedly
  73.  
  74. Please see the batch files below for examples.  Always remember to check
  75. the highest errorlevel first and work your way down, as DOS sees the
  76. expression IF ERRORLEVEL X as "true" for values of X and higher.
  77.  
  78. The program will also display a terse message indicating whether or not a
  79. match was made or if it exited with an error condition.
  80.  
  81.      SAMPLE BATCH FILES:
  82.      -------------------
  83.  
  84. The first batch file mails a "Welcome" message to each caller on his/her
  85. first call, using the PostMaster program.  Directories are just examples
  86. and can be used as shown or altered according to how you have your files
  87. arranged.  The second batch file lets you know that a caller has reached
  88. the 500 call mark by adding a note to your activity log.  Both examples
  89. are for Wildcat! systems; this is not to imply that IsCallN is limited to
  90. Wildcat!  SysOps of other systems are bound to find parallel or other uses.
  91.  
  92.      @echo off
  93.      rem This is the first example batch file
  94.      iscalln 1 c:\wc30\wcwork\node1\door.sys
  95.      if errorlevel 5 goto oops
  96.      if errorlevel 1 goto first
  97.      goto end
  98.      :first
  99.      postmstr /I:WELCOME.TXT /T:DOOR /F:SYSOP /S:Welcome! /P /C:0 /A:RULES.TXT
  100.      goto end
  101.      :oops
  102.      echo Error encountered in ISCALLN program!! >> c:\wc30\activity.001
  103.      :end
  104.  
  105.      @echo off
  106.      rem This is the second example batch file
  107.      iscalln 500 d:\bbs\wcwork\node1\door.sys
  108.      if errorlevel 5 goto error
  109.      if errorlevel 1 goto mark
  110.      goto end
  111.      :mark
  112.      echo ### This user is calling for the 500th time! >> d:\bbs\activity.001
  113.      goto end
  114.      :error
  115.      echo Error encountered in ISCALLN program! >> d:\bbs\activity.001
  116.      :end                                                                 
  117.  
  118.      OTHER COMMENTS:
  119.      ---------------
  120. This program was written by UniNova Services Corporation for its own use,
  121. and released to the public domain to allow other SysOps to take advantage
  122. of its functionality.  A copyright and registration fee were briefly
  123. considered, but abandoned.  SysOps have enough costs without charging for
  124. tiny utilities such as this.  The source code for IsCallN is available for
  125. download from the UniNova Support BBS.
  126.  
  127. You are encouraged to contact UniNova if you are in the market for computer
  128. products!  Hardware, software, accessories...  UniNova also offers a variety
  129. of other services via the UniNova Support BBS, such as "green FAX services",
  130. FriendFind(tm), etc.  (Please note the BBS phone number at the beginning of
  131. this document.)
  132.  
  133. If you would like to add your BBS to the .QWK echo network TUNNIL, which
  134. UniNova operates as part of its support function, please log on to the
  135. support BBS and download the file TUNNIL.LZH, which contains information
  136. about the network.  In addition, UniNova offers documentation services for
  137. shareware authors who would rather not write their own program documentation,
  138. or simply want a professional proofreading prior to distributing their
  139. product.
  140.  
  141. If you'd like to write to UniNova rather than sending a FAX or connecting to
  142. the BBS, you may reach the company at:
  143.                 UniNova Services Corp.
  144.                 PO Box 900
  145.                 Ellensburg,  WA    98926
  146.  
  147.      ACKS:
  148.      -----
  149. All product names and trademarks mentioned in this document are the property
  150. of their respective owners; their appearance here is not intended as an
  151. infringement on ownership rights.
  152.  
  153. Anyone who distributes this program and documentation together, unmodified,
  154. is also hereby acknowledged and thanked -- we'll admit it, parts of it are
  155. unabashed advertising!
  156.  
  157.  
  158.  
  159. IF YOU PRINT THIS DOCUMENT, PLEASE RECYCLE IT WHEN YOU ARE FINISHED WITH IT.
  160.  
  161.