home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / oct93 / comm / 4d-bbsdemo.lha / 4D-BBSDemo / Docs / 10.Doors < prev    next >
Text File  |  1993-07-02  |  4KB  |  124 lines
  1.  
  2. Chapter 10
  3.  
  4.  
  5.                 Doors and External Programs
  6.  
  7.  
  8. 10.1.0 Introduction
  9.  
  10. Doors are separate programs that can communicate with the BBS.  They
  11. come in many forms, games, utilities, ect,  and can be found on
  12. many BBS's.  It is not guaranteed that all doors will work on 4D-BBS.
  13. They may have been written for another BBS and may not be fully
  14. compatable.
  15.  
  16. 10.1.1 Types
  17.  
  18.      On 4D you can run three types of Door programs.
  19.  
  20.          1: ARexx
  21.          2: Paragon
  22.          3: Cli (StdIO/FIFO)
  23.  
  24. 10.1.2 ARexx Doors
  25.  
  26. In the cfg_ed you can set up the port name you wish to use for your
  27. ARexx port. The default is '4D-BBS'. If you run a multi-line BBS,
  28. 4D-BBS will automatically add a number to the end of your port name.
  29.  
  30. For Example:
  31.  
  32. line 0: Port Name '4D-BBS'
  33. line 1:  "     "  '4D-BBS1'
  34.  
  35. For specific ARexx commands see the Appendix 3.
  36.          
  37. Usually all that is required for a ARexx door to run on 4D-BBS is to
  38. change the address to the ARexx port name.  Or also you can pass it
  39. the ARexx port name as an argument by using 4D-BBS's embedded
  40. instructional code for the ARexx port name.   ^]WT%
  41. This will require a good understanding of ARexx if the script is not
  42. set up to handle this.
  43.  
  44. You can find an example of this in whoson4d.rexx
  45.  
  46. A simple menu example on how to start a ARexx door
  47.  
  48. H:c A Path/filename.rexx
  49.  
  50. H is the keypress
  51. c is for door
  52. A is the type of door  (A,P,O,F)
  53.  
  54. Note: see menu options
  55.  
  56. 10.1.3 Paragon Door Types
  57.  
  58.          Usually installing a Paragon door is very simple. You have
  59. to have a directory devoted to doors and assign DOORS: to it. Many
  60. doors require that subdirectories be set up for them (you will have
  61. to read their docs about this).
  62.  
  63.          4D-BBS has two ways to run a Paragon door. The best way is
  64. to use the door option of 'P'. 4D-BBS will check to make sure the door
  65. opens a reply port to prevent the BBS from hanging in the door mode. 
  66. If the reply port can not be found 4D-BBS will return. 
  67.  
  68. A simple menu example:
  69.  
  70. h:c P Doors:filename
  71.  
  72.          The other way to run a Paragon type door is to use the door
  73. option of 'O'.  Some Paragon doors will not work using the 'P' option
  74. because they don't open a properly names reply port.  4D-BBS will not
  75. check for a reply port and start waiting for commands with the door
  76. option of 'O'.
  77.  
  78. A simple menu example:
  79.  
  80. h:c O Doors:filename
  81.  
  82.  
  83. 10.1.4 CLI (FIFO)
  84.  
  85.      To use this option you must have Matt Dillion's FIFO. It is 
  86. in the public domain. You need fifo.library in your libs: directory
  87. and also run the fifo-handler. Read the docs that come with fifo
  88. for more details. FIFO is available at 4D-BBS support BBS.
  89.  
  90.      Any program that does not detach its self from the stdin &
  91. stdout or open a window should be able to be ran with this option.
  92. Ususally if it will run on a CLI (with output to the cli) it will work
  93. here. Example: 4D-BBS editors could be ran as a fifo door! If a user
  94. hangs up during a FIFO door, 4D-BBS will send a ctrl-C to try to abort 
  95. the program. It is suggested that you only run programs that will abort
  96. on a ctrl-c.
  97.  
  98. A simple menu example:
  99.  
  100. h:c F path/filename
  101.  
  102. or with embedded instructional code (EIC)
  103.  
  104. h:c F doors:h&s/HSclient -tP7% "P3%"
  105. the P7% being time left on BBS & P3% is the users name. Use quotes
  106. around any EIC that may have a space.
  107.  
  108.      There is also a built in SHELL you can start with this option.
  109. This works VERY well for remote access. But WARNING!! keep it out
  110. of the reach of users. It is just like using the cli, except you can
  111. not click requesters. 
  112.  
  113.      To run the SHELL use '4D-SHELL'. It is Case sensitive.
  114.  
  115. example:  s:c F 4D-SHELL
  116.  
  117.  
  118.  
  119.  
  120.  
  121.          
  122.  
  123.  
  124.