home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_opus / util170.arj / PHATCH.DOC < prev    next >
Text File  |  1991-07-12  |  3KB  |  105 lines
  1. PHATCH
  2.  
  3. PHATCH is an Opus 1.70-specific pre-processor for HATCH.EXE.  In 
  4. other words, you run it before running HATCH, because HATCH is not 
  5. aware of the new file database structure in Opus 1.70, and you still 
  6. need to add new file names and descriptions to your file database.
  7.  
  8. It enters a hatched file to your Opus 1.70 file database and invokes 
  9. HATCH to generate the corresponding TIC files.  A companion program 
  10. for PTIC, PHATCH uses the same TIC.CFG file and the same requirements.  
  11.  
  12. It uses the same rules as HATCH for finding the TIC.CFG file.  Firstly, 
  13. it looks for the command line switch /C, then for the environment 
  14. variable TIC, and then for TIC.CFG in the current directory.
  15.  
  16.  
  17. Command Line Switches:
  18. ======================
  19.  
  20.     /a   file echo area name
  21.     /c   TIC configuration file name
  22.     /d   file description
  23.     /f   name of file to HATCH
  24.     /l   log file name
  25.     /ON  no wait
  26.     /Rxx release in xx days
  27.     /v   verbose gives very detailed output (for debugging)
  28.  
  29. Most of the above params are the same as for HATCH.  
  30.  
  31.  
  32. Preparing TIC.CFG:
  33. ==================
  34.  
  35. Comment or delete all the FILES.BBS statements like ListFmt and 
  36. ListName from your TIC.CFG file.
  37.  
  38.  
  39. Setting The Environment:
  40. ========================
  41.  
  42. Since Opus 1.70 allows the system dat files and the user file to be
  43. located in a directory other than the Opus home directory, support 
  44. has been added to look up these paths in the Opus prm file.
  45.  
  46. Set up an environment variable labeled OPUS, and specify the full 
  47. pathname of the prm file as follows:  
  48.  
  49.      SET OPUS=H:\OP120\BBS.PRM 
  50.  
  51. If your environment space is cramped, you may leave off the .PRM 
  52. suffix, the program will add it.  BTW, Doug and I are making the 
  53. OPUS environment variable a standard for all the OPUS utilities. 
  54. If you want the C source, just ask.
  55.  
  56. If the OPUS environment variable is not set, the program will look
  57. in the current working directory for USER.DAT and SYSMSG.DAT. If
  58. either file is not found, it will then look for BBS.PRM and look
  59. up the paths in there. If none of the above are found, the program
  60. will fail.
  61.  
  62.  
  63. What Happens:
  64. =============
  65.  
  66. When you invoke PHATCH, here's what happens:  
  67.  
  68. 1.  PHATCH reads your TIC.CFG.  
  69.  
  70. 2.  PHATCH reads your input (via the command line switches or the 
  71.     interactive prompts) to post the file and prepare a command 
  72.     line instruction for HATCH.  
  73.  
  74. 3.  HATCH is invoked to generate the corresponding TIC files
  75.     and post the entry to the default file listing Files.Bbs.  
  76.  
  77. 4.  PHATCH returns (having already read the TIC.CFG) awaiting
  78.     fresh input.  You may default the current file area or enter     a new one. 
  79.  
  80. 5.  PHATCH exits when you hit <ENTER> with no fresh input.  
  81.  
  82.  
  83. John Valentyn 1:114/5@fidonet.org
  84.  
  85. Revision History:
  86. =================
  87.  
  88. v.2   6-26-91
  89. Fixed problem with delete duplicate entry.
  90. Finished code to make log work.
  91.  
  92. v.3  Jun 30 91
  93. Changed PHATCH from a one file per run, to many files per run.
  94.  
  95. v.4 Jul 4 91
  96. Added feature to "remember" the area name.  Saves from having to 
  97. type it in again if hatching to the same area.
  98. Fixed problem with log entries.
  99.  
  100. v.5  Jul 11 91
  101. Fixed problem with /d description command line switch
  102.  
  103.  
  104.  
  105.