home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / RBTCH220.ZIP / DOCS.ZIP / WHATISA.DOZ < prev   
Text File  |  1993-04-09  |  7KB  |  185 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                        -------------------
  14.                        What is a .DOZ File
  15.                        -------------------
  16.  
  17.  
  18.  
  19.                    .DOZ File Internal Structure
  20.                     (C) by Dan Shore - 1992,93
  21.                         THE SHORELINE BBS
  22.                         December 18, 1992
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39. A.  Why the .DOZ file was created:
  40.  
  41.  
  42. 1.  For files that do not have the ability to accept a FILE_ID.DIZ
  43.     or a DESC.SDI.  What types of files are these do you ask?  Well,
  44.     any file that cannot accept another file "inside" of a file
  45.     (.GIF's are an excellent example).  Remember that the .DIZ or
  46.     .SDI are just text files that are added into compressed files.
  47.  
  48. 2.  When a .DOZ file is uploaded or used locally, with descriptions
  49.     and category codes, the files uploaded are processed by RBatch
  50.     for the file description and the category code without any
  51.     intervention by the user or SysOp.  Basically AUTOMATIC UPLOADS!
  52.     As a user, just start the upload process and sit back and watch
  53.     your files posted to the BBS automatically.  As a SysOp, just run
  54.     FakeXfer, then RBatch, and again just SIT BACK AND WATCH FILES
  55.     GET POSTED TO YOUR BBS AUTOMATICALLY!!.
  56.  
  57. 3. ****************************************************************
  58.    * REMEMBER THAT YOU ONLY NEED ONE (1) .DOZ FILE WHEN UPLOADING *
  59.    * OR POSTING FILES LOCALLY.  All the filename are listed in    *
  60.    * this one .DOZ file.  YOU SHOULD NOT HAVE MULTIPLE .DOZ       *
  61.    * FILES AS THIS WILL NOT WORK WITH RBATCH.                     *
  62.    ****************************************************************
  63.  
  64. NOTE:----------------------------------------------------------------
  65.  
  66. .DOZ files are VERY USEFULL when you are posting files LOCALLY
  67. to your BBS, when used in conjunction with the FakeXfer program.
  68. See the FakeXfer.Doc file for more information on this excellent
  69. new process that saves time for SysOps who post files to their BBS.
  70.  
  71. Also, the program CAP2DOZ (CAP2DOZ.ZIP) makes creating a .DOZ file
  72. so simple, that it is hard not to use a .DOZ file when posting files
  73. locally on your BBS!
  74. ---------------------------------------------------------------------
  75.  
  76.  
  77. The .DOZ filename can be named anything as long as it is a legal
  78. DOS filename.  Here is an example of a .DOZ file is shown here
  79. with the internal structure of a .DOZ:
  80.  
  81.  
  82.                 {FI dflat8.zip window x
  83.                 Description of file goes here with a maximum
  84.                 line length of 75 characters and a maximum
  85.                 of 10 lines
  86.                 {FI jiklan.zip window
  87.                 Description of file goes here with a maximum
  88.                 line length of 75 characters and a maximum
  89.                 of 10 lines
  90.                 {FI ved201.zip utils n dan shore
  91.                 Description of file goes here with a maximum
  92.                 line length of 75 characters and a maximum
  93.                 of 10 lines
  94.  
  95.  
  96. Line 1 :  ALWAYS STARTS WITH A {FI and then the filename.  Note
  97.           that there is a space between the {FI, filename, &
  98.           the category code.  Do not use a path for the file.
  99.           (The {FI is the  Smart Text variable for FileName in
  100.           RBBS, hence it seemed logical to use this as part of
  101.           the structure)
  102.  
  103.    #####  The text MUST START AT THE LEFT MARGIN.  The example
  104.           above starts in the middle of the screen for ease of
  105.           reading.
  106.  
  107.           The category code is the code that a user would normally
  108.           type when prompted to categorize a file.  This is NOT
  109.           THE THREE DIGIT CODE in your FMS.  For example if your
  110.           DIR.CAT had this entry:
  111.  
  112.           "GAMES","GAM","All Games"
  113.  
  114.           The .DOZ entry would look like this:
  115.  
  116.           {FI WARRIORS.ZIP GAMES
  117.           This is a great graphical warrior game
  118.  
  119.  
  120.           The next field is if you are going to be uploading a
  121.           personal file to the BBS.  If you use a "X", this tells
  122.           RBatch to not prompt the user to see if the file is
  123.           a personal upload or not.  If you use the following
  124.           codes:
  125.  
  126.           N = UserName for personal file
  127.           S = Personal Upload to SysOp (No additional field needed)
  128.           L = Personal Upload to security level
  129.           D = Personal Upload to a distribution list
  130.  
  131.           If you use one of these codes, the RBatch EXPECTS to see
  132.           a value in the next field after this letter (except for
  133.           the SysOp personal upload).
  134.  
  135.  
  136. Line 2 thru 11 :  The description of the file to be posted, with
  137.                   a maximum line length of 80 chars and a maximum
  138.                   of 10 lines.
  139.  
  140.  
  141. --------------------------- IMPORTANT ------------------------------------
  142.  
  143. The .DOZ file is uploaded to a BBS as part of the Uploading process and
  144. can be sent first, in the middle, or last, it does not matter.
  145.  
  146. REMEMBER THAT THE .DOZ FILE CONTAINS "ALL" THE FILENAMES THAT YOUR ARE
  147. UPLOADING OR POSTING LOCALLY.  DO NOT USE MORE THAN ONE (1) .DOZ FILE
  148. WITH RBATCH OR IT WILL NOT WORK.
  149.  
  150. When using .DOZ files for local posting by the SysOp, you want your .DOZ
  151. file TO BE IN THE SAME DIRECTORY as the files that FAKEXFER is processing.
  152. After the fakexfer file is generated, the .DOZ file will be copied to the
  153. upload directory with all the other files.  If the .DOZ file is not in the
  154. upload directory, RBatch will not recognize it, hence you will be prompted
  155. for descriptions/categories.  If the file contains a FILE_ID.DIZ or a
  156. DESC.SDI then the .DOZ file description entry is ignored for that file,
  157. but the catgory code is used!
  158. --------------------------------------------------------------------------
  159.  
  160.  
  161. On the BBS side when the file is received RBatch will detect the .DOZ
  162. file and then compare the filenames in it, to the filename in the
  163. XFER-?.DEF file.  When a match is found, the description within the
  164. .DOZ is used and the user only has to categorize the upload.  If a
  165. category is found within the .DOZ file and it matches a category code
  166. on the BBS, then the user or the SysOp is not prompted to categorize as
  167. long as their security level allows them to categorize.  If the security
  168. level is too low to categorize then the default code that is specified
  169. in the configuration file is used.
  170.  
  171. ************************** AUTOMATED UPLOADS **************************
  172.  
  173. If the file being processed has a FILE_ID.DIZ or DESC.SDI and a .DOZ exists,
  174. file category codes are used from the .DOZ, and the FILE_ID.DIZ/DESC.SDI file
  175. description are used, hence the sysop/user does not have to intervene with
  176. RBatch after the upload is started from RBBS!!!!
  177.  
  178. To aid the user in this new feature, I recommend that you either post
  179. a file or make a bulletin describing how to use .DOZ files with an
  180. upload.
  181.  
  182.                           Dan Shore - SysOp
  183.                           THE SHORELINE BBS
  184.                             301-946-2771
  185.