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