home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / new / comm / bbs / 4d-bbsdemo / docs / text / 06.file_transfers < prev    next >
Text File  |  1993-12-28  |  14KB  |  373 lines
  1. Chapter 6:
  2.  
  3.  
  4.         File Transfers
  5.  
  6.  
  7. 6.1.0 Overview
  8.  
  9. 6.2.0  The File Catalog Editor
  10.  
  11.  
  12.  
  13.         4D-BBS FCL_ED DOCUMENTATION, (C) 1993 CornerStone Software.
  14.                   Written by Jeff Holden   Feb 12, 1993
  15.                          FCL_ED V2.65 and above.
  16.  
  17.  
  18.    4D-BBS, CLP and EIC are registered tradmarks of CornerStone Software.
  19.  
  20.  
  21. As a multi functionable executable editor, you have 4 ways of running
  22. this software, they are broken down into 2 catagories.
  23.  
  24. 1  Command mode
  25. 2  Silent mode
  26.  
  27. The editors may be run through workbench, shell/cli, script, or as a door.
  28.  
  29. In command mode you are allowed to edit everything (options via keys),
  30. however in silent mode (NOT available if running as a door) the editor
  31. is not viewable, nor is keyboard input. In silent mode you pass all
  32. options to the editor via the command line parameters (CLP).
  33.  
  34. In silent mode, options are carried out without the veiwable editor, this
  35. is very handy for maintenance scripts and fast updating without starting
  36. up the full editor.
  37.  
  38. FCL_ED does not detach from the CLI when run, if you want it to (running in
  39. silent mode) use the 'Run >NIL: fcl_ed (options)' and your script/cli
  40. will continue with the editor running in the background.
  41.  
  42. The following CLPS tell the editor certain specific information in which the
  43. editor needs to know in order to run. (In Command OR Silent mode)
  44.  
  45. *** CLPS ARE CASE SENSITIVE **
  46.  
  47. (# = a number)
  48. ($ = String (filename/name/etc.)
  49.  
  50.  
  51. OPTION    Description               Supporting OPTS     DEFAULTS
  52. ---------|-------------------------|-------------------|-------------
  53.  -b$      Path/assign to BBS:          All but -f          BBS:
  54.  -c       Convert from old          All    but -f          Defaults to editor
  55.  -d$      Path/filename of datafile All    but -f          BBS:FileDefs.d
  56.  -r#      Rows displayable          All    but -f          10 rows (Lists)
  57.  -a$         On-Line Arexx update      All but -f          NONE
  58.           (This tells the editor to update 4d-bbs on changes)
  59.  
  60. If none of the above are given the defaults will be used.
  61.  
  62. If running as a door, the door will tell 4d about the changes (If any).
  63. Door running can only be accomplished if using 4D-BBS SERIES IIA V1.00
  64. and above extended door protocols.
  65.  
  66. If running through 4D-BBS function keys or pull down menus, WITH THE
  67. ONLINE UPDATE option ON, 4D will be notified of any changes via the
  68. arexx port name passed to the editor (-a$).
  69.  
  70. Special CLPS
  71.  
  72. ** -s #
  73. To initialize a silent mode you must give the '-s' CLP followed by a #, the
  74. number represents the file library you wish to silently edit/change/delete.
  75.  
  76. ** -f $
  77. A generic string specifier. If changing names or overriding default filepaths 
  78. and etc. Use the -f (Only for silent mode use, and ONLY where the -f is 
  79. supported ; almost all silent mode options support the -f CLP ).
  80.  
  81. ** NOTE ** only do one operation (changing name or ??) per run.
  82. Do NOT try to pass CLPS to the editor which specify two diff tasks. EX:
  83. dont try to explore the catalog, and change file section twos' filename
  84. in the same run.  CLP conflicts may arise.
  85.  
  86. The following is a list of silent mode options, ** Remember, the silent
  87. mode must be initiated with the -s# CLP. Options tend to follow the same
  88. keypresses you would have done if running in command mode.
  89.  
  90. In order to jump right to the editing point, the silent mode CLPS are
  91. setup as a string, each character in the string has a useful function
  92. and directs the editor as to where to do the editing.
  93.  
  94. _________________________________________________________________________
  95.  
  96. -E             This initializes the GENERAL LIBRARY SECTION EDITING.
  97.                2 characters MAX for this CLP. EX: -Ed tells the editor
  98.                to DELETE the library number in -s CLP.
  99.  
  100.                The second character can be one of the following:
  101.  
  102.                f    This will cause the editor to re-count all the files
  103.                     in the sections, and place the TRUE cataloged entries
  104.                     in the libraries count number. It will also total all
  105.                     the files cataloged and place it in the system stats
  106.                     data file. This is very handy if you Explore/Find
  107.                     files, saved the catalog but forgot to save the
  108.                     updated library counts.
  109.  
  110.                d    This will delete the library # found in the -s CLP
  111.                     all together, The actual files in its directory will
  112.                     NOT be deleted.
  113.      
  114.                END OF GENERAL LIBRARY SECTION EDITING CLPS
  115. _________________________________________________________________________
  116.  
  117. -e ...         This initializes the specific LIBRARY SECTION EDITING.
  118.                2 characters MAX for this CLP. EX: -ea tells the editor
  119.                to change this libraries name to whatever is in the -s
  120.                CLP.
  121.  
  122.                The second character can be one of the following:
  123.      
  124.                a    This is the new name you wish this library to be  
  125.                     known as. The name will be in the -f CLP.
  126.  
  127.                b    This tells the editor to place the path in -f CLP
  128.                     as this libraries file path (Where to find files
  129.                     for this section, section is found in -s CLP).
  130.                
  131.                c    Tells the editor that this library has an extended
  132.                     description base.. The Message base number to place
  133.                     in this libraries base # is in the -f CLP.
  134.  
  135.                d    New amount of files for this library, file count
  136.                     is found in the -f CLP.
  137.                
  138.                e    Status of this library in comparison to files.
  139.                     1 of the 2 following must be found in the -f CLP
  140.                     and ** ARE CASE SENSITIVE **
  141.                     
  142.                          A    Ask if file is private.
  143.                          P    Private library.
  144.  
  145.                     If neither of the above are found, the editors assumes
  146.                     the library is supposed to be a public one.
  147.  
  148.                f    Library opens at this hour. Ex: 6:00pm = 14, 
  149.                     the hour can be found in the -f CLP.
  150.  
  151.                g    Library Closes at this hour. Ex: 4:00am = 4, 
  152.                     the hour can be found in the -f CLP.
  153.  
  154.                h    Current (Right NOW) status of the library (overrides
  155.                     users access) and is a digit (0 through 4) found in 
  156.                     the -f CLP.
  157.                     
  158.                          0  Closed
  159.                          1  Open
  160.                          2  D-Load 
  161.                          3  U-Load
  162.                          4  Hide
  163.         
  164.                i    Sets the New user access level for this library to 
  165.                     whatever is in the -f CLP, IF the char is in 
  166.                     uppercase, its considered to be scanable, If in lower 
  167.                     case, its masked out.
  168.  
  169.                     The char in -f CLP can be one of the following
  170.  
  171.                     D    (Library is Download only)
  172.                     U    (Library is Upload only)
  173.                     B    (Upload and downloading available)
  174.                     N    (No access, closed library)
  175.             
  176.                j    Same as above (i) but effects MEMBERS.
  177.                        
  178.                k    Full path and filename of binary file catalog (where
  179.                     entry names and information is stored). Found
  180.                     in -f CLP.
  181.  
  182.                END OF SPECIFIC LIBRARY SECTION EDITING CLPS.
  183. _________________________________________________________________________
  184.  
  185. -l ...         This initializes the specific section CATALOG EDITING.
  186.                2 characters MAX for this CLP. EX: -lc -f3 tells the editor
  187.                to sort the catalog list by file name [alphabetically],
  188.                for whatever library section was found in the -s# CLP.
  189.  
  190.                The second character can be one of the following:
  191.  
  192.                f    Search for descriptionless entries and append the
  193.                     uploaders description file to prompt for descriptions.
  194.  
  195.                c    Compare/Sort the entries (Follows 1-6 options in command
  196.                     mode). The -f CLP cont