home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / c / cn311-sw.zip / MAILCALL.DOC < prev    next >
Text File  |  1991-12-14  |  5KB  |  132 lines
  1. Mailcall Version 3.10: mail packet transfer utility for CircuitNet
  2. hosts. 12-14-91 11:25:44 am
  3.  
  4. Mailcall is a utility that will select the proper mailpacket and
  5. send it via one of Spitfire's external download batch files.  It
  6. requires a command line parameter specifying the complete pathname
  7. of the batchfile to use, or the word "Edit" to edit or create the
  8. data file.  Since Mailcall was Written as a replacement for CircDoor
  9. as written by Sean C. Burbidge, it will recognize and use CIRCDOOR.
  10. DAT as well as MAILCALL.DAT.  It will read in CIRCDOOR.DAT and Write
  11. MAILCALL.DAT in edit mode if MAILCALL.DAT is not found.
  12.  
  13. FILE TRANSFER MODE:
  14.  Overview:  Mailcall reads CIRCUIT.CFG to find the path to the
  15. Spitfire system directory, and the CircuitNEt directories.  It then
  16. looks in the Spitfire System directory for SFDOORS or one of the
  17. compatible files written by SpitFire 3.1.  It looks for SFDOORS.DAT,
  18. SFMAIN.DAT, SFMESS.DAT, or SFFILE.DAT, in that order, and uses the
  19. first that it finds.  It reads the User's NAME, BAUD rate, and the
  20. com PORT from the .DAT file.  It then searches for MAILCALL.DAT, or
  21. CIRCDOOR.DAT, and tries to match the name from the Spitfire Data
  22. file.  When it finds a match, it builds a fully qualified path to a
  23. file in the CircuitNet MAIL directory with node + .ZIP as the
  24. filename.  Mailcall then executes the batch file specified on the
  25. command line, and passes the BAUD, PORT, and FileName in the same
  26. format as used for Spitfire 3.1 external download protocol batch
  27. files. (See SFEXTDN(x).BAT in your Spitfire documentation)  It then
  28. writes a message to the CircuitNet Activity Log specifying the user
  29. and the exit code returned by the Exec function.
  30.  
  31. If an error other than "Circuit.CFG Not found" occurs, Mailcall will
  32. write the error to the Circuitnet error log, and halt with one of
  33. the following errorlevels:
  34.  
  35. 255 -- CIRCUIT.CFG not found
  36. 254 -- No command line specified
  37. 253 -- Batch file specified does not exist
  38. 252 -- SFDOORS.DAT or Equivalent not found
  39. 251 -- MAILCALL.DAT or CIRCDOOR.DAT not found
  40.  
  41. 2   -- User not found in data file
  42. 1   -- No mail to send
  43.  
  44.  
  45.  
  46. Examples:
  47.  
  48. { SFSEC5.BAT }
  49. CD \SF\CIRCUIT
  50. MAILCALL C:\SF\EXTNOD1\SFEXTDNA.BAT
  51. IF ERRORLEVEL 251 THEN FATAL
  52. IF ERRORLEVEL 2   THEN DONE
  53. IF ERRORLEVEL 1   THEN NOMAIL
  54. GOTO DONE
  55.  
  56. :FATAL
  57.  Echo Fatal error in mailcall >> \SF\WORK\HEYSYSOP.LOG
  58.  GOTO DONE
  59.  
  60. :NOMAIL
  61.   rem Put whatever commands you want here to take care of a no mail
  62.   rem packet found condition.
  63.  
  64. :DONE
  65.  
  66.  
  67. EDIT FILE MODE:
  68.  Overview:  When the word EDIT is found on the command line,
  69. Mailcall will read in the CIRCUIT.CFG file, and search the
  70. CircuitNet system directory for either MAILCALL.DAT or CIRCDOOR.
  71. DAT.  It will read the file into memory, and give you the option of
  72. editing a record, deleting a record, adding a record, or listing the
  73. current records to screen or printer.  When you are done editing or
  74. listing the file, it will ask if you wish to save any changes.  If
  75. you answer NO, it will simply exit to dos, otherwise it will Write
  76. all records from memory to MAILCALL.DAT regardless of which file
  77. they were read from.  If neither file is found, then MAILCALL.DAT
  78. will be created if you added at least one record.  If no records
  79. were entered, or all records were deleted, then MAILCALL.DAT will
  80. be deleted.
  81.  
  82.  Another command line option has been added to the EDIT FILE MODE:
  83. This is the Color option.  If you run MAILCALL EDIT mailcall is
  84. defaulted to a Black and White color screen,  if you run MAILCALL
  85. EDIT COLOR you will get a Blue background with White Letters on the
  86. screen.
  87.  
  88. MAILCALL EDIT MODE MENUS:
  89.  
  90.  [E] - Edit a Person in DataBase
  91.  [F] - Edit User DataBase
  92.  [A] - Add User to DataBase
  93.  [P] - Print DataBase
  94.  [Q] - Quit MailCall
  95.  
  96.   Option [E]
  97.     First you will be asked for the user name to be edited in the
  98.   Database, if that user can not be found you will be given a message
  99.   stating the user can not be found and returned to the main menu.  If
  100.   the user was found you will then see the next menu.
  101.  
  102.   [U] - User Name: 702001
  103.   [N] - File Name: 702001.ZIP
  104.     Record Number: 1
  105.   [D] - Delete this User
  106.   [Q] - To Quit this Menu
  107.  
  108.   Option [F]
  109.     This option will allow you to edit or delete a user in the database.
  110.   To move forward or backward in the database use the - or + keys.
  111.  
  112.   [U] - User Name: 702001
  113.   [N] - File Name: 702001.ZIP
  114.     Record Number: 1
  115.   [D] - Delete this User
  116.   [-] - For Previous User
  117.   [+] - For Next User
  118.   [Q] - Quit this Menu
  119.  
  120.   Option [A]
  121.     This option will allow you to add a user to the database.
  122.  
  123.   Option [P]
  124.     This option will allow you to either display the database to the
  125.   screen or to print the database to paper.
  126.  
  127.   Option [Q]
  128.     This option will end the program, but first it will ask you if you
  129.   want to save the changes made to the database.  If you choose not to
  130.   save then all changes made will be lost forever.
  131.  
  132.