home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / PCBDXEXC.ZIP / SETCONFS.DOC < prev    next >
Text File  |  1993-08-21  |  102KB  |  2,194 lines
  1. 6
  2. ==============================================================================
  3.                                                               Conference Setup
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13. Main Board Configuration
  14.  
  15. Conferences
  16.  
  17. Conference Options Screen
  18.  
  19. Sharing Files Between Conferences
  20.  
  21. File Directories
  22.  
  23. Doors
  24.  
  25. Script Questionnaires
  26.  
  27. Bulletins
  28.  
  29. The PCBSetup Main Menu contains two menu items that will help you setup 
  30. conferences.  The first selection will allow you to modify the configuration 
  31. of the Main Board (conference 0) while the second option will allow you to 
  32. select the conference number you want to modify (1-65,535).
  33.  
  34. Main Board Configuration
  35.  
  36. The Main Board is a special conference.  This conference is the base 
  37. conference of PCBoard and it is sometimes referred to as conference 0.  When 
  38. a user abandons a conference they will be returned to the Main Board 
  39. conference.
  40.  
  41. The reason that there are two different menu options on the Main Menu is 
  42. because the following fields that are available in other conference 
  43. definitions would have no effect on the Main Board Conference:
  44.  
  45.     Conference Name
  46.     Public Conference
  47.     Password to Join if Private
  48.     Req. Security if Public
  49.     Auto-Register Flags
  50.  
  51. The Main Board is a public conference by default and the conference that most 
  52. people will login to.  You can lock a user out of the Main Board if you wish, 
  53. by setting the L conference flag in a user's record.
  54.  
  55. For information on all of the fields available in the Main Board 
  56. Configuration screen, please reference the Conferences | Display Files And 
  57. Message Locations and Conference Options Screen sections.
  58.  
  59. Conferences
  60.  
  61. When you select the Conferences option from the Main Menu, you will be 
  62. presented with a list of conferences on your system. You need to select the 
  63. conference that you wish to edit from this list.
  64.  
  65. Selecting a Conference To Edit
  66.  
  67. The screen that lists your conferences looks similar to the
  68. following:
  69.  
  70. To edit a conference, move to the conference you want to edit and press 
  71. ENTER.  The keyboard commands that you can use to move the highlighted bar 
  72. are:
  73.  
  74.    [conf. #]  Anytime that you begin typing a number you will see a field 
  75.               show up on your screen which enables you to go directly to a 
  76.               particular conference.  The field will appear towards the top 
  77.               of the screen as shown in the screen on the following page.
  78.  
  79.       PgDn    View the next 42 conferences in your system.
  80.              
  81.       PgUp    View the previous 42 conferences in your system.
  82.  
  83.       Home    Highlight the first conference on the current screen.
  84.  
  85.       End     Highlight the last conference on the current screen.
  86.  
  87. As you are moving the highlighted bar around, you may notice that it 
  88. disappears once you have passed a certain number.  When the bar disappears, 
  89. it is letting you know that you have passed the number that you entered as 
  90. Number of Highest Conference Desired in PCBSetup | Configuration Options | 
  91. Messages.  Another way that you will know when you have exceeded this number 
  92. is when PCBSetup emits a beep when attempting to edit the conference.
  93.  
  94. Once you have selected the conference you want to edit, press ENTER to see 
  95. the first screen of fields that you may edit relating to that conference.  
  96. When you are editing a particular conference you can press PgDn to go to the 
  97. second configuration screen or press PgDn twice to go to the next available 
  98. conference.  To go to the previous conference, press PgUp.
  99.  
  100. Conference Name / Definition
  101.  
  102. Conference Name
  103.  
  104. In this field, enter the name you wish to use for this conference.  This name 
  105. will be shown at the conference command prompt.  For example, when you are in 
  106. the Chit-Chat conference the conference command prompt will resemble the 
  107. following:
  108.  
  109.  
  110. (13 min. left) Chit-Chat Conference Command?
  111.  
  112.  
  113. This name will also be used if a user attempts to join a conference.  PCBoard 
  114. will search by conference name or by conference number.
  115.  
  116. Public Conference
  117.  
  118. A conference can be configured to be either a public conference or a private 
  119. conference.  A public conference can be joined by anyone if they have 
  120. sufficient security to do so (see the discussion about the Req. Security if 
  121. Public field on this screen for further information).  A private conference 
  122. requires that a user be registered (the R conference flag is set in their 
  123. user record)  in order for them to join the conference.
  124.  
  125.         N       The conference will be considered a private conference. Users 
  126.                 must be registered in the conference before they may join the 
  127.                 conference.
  128.  
  129.         Y       The conference will be a public conference.  In order to join 
  130.                 a public conference, the user must have a security level that 
  131.                 is greater than or equal to the value you enter in the Req. 
  132.                 Security if Public field.
  133.  
  134. Req. Security if Public
  135.  
  136. If you have defined your conference to be a public conference, you should 
  137. enter the security level that is required to join the conference in this 
  138. field.  If a user attempts to join a conference and they do not have 
  139. sufficient security, they will not be allowed to join the conference.
  140.  
  141. One exception to this rule is, PCBoard will allow the user to join the public 
  142. conference if the R flag has been set in their record.  This would allow you 
  143. to manually register users in a public conference even if the security level 
  144. requirements are not met.
  145.  
  146. Password to Join if Private
  147.  
  148. If you have defined a conference as a private conference, you can have 
  149. PCBoard automatically register your users in the conference if they know the 
  150. proper password.  This would be a good situation where you want to enable 
  151. only a select few individuals into a conference but do not want to manually 
  152. register all of the users.  If a user that is not registered in the 
  153. conference attempts to join the conference, they will be prompted for a 
  154. password.
  155.  
  156. The user will be given one attempt at guessing the password each time they 
  157. attempt to join the private conference.  If the user gets the correct 
  158. password, PCBoard will register the user in the conference with an R flag.  
  159. By doing this, the user will not have to enter the password each time they 
  160. join the conference.
  161.  
  162. If you decide you want to change the password, you may want to de-register 
  163. all users in the conference via System  Manager | Users File Maintenance | 
  164. Remove Group Conference.  After you do this, all users would have to re-enter 
  165. the correct password to become registered in the conference again.
  166.  
  167. NOTE:  To help deter hackers from gaining access to a conference, PCBoard 
  168. will hang up on the caller if they fail to get the right password after 8 
  169. attempts per session.
  170.  
  171. Auto-Register Flags
  172.  
  173. In a public conference, you do not need to use conference registration flags 
  174. for a user to be able to join the conference. The ability to join a 
  175. conference is based on the security level of the user and the minimum 
  176. security level that you want joining the conference.  However, by setting the 
  177. conference flags, you can speed up the caller's access to the conference.  
  178. This is possible because PCBoard then does not have to read in the conference 
  179. information to determine the public/private status or the security level 
  180. requirements.  Valid characters in this field are:
  181.  
  182.         [blank] When a user joins a conference for the first time, no changes 
  183.                 will be made to their conference registration flags. Each 
  184.                 time the user joins the conference, PCBoard will check to 
  185.                 make sure that the user has sufficient security to join the 
  186.                 conference.
  187.  
  188.         R       When joining a conference for the first time, the R 
  189.                 conference flag will be set in the user's record so that 
  190.                 their security will not be checked each time they join the 
  191.                 conference. This will enable the user to join the conference 
  192.                 quicker.  If you do not also set the X flag, then the user 
  193.                 will not be able to join the conference when their 
  194.                 subscription expires (assuming you have subscription mode 
  195.                 enabled).
  196.  
  197.         X       When joining a conference for the first time, the X 
  198.                 conference flag will be set in the user's record.  When this 
  199.                 flag and the R conference flag is set, the user will have 
  200.                 access to the conference at all times (even when their 
  201.                 subscription has expired).  If the X flag is set, but not the 
  202.                 R flag, the user will be locked out of the conference.
  203.  
  204.         S       The S conference flag will be set if the user is joining the 
  205.                 conference for the first time.  The S flag will mark the 
  206.                 conference for scanning when reading mail within PCBoard.
  207.  
  208.  
  209.  
  210. You can enter any combination of the R, X, and S conference flags in this 
  211. field or you may leave the field blank.  For example, you may want to enter 
  212. R, RX, or even RXS.
  213.  
  214. Display Files And Message Locations
  215.  
  216. Number of Message Blocks
  217.  
  218. Versions of PCBoard prior to v15.0 used a different method of indexing the 
  219. message bases.  You were required to enter the number of message blocks you 
  220. wanted to use for this older format.  If you are running third-party software 
  221. which requires use of the older index files, you can have PCBoard maintain 
  222. these older format index files for you by using the /OLDINDEX environment 
  223. setting for PCBOARD.EXE or by setting the option in each conference 
  224. configuration regarding old index support.
  225.  
  226. As mentioned previously, the old index format requires a message block 
  227. setting.  In this field, enter the number of message blocks that you want to 
  228. use for this older message index format. Each block represents a RANGE of 1K 
  229. in message numbers.  That is, with 1 block defined you may have a RANGE of 
  230. messages from a low number of 1 to a high number of 1024.  Likewise, 100,001 
  231. up through 101,024 is also valid with a block setting of 1.
  232.  
  233. Each block requires 4 kilobytes of disk space.  Regular use of PCBPack will 
  234. remove numbers from the low end and this will slide the range forward.  
  235. Usually you will not have to increase the number of blocks for the message 
  236. base beyond a value of 4 or so unless you have extremely high traffic or keep 
  237. very old messages in the message base.
  238.  
  239. NOTE:  If you are not maintaining the older index formats then the value in 
  240. this field will be ignored.  In addition, if you run a multi-node system this 
  241. number must be the same for this conference on all nodes on the system.
  242.  
  243. Name/Loc of MSGS File
  244.  
  245. Each conference has a message base file where messages left in the conference 
  246. are stored.  In this field, enter the name and location of the message file 
  247. that you want to use for this conference.  Normally, the filename you specify 
  248. in this field will be unique to any other conference but it is not absolutely 
  249. required to be unique.  For example, if you enter H:\PCB\MSGS\CONF001 in this 
  250. field, then PCBoard will think that the message base will be stored in 
  251. H:\PCB\MSGS\ using the filename CONF001.
  252.  
  253. Name/Loc of User's Menu
  254.  
  255. PCBoard, by default, has one main menu that is displayed at each conference 
  256. command prompt when in novice mode.  This menu is used by your callers so 
  257. that they know which commands are available on your system.  The menu file is 
  258. simply a text file so you can customize it any way that you think will make 
  259. it easier for your users to navigate around the system.
  260.  
  261. In this field, enter the name and location of your user  menu for this 
  262. conference.  Remember, that several conferences can point to the same menu 
  263. file if you wish to reduce the complexity of your system.
  264.  
  265. Editing The User Menu File
  266.  
  267. If you wish to edit the user menu file, press F2 to edit the non-graphics 
  268. files and F3 to edit the graphics specific file.  To create security specific 
  269. and language specific files, you will need to do so directly from the DOS 
  270. prompt using the display file conventions.
  271.  
  272. Name/Loc of Sysop's Menu
  273.  
  274. Because the SysOp has more menu options available to them than regular users, 
  275. this file will be displayed as the menu for those users who have SysOp 
  276. security level or higher.  The SysOp security level is defined in PCBSetup | 
  277. Security Levels | Sysop Commands.
  278.  
  279. In this field, enter the name and location of the SysOp menu you wish to use.  
  280. If you do not want to maintain two separate menu files (one for SysOps and 
  281. one for regular users), enter the filename of the user menu in this field.
  282.  
  283. Editing The SysOp Menu File
  284.  
  285. If you wish to edit the SysOp menu file, press F2 to edit the non-graphics 
  286. files and F3 to edit the graphics specific file.  To create security specific 
  287. and language specific files, you will need to do so directly from the DOS 
  288. prompt using the display file conventions.
  289.  
  290. Name/Loc of NEWS File
  291.  
  292. Each conference can specify a different news file.  The news file is 
  293. typically used to make the users aware of upcoming events, policies of the 
  294. board and general information that you want the users to be aware of.
  295.  
  296. In this field, enter the name and location of the news file for the 
  297. conference.  If you leave this field blank, no conference news file will be 
  298. available to your callers.
  299.  
  300. Editing The Conference News File
  301.  
  302. If you wish to edit the news file, press F2 to edit the non-graphics files 
  303. and F3 to edit the graphics specific file.  To create security specific and 
  304. language specific files, you will need to do so directly from the DOS prompt 
  305. using the display file conventions.
  306.  
  307. Name/Loc of Conf INTRO File
  308.  
  309. Each conference may have an introduction file.  This file is typically used 
  310. to remind the user of any particular items of interest about this conference.  
  311. For example, if you want the users to know what is expected in the conference 
  312. each time they join it, you would use the introduction file.  Remember, this 
  313. file will be displayed each and every time the user joins a conference unless 
  314. the Q subcommand is used when joining the conference.  This file may be 
  315. displayed while doing mail scans as well if you have enabled the Show INTRO 
  316. in `R A' scan (Conference Options Screen).
  317.  
  318. In this field, enter the name and location of the introduction file for the 
  319. conference.  If you leave this field blank, no introduction file will be 
  320. displayed.
  321.  
  322. Editing The Conference Introduction File
  323.  
  324. If you wish to edit the conference introduction file, press F2 to edit the 
  325. non-graphics files and F3 to edit the graphics specific file.  To create 
  326. security specific and language specific files, you will need to do so 
  327. directly from the DOS prompt using the display file conventions.
  328.  
  329. Location for Attachments
  330.  
  331. The drive and subdirectory that you enter in this field will determine where 
  332. file attachments will be stored for this conference.  If you leave this field 
  333. blank, you will be specifying the current directory as your directory for 
  334. file attachments which is not recommended.
  335.  
  336. Public Uploads
  337.  
  338. Sort
  339.  
  340. In this field, enter the sort type to be used by PCBFiler for the public 
  341. upload DIR (description) file.  Valid values are:
  342.  
  343.  
  344.     0    Do not sort.
  345.     1    Sort by filename (ascending / A-Z)
  346.     2    Sort by filename (descending / Z-A)
  347.     3    Sort by file date (ascending)
  348.     4    Sort by file date (descending)
  349.  
  350. Name/Loc Upload DIR File
  351.  
  352. PCBoard stores the file descriptions in a separate file for each directory 
  353. (including upload directories).  In this field, enter the name and location 
  354. of the public upload DIR (description) file.  This file contains the name, 
  355. size, date, and file description of files uploaded to your system, when 
  356. uploads are public.
  357.  
  358. Location of Uploads
  359.  
  360. In this field, enter the drive and subdirectory where you want the actual 
  361. files that are uploaded as public uploads to be stored.  If you are running 
  362. multiple nodes, you will want to make sure this location is the same for all 
  363. nodes.  Otherwise, files may be available on one node, but not available on 
  364. another node.  For example, you may want to enter F:\PCB\UPLOADS\ in this 
  365. field.
  366.  
  367. Private Uploads
  368.  
  369. Sort
  370.  
  371. In this field, enter the sort type to be used by PCBFiler for the private 
  372. upload DIR (description) file.  Valid values are:
  373.  
  374.     0    Do not sort.
  375.     1    Sort by filename (ascending / A-Z)
  376.     2    Sort by filename (descending / Z-A)
  377.     3    Sort by file date (ascending)
  378.     4    Sort by file date (descending)
  379.  
  380. Name/Loc Upload DIR File
  381.  
  382. PCBoard stores the file descriptions in a separate file for each directory 
  383. (including upload directories).  In this field, enter the name and location 
  384. of the private upload DIR (description) file.  The name, size, date, and file 
  385. description of files that are uploaded to your system, when uploads are 
  386. private.
  387.  
  388. Location of Uploads
  389.  
  390. In this field, enter the drive and subdirectory where you want the actual 
  391. files that are uploaded as private uploads to be stored.  If you are running 
  392. multiple nodes, you will want to make sure this location is the same for all 
  393. nodes.  Otherwise, files may be available on one node, but not available on 
  394. another node.  For example, you may want to enter F:\PCB\PRIVUPLD\ in this 
  395. field.
  396.  
  397. Doors
  398.  
  399. Menu Listing
  400.  
  401. When a user uses the OPEN or DOOR user commands without specifying a door 
  402. name or number, PCBoard will display a menu of doors that are available.  The 
  403. filename you enter in this field will be the file that is displayed to the 
  404. caller.  This file is a standard display file so you may have security, 
  405. graphics, and language specific versions of the menu.  Because you can have 
  406. different versions of the doors menu, you should not specify a filename 
  407. extension or you will eliminate the ability to have different menus for 
  408. languages on your system (if you have defined them).  For example, you may 
  409. enter C:\PCB\MAIN\DOORS or any other valid filename in this field.
  410.  
  411. Editing The Door Menu File
  412.  
  413. If you wish to edit the door menu file, press F2 to edit the
  414. non-graphics files and F3 to edit the graphics specific file.  To create 
  415. security specific and language specific files, you will need to do so 
  416. directly from the DOS prompt using the display file conventions.
  417.  
  418. Path/Name List File
  419.  
  420. The Path/Name List File, as it is called, refers to the data file that is 
  421. used to define the doors that are available in the conference.  This is the 
  422. file you will edit to define, delete, or alter the configuration of the doors 
  423. available in this conference.  To edit this file, press F2 while the filename 
  424. is highlighted.   Please refer to the Doors section in the chapter for 
  425. additional information on editing this file..
  426.  
  427. NOTE:  Even though this file is not a display file, you may create security 
  428. specific versions of the Path/Name List File. For example, if the file is 
  429. called DOOR.LST, you can create a DOOR50.LST that would be used exclusively 
  430. by those with a security level of 50.
  431.  
  432. Bulletins
  433.  
  434. Menu Listing
  435.  
  436. When a user uses the B user command without specifying a bulletin number, 
  437. PCBoard will display a menu of bulletins that are available.  The filename 
  438. you enter in this field will be the file that is displayed to the caller.  
  439. Even though this file is a standard display file, you cannot have a security 
  440. specific version of this menu.  You may create graphic and language specific 
  441. versions of this menu..  Because you can have different versions of the 
  442. bulletin menu, you should not specify a filename extension or you will 
  443. eliminate the ability to have different menus for languages on your system 
  444. (if you have defined them). For example, you may enter C:\PCB\MAIN\BLTS or 
  445. any other valid filename in this field.
  446.  
  447. Editing The Bulletin Menu File
  448.  
  449. If you wish to edit the bulletin menu file, press F2 to edit the non-graphics 
  450. files and F3 to edit the graphics specific file.  To create language specific 
  451. files, you will need to do so directly from the DOS prompt using the display 
  452. file conventions.
  453.  
  454. Path/Name List File
  455.  
  456. The Path/Name List File, as it is called, refers to the data file that is 
  457. used to define the bulletins that are available in the conference.  This is 
  458. the file you will edit to define, delete, or alter the configuration of the 
  459. bulletins available in this conference.  To edit this file,  press F2 while 
  460. the filename is highlighted.   Please refer to the Bulletins section in this 
  461. chapter for additional information on editing this file.
  462.  
  463. NOTE:  Even though this file is not a display file, you may create security 
  464. specific versions of the Path/Name List File. For example, if the file is 
  465. called BLT.LST, you can create a BLT50.LST that would be used exclusively by 
  466. those with a security level of 50.
  467.  
  468. Scripts
  469.  
  470. Menu Listing
  471.  
  472. When a user uses the S user command, PCBoard will display a menu of script 
  473. questionnaires that are available.  The filename you enter in this field will 
  474. be the file that is displayed to the caller.  Even though this file is a 
  475. standard display file, you cannot have a security specific version of this 
  476. menu.  You may create graphic and language specific versions of this menu. 
  477. Because you can have different versions of the script menu, you should not 
  478. specify a filename extension or you will eliminate the ability to have 
  479. different menus for languages on your system (if you have defined them).  For 
  480. example, you may enter C:\PCB\MAIN\SCRIPTS or any other valid filename in 
  481. this field.
  482.  
  483. Editing The Script Questionnaire Menu File
  484.  
  485. If you wish to edit the script questionnaire menu file, press 2 to edit the 
  486. non-graphics files and F3 to edit the graphics specific file.  To create 
  487. language specific files, you will need to do so directly from the DOS prompt 
  488. using the display file conventions.
  489.  
  490. Path/Name List File
  491.  
  492. The Path/Name List File, refers to the data file used to define the script 
  493. questionnaires that are available in the conference. This is the file you 
  494. will edit to define, delete, or alter the configuration of the script 
  495. questionnaires available in this conference.  To edit this file,  press F2 
  496. while the filename is highlighted.   Please refer to the Script 
  497. Questionnaires section in this chapter for additional information on editing 
  498. this file..
  499.  
  500. NOTE:  Even though this file is not a display file, you may create security 
  501. specific versions of the Path/Name List File. For example, if the file is 
  502. called SCRIPT.LST, you can create a SCRIPT50.LST that would be used 
  503. exclusively by those with a security level of 50.
  504.  
  505. Directories
  506.  
  507. Menu Listing
  508.  
  509. When a user uses the F user command without specifying a subcommand, PCBoard 
  510. will display a menu of file directories that are available.  The filename you 
  511. enter in this field will be the file that is displayed to the caller.  Even 
  512. though this file is a standard display file, you cannot have a security 
  513. specific version of this menu.  You may create graphic and language specific 
  514. versions of this menu..  Because you can have different versions of the 
  515. script menu, you should not specify a filename extension or you will 
  516. eliminate the ability to have different menus for languages on your system 
  517. (if you have defined them). For example, you may enter C:\PCB\MAIN\DIR or any 
  518. other valid filename in this field.
  519.  
  520. Editing The File DIrectory Menu File
  521.  
  522. If you wish to edit the file directory menu file you can press 2 to edit the 
  523. non-graphics files and F3 to edit the graphics specific file.  To create 
  524. language specific files, you will need to do so directly from the DOS prompt 
  525. using the display file conventions.
  526.  
  527. Path/Name List File
  528.  
  529. The Path/Name List File, as it is called, refers to the data file that is 
  530. used to define the file directories that are available in the conference.  
  531. This is the file you will edit to define, delete, or alter the configuration 
  532. of the file directories available in this conference.  To edit this file, 
  533. press F2 while the filename is highlighted.   Please refer to the File 
  534. Directories section in this chapter for additional information on editing 
  535. this file.
  536.  
  537. NOTE:  Even though this file is not a display file, you may create security 
  538. specific versions of the Path/Name List File. For example, if the file is 
  539. called DIR.LST, you can create a DIR50.LST that would be used exclusively by 
  540. those with a security level of 50.
  541.  
  542. Download Paths
  543.  
  544. Path/Name List File
  545.  
  546. The Path/Name List File, refers to the data file used to define the paths 
  547. that PCBoard will search to locate files that are available for downloading 
  548. in this conference.  This is the file you will edit to define, delete, or 
  549. alter the configuration of the paths that search for downloadable files.  To 
  550. edit this file, press F2 while the filename is highlighted.   Please refer to 
  551. the File Directories section in this chapter for additional information on 
  552. editing this file.
  553.  
  554. NOTE:  Even though this file is not a display file, you may create security 
  555. specific versions of the Path/Name List File. For example, if the file is 
  556. called DLPATH.LST, you can create a DLPATH50.LST that would be used 
  557. exclusively by those with a security level of 50.
  558.  
  559. Conference Options Screen
  560.  
  561. These conference options are made available to you when you press d while in 
  562. the conference configuration screen.  These options give you more control 
  563. over how the conference will operate.
  564.  
  565. Auto-Rejoin into this Conf.
  566.  
  567. In certain situations it may be desirable to have the user automatically 
  568. re-join a conference if they logoff while in that conference.  For example, 
  569. you may have a conference set aside for each of several groups of users on 
  570. your system.  Your system may be configured so that all of the information 
  571. they need to obtain can be found in the conference which is dedicated for 
  572. their use.  You could then lock the users out of all other conferences (using 
  573. the L conference flag) and force them to join their conference next time they 
  574. logon.  Valid options for this field are:
  575.  
  576.         N       When the user logs in the next time, they will be placed into 
  577.                 the Main Board (Conference 0).
  578.  
  579.         Y       The next time the user logs onto the system, they will 
  580.                 automatically rejoin this conference if they disconnected 
  581.                 from the system while in this conference.
  582.  
  583. Allow Viewing Conf. Members
  584.  
  585. This option controls whether or not a user will be asked to view a list of 
  586. users who are registered in the conference they are about to join.  This 
  587. question is asked only once per session (when the conference is joined for 
  588. the first time).  Valid options for this field are:
  589.  
  590.         N       Users are not asked if they wish to view conference members 
  591.                 when they join the conference.  The users may still be able 
  592.                 to use the USERS command to see the same information.  This 
  593.                 command, however, is controlled by security level in PCBSetup 
  594.                 | Security Levels | User Commands.
  595.  
  596.         Y       Users will be asked if they wish to view conference members 
  597.                 when they join the conference for the first time during that 
  598.                 session.
  599.  
  600. Make All Uploads Private
  601.  
  602. With the concern of virus infected or other damaging files being sent over 
  603. the modem, you may want to screen all  of your uploads before making them 
  604. available to your callers.  An additional concern would be if your callers 
  605. were uploading files that you deemed inappropriate for your system.  In this 
  606. case too, you will most likely want to make all of your uploads private.  By 
  607. making an upload private, you are telling PCBoard to place all files that are 
  608. uploaded in the conference to the private upload directory that you specified 
  609. on the first screen.  Valid options for this field are:
  610.  
  611.         N       All uploads in the conference will be considered public 
  612.                 uploads unless the user enters a / as the first character of 
  613.                 their description.  Once the file is uploaded, callers will 
  614.                 be able to download it without you screening the files.
  615.  
  616.         Y       All uploads will be sent to the private upload directory even 
  617.                 if the description the user entered does not begin with a /.  
  618.                 It is then your responsibility to screen the uploads and move 
  619.                 them (using PCBFiler) out of the private upload directory to 
  620.                 one of your download directories.  If you have defined your 
  621.                 public upload directory (even though you are making all 
  622.                 uploads private) PCBoard will consider the public upload 
  623.                 directory valid for your users.  This means that you could 
  624.                 screen your uploads and then move them over to your public 
  625.                 upload directory where your users will easily be able to find 
  626.                 new uploads to your system.
  627.  
  628. Make All Messages Private
  629.  
  630. Not only can you make all uploads to a conference private, but you can also 
  631. make all messages in a conference private as well. While it is less likely 
  632. that you want to screen your messages, the conference that you are editing 
  633. may have a lot of one on one conversations where making all messages private 
  634. would be the ideal situation.  Valid options for this field are:
  635.  
  636.         N       When entering a message, the user can assign the message 
  637.                 security of their choice when prompted.  This means that they 
  638.                 can choose to make a message private, public, group password 
  639.                 or any other valid message security option.  If you want to 
  640.                 make a public message private, you may do so by using the P 
  641.                 subcommand at the End of Message Command prompt.
  642.  
  643.         Y       Users will not be given the choice to assign security to a 
  644.                 message.  Instead, all messages will be deemed RECEIVER ONLY. 
  645.                 As you read these private messages, you can unprotect them 
  646.                 (making them public messages) by using the U subcommand at 
  647.                 the End of Message Command prompt.
  648.  
  649.  
  650.  
  651. Echo Mail in Conference
  652.  
  653. The primary design of a bulletin board system is to distribute information to 
  654. the callers of the system.   Some systems get involved with echo mail 
  655. networks where several bulletin board systems exchange messages with one 
  656. another.  Valid options for this field are:
  657.  
  658.         N       You do not plan on sharing messages in this conference with 
  659.                 other systems. Users will not be asked any questions about 
  660.                 echoing the message they are entering.
  661.  
  662.         Y       When entering a message, the user will be asked if this 
  663.                 message should be echoed to other systems or not.  PCBoard 
  664.                 does not actually transfer the mail (that is up to the 
  665.                 network mail software).  Therefore, it is up to the network 
  666.                 mail software to honor the echo flag if it is set.  If you 
  667.                 want to force all messages to be marked as messages for 
  668.                 echoing then you should enable the Force Echo on all Messages 
  669.                 option on this same screen.
  670.  
  671. Force Echo on All Messages
  672.  
  673. If you would rather force all messages left in the conference to be marked 
  674. for echoing, enable this option.  When entering messages, your users will not 
  675. be allowed to choose whether or not the message should be marked for echoing 
  676. or not.  For this setting to have any effect, you must have answered Y to the 
  677. Echo Mail in Conference question.  Valid options for this field are:
  678.  
  679.         N       Allow the user to choose whether or not the message they are 
  680.                 entering should be mark for echoing or not.
  681.  
  682.         Y       Force all messages entered in the conference to be marked for 
  683.                 echoing.  The user is never given a choice.
  684.  
  685. Allow Internet (long) TO: Names
  686.  
  687. The normal limit for user names when addressing message is 25 characters.  
  688. However, some  networks such as the Internet can have extremely long 
  689. identities or addresses.  If you are echoing a conference that requires the 
  690. TO: field to allow input of more than 25 characters, you can choose to do so 
  691. based on your answer to this field.  Valid options for this field are:
  692.  
  693.     N    Users are given up to 25 characters to address their message.
  694.         
  695.         Y       Users are given up to 120 characters to address their message.
  696.  
  697. Make Conference Read-Only
  698.  
  699. You may desire to make some conferences read-only.  Users cannot reply or 
  700. enter messages in conferences that are marked as read-only.  If you would 
  701. rather limit who can enter messages by security level, refer to the Level to 
  702. Enter a Message field on this screen instead.  Valid options are:
  703.  
  704.     N    Users can enter and reply to messages as they read them.
  705.         
  706.         Y       Users (not even the SysOp) will be able to enter messages in
  707.                 this conference.
  708.  
  709. Disallow Private Messages
  710.  
  711. Private messages are not often supported in echo mail networks. Therefore, 
  712. you may wish to not allow users to leave private messages in these 
  713. conferences.  This field controls whether or not a user can enter private 
  714. messages in a conference.  Valid options for this field are:
  715.  
  716.  
  717.  
  718.         N       Users can choose to enter private messages if they are 
  719.                 prompted for the message security.
  720.  
  721.         Y       Users will not be able to enter a private message if they are 
  722.                 prompted for the message security.  If they attempt to, 
  723.                 PCBoard will warn them that private messages cannot be left 
  724.                 in this conference and then prompt them again for the message 
  725.                 security that they wish to assign to the message.
  726.  
  727. Place Origin Info in Messages
  728.  
  729. When you participate in an echo mail network, information that refers to 
  730. where the message originated from is usually appended to the end of the 
  731. message.  You can tell PCBoard to include this origin information directly 
  732. into the message if you wish.  The origin information is taken directly from 
  733. the Board Name field in PCBSetup | Node Information.  For most systems, it is 
  734. up to the echo mail software if you should have PCBoard include the origin 
  735. information or not.  Please refer to the documentation for your mail software 
  736. to see if it requests that PCBoard include this information.  Valid options 
  737. for this field are:
  738.  
  739.         N       Do not place origin information in each message entered in
  740.                 this conference.
  741.  
  742.     Y    Include the origin information for each message entered in
  743.                 this conference.
  744.  
  745. Prompt for ROUTE Info
  746.  
  747. Some mail networks will allow you to route a message directly to a particular 
  748. site in the echo mail network.  Check with your echo mail documentation to 
  749. see if it supports routing and if it knows how to extract routing information 
  750. directly from PCBoard. In order for a user to be prompted for routing 
  751. information the following must be true of the message being entered:
  752.  
  753.  
  754. The message must be marked for echoing
  755. The message must be a private (RECEIVER ONLY) message
  756.  
  757.  
  758. If prompted for routing information, the user will be able to enter up to 58 
  759. characters to identify where the message should be directed to.  The echo 
  760. mail software that you are using will determine the format that the routing 
  761. information should be entered in.  Valid options for this field are:
  762.  
  763.     N    Users will not be prompted for routing information.
  764.  
  765.         Y       Users will be prompted for routing information if the 
  766.                 aforementioned conditions are met.
  767.  
  768. Allow Aliases to be used
  769.  
  770. Once you have installed the Alias PSA you need to determine which conferences 
  771. each user's alias will become active.  Each conference has this field which 
  772. determines if alias will be used or not.  Valid options for this field are:
  773.  
  774.         N       Even if the user has defined an alias to use (using the W 
  775.                 user command), only their real name will be used while in 
  776.                 this conference.
  777.  
  778.         Y       While in this conference, the user's alias name will be in 
  779.                 use.
  780.  
  781. Show INTRO in 'R A' Scan
  782.  
  783. The conference introduction file is normally only displayed when a caller 
  784. uses the J user command  to join a conference. However, to help separate 
  785. conferences and make the transition from one conference to the next more 
  786. obvious you can display the introduction file more often.  When using the A 
  787. or ALL subcommands with the R user command,  this setting will determine if 
  788. the introduction file for the current conference will be displayed before the 
  789. conference is actually scanned for new mail.  Remember, this setting is 
  790. conference specific, so if you want the introduction file for all of your 
  791. conferences to be displayed, you will need to change this setting for all of 
  792. your conferences.  Valid options are:
  793.  
  794.         N       Conference introduction files will only be displayed only 
  795.                 when joining conferences and not during new mail scans.
  796.  
  797.         Y       In addition to being displayed when joining a conference, the 
  798.                 introduction file will be displayed when scanning for new 
  799.                 mail using the A or ALL subcommands of the R user command.
  800.  
  801. Maintain Old MSGS.NDX File
  802.  
  803. Older (non-v15.0 compliant) software may not read the new IDX files and 
  804. consequently may not be able to recognize messages on your system.  This 
  805. setting will determine whether or not PCBoard will maintain the older NDX 
  806. format for this conference.  Valid options are:
  807.  
  808.         N       PCBoard will continue to maintain only the IDX file (not the 
  809.                 older NDX file) for the conference.
  810.  
  811.         Y       In addition to maintaining the IDX file, PCBoard will also 
  812.                 maintain the NDX file as well so that software designed to 
  813.                 operate with v14.x (but not v15.0) will be able to operate 
  814.                 properly.
  815.  
  816. NOTE:  If you want to force all conferences to maintain the older NDX format, 
  817. use the /OLDINDEX environment switch for PCBoard.
  818.  
  819. Conf-Specific CMD.LST File
  820.  
  821. You will probably recall that there is what is referred to as a global 
  822. CMD.LST file defined in PCBSetup | File Locations | Configuration Files.  
  823. Normally, the commands that you define in that file will be available in all 
  824. conferences.  If you want a conference to use a different CMD.LST, specify 
  825. the CMD.LST to use in this field.  By entering a filename in this field you 
  826. are overriding the entire contents of your global CMD.LST file with whatever 
  827. commands are defined in your conference specific version.
  828.  
  829. Additional Conference Security
  830.  
  831. In this field, enter the amount of security that should be added to the 
  832. user's security level at the time they join this conference.  The value that 
  833. you enter may be positive or negative and can range from -99 to 999.  If the 
  834. value you enter is negative, then the caller's security will be lowered upon 
  835. joining the conference.  Also, remember that PCBoard supports security levels 
  836. up to 255.  Even though you can add 999 to a security level it would not be 
  837. practical to do so.  Try to limit all security level adjustments so that they 
  838. remain under 256. Entering 0 in this field will leave the security level of 
  839. the caller unchanged when joining this conference.
  840.  
  841. NOTE:  The change in security level will only be in effect while in the 
  842. conference.  When the conference is abandoned or another conference is joined 
  843. then the user will return to their assigned security level.
  844.  
  845. Additional Conference Time
  846.  
  847. In this field, enter the amount of time that should be added to the user's 
  848. time remaining on the system at the time that the conference is joined.  You 
  849. may enter any value between 0 and 999 in this field.  A value of 0 will not 
  850. adjust the time of the caller when joining the conference.
  851.  
  852. Once the time is added, it is not removed until the caller logs off of the 
  853. system.  This means a user could join this conference to get a additional 
  854. boost in time.  Perhaps the additional time could be used as some sort of 
  855. incentive.  The additional time is not added each time the user joins the 
  856. conference.  Instead, it is added the first time they join the conference 
  857. during each call.
  858.  
  859. Level to Save File Attachment
  860.  
  861. The ability to attach files to messages can be a powerful feature and at the 
  862. same time an annoying feature if abused.  In this field enter the security 
  863. level that is required to save a message with an attached file in this 
  864. conference.  The value you enter in this field must be between 0 and 255.  By 
  865. setting this value to a higher value, you can let your most trusted users 
  866. attach files without having to worry about it being abused.
  867.  
  868. Level to Enter a Message
  869.  
  870. For some conferences, you may want the primary purpose of the conference to 
  871. have users read messages.  You could disable the ability to enter messages 
  872. (or replies) by entering Y in the Make Conference Read-Only.  Enabling this 
  873. setting, however, would not allow you to enter messages directly into this 
  874. conference.  In this field, enter the security level that is required for a 
  875. user to leave a message in this conference.  If you did make the conference 
  876. Read-Only, the value you enter in this field will have no effect.
  877.  
  878. Be aware that there is a global security level that can be assigned to the E 
  879. user command in PCBSetup | Security Levels | User Commands.  Whichever value 
  880. is higher (the global setting or the conference specific setting) will be the 
  881. controlling security level for entering messages and replies.
  882.  
  883. Level to Request Return Receipt
  884.  
  885. Like the file attachment feature, users can end up abusing the ability to 
  886. request return receipts on their messages.  If this feature is abused, your 
  887. message bases could quickly become full of un-necessary messages because each 
  888. return receipt is a message.  In this field enter the security level that is 
  889. required for a user to be able to request a return receipt in this 
  890. conference.  You may enter any value between 0 and 255. Entering a high value 
  891. in this field can disable the ability to request return receipts for all or 
  892. some of your callers.
  893.  
  894. Level to Enter Carbon List Msgs
  895.  
  896. To address a single message to a group of users on the system, the message 
  897. can be addressed to @LIST@.  Once you address the message in this manner, 
  898. PCBoard will prompt the user for a list of names that the message should be 
  899. addressed to.  You can control the security level that is required to address 
  900. messages in this manner.  In this field enter the security level that is 
  901. required for a user to address a single message to a group of users.  When a 
  902. user attempts to address a message to @LIST@ and either does not have 
  903. sufficient security or the Carbon Copy List Limit is set to 0, the message 
  904. will be addressed to ALL instead.
  905.  
  906. Carbon Copy List Limit
  907.  
  908. When addressing a message to a group of users, you can set the maximum number 
  909. of users that the message can be addressed to. In this field enter a value 
  910. between 0 and 99 that will determine the maximum number of users that can be 
  911. addressed.  A value of 0 disables the ability to enter @LIST@ messages.  When 
  912. a user attempts to address a message to @LIST@ and either does not have 
  913. sufficient security or the Carbon Copy List Limit is set to 0, the message 
  914. will be addressed to ALL instead.
  915.  
  916. Sharing Files Between Conferences
  917.  
  918. The conference configuration screens specify the location of several files.  
  919. As you know, conferences are designed to separate groups of people and or 
  920. common information together.
  921.  
  922. You will have different message bases for every conference but you may want 
  923. to use the same door, script, and bulletin configurations for multiple 
  924. conferences.  For example, conference 1 and conference 3 on your system may 
  925. have separate message bases, but you may want to make the same doors 
  926. available in both conferences.
  927.  
  928. Rather than having to maintain two separate DOORS.LST files, you can have 
  929. both conferences use the same DOORS.LST file.  When you make a change to the 
  930. file, the change will be seen in both conferences (because they are both 
  931. reading from the same configuration file on disk).  This would mean that 
  932. conference 1 and 3 may have C:\PCB\GEN\DOORS.LST entered while conference 2 
  933. could have C:\CONF\2\DOORS.LST  because it will have different doors defined.  
  934. This concept can be applied to any of the file locations in the conference 
  935. configuration screens.
  936.  
  937. File Directories
  938.  
  939. In order for users to be able to transfer files on your system, you will need 
  940. to have some file directories available.  Each conference can specify a 
  941. different set of file directories and each file directory can contain 
  942. virtually an unlimited number of files.  The file directories simply store 
  943. the filename, date, size, and description of a file that is available for 
  944. download.
  945.  
  946. Creating
  947.  
  948. To create a file directory,  you must understand how DIR, DIR.LST, and 
  949. DLPATH.LST interact with one another to form your file directory system.  The 
  950. following lists the three files that make up your file directories in each 
  951. conference configuration screen:
  952.  
  953. Directories : C:\PCB\GEN\DIR              : C:\PCB\GEN\DIR.LST
  954.  
  955. Download Paths (listing only)              :
  956. C:\PCB\GEN\CDLPATH.LST
  957.  
  958. To help illustrate how these files interact with one another we are going to 
  959. go through a step by step process on how to setup some file directories.  
  960. First, you need to have a brief overview of DIR, DIR.LST, and DLPATH.LST.
  961.  
  962. DIR is the file that gets displayed to the user when they select (F)ile 
  963. Directories from the menu.
  964.  
  965. DIR.LST is the file that PCBoard uses to determine where the file 
  966. descriptions are stored, and the description for the directory contents.  
  967. PCBFiler uses DIR.LST to determine where the files are stored on your hard 
  968. drive or similar device. PCBFiler also determines what method to use when you 
  969. sort your directories by reading DIR.LST.
  970.  
  971. DLPATH.LST is a file that contains a list of paths that PCBoard should search 
  972. through for files a user requests to download. Only the paths listed in this 
  973. file are searched when a user requests to download a file.
  974.  
  975. The first thing you will want to do is to think about categories you would 
  976. like to define as file directories.  For example, you may have categories 
  977. called Printer Fonts, Adventure Games, Disk Utilities, etc.  Once you have 
  978. determined which file categories you wish to create, you are ready to begin 
  979. adding entries in DIR.LST.
  980.  
  981. To edit DIR.LST, load PCBSetup by either loading PCBSETUP.EXE from your \PCB 
  982. directory or select the PCBSetup button from your call-waiting screen.  Once 
  983. you are in PCBSetup, select either I or J from the PCBSetup Main Menu to 
  984. enter one of the conference configuration screens.  Now you only need to move 
  985. your cursor over to the DIR.LST entry and press F2 to edit the file.  Your 
  986. screen should now resemble the following:
  987.  
  988. The first field you will be editing is labeled as DIR Text File Name & Path.  
  989. This is the full path and filename where PCBoard will be storing descriptions 
  990. (not the actual files for download) for the directory number identified at 
  991. the left hand side of the line in this file.  You can name this file anything 
  992. you want, although filenames without extensions are highly recommended. The 
  993. descriptions in your DIR file will look like the following:
  994.  
  995. PCBSHOW.ZIP     89722  02-20-91  PCBoard v14.5 Introductory SHOW dated
  996.                                  2/20/91.  This program gives a quick
  997.                                  demonstration of installing PCBoard
  998.                                  It's final goal being that of giving
  999.                                  new sysops a quick start. Other SHOWs
  1000.                                  may follow in the future.
  1001.                                  Uploaded by: Dan Moore
  1002.  
  1003. The next field in your DIR.LST is Hard Disk Subdirectory.  This field should 
  1004. contain the drive and subdirectory where a majority or all of your files are 
  1005. stored for this file directory. PCBFiler uses this field to help determine 
  1006. where the files are located on disk when you edit/move files and file 
  1007. descriptions. Remember, PCBoard never uses this field to locate files 
  1008. requested for download.
  1009.  
  1010. It is only possible to assign one drive and subdirectory per file directory.  
  1011. If you have files stored in more than one drive and directory, enter the 
  1012. drive and directory where the majority of the files for this directory are 
  1013. located.
  1014.  
  1015. The last field on this screen asks what type of sort method you wish to use.  
  1016. You can specify any of five choices (0-4) that are listed at the bottom of 
  1017. your screen.  When you use PCBFiler to edit/move files and file descriptions, 
  1018. the sort method you specify here will be used to rearrange the file 
  1019. descriptions.
  1020.  
  1021. There is one more screen to edit before you are finished.  If you press 2, 
  1022. you will notice that the screen changes.  You still see the column labeled 
  1023. DIR Text File Name & Path.  However, the Hard Disk Subdirectory and Sort 
  1024. fields are no longer on this screen.  Instead, there is a field called 
  1025. Description of Directory Contents.
  1026.  
  1027. In this field, you enter a description of what type of files can be found in 
  1028. this directory.  If one of your directories contains laser printer fonts, you 
  1029. could enter Laser Printer Fonts in this field. When your users are doing file 
  1030. scans using the (Z)ippy, (L)ocate, and (N)ew commands they will see these 
  1031. descriptions to the right of the directory number.  Example:
  1032.  
  1033.  
  1034. Scanning Directory 1  (Printer Fonts)
  1035. Scanning Directory 2  (Adventure Games)
  1036. Scanning Directory 3  (Disk Utilities)
  1037. Scanning Directory 4  (Security Related Files)
  1038.  
  1039. All of the descriptions between the parentheses were entered in DIR.LST on 
  1040. the second screen.  If you do not enter any descriptions in the Description 
  1041. of Directory Contents field, you will see the following when you do a 
  1042. directory scan:
  1043.  
  1044. Scanning Directory 1  ()
  1045. Scanning Directory 2  ()
  1046. Scanning Directory 3  ()
  1047. Scanning Directory 4  ()
  1048.  
  1049. If you have not yet defined all of your file directories in DIR.LST you 
  1050. should do so now.  If you do not have enough lines and need more, you can use 
  1051. ALT-I to insert a new line.  Likewise, if you have defined a file directory 
  1052. that you do not want, you can use ALT-D to delete it.
  1053.  
  1054. Assuming you have defined all the file directories you wish to define, it is 
  1055. now time to move on to DLPATH.LST.  This file contains a list of paths that 
  1056. PCBoard will search when a user requests a file to download.  This is the 
  1057. ONLY file that PCBoard will search to determine if a file is available for 
  1058. download. Even if the description for the file is listed in one of the file 
  1059. directories, it will not be allowed to be downloaded unless the file is found 
  1060. in one of the directories listed in DLPATH.LST.
  1061.  
  1062. Because the DLPATH.LST is not directly tied into DIR.LST you can enter any 
  1063. directories that you wish in this file.  For example, since PCBoard allows 
  1064. callers to download bulletins, you may want to list the directory where all 
  1065. of your bulletins are stored (e.g., C:\PCB\BLT) in the DLPATH.LST file.  You 
  1066. might also have a special directory set aside where you allow users to 
  1067. download files that are not listed in the directories.  These may be private 
  1068. files that you want to make available to individuals you individually inform 
  1069. of the specific filenames.
  1070.  
  1071. For the most part your DLPATH.LST will contain all of the directories you 
  1072. listed in the Hard Disk Subdirectory column in DIR.LST, the location where 
  1073. all of you new uploads are stored.
  1074.  
  1075. The final file you will need to edit is your DIR "Menu Listing" file and your 
  1076. file directory setup will be finished.  See Creating Menu later in this 
  1077. section.
  1078.  
  1079. Adding Files To
  1080.  
  1081. Adding files for download in your file directories can be an easy process.  
  1082. What you need to do is copy the files to one of your directories, and use 
  1083. PCBFiler to provide the descriptions for the files.  See the PCBFiler chapter 
  1084. of this manual for additional information on adding files to your system.
  1085.  
  1086. Disabling
  1087.  
  1088. The easiest way to disable your file directories (leaving only your upload 
  1089. directories working) is to blank out your DIR and DIR.LST fields. For 
  1090. example, if your fields in the conference configuration screen look like the 
  1091. following:
  1092.  
  1093. Directories : C:\PCB\GEN\DIR               : C:\PCB\GEN\DIR.LST
  1094.  
  1095.  
  1096. Modify them to look like this to disable your file directories:
  1097.  
  1098.  
  1099. Directories :                              :
  1100.  
  1101.  
  1102. When your file directories are disabled, your users will receive a message 
  1103. stating that there are no directories whenever they try to access your file 
  1104. areas.
  1105.  
  1106. Creating Menu
  1107.  
  1108. In order for your users to know what file directories are available on your 
  1109. system (if any), you need to edit the Directory Menu Listing file.  This file 
  1110. is commonly referred to as DIR.
  1111.  
  1112. This is the file that is displayed to the user when they execute the F user 
  1113. command.  This file is nothing more than a text file. Because it is a text 
  1114. file, you can design it to look or display anything you want.  As a general 
  1115. rule it should contain each directory number and should also list a 
  1116. description of the contents of each file directory.   The following is a 
  1117. sample menu text file.
  1118.  
  1119.  
  1120. Doors
  1121.  
  1122. When you add a door to your bulletin board system you add functionality to 
  1123. your system.  A door application can enable your users to play on-line games, 
  1124. access databases, and just about anything else you can imagine.
  1125.  
  1126. When a user opens a door they temporarily exit PCBoard and run a batch file 
  1127. called the door batch file.  This batch file will then execute some other 
  1128. application -- be it a game, utility or other program.
  1129.  
  1130. Usually the program that is being run is designed to be a door application, 
  1131. or is designed to accept input and output via the serial port so that the 
  1132. remote user can control the operation of the program.  Programs that do not 
  1133. provide input and output through the serial port may not be able to run as a 
  1134. door unless you use a program like DOORWAY which redirects both text screen 
  1135. and keyboard i/o to the remote caller.
  1136.  
  1137. Probably the most popular type of door programs are games. However, there are 
  1138. utility type doors as well that may allow users to store additional time on 
  1139. the system, read off-line mail, etc.  Virtually anything that communicates 
  1140. via a serial port can be considered a door application.
  1141.  
  1142. What Is A Door?
  1143.  
  1144. A door is nothing more than a program which is designed to
  1145. communicate through the serial port rather than through normal
  1146. means (i.e., the keyboard).
  1147.  
  1148. You may be asking yourself if there is anyway to run a non-door application 
  1149. as a door.  You can but it means that you will have to have some sort of 
  1150. software that will monitor what is on the screen and output it to the remote 
  1151. users screen.  DOORWAY by TriMark Engineering does exactly this.  It will 
  1152. monitor any 80x25 text mode application and draw it on the remote users 
  1153. screen using ANSI codes.  Using this program you could run virtually any text 
  1154. mode DOS application as a door.
  1155.  
  1156. For the most part most door applications are all character-mode based. That 
  1157. means that you cannot run Windows application or other graphical applications 
  1158. as a door.  The primary reason you cannot run graphical applications as doors 
  1159. is because there is no standard way to send graphical data over the modem and 
  1160. have the majority of modem users be able to view that information.
  1161.  
  1162. Adding A Door
  1163.  
  1164. If you load PCBSetup, and select a conference to edit you will
  1165. see the following fields at the bottom of your display:
  1166.  
  1167.  
  1168.                  Menu Listing                     Path/Name List File
  1169.  
  1170.   Doors       : C:\PCB\GEN\DOORS            : C:\PCB\GEN\DOORS.LST
  1171.   Bulletins   : C:\PCB\GEN\BLT              : C:\PCB\GEN\BLT.LST
  1172.   Scripts     : C:\PCB\GEN\SCRIPT           : C:\PCB\GEN\SCRIPT.LST    
  1173.   Directories : C:\PCB\GEN\DIR              : C:\PCB\GEN\DIR.LST
  1174.   Download Paths (listing only)             : C:\PCB\GEN\DLPATH.LST    
  1175.  
  1176.  
  1177.  
  1178. The two fields that relate to door operation are the following:
  1179.  
  1180.  
  1181.                  Menu Listing                     Path/Name List File
  1182.  
  1183.   Doors       : C:\PCB\GEN\DOORS            : C:\PCB\GEN\DOORS.LST
  1184.  
  1185.  
  1186. The following is a brief description of each of the files:
  1187.  
  1188.  
  1189. DOORS - This is the menu file that is displayed to the user when they type 
  1190. either OPEN or DOOR.  This file is a normal PCBoard display file.  It should 
  1191. list all of the doors that are available on your system and their 
  1192. corresponding numbers or names.  Creating the door menu is discussed later in 
  1193. this section.
  1194.  
  1195. DOORS.LST - This file stores all of the setup information about the doors you 
  1196. have defined in this particular conference. PCBoard will read this file to 
  1197. determine what batch file to use to execute the door, where the batch file is 
  1198. found, and other options controlling access to the door.  To edit this file, 
  1199. press F2 and you will see the following screen:
  1200.  
  1201. The number at the very left of each line is the door number. The rest of the 
  1202. fields are not always so intuitive.  The following briefly describes each 
  1203. field in the DOORS.LST file:
  1204.  
  1205.      Filename   This is the exact batch filename that PCBoard will look to 
  1206.                 execute.  You are given up to 8 characters for a door name 
  1207.                 and you should not put a .BAT extension in the filename 
  1208.                 field.
  1209.  
  1210.  
  1211.  
  1212.                 NOTE:  Make sure that you do not enter a filename which is 
  1213.                 the equivalent of any internal PCBoard command.  For example, 
  1214.                 if you were to enter TEST as a filename  your door batch file 
  1215.                 will never run because PCBoard has an internal command with 
  1216.                 the same name.
  1217.  
  1218.     Password    If you want users to enter a password in order to access a 
  1219.                 particular door, enter up to 12 characters in this field. If 
  1220.                 you do not desire a password to be asked, make sure this 
  1221.                 field is blank.
  1222.  
  1223.         Sec     Enter the security level required in order to be able to open 
  1224.                 a particular door.  A user may open the door if their 
  1225.                 security level is equal to or greater than the security level 
  1226.                 in this field. Of course, if the security level entered in 
  1227.                 this field is 0, everyone will have sufficient security to 
  1228.                 open the door.
  1229.  
  1230.         Login   This field may contain either a Y or an N.  If you enter a Y 
  1231.                 in this field, when the user logs into the system this door 
  1232.                 will be loaded.  Note that the security level field behaves a 
  1233.                 little different when you are dealing with an auto-login 
  1234.                 door.
  1235.  
  1236. With an auto-login door it will only open for the security level that is 
  1237. listed in the SEC field.  If you want the door to open every time any user 
  1238. logs in, enter a security level of 0 in the sec field.
  1239.  
  1240. NOTE:  If you have any conferences that are defined as auto-rejoin, be aware 
  1241. that if a user logged off of the BBS in one of these conferences, they will 
  1242. rejoin that conference on their next login.  Consequently, you must make sure 
  1243. that the proper doors are defined in this conference because this is the 
  1244. conference that PCBoard will read the DOORS.LST from.
  1245.  
  1246.     USER SYS    In this field you may enter a Y, N, or O.  The letter that 
  1247.                 you enter in this field will determine if a USERS.SYS is 
  1248.                 created and if so, what type.  If you enter a Y, PCBoard will 
  1249.                 create a USERS.SYS in the same directory that you loaded 
  1250.                 PCBoard from.  If you enter O, a USERS.SYS will also be 
  1251.                 created but it will be output so it is compatible with v14.5.  
  1252.                 Check the documentation for the door you are about to add to 
  1253.                 see if it requires a USERS.SYS file and if so, what type. If 
  1254.                 the door does not need a USERS.SYS file, you should enter N 
  1255.                 in this field.
  1256.  
  1257.     DOOR SYS    Like the USER SYS field, this field will determine if PCBoard 
  1258.                 should create a DOOR.SYS file for the door. Again, you should 
  1259.                 check the door documentation to see if a DOOR.SYS file is 
  1260.                 required for door operation.  If not, leave this field set to 
  1261.                 N.
  1262.  
  1263.         SHELL   This field has three possible options (Y, N, and S).
  1264.  
  1265.                 N - Do not shell to DOS to execute the door.  This means that 
  1266.                 PCBoard will unload completely and then load the door. If you 
  1267.                 use this method then you will have the same amount of memory 
  1268.                 for the door to execute as you had just before you first 
  1269.                 loaded PCBoard.
  1270.  
  1271.                 S - If you use this option, PCBoard will shell to DOS, 
  1272.                 swapping itself to XMS, EMS, or to Disk (whichever is 
  1273.                 available) and will then execute the door batch file.  Using 
  1274.                 this method means that will get about 25k of memory less than 
  1275.                 if you had used N.
  1276.  
  1277.                 Y - Shell to DOS and then execute the door rather than 
  1278.                 exiting PCBoard completely to load the door.  This means that 
  1279.                 you will have less memory available to run the door but it 
  1280.                 also means that it will be quicker loading and returning from 
  1281.                 the door. Typically you may have only 100-200k of memory 
  1282.                 available to the door if you shell to it.
  1283.  
  1284.     Path to..   In this field, enter the path where your door batch file can 
  1285.                 be found.  For example if the batch file for this door is 
  1286.                 stored in C:\PCB\, enter C:\PCB\ in this field.
  1287.  
  1288. Editing/Creating Your Door Batch File
  1289.  
  1290. By far the easiest method to create or edit your DOOR batch files is while 
  1291. you are editing DOORS.LST.  First of all you need to make sure that you have 
  1292. defined a text editor in System Manager.  If you have, highlight the filename 
  1293. field in DOORS.LST and press 2.  This will allow you to create or edit the 
  1294. batch file.  If you want to edit the file manually, you will need to look at 
  1295. your entry in DOORS.LST to determine the name and location of the batch file.  
  1296. The following is sample entry in DOORS.LST
  1297.  
  1298.  
  1299.                                    USER DOOR
  1300.   Filename    Password   Sec Login SYS  SYS  Shell    Path to DOOR Files
  1301.  ---------- ------------ --- ----- ---- ---- ----- --------------------- 
  1302. 1) TESTDOOR                0   N    N    N     N   C:\PCB\DOORS\
  1303.  
  1304.       │                                                  │
  1305.       └─────────────────────────┐                        │
  1306.                                                          │
  1307.                  C:\PCB\DOORS\TESTDOOR                   │
  1308.                        │                                 │
  1309.                        └─────────────────────────────────┘
  1310.  
  1311.  
  1312.  
  1313. You can see that PCBoard thinks that the DOOR batch file is 
  1314. C:\PCB\DOORS\TESTDOOR.  Notice that there is no .BAT extension. Even though 
  1315. it sounds strange it will still execute properly.
  1316.  
  1317. Returning Back To PCBoard From A Door
  1318.  
  1319. If the door you are creating the batch file for has either an S or a Y in the 
  1320. Shell column,  you do not need to add any lines to the batch file in order to 
  1321. return to PCBoard. Once the door batch file has completed, PCBoard will 
  1322. automatically reload.
  1323.  
  1324. If you answered N to the Shell column, you need to reload BOARD.BAT.  The 
  1325. easiest way to do this is to add the following three lines to the end of your 
  1326. door batch file: 
  1327.  
  1328. %PCBDRIVE%
  1329. CD %PCBDIR%
  1330. BOARD
  1331.  
  1332. These lines will first make sure that your system returns to the proper 
  1333. drive, then change to the proper directory to reload, and finally reload 
  1334. PCBoard using BOARD.BAT.
  1335.  
  1336. Debugging
  1337.  
  1338. Debugging a door is an easy process.  There are two commands designed for 
  1339. batch files that you may want to keep in mind -- PAUSE, and ECHO ON.  The 
  1340. PAUSE command can be used to delay further execution of the batch file. This 
  1341. is useful when trying to catch errors that might be displayed as your batch 
  1342. file is running. The pause command will ask you to strike a key when it runs.  
  1343. Therefore you could put a PAUSE command after every command until you find 
  1344. the offending line in the batch file.
  1345.  
  1346. In conjunction with the PAUSE command you can put a line that says ECHO ON at 
  1347. the beginning of the batch file. This will let you see each command of the 
  1348. batch file as it runs.  This method is useful for checking to see if your 
  1349. environment variables are being correctly substituted, changing to the wrong 
  1350. directory, and for tracking other obvious errors.
  1351.  
  1352. Using these two commands together can really help you track down some of the 
  1353. problems you will incur as you are creating your door batch files.  If you 
  1354. have used these techniques and you still are unable to track down the problem 
  1355. perhaps you should consider contacting the author of the door for further 
  1356. help.
  1357.  
  1358. Multiple Nodes
  1359.  
  1360. This section discusses various techniques for installing door programs on a 
  1361. multi-node setup. All of the techniques in this section are designed to help 
  1362. save you time both in the present setup and in the future when you add more 
  1363. nodes. You may use these instructions for setting up door programs in a 
  1364. multitasking or network environment.
  1365.  
  1366. It is assumed that you already know how to setup a door under PCBoard.  If 
  1367. you do not yet know how to setup a door please refer to the Creating a Door 
  1368. section.  It is also assumed that you have a good grasp on how to create 
  1369. batch files and pass parameters inside of batch files.
  1370.  
  1371. You do not have to be a batch file wizard but you should be familiar with the 
  1372. following topics:
  1373.  
  1374. * What a batch file is
  1375. * How to create and edit a batch file
  1376. * Batch file commands (IF, GOTO, etc.)
  1377. * Using  replaceable parameters in batch files (environment
  1378.   variables in particular)
  1379.  
  1380. If you are not familiar with batch files or any of the above topics, please 
  1381. consult your DOS manual's batch file section for more information.
  1382.  
  1383. Because door programs are written by different authors and the fact that 
  1384. there are so many door programs available, you will find that the methods 
  1385. required to setup a particular door program differ greatly.  Some door 
  1386. authors may require you to pass specific information on the command line of 
  1387. the executable file while other door authors may store the information in a 
  1388. configuration file.  Other door programs may use a combination of 
  1389. configuration files and command line parameters.
  1390.  
  1391. Because setting up door programs requires a comprehensive knowledge of 
  1392. creating batch files, setting up door programs in a multinode environment may 
  1393. prove tricky at first. However, your efforts will pay off in the long run 
  1394. especially if you plan on adding more nodes in the future. By using the 
  1395. methods discussed in this section you will learn how you will be able to use 
  1396. one batch file for each door on all of your nodes.
  1397.  
  1398. You can set up your system so that each node has a different DOORS.LST.  
  1399. However, this would mean that you would have to add your door configuration 
  1400. to each node rather than making the change on one node and spreading the 
  1401. change automatically through the entire system. It is strongly recommended 
  1402. that you stay with one single DOORS.LST for your entire system.  See Using A 
  1403. Different DOORS.LST For Each Node for additional information.
  1404.  
  1405. Using One Batch File For All Nodes
  1406.  
  1407. The first step in setting up a door is to browse the documentation included 
  1408. with the door package. Look to see if the door requires any special hardware 
  1409. or software. If you are using a COM port other than COM1 or COM2, you should 
  1410. also check to see if the door will support non-standard COM port definitions. 
  1411. Likewise, if you are using the /M version of PCBoard, check and see if the 
  1412. program supports the FOSSIL interface.  If the door program does not support 
  1413. your hardware configuration, you will not be able to run the door.
  1414.  
  1415. The next step is to install the door on your system as per the instructions 
  1416. provided by the author.  If you have questions on the installation of the 
  1417. door, contact the author for further assistance.
  1418.  
  1419. Test the door program and make sure that it works on at least one node.  Do 
  1420. not proceed until you have confirmed that the door operates properly.
  1421.  
  1422. If the door does not work correctly your best chance of getting the door 
  1423. program to operate correctly is to contact the author of the program directly 
  1424. since they know how their program functions.  If the author of the program is 
  1425. no longer available, try contacting other SysOps to see if they might already 
  1426. have it up and running.  The PCBoard technical support staff is very familiar 
  1427. with the PCBoard program but are not very familiar with the thousands of 
  1428. third party programs that are available for PCBoard.
  1429.  
  1430. Now that you know that the door works you should examine the batch file you 
  1431. use to run the door.  When looking at this batch file you should search for 
  1432. anything that is specific to a particular node.  Look at the following 
  1433. example:
  1434.  
  1435. C:
  1436. CD\DOORS\ABCGAME
  1437. ABCGAME C:\PCB\NODE2\
  1438. C:
  1439. CD\PCB
  1440. BOARD
  1441.  
  1442. Notice how this batch file explicitly uses C:\PCB\NODE2\.  This means that if 
  1443. you ran this door batch file on node 3, it would not work because the 
  1444. C:\PCB\NODE2\ is hard-coded into the batch file.
  1445.  
  1446. Not all of the node specific information is so easy to spot. Let's take a 
  1447. look at another example:
  1448.  
  1449. C:
  1450. CD\DOORS\NEATDOOR
  1451. NEATDOOR ND.CFG
  1452. C:
  1453. CD\PCB
  1454. BOARD
  1455.  
  1456. On the outside it appears this door does not reference any node-specific 
  1457. information.  However, if you  look  in  the configuration file for this door 
  1458. (ND.CFG) you will most likely find that it contains some node specific 
  1459. information. This node specific information might be where to find  
  1460. PCBOARD.SYS, DOOR.SYS, or even what serial port to use.
  1461.  
  1462. Once you have determined where the node specific information is, you will 
  1463. need to find a way around this problem so you can still use one batch file 
  1464. for all of your nodes.  To help you with your door configuration, PCBoard 
  1465. will create four environment variables.  They are as follows:
  1466.  
  1467.     PCBNODE     Contains the number of the node that is executing the door (e.g., 3)
  1468.  
  1469.     PCBDRIVE    Contains the drive letter that PCBOARD.EXE was run from.  
  1470.                 This is sometimes referred to the home drive for the node 
  1471.                 (e.g., D:)
  1472.  
  1473.     PCBDIR      This variable will contain only the directory that 
  1474.                 PCBOARD.EXE was run from.  This is sometimes referred to as 
  1475.                 the home directory for the node and is also the location 
  1476.                 where, PCBOARD.SYS, USERS.SYS, and DOOR.SYS will be created 
  1477.                 (e.g., \PCB\NODE3)
  1478.  
  1479.     PCBDAT      Contains the full drive, path and filename of the PCBOARD.DAT 
  1480.                 that is being loaded for this node.
  1481.  
  1482. If you did not heed the previous warning regarding environment variables and 
  1483. how to use them in batch files, consult your DOS manual for that information 
  1484. at this time.
  1485.  
  1486. A batch file that does not use the environment variables PCBoard provides 
  1487. might look like the following:
  1488.  
  1489. C:
  1490. CD\DOORS\ABCGAME
  1491. ABCGAME C:\PCB\NODE2\
  1492. C:
  1493. CD\PCB
  1494. BOARD
  1495.  
  1496. The same batch file using the environment variables that PCBoard provides, 
  1497. would look like the following:
  1498.  
  1499. C:
  1500. CD\DOORS\ABCGAME
  1501. ABCGAME %PCBDRIVE%%PCBDIR%\
  1502. %PCBDRIVE%
  1503. CD %PCBDIR%
  1504. BOARD
  1505.  
  1506. The following describes each line in the above example.  It will help you 
  1507. understand how and why the environment variable were used:
  1508.  
  1509. C:              Change to the C: drive because that is where the door is 
  1510.                 installed
  1511.  
  1512. CD\DOORS...     Change to the \DOORS\ABCGAME subdirectory (where the door is 
  1513.                 installed)
  1514.  
  1515. ABCGAME...      Execute the door program. Uses the PCBDRIVE and PCBDIR 
  1516.                 environment variables to tell the door where it can find 
  1517.                 specific files (e.g., PCBOARD.SYS) for the node running the 
  1518.                 program.
  1519.  
  1520. %PCBDRIVE%      Change  to  the PCBoard drive (where  the  node subdirectory 
  1521.                 is located)
  1522.  
  1523. CD %PCBDIR%     Change to the PCBoard directory (the node subdirectory)
  1524.  
  1525. BOARD    Reloads your BBS batch file
  1526.  
  1527. The variables (surrounded by % signs) will be replaced by the appropriate 
  1528. values as they are set for each node.  At this point you may be asking 
  1529. yourself, if this makes my node configuration easier, why are the batch files 
  1530. larger?  What you may not be aware of is that you can use this batch file for 
  1531. EVERY node in your system.  This makes both your maintenance and system 
  1532. configuration less complex.  A tradeoff that is well worth the results.
  1533.  
  1534. Consider the following two examples to really appreciate how using 
  1535. environment variables in your DOOR batch files can help you out:
  1536.  
  1537. You add more nodes to your system.
  1538. You change the location or delete the door from your system.
  1539.  
  1540. In the first example you do not really have to do anything to activate your 
  1541. new nodes on the system.  In the second example, if you move the location of 
  1542. the door you only need to change the one batch file to reflect the new 
  1543. location (The first CD command in the batch file).  Can you imagine running 
  1544. 19 nodes and having to change 19 different batch files?  Having numerous 
  1545. batch files for one door also increases your chance of making a configuration 
  1546. mistake.
  1547.  
  1548. Some door programs use a configuration (config) file for normal operation.  
  1549. Some of these programs store node-specific information in these files.  
  1550. Remember, environment variables can only be used in the batch files 
  1551. themselves (i.e., not in config files). This may lead you to wonder how you 
  1552. can still use environment variables and create one batch file for all of your 
  1553. nodes. The answer is quite simple.  Create multiple config files and then use 
  1554. the PCBNODE environment variable to load the proper one.
  1555.  
  1556. As an example lets say you have the following batch file:
  1557.  
  1558. C:
  1559. CD\DOORS\NEATDOOR
  1560. NEATDOOR ND.CFG
  1561. C:
  1562. CD\PCB
  1563. BOARD
  1564.  
  1565. Now, lets say in the ND.CFG file is the following:
  1566.  
  1567. C:\PCB\NODE3\PCBOARD.SYS ;location of PCBOARD.SYS
  1568. 5                        ;number of times game can be played per
  1569. day
  1570. 400                      ;points per win
  1571.  
  1572. If you could use environment variables in other files, the solution would be 
  1573. easy enough, you would replace the C:\PCB\NODE3\PCBOARD.SYS in the ND.CFG 
  1574. file to say %PCBDRIVE%%PCBDIR%\PCBOARD.SYS.  However, you cannot do that 
  1575. because environment  variables cannot  be  read  in  from configuration 
  1576. files.  Therefore, you need another alternative.
  1577.  
  1578. At this point you need to create a configuration file for each node.  You 
  1579. will want to come up with some sort of naming convention. Since the original 
  1580. config file was called ND.CFG you may want to simply tack on the node number 
  1581. to each config file (e.g. ND1.CFG, ND2.CFG, ND3.CFG).  By naming them with 
  1582. the node numbers in the filename we will be able to use the PCBNODE 
  1583. environment variable. The most important thing to remember is that you should 
  1584. remain consistent in your naming conventions. If you do not, you will not be 
  1585. able to use environment variables.
  1586.  
  1587. Once you have created (or copied) a config file for each node you need to 
  1588. change the first line to reflect the location of the PCBOARD.SYS for each 
  1589. node. Next,  you need to make the modification to the batch file. After you 
  1590. have added the environment variables, your batch file would look like this:
  1591.  
  1592.  
  1593. C:
  1594. CD\DOORS\NEATDOOR
  1595. NEATDOOR ND%PCBNODE%.CFG
  1596. %PCBDRIVE%
  1597. CD %PCBDIR%
  1598. BOARD
  1599.  
  1600. The following describes each line in the previous example:
  1601.  
  1602. C:        Change to the C: drive (where the DOOR is installed)
  1603.  
  1604. CD\DOORS...     Change to the \DOORS\NEATDOOR subdirectory (where the DOOR is 
  1605.                 installed)
  1606.  
  1607. NEATDOOR...     Execute the DOOR program using a config file. Because of the 
  1608.                 PCBNODE environment variable a different file will be loaded 
  1609.                 for each node.
  1610.  
  1611. %PCBDRIVE%      Change to the PCBoard drive (where the node subdirectory is 
  1612.                 located)
  1613.  
  1614. CD %PCBDIR%     Change to the PCBoard directory (the node subdirectory)
  1615.  
  1616.  
  1617. And finally, a more complex batch file might look something like
  1618. the following:
  1619.  
  1620. C:
  1621. CD\DOORS\PCBMAIL
  1622. PCBMAIL PCBM.CFG C:\PCB\NODE3\ /PORT:3E8:5
  1623. C:
  1624. CD \PCB\NODE2
  1625. BOARD
  1626.  
  1627. This batch file represents a door which points to a single config file which 
  1628. does not contain information specific to any node (maximum plays per day, 
  1629. points rewarded, etc.).  Also passed on the command line is the location of 
  1630. this node and the final parameter passed on the command line is the base 
  1631. address and IRQ for the COM port (/PORT parameter).
  1632.  
  1633. Do not let the additional parameters worry you. Your goal should still be the 
  1634. same. Replace the node specific information with environment variables.  What 
  1635. makes this problem just a little different is that PCBoard does not create 
  1636. environment variables for the base address and IRQ for COM port.  However, 
  1637. you could easily enough create some environment variables in your BOARD.BAT 
  1638. file which would represent your base address and IRQ for each of your COM 
  1639. ports.  If you wish to do this, add the following lines to your BOARD.BAT:
  1640.  
  1641. SET COMBASE=2f8
  1642. SET COMIRQ=5
  1643.  
  1644. Of course, your system may not use 2f8, with an IRQ of 5 so you should change 
  1645. that information to reflect your system configuration.
  1646.  
  1647. We have now assured ourselves that we have environment variables that we can 
  1648. use to replace all of the node specific information in the previous batch 
  1649. file we are ready to change the batch file.  Your final batch file should 
  1650. resemble the following:
  1651.  
  1652. C:
  1653. CD\DOORS\PCBMAIL
  1654. PCBMAIL PCBM.CFG %PCBDRIVE%%PCBDIR%\ /PORT:%COMBASE%:%COMIRQ%
  1655. %PCBDRIVE%
  1656. CD %PCBDIR%
  1657. BOARD
  1658.  
  1659. One thing that you should note about the above batch file is that the door 
  1660. that was used for this example does use a configuration file called PCBM.CFG. 
  1661. However, this configuration file does not contain any node specific 
  1662. information and that is why we did not have to make any changes.  All of the 
  1663. node specific information was passed on the command line therefore it would 
  1664. be pointless to create multiple configuration files. This batch is a little 
  1665. more difficult because it contains more node specific information on the 
  1666. command line. In reality however, the technique is the same as in the 
  1667. previous examples.
  1668.  
  1669. By now you should have noticed that for all intents and purposes most of the 
  1670. batch file looks the same, the only line that has changed is the line that 
  1671. calls the program. For the most part this is the way most of your door batch 
  1672. files will look.  You will change to the directory where the door is located, 
  1673. run the program, change back to the PCBoard drive and directory, and finally 
  1674. reload the BBS.
  1675.  
  1676. Once you have replaced the node specific information with environment 
  1677. variables, you are now ready to test the door to make sure that, with the 
  1678. changes you have made, the door still works.  If it works on one node, try it 
  1679. on another node and make sure everything still works correctly. As an extra 
  1680. precaution you should try it out on every node (especially when a door uses 
  1681. config files)  to make sure that all nodes work correctly.  If the door works 
  1682. correctly on all nodes, you have properly setup your door for use in a 
  1683. multi-node environment.  If you have problems with any nodes, use the 
  1684. debugging information described previously to help locate the problem.
  1685.  
  1686. There are about as many ways to configure a door as there are door programs 
  1687. out there. The previous examples should be used to aid you in several of the 
  1688. more popular types of  door configurations.  Not all of the configurations 
  1689. could be covered in this section so remember that you may run into 
  1690. configurations that you may not recognize.  If you do run into such a 
  1691. configuration identify the node specific information and use environment 
  1692. variables to create one batch file for all of your nodes
  1693.  
  1694. Using A Different DOORS.LST For Each Node
  1695.  
  1696. If you decided you do not want to go to the trouble of using environment 
  1697. variables in your door batch files, you can have each node use a different 
  1698. DOORS.LST file.  By doing that, you can specify a different location for the 
  1699. door batch file.  For example, instead of storing the batch file in 
  1700. C:\PCB\DOOR\, you may instead choose to locate the batch file in 
  1701. C:\PCB\DOOR\N1\ for node 1, and C:\PCB\DOOR\N2\ for node 2.
  1702.  
  1703. The problem with this type of setup though is that as the number of nodes on 
  1704. your system increases, the time it takes to change the batch files also 
  1705. increase.  If you have two nodes you may only have to edit two batch files.  
  1706. However, if you have 20 nodes online then that means 20 files to edit and 
  1707. consequently more lost time.
  1708.  
  1709. If you decide that separate DOORS.LST files are the way for you, the setup 
  1710. can be accomplished very easily.  Since all of your nodes likely share the 
  1711. same CNAMES file you can change the location of DOORS.LST to look like the 
  1712. following:
  1713.  
  1714.               Menu Listing                     Path/Name List File
  1715. Doors       : C:\PCB\GEN\DOORS             : DOORS.LST
  1716.  
  1717.  
  1718. Notice that only the filename DOORS.LST is in this field.  That means that 
  1719. PCBoard will search the current directory to find the file instead of an 
  1720. absolute location like C:\PCB\GEN\DOORS.LST. Since you are in different 
  1721. directories on every node this means each node will have a DOORS.LST file in 
  1722. their default directory.
  1723.  
  1724. Where to find DOOR.SYS, or USERS.SYS
  1725.  
  1726. Because PCBoard creates DOOR.SYS and USERS.SYS before the door is run and 
  1727. deletes them when returning there may be some confusion as to where these 
  1728. files are created.  These files will be located in the same location as 
  1729. PCBOARD.SYS for the nodes. The best way to determine the subdirectory is to 
  1730. log into that node locally and then press 5.  The subdirectory you are in is 
  1731. the subdirectory where the files will be stored.
  1732.  
  1733. NOTE:  This subdirectory is also the subdirectory that you were in when you 
  1734. loaded PCBOARD.EXE from.  In addition, it is also the subdirectory that is 
  1735. specified by the PCBDRIVE and PCBDIR environment variables.
  1736.  
  1737. Opening A DOOR
  1738.  
  1739. There are four methods with which a door may be opened via PCBoard:
  1740.  
  1741. * Using the OPEN command from the conference command prompt.
  1742. * Using the DOOR command from the conference command prompt.
  1743. * Typing the name of the door at the conference command prompt.
  1744. * If you are using an MNU file, one of your options in the MNU
  1745.   file can execute a door.
  1746.  
  1747. The third and forth methods provide the most interesting possibilities 
  1748. because you can make the door appear to be a more integrated function of your 
  1749. bulletin board system.
  1750.  
  1751. Accessing Parameters Passed To A Door
  1752.  
  1753. Any text that is entered after the door name or number will be passed as 
  1754. command line parameters.  These command line parameters are available to the 
  1755. door application if they will read the PCBDOOR environment variable.  If you 
  1756. open a door called MAIL by typing the following,
  1757.  
  1758. MAIL D;Y;G
  1759.  
  1760. PCBoard will store D;Y;G in the PCBDOOR environment variable. In order for 
  1761. the door to see these parameters, you will most likely have to modify the 
  1762. door batch file.  For the MAIL door mentioned previously, the batch file may 
  1763. resemble the following:
  1764.  
  1765. @ECHO OFF
  1766. CD\DOORS\MAIL
  1767. MAIL
  1768. %PCBDRIVE%
  1769. CD %PCBDIR%
  1770. BOARD
  1771.  
  1772. You must only make one change to this batch file in order to pass the command 
  1773. line parameters to the door.  The change you must make is the line that 
  1774. executes MAIL.   This line would change to read:
  1775.  
  1776. MAIL %PCBDOOR%
  1777.  
  1778. NOTE:  For more information on accessing environment variables in batch 
  1779. files, please refer to your DOS manual.
  1780.  
  1781. Stuffing The Keyboard Upon Return
  1782.  
  1783. When PCBoard returns from running a door, it will check to see if a file 
  1784. named PCBSTUFF.KBD exits in the current directory.  If it does, the contents 
  1785. of this file will be stuffed into PCBoard's keyboard buffer.
  1786.  
  1787. Example
  1788.  
  1789. If you have a door which creates a file that you want to the user to 
  1790. download, you would want PCBoard to automatically download a specific 
  1791. filename.  The first thing that you would need to do is to create a file that 
  1792. you want to stuff into the keyboard.  For this example, the filename created 
  1793. by the door will be called DATA.ZIP.
  1794.  
  1795. In your PCBoard directory create a file named. DATA.STF.  The contents of 
  1796. this file should be the following:
  1797.  
  1798. D;DATA.ZIP
  1799.  
  1800. The only change you will have to make to the door batch file is to add a line 
  1801. that will copy your DATA.STF file to the PCBSTUFF.KBD file.  In your batch 
  1802. file, this line may appear as:
  1803.  
  1804. COPY C:\PCB\DATA.STF %PCBDRIVE%%PCBDIR%\PCBSTUFF.KBD
  1805.  
  1806. The %PCBDRIVE% and %PCBDIR% environment variables are used to insure the 
  1807. PCBSTUFF.KBD file is created in the proper directory. If it is not, PCBoard 
  1808. will not find it and nothing will be stuffed into the keyboard.
  1809.  
  1810. NOTE:  Once the file has been read by PCBoard, it will be deleted.
  1811.  
  1812. Displaying A File Upon Return
  1813.  
  1814. When PCBoard returns from running a door, it will check to see if a file 
  1815. named PCBDOOR.TXT exists in the current directory.  If it does, the contents 
  1816. of this file will be displayed on the local and remote screens.
  1817.  
  1818. Example
  1819.  
  1820. After you have installed a door, you may find it has a problem which will 
  1821. force you to take it temporarily off line.  You could delete the definition 
  1822. of the door from the DOORS.LST file, but that will be more trouble than it is 
  1823. worth if you are taking it off-line temporarily.
  1824.  
  1825. Instead, try inserting a REM before each line in your door batch file except 
  1826. BOARD (if that line is in your door batch file). When you have done this, 
  1827. create a text file that you want to display to your callers.  The next step 
  1828. is for you to add the following line to your door batch file (before BOARD 
  1829. (if that line exists in your batch file):
  1830.  
  1831. COPY C:\PCB\CLOSED.TXT %PCBDRIVE%%PCBDIR%\PCBDOOR.TXT
  1832.  
  1833. Assuming that you name you display file CLOSED.TXT and store it in C:\PCB, 
  1834. that file will be displayed to anyone who runs the door.  What will happen is 
  1835. that DOS will skip all of the lines that begin with REM and then execute the 
  1836. line that you added to your batch file.  Finally it will return to PCBoard 
  1837. which will find the PCBDOOR.TXT and display it on the screen.
  1838.  
  1839. NOTE:  Once the file has been read by PCBoard, it will be deleted.
  1840.  
  1841. Disabling
  1842.  
  1843. To disable doors in a particular conference, simply clear out the fields 
  1844. related to door configuration as shown in the following example:
  1845.  
  1846.               Menu Listing                     Path/Name List
  1847. File
  1848. Doors       :                              :
  1849.  
  1850.  
  1851. If you do this, when a user attempts to open a door they will be informed 
  1852. that no doors are presently available.
  1853.  
  1854. NOTE:  Doors are always disabled for users who do not have established 
  1855. accounts on the system.  The following lists the two possibilities for a user 
  1856. to not establish an account on your system:
  1857.  
  1858. The caller logged in as a new user on a node defined as a closed board and 
  1859. you have a NEWASK questionnaire defined.
  1860.  
  1861. A user calls for the first time.  When asked if they want to register, they 
  1862. choose not to.  In order for the user to remain online, you must give those 
  1863. that refuse to register a security level other than 0.
  1864.  
  1865. Creating Menu
  1866.  
  1867. If doors are available in a conference, when a user types OPEN or DOOR from 
  1868. the conference command prompt they will be shown a file which lists all of 
  1869. the doors that are available on the system.  This file is specified by the 
  1870. following field in the conference configuration:
  1871.  
  1872.               Menu Listing
  1873. Doors       : C:\PCB\GEN\DOORS
  1874.  
  1875. This file is commonly referred to as the DOORS file.  You can edit this text 
  1876. file by pressing F2 or F3 as listed on the bottom of the screen.  When you 
  1877. are creating this file, you should list either the door number or door name 
  1878. (filename in DOORS.LST) and a description of the door for your users.  The 
  1879. user can open the door by typing the door name or door number.
  1880.  
  1881. Script Questionnaires
  1882.  
  1883. Script questionnaires provide a method which you can ask the user questions 
  1884. and record their responses to a text file.
  1885.  
  1886. Creating
  1887.  
  1888. There are two types of script questionnaires you can create. You can use the 
  1889. regular questionnaire type which is a text file with a question on each line.  
  1890. The second type you can create is a PPE file.  To create a PPE file, you need 
  1891. to have purchased the optional PPL (PCBoard Programming Language) Compliler.  
  1892. Any PCBoard v15.0 system can run a PPE file even if the owner of the system 
  1893. did not buy the compiler.  To create the PPE files though, you will need the 
  1894. compiler.
  1895.  
  1896. Scripts are defined for the conference in the SCRIPT.LST file. This file 
  1897. contains the location of the script file and where the answers for the script 
  1898. will be stored.  When you edit the SCRIPT.LST by pressing 2, you should see a 
  1899. screen which resembles the following:
  1900.  
  1901. Conference Name  (#0)       : Main Board
  1902.  
  1903.       SCRIPT Questionnaire Files      SCRIPT Answer Files
  1904.       --------------------------      -------------------
  1905. 1)
  1906.  
  1907. The first field specifies the location of the script questionnaire.  The 
  1908. second field specifies the location where the response file will be stored.  
  1909. PCBoard determines if the file is a standard questionnaire or a PPE file 
  1910. based on the filename extension you specify.  If the filename of the 
  1911. questionnaire ends with PPE, the questionnaire will be treated as a PPE.  
  1912. Otherwise, the file will be treated as a standard questionnaire.
  1913.  
  1914. Standard Questionnaires
  1915.  
  1916. Standard questionnaires are very easy to setup because the questionnaire 
  1917. itself is a text file.  Questions are asked one line at a time and the user 
  1918. is given the ability to respond to each question with a 60 character 
  1919. response.  There is no method provided to check the response of the user.  
  1920. The question itself may be up to 79 characters in length.
  1921.  
  1922. The easiest way to load the script questionnaire file is to press F2 when you 
  1923. are highlighting the script to edit while in the SCRIPT.LST editor.  PCBSetup 
  1924. will use your text editor to load the script questionnaire.
  1925.  
  1926. The first five lines of your questionnaire file is called the script header.  
  1927. You can use these five lines to give your users a brief overview of the 
  1928. questionnaire.  After PCBoard displays the header to the user, they are asked 
  1929. if they wish to continue to answer the script.  If they choose not to respond 
  1930. to your questionnaire, they will be returned back to the system.  If they 
  1931. choose to respond, PCBoard will continue.
  1932.  
  1933. Anything after line five in your questionnaire file is considered a question.  
  1934. Each line is a question.  The following is a simple example of a 
  1935. questionnaire:
  1936.  
  1937. -----------------------------------------------------
  1938.  
  1939. This questionnaire will ask for your name
  1940.  
  1941. -----------------------------------------------------
  1942. Enter your first name?
  1943. Enter your last name?
  1944.  
  1945.  
  1946. If a user will executes this script then they will see the following:
  1947.  
  1948.  
  1949. -----------------------------------------------------
  1950.  
  1951. This questionnaire will ask for your name
  1952.  
  1953. -----------------------------------------------------
  1954.  
  1955. Complete the Questionnaire (Enter)=no? (y)
  1956.  
  1957. Enter your first name?
  1958. ? (Jim                                                         )
  1959.  
  1960. Enter your last name?
  1961. ? (Smith                                                       )
  1962.  
  1963. As you can see, every line after the fifth line is considered as
  1964. a question.  If you want to only display text and not ask a
  1965. question, you would begin the line to display with a semi-colon.
  1966. This is referred to as a comment line.
  1967.  
  1968. If you wish, you can use comment lines to ask questions which
  1969. use more than one line.  Look at the following questionnaire
  1970. file:
  1971.  
  1972. -----------------------------------------------------
  1973. We have several items available for sale.  From
  1974. hardware to software, we have products that fit your
  1975. needs and wants.  If we don't have it, just ask!
  1976. -----------------------------------------------------
  1977. ;We have the following products available for sale:
  1978. ;
  1979. ; 1.  Complete 80486 system with SVGA video system
  1980. ; 2.  Whiz-bang hard-drive
  1981. ; 3.  Plain paper bag software
  1982. Which item would you like to order?
  1983.  
  1984. When the user executes this script, they will see the following
  1985. display:
  1986.  
  1987. -----------------------------------------------------
  1988. We have several items available for sale.  From
  1989. hardware to software, we have products that fit your
  1990. needs and wants.  If we don't have it, just ask!
  1991. -----------------------------------------------------
  1992.  
  1993. Complete the Questionnaire (Enter)=no? (y)
  1994.  
  1995. We have the following products available for sale:
  1996.  
  1997.  1.  Complete 80486 system with SVGA video system
  1998.  2.  Whiz-bang hard-drive
  1999.  3.  Plain paper bag software
  2000.  
  2001. Which item would you like to order?
  2002. ? (3                                                           )
  2003.  
  2004.  
  2005. Notice how those lines that were prefixed with a semicolon were only 
  2006. displayed on the screen.  Only after the items for sale were listed was the 
  2007. user prompted for input by the line in the questionnaire that did not have a 
  2008. semicolon in front of the line.
  2009.  
  2010. PPE Files
  2011.  
  2012. Because PPE files are made from the PCBoard Programming Language the actual 
  2013. creation of these files are too complex to cover in this section.  Instead, 
  2014. you should refer to the documentation that was included with the optional PPL 
  2015. Compiler package for further instructions.
  2016.  
  2017. If you are given a PPE file and need to install it on your system, simply 
  2018. enter the PPE filename in the Script Questionnaire Files field including the 
  2019. .PPE extension.  PCBoard will know that it is a PPE file and execute it 
  2020. properly.
  2021.  
  2022. Reading Responses
  2023.  
  2024. The entire purpose behind questionnaires is to get responses from the users 
  2025. who fill them out.  The responses to your questionnaire will be stored in the 
  2026. filename you specified in SCRIPT.LST as the answer file.  The following is a 
  2027. sample entry in SCRIPT.LST:
  2028.  
  2029.       SCRIPT Questionnaire Files      SCRIPT Answer Files
  2030.       --------------------------      -------------------
  2031. 1)    C:\PCB\MAIN\SCRIPT1             C:\PCB\MAIN\ANSWER1
  2032.  
  2033. In this example, all answers will be written to a file called ANSWER1 located 
  2034. in the C:\PCB\MAIN\ subdirectory.
  2035.  
  2036. Standard Questionnaires
  2037.  
  2038. The response or answer file for a standard questionnaire follows a very rigid 
  2039. format.  PCBoard will begin the response with a row of asterisks (*) to help 
  2040. separate this response from any previous responses.
  2041.  
  2042. The next line contains the name of the user that filled out the 
  2043. questionnaire, the date and time the questionnaire was filled out, the node 
  2044. number the user was on, the security level of the user, and finally the 
  2045. expiration date of the user.
  2046.  
  2047. The rest of the lines in the response file show the question, and the 
  2048. response of the user.  Only the question line is recorded.  If you use 
  2049. comment lines in your script questionnaire they will not be recorded.
  2050.  
  2051. PCBoard will continue to append responses to the file so you may want to 
  2052. periodically delete the response file after you have reviewed the answers.
  2053.  
  2054. PPE Files
  2055.  
  2056. Because PPE files are created using PPL (PCBoard's Programming Language) the 
  2057. way the responses are stored is the responsibility of the PPE author.  
  2058. Therefore, if you do not understand the response format, contact the author 
  2059. of the PPE file.
  2060.  
  2061. Disabling Scripts
  2062.  
  2063. You can disable script questionnaires simply by blanking the SCRIPT and 
  2064. SCRIPT.LST fields in the conference configuration of PCBSetup.  If it used to 
  2065. look like
  2066.  
  2067.  
  2068. Scripts     : C:\PCB\GEN\SCRIPT            :
  2069. C:\PCB\LST\SCRIPT.LST
  2070.  
  2071.  
  2072. change it to read
  2073.  
  2074.  
  2075. Scripts     :                              :
  2076.  
  2077.  
  2078. By doing this, your users will be notified that no scripts currently exists 
  2079. when they try to fill out a script questionnaire.
  2080.  
  2081. Creating The Menu
  2082.  
  2083. In order for your users to know what scripts are available on your system (if 
  2084. any), you need to edit the Script Menu Listing file.  This file is commonly 
  2085. referred to as SCRIPT.
  2086.  
  2087. This is the file that is displayed to the user when they execute the S user 
  2088. command.  This file is nothing more than a text file. Because it is a text 
  2089. file, you can design it to look or display anything you want.  As a general 
  2090. rule it should contain the script number and a description of each script 
  2091. questionnaire. The following is a sample script questionnaire menu file:
  2092.  
  2093. Scripts Available On This System
  2094. ------------------------------------------
  2095.  
  2096. [1] Order a subscription to this system
  2097. [2] Order a product we sell
  2098.  
  2099. You can create this text file using just about any text editor.
  2100. Better yet, if you have defined your text editor or graphics editor in PCBSM, 
  2101. you can simply press F2 or F3 (depending on which file you want to edit).  
  2102. Otherwise you will have to manually edit the files while at the DOS prompt.
  2103.  
  2104. Bulletins
  2105.  
  2106. Bulletins provide a method with which you can display text files to callers.  
  2107. Text files can be created with text editors or even with word processors that 
  2108. allow you to export to ASCII format. You can use bulletins to list current 
  2109. events, rules of your system, legal information in regards to communications 
  2110. services, etc.
  2111.  
  2112. Creating
  2113.  
  2114. Bulletins are very easy to setup.  To configure the bulletins that are 
  2115. available in a particular conference, you need to highlight the following 
  2116. field in the conference configuration screen:
  2117.  
  2118.              Path/Name List File
  2119. Bulletins   :C:\PCB\LST\BLT.LST
  2120.  
  2121. Now press F2 to edit the BLT.LST file.  You should see a screen which 
  2122. resembles the following:
  2123.  
  2124. Conference Name  (#0)       : Main Board
  2125.  
  2126. Enter a list of BLT Paths & Names
  2127. ------------------------------------
  2128.  1)   
  2129.  
  2130.  
  2131. The number on the left hand side of the screen represents the bulletin 
  2132. number.  In the edit field you can specify any filename you wish to display 
  2133. when a user chooses the bulletin number that is listed to the left.  As an 
  2134. example, you may want to have the users view C:\PCB\GEN\ORDER when they view 
  2135. bulletin 1.  If you do, make the following entry in your BLT.LST file:
  2136.  
  2137.  
  2138. Enter a list of BLT Paths & Names
  2139. ------------------------------------
  2140.  1)   C:\PCB\GEN\ORDER
  2141.  
  2142. Adding another bulletin can be dine simply by pressing ALT-I.  You will now 
  2143. see that there is an entry for bulletin F2 that you may fill in with the 
  2144. filename you wish to display.
  2145.  
  2146. Making Bulletins Available For Download
  2147.  
  2148. Any bulletin(s) can be download as long as the location of the bulletin file 
  2149. is included in the DLPATH.LST for the conference. The B user command provides 
  2150. subcommands and explanations for downloading any bulletin number.
  2151.  
  2152. If you want, you may provide compressed versions of the bulletins on your 
  2153. system.  PCBoard will look at the Filename EXTENSION for compressed files in 
  2154. PCBSetup | File Locations | Configuration  to find the extension for 
  2155. compressed files on your system.
  2156.  
  2157. NOTE:  If PCBoard can find a file with the same name as the bulletin and with 
  2158. your compression extension, it will pick that file for download instead of 
  2159. the uncompressed version.
  2160.  
  2161. Disabling
  2162.  
  2163. To disable bulletins in a conference, you simply clear out the fields that 
  2164. relate to bulletins in a conference configuration screen.  For example, if 
  2165. your bulletin fields contain the following information:
  2166.  
  2167.               Menu Listing                     Path/Name List
  2168. File
  2169. Bulletins   : C:\PCB\GEN\BLT               : C:\PCB\GEN\BLT.LST
  2170.  
  2171.  
  2172. then you would blank them out making them look like the
  2173. following:
  2174.  
  2175.               Menu Listing                     Path/Name List
  2176. File
  2177. Bulletins   :                              :
  2178.  
  2179. Your bulletins would then be disabled and your users would be warned that no 
  2180. bulletins currently are available on the system if they tried to view any of 
  2181. the bulletins.
  2182.  
  2183. Creating Menu
  2184.  
  2185. Whenever a user presses B and RETURN, a list of bulletins that exist on the 
  2186. system will be displayed.  The file that is displayed to your callers is the 
  2187. bulletin menu listing.  The filename for this menu or the actual menu itself 
  2188. may be changed by editing the following field in the conference configuration 
  2189. screen:
  2190.  
  2191.               Menu Listing
  2192. Bulletins   : C:\BLT\BLTMENU
  2193.  
  2194.