home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / zip / bbs / transbbs.lzh / SYSEDIT.TXT < prev    next >
Text File  |  1992-04-26  |  50KB  |  1,083 lines
  1. Kudos!!
  2.  
  3. Greg has been instrumental in making sure this program is as bug free as 
  4. possible. He has offered ideas and suggestions that have been very 
  5. helpful. Thanks Greg!
  6.  
  7. Without David's programming abilities and doing most of the work in the 
  8. text version of the System Editor, the GEM version would have been a 
  9. nightmare. You would not believe what all is involved in this thing. A 
  10. lot of the routines in the text version was transported over and minor 
  11. modifications done.
  12.  
  13. This archive should contain the following files. These files should be
  14. placed in the same location as SYSEDITG.PRG. After setup is complete, you 
  15. will need to copy the below files to their proper folder.
  16.  
  17. SYSEDITG.PRG        G = GEM
  18. SYSEDIT.RSC    Goes in the same directory that SYSEDITG.PRG is ran from.    
  19. SYSEDIT.DOC
  20. PROTOCOL.DAT   Goes in \DATA\ folder
  21. COMMAND.DAT    "                   "
  22. EVENTS.DAT     "                   "
  23. MASKS.DAT      "                   "
  24. MACROS.DAT     "                   "
  25. PROMPT.DAT     Goes in \TEXT\MENUS0 folder
  26.  
  27. This is the GEM version of the System Editor. I have made every effort to
  28. ensure that this program is bug free. I am not responsible for any damages,
  29. loss of data, income, etc. due to the use or misuse of this program. You
  30. accept it as is.
  31.  
  32. First thing you should do is backup your data. The files you should backup
  33. are listed below. If you are creating a New BBS, then don't worry about
  34. these files.
  35.  
  36. TRANS.DAT
  37. PROTOCOL.DAT
  38. MASKS.DAT
  39. MACROS.DAT
  40. EVENTS.DAT
  41. COMMAND.DAT
  42. USERS.DAT
  43. USERS.IDX
  44.  
  45. Any files related to a Message Base that you intend to edit. These files
  46. are listed below. xx refers to the number of the base.
  47.  
  48.    MTOPxx.TXT
  49.    BASExx.TXT
  50.    Mxx.DAT
  51.    Mxx.IDX
  52.  
  53. Any files related to a file area that you intend to edit. These files are
  54. listed below. xx refers to the number of the file area.
  55.  
  56.    FTOPxx.TXT
  57.    Fxx.DAT
  58.    Fxx.IDX
  59.  
  60. This program has been tested and at the time of this writing, there are no
  61. known problems with maintaining data integrity. Backing up the files just
  62. ensures you that you can restore the files in case of problems.
  63.  
  64. Now, run SYSEDITG.PRG. You will be presented with a dialog box. After you
  65. press Return or click on OK, the program will load some files and then
  66. present you with a menu. You will need about 265K of free memory in order
  67. to run this program.
  68.  
  69. *** Entries are Menu headings
  70. **  Entries are Menu selections
  71. *   Entries are submenu selections
  72.  
  73. *** File ***
  74.  
  75. ** Load TRANS.DAT
  76.  
  77. When you select this option, you will be presented with a file selector if
  78. the program does not find TRANS.DAT. This will allow you run the program
  79. from another drive. Use this option also for reloading the TRANS.DAT file
  80. in case you want to start over. If you are setting up a new BBS, when the
  81. file selector appears, just select OK and it will automatically step you
  82. through the program to create a new BBS.
  83.  
  84. ** Save TRANS.DAT
  85.  
  86. When you select this option, you will be presented with a file selector.
  87. This will allow you to save TRANS.DAT. The file selector will default to
  88. the drive SYSEDITG.PRG was ran from but, you can save it to anywhere you
  89. want. Just make sure you save a copy of it to the drive/folder that
  90. contains the BBS program. ANYTIME you make changes, you need to Save
  91. the TRANS.DAT file. You will be asked if you want to save the file before
  92. you Quit if you have not already done so.
  93.  
  94.  
  95. *** Edit ***
  96.  
  97. ** Message Bases
  98.  
  99. This option will take you to another menu where you will have several
  100. options.
  101.  
  102. * Edit Message Bases
  103.  
  104. This option will present a dialog box where you can edit the available
  105. Message Bases. This option will start you at Message Base 1. Below is a
  106. description of each field of the dialog box. All items deal with the 
  107. currently selected message base only.
  108.  
  109. Name - This is the name of the Message Base. This is the name that will be
  110. displayed to the user.
  111.  
  112. Maximum Messages - This is the maximum amount of messages you want to have
  113. in the message base. Once the message base reaches this amount of messages,
  114. it will roll over. If you assign 50 message slots and the program reaches
  115. 50 messages in the base, the first message will then be deleted and the
  116. next message (# 51) will take it's place. The higher the number of maximum
  117. message you assign, the larger the data file.
  118.  
  119. Maximum Lines - This is the maximum number of lines that a user can enter
  120. as a message. Anything past this point becomes an Extended message and will
  121. be saved in the EXTENDED folder. The higher the number, the larger the data
  122. file. If you edit the Message Base and change the maximum number of lines,
  123. you will be asked if you would like to Reformat or Convert the Message
  124. Base. See below under Reformat 1 Base for full details on this.
  125.  
  126. Minimum Age - The user's age must be at least this age before he/she can
  127. enter a message base.
  128.  
  129. Group Number - This tells the program what group this message base belongs
  130. to. In other words, say you wanted all the message bases related to the
  131. Atari computers grouped together. You assign number 1 to all message bases
  132. dealing with Atari computers. Now, the user selects from a menu and selects
  133. Atari Computers which you have assigned the number 1 to. The program then
  134. displays all available Message Bases assigned to group 1. Sort of a
  135. Category and Topic sort of thing. This feature will be in a later version
  136. of Transcendence. At the moment, you can ignore it.
  137.  
  138. ** You may enter On or Off in the following fields or you can click on them
  139. with the mouse to toggle them On or Off. Upper or lower case is accepted.
  140.  
  141. Remote Message Ops - This will tell the BBS whether or not to allow Remote
  142. Message Ops. Not used at the moment.
  143.  
  144. Anonymous - This tell the BBS whether or not to allow anonymous messages.
  145.  
  146. Alternate Message Header - This tell the BBS whether or not to use an
  147. alternate header for message status (if available) or not. With the use of
  148. variable tags, you can design your own headers in a text file that includes
  149. Message number, Status, etc. Whatever you want.
  150.  
  151. Allow Any Name - This tells the BBS whether or not to allow the user to
  152. post a message using any name he/she wishes. Obviously this should be a
  153. very controlled privilege and should not generally be used. There may be
  154. Message Base that this would be allowed but, not usually.
  155.  
  156. Allow ESC codes - This tells the BBS whether or not to allow the use of ESC
  157. codes in a message. VT52 text and graphics use ESCape codes to control text 
  158. color, background color, etc. With this off, the program will weed those 
  159. codes out.
  160.  
  161. Allow Variable Tags - This will allow the use of variable tags within a
  162. message base. Variable tags are used in the text files you create also.
  163. For instance, if you wish to post a message and each time a caller logs on
  164. and reads that message, if you place the variable tag for the user's name
  165. in the message, then the user's name would appear in the message and it
  166. looks as if it is a personal message to that user.
  167.  
  168. Next - Takes you to the next Message Base. It will grey out and become
  169. unselectable when it reaches the last Message Base.
  170.  
  171. Previous - Takes you to the previous Message Base. It will grey out and
  172. become unselectable when it reaches the first Message Base.
  173.  
  174. * Reformat 1 Base
  175.  
  176. This will allow you to reformat, convert or restore a single Message Base.
  177. You will be presented with a list of the current Message Bases to choose
  178. from. Select the Message Base you wish to reformat. The Dialog box for
  179. editing a Message Base will appear. Edit it as you wish and select Exit.
  180. You will then be asked if you wish to Reformat, Convert or Restore Original
  181. Message Base and then asked if you are sure. Here is your chance to abort.
  182. All .DAT & .IDX files that apply during a Convert will renamed to .DA &
  183. .SP. The data is then taken from these files and converted to the new
  184. format. The program will not delete these backup files. You will need to
  185. copy them to another place and/or delete them before you do another
  186. Conversion on that message base.
  187.  
  188. Reformat - Choosing reformat will zero out all messages. You will then be
  189. asked if you wish to set all the user's counters. If you choose to do so,
  190. the user's counters will be reset to 0. A dialog box will appear displaying
  191. the status.
  192.  
  193. Convert - This will allow you to convert a Message Base. It was designed to
  194. allow you to change the Maximum number of Lines allowed without having to
  195. reformat your Message Bases. If you have your Max. Lines set to 20 and
  196. later on wanted to change it to 10, then choosing Convert would take all
  197. messages and convert them to the new line length. If the messages are
  198. longer than the Max. Lines, then they will become Extended Messages. If
  199. not, then they will remain the same. If a message is already Extended, then
  200. it will remain that way. Every attempt to save your information has been
  201. offered.
  202.  
  203. Restore Original - This will allow you to restore the Message Base settings
  204. back to original. If you did a Convert, the .DAT & .SPD files are backed
  205. up. By deleting the .DAT & .SPD files and renaming the backups (.DA & .SP)
  206. to .DAT & .SPD, you can restore your original settings and Message Bases.
  207. You will need to do this in advance since you will only be asked if you
  208. wish to restore the original after you have been asked for the new data
  209. for that Message Base when you select Reformat 1 or All Bases. The program
  210. will then do some calculations based on the info you provided and if they
  211. match up, then all is ok and you will be notified that the restore has
  212. taken place. If not, then you will be notified that the numbers do not
  213. match. You can also do a restore on a Message Base if you have Reformatted
  214. it. This will only work properly if you backup the .DAT & .SPD files
  215. before you reformat them. Just delete the .DAT & .SPD files and replace
  216. them with the backups. I will give you a quick example.
  217.  
  218. I have Message Base 1 setup for 50 messages and 15 lines. One day I decide
  219. that I want to reduce it to 25 messages and 10 lines. I want to save the
  220. messages so I select Convert. Now, later on, I get complaints and decide
  221. to change it back. I can still keep the data by doing a Restore Original.
  222. I grab the M1.DAT & M1.SPD files and move them to another place (I want to
  223. keep them) and I rename M1.DA to M1.DAT & M1.SP to M1.SPD. Now I go into
  224. the System Editor and select Message Bases and select Reformat 1 Base 
  225. and the Edit dialog box appears. Now remember my original settings were
  226. 50 messages and 15 lines so, I enter these numbers into the appropriate
  227. fields and select Exit. The program will then ask if I want to Reformat,
  228. Convert, or Restore Original. I select Restore Original and then YES. The
  229. program calculates the numbers and finds everything to match up and tells
  230. me my Original Settings have been restored. I now have my original Message
  231. Bases back and my users are happy. Any messages entered after the 
  232. conversion and before the restore are lost.
  233.  
  234. * Reformat ALL Bases
  235.  
  236. This will just step through each Message Base and offer the same functions
  237. as Reformat 1 Base.
  238.  
  239. * Edit A Base
  240.  
  241. This is basically the same as Edit Message Bases except, it will display a
  242. list of the Message Bases so that you can choose a starting point. If you
  243. wanted to edit Base 20, then it would be a pain to start at 1 and have to
  244. Next your way to 20.
  245.  
  246. * Delete a Base
  247.  
  248. This will allow you to delete a Message Base. You will be presented with a
  249. list of Message Bases and asked which one. You will then be asked if you
  250. want to delete that Message Base. Selecting No will abort. Selecting Yes
  251. will delete the Message Base and renumber the bases. ALL file associated
  252. with that Message Base will also be renumbered so that MTOPxx.TXT, etc.
  253. will stay with that base. After it renames the files, it will then adjust
  254. the user's accesses to that base.
  255.  
  256. * Insert/Add a Base
  257.  
  258. This will allow you to Insert or Add a Message Base. You will be presented
  259. with a list of available Message Bases. Enter the position you wish to put
  260. this base. If you wanted it to become Message Base 2, then you would enter
  261. 2. You will then enter the data (See Edit Message Bases above). You will
  262. then be asked if you want to do this. The program will then modify and
  263. create the necessary files. If you Inserted the base, then all bases
  264. above it and all the files that go along with it will be renumbered. The
  265. user's access to that base will be adjusted. They will be given the basic
  266. access of Enter, Read and Post.
  267.  
  268. * Reset Message Counters
  269.  
  270. This will allow you to set all the user's counters to a value that you
  271. enter. You will be asked if you wish to do this before it does it. Make
  272. sure you read the dialog box that ask you for the value. Depending on which
  273. selection you choose, it will ask for settings differently.
  274.  
  275. ALL Counters - This will allow you to reset all the user's counters in ALL
  276. the message bases to a specified value.
  277.  
  278. One Counter - This will allow you to reset the user's counters in 1 base.
  279. You will be presented with a list of Message Bases to choose from. You then
  280. enter the desired number to set it at.
  281.  
  282. Some Counters - This will step through each Message Base and ask for the
  283. desired number to set the user's counters to.
  284.  
  285. ** Email
  286.  
  287. This will allow you to Rename your Email Base or Reformat it.
  288.  
  289. Rename - Just that, it allows you to rename your Email Base. Nothing
  290. special to do or know. The Max. Messages & Max. lines will be
  291. greyed out.
  292.  
  293. Reformat - It allows you to rename your Email Base and change the Max.
  294. Messages and Max. Lines. You will be asked if you are sure and if you
  295. choose YES, then it will zero out all your data.
  296.  
  297. ** File Areas
  298.  
  299. The File Areas are basically set up the same as Message Bases. You will
  300. have the same options as the Message Bases except for Reset Message
  301. Counters. The options work the same as in Message Bases except, Reformat 1
  302. or All Areas will not create Extended file descriptions. This is due to the
  303. fact that the BBS program does not use Extended file descriptions. The user
  304. can only enter the amount of lines of information that you set up. Since
  305. there are no extended file descriptions, if you Reformat or Convert a file
  306. area and have chosen a lower amount of lines for the description, then
  307. they will be chopped off.
  308.  
  309. * Edit File Areas - This allows you to edit the files areas. Below is an
  310. explanation of the fields located on the Edit screen.
  311.  
  312. Name - This is the Name of the File Area. This is the name that the users
  313. will see when they make their choice as to what File Area to go to.
  314.  
  315. Folder - This is the name of the folder that will hold all the files
  316. associated with that File Area. The files that are uploaded and the
  317. description files will go here. You will be asked if you want the program
  318. to create this folder. If it is already there, then there will be no
  319. problem if you say YES.
  320.  
  321. Maximum Lines - This is the maximum number of lines that will be allowed
  322. for entering a description. If it is set to 15, then only 15 lines of
  323. description can be used. You don't want to have too many lines but you also
  324. don't want to have too few lines. 10 - 15 lines is generally enough. In the
  325. File Area where I have ST Reports and Znets, I have it set to 15 because
  326. the contents of that issue usually run about 11 lines.
  327.  
  328. Minimum Age - This is the minimum age of a user that is required in order
  329. for them to enter into the File Area. 0 = Any Age.
  330.  
  331. Upload Level - This is what level the uploads will default to if the user
  332. that uploads the file does not have the privilege of choosing/setting the
  333. upload level. The user must have this File Access Level before he/she can
  334. see it. If he/she cannot see it, then they cannot download it, etc. I have
  335. all my files default to 255 when uploaded. This means that only I or anyone
  336. with that access level (generally only those with sysop access should have
  337. this level) can see it until it has been validated/released by me. I do 
  338. this by changing the level of the file.
  339.  
  340. Group Number - This is the same as Group Number under the Message Bases. It
  341. just groups File Areas together. If I have all the Atari File Areas set
  342. with group number 1, then when the user chooses Area 1, then he/she will be
  343. shown the File Areas under that group. As stated before, this is not a
  344. feature in Transcendence at this moment and for now can be ignored.
  345.  
  346. The below settings can either have the words On or Off typed in them or
  347. they can be toggled On/Off by clicking on them with the mouse. It does not
  348. matter if you type it in upper or lower case.
  349.  
  350. Remote File Ops - This tells the BBS that Remote File Ops are allowed. Not 
  351. used at the moment.
  352.  
  353. The below settings with the exception of Auto-Compress will tell the BBS to
  354. ask for this information when a user enters the description of a file that
  355. he/she uploaded or when the description of that file is being edited.
  356.  
  357. Anonymous - This tells the BBS that a user can upload a file anonymously.
  358.  
  359. Ask Computer Type - This tells the BBS to ask for the Computer Type.
  360. If you have the COMPUTER.DAT file in the DATA folder, then that file will
  361. be displayed. Otherwise, they will be able to enter in anything they want.
  362.  
  363. Ask Monitor Type - This tell the BBS program to ask for Monitor type. They
  364. will be asked if it is Color, Monochrome or both. This will let a user know
  365. if the program requires a certain monitor.
  366.  
  367. Ask File Type - This tell the BBS to ask for the type of file. It was
  368. designed for asking whether or not the file is a Utility, Application,
  369. Game, etc. You can use it for whatever you want. If the file TYPE.DAT is in
  370. the DATA folder, then it will display it and the user will choose from this
  371. list. Otherwise, the user will be able to enter in any information they
  372. want.
  373.  
  374. Alt. File Header - This tells the BBS to look for FHDRxx.TXT (xx = File
  375. Area number) and display it. This is the header information where it tells
  376. all about the file. It includes things such as Filename, Filenumber,
  377. Uploader, Date of Upload, etc. You can create this file using any of the
  378. variable tags and put in the information you want. If it does not find this
  379. file, then the built in header will be used.
  380.  
  381. Auto-Compress - I can't remember. David, fill in here.
  382.  
  383. Next - This will advance you to the next File Area.
  384.  
  385. Previous - This will take you to the previous File Area.
  386.  
  387. Exit - This will exit the editing of that File Area. Follow any prompts
  388. that may appear.
  389.  
  390. * Reformat 1 Area - This allows you to Reformat, Convert or
  391. Restore Original File Area. If you do a Restore, you WILL need to know the
  392. amount of lines you allowed in the old file area files.
  393.  
  394. * Reformat ALL Areas - This will step you through each File Area and offer
  395. the same options as Reformat 1 Area.
  396.  
  397. * Edit An Area - This will display a list of File Areas to choose from.
  398. This allows to select a starting point other than 1.
  399.  
  400. * Delete An Area - This allows you to delete a File Area. All File Areas
  401. and their associated files will be renumbered from that point on.
  402.  
  403. * Insert/Add An Area - This allows you to Insert/Add a File Area. If you
  404. Insert an Area, then all File Areas and associated files above the point in
  405. which you inserted it will be renamed.
  406.  
  407. ** Command Tables
  408.  
  409. This will allow you to setup your Command Tables. This is where you define
  410. what commands will be available to the users. These are the commands that
  411. available from the Main Menu, File Menu and Message Menu. You will need
  412. to know what the Function names are. These are the Built in BBS Procedures.
  413. You should have an example COMMAND.DAT file already. You will be presented
  414. with a menu. You will have the option of Edit Command tables and Reload
  415. Command Tables.
  416.  
  417. * Edit Command Tables - This will allow you to edit the Command Tables.
  418. Below is a description of each field.
  419.  
  420. Keystroke - This is the keystroke that is required in order to activate
  421. that function.
  422.  
  423. Status - This will tell the BBS whether or not this command is On or Off.
  424. If On, then the user will ne able to select it. If Off, then they will not
  425. be able to select it. Use the mouse to toggle it On or Off.
  426.  
  427. Type - There are 4 types of Commands. Select this field with the mouse and
  428. you will be presented with a menu to choose from. It will then insert that
  429. information into the field.
  430.  
  431.   Internal BBS Procedure - These are the commands that are built into the
  432. BBS. Example: If you want the user to be able to page the Sysop, there is
  433. an Internal BBS Procedure called CALLSYS that will allow the user to do
  434. this. It just tell the BBS that the name in the Filename field is the name
  435. of a built in procedure/command.
  436.  
  437.   Text/Menu/Script - This tell the BBS that the name in Filename is the
  438. name of a file and that it should display it to the user. This file can be
  439. a simple text file, a text file that is a menu or a script file. The BBS
  440. will know the difference.
  441.  
  442.   External Module - David, fill in here.
  443.  
  444.   External BBS Module - Fill in here also.
  445.  
  446. Filename - This is the name of the built in BBS procedure, drive, path and
  447. filename of a Text/menu/Script file or module. For a text file, you would
  448. enter something like 'G:\HANDLES.TXT'. This would display the file if the
  449. user chose this command.
  450.  
  451. Reaction - This is what the BBS will send out due to the user selecting
  452. this command. If the user chooses this option and I had it set to view the
  453. file 'G:\HANDLES.TXT' and that file displayed the handles and Real name of
  454. the user, then I would want a reaction of 'View Handles'. This appears if
  455. the user has Hotkeys selected.
  456.  
  457. Access - This is the Command Access Level of a user that is required
  458. before the user can access this command. If I wanted only users with a
  459. Command Access Level of 10 or higher to access the online games, then I
  460. would put 10 here.
  461.  
  462. Parameters - This is where you would place any parameters that needs to be
  463. sent to an external program. If you wanted this command to run ARC.TTP and
  464. you wanted ARC.TTP to compress a file, then you would pass on something
  465. like '-a COMMAND.ARC G:\DATA\COMMAND.DAT'.
  466.  
  467. Now you will notice the days of the week and On At and Off At. This allows
  468. you to have this command only active certain days and certain times of the
  469. day. If you only wanted to have this command active on Monday - Friday,
  470. then you would select it with the mouse to toggle it On/Off. If it is
  471. highlighted, then it is on. Now you can set the times of the days you have
  472. it active for. Say you wanted this command active from 6:00 am to 1:00 pm,
  473. you would enter in 060000 and 130000. The program will automatically take
  474. you past the ':'. Just type in the numbers. This allows for a lot of
  475. flexibility in your commands. To have it on at ALL times, then it must be
  476. set to 'On At: 00:00:00' and 'Off At: 00:00:00'. If you have it set to 'On
  477. At: 01:00:00' and 'Off At: 01:00:00', then this is the same as having it
  478. off. You can have the same keystroke activate different commands at
  479. different days. In the example above, I had this keystroke display a text
  480. file from Monday to Friday. Now, say I wanted this keystroke to allow the
  481. users to play online games on Saturday and Sunday. I would put in the
  482. information and highlight Saturday and Sunday ONLY. A keystroke can
  483. basically activate different things at different days of the week and
  484. different times of the day. DO NOT have the same keystroke activate
  485. different commands at the same time. You can have it set up for different
  486. days or the same day and different times. Whew! I hope you got that.
  487.  
  488. Daily Schedule - Selecting this button with the mouse will pop up a dialog
  489. box. You can enter the 'On At' and 'Off At' times and it will turn on ALL
  490. days and set these times in ALL the 'On At' and 'Off At' times. It is just
  491. a shorter way of enter the information if you want the command active at 
  492. the same time and on ALL the days.
  493.  
  494. Exit - This will exit you out of editing the Commands and you will be asked
  495. if you want to Save COMMAND.DAT.
  496.  
  497. Cancel - This will exit you out and not change any information. All
  498. information you entered will be lost.
  499.  
  500. Change Tables - You have 3 tables/menus to enter commands for. This allows
  501. you to switch to one of those tables. You will have the choice of Main,
  502. File and Message.
  503.  
  504. Find Key - This will allow you to search for a particular keystroke. Lower
  505. or uppercase is acceptable.
  506.  
  507. Print Tables - This will allow you to print out your Command Tables. You
  508. have three methods of printing them out.
  509.  
  510.   Print Commands Only - This will only print out the top portion of the
  511. Command Tables. The Schedule will not be printed. If you just want to know
  512. what you have each keystroke setup as, then use this one.
  513.  
  514.   Print Commands With Schedule - This will print out ALL information on the
  515. command including ALL days and On and Off times.
  516.  
  517.   Print Commands With Partial Schedule - This will print the Command data
  518. and the Day and Times that you have the command active. For instance, I
  519. have the command only active on Monday. The program will print the command
  520. data and 'Monday   On At: 00:00:00  Off At: 00:00:00' instead of all the
  521. days and times as with the above option.
  522.  
  523. Command Summary - This will bring up another dialog box that will display 
  524. a summary of the Commands for the currently selected table. It will display 
  525. the Keystroke, Filename and Reaction. It will display 8 commands at a time. 
  526. Click on the arrows to page up or down. If you click on a filename field, 
  527. you will be taken back to the Command screen and the command you selected 
  528. will be displayed.
  529.  
  530. * Reload Command Table Data - This gives you the option to Reload the data
  531. from disk. This is useful if you decide you want to restore all the
  532. information back to original. This is only handy if you have not Saved any
  533. of the changes. When you Exit the editing, you are asked if you want to
  534. Save the data, if you choose NO, then the information is not saved but,
  535. the changes are still in memory. In order to restore the information back
  536. to original in memory you will need to reload the data (if you haven't
  537. saved it to disk).
  538.  
  539. ** Macros
  540.  
  541. If the Macro file is found when the BBS runs, it will allow the users to
  542. use Macros. This allows the user to define a key to store test in, a
  543. sequence of keystrokes, etc. If I did a certain sequence of keypresses a lot,
  544. I could setup a macro to do this for me. I would just press Control-A and
  545. the Macro Number and the contents of that Macro would be inserted at the
  546. point that I am currently at.
  547.  
  548. This option will allow you to Reformat/Define the number of Macros and
  549. their length or Delete them.
  550.  
  551. * Reformat
  552.  
  553. This will allow you to Reformat/Define the number of Macros for each user
  554. and the length of each Macro. I have mine set at 10 macros with 20
  555. characters each. You will be asked for the number and the length. If the
  556. file is found, it will notify you that the file exist and ask if you want
  557. to overwrite it. The program will display the current record it is on.
  558.  
  559. * Delete
  560.  
  561. This will just delete the file. It will ask you if you are sure.
  562.  
  563. ** Events
  564.  
  565. An Event to the BBS is a program that is to be executed on a certain day
  566. and at a certain time of the day. You can run any program. There are
  567. several programs that are designed to be ran with Transcendence as Events.
  568. One such program is called Cleanup. It is designed to help the Sysop by
  569. searching for duplicate users, Archive files, etc. Now, if you wanted to
  570. run this program each night at a certain time, then you could set it up as
  571. an event.
  572.  
  573. This option will allow you to do several things.
  574.  
  575. * Edit Event
  576.  
  577. This will allow you to edit an existing Event. Below is a description of
  578. the Edit Event screen. Anytime you Exit the edit screen, you will be asked
  579. if you want to save the data. If you select no, then it will not save it
  580. but, the changes will remain in memory.
  581.  
  582. Filename - This is where you enter the Drive, path and filename of the
  583. program to execute. Example: G:\MODULE\CLEANUP\CLEANUP.TTP.
  584.  
  585. Parameters - This is where you would pass on any parameters/info to the
  586. program that is going to be executed. If you have ARC.TTP setup to run each
  587. night and you wanted it to ARC your TRANS.LOG file, then you would pass on
  588. these parameters. '-a G:\DATA\TRANSLOG.ARC G:\DATA\TRANS.LOG'.
  589.  
  590. Priority - This is where you tell the BBS how urgent it is to run this
  591. program.
  592.   0 (zero) turns the event off.
  593.   1 is Low priority. This will tell the BBS that if a user is online, then
  594.     don't bother with it.
  595.   2 is Medium priority. This will execute the program with the user still
  596.     online. It will tell the user to stand by and then execute the program.
  597.   3 is High priority. This will decrease the user's amount of time left
  598.     online for that call. If the user logs on and has 1 hour for that call
  599.     and the event is take place in 15 minutes, then the user will only have
  600.     15 minutes for that call. The program will then start warning him that
  601.     an event is going to take place in so many minutes. You determine that
  602.     in the General Setting. Refer to Warn Events activating in: under Edit
  603.     Settings. Page 2. When the user's time is up, it will log him/her off
  604.     and execute the event. Only the user's time for that call is reduced.
  605.     His/Her overall time is not affected.
  606.   4 is After each call. This tell the BBS to run this program after each
  607.     user has logged off.
  608.  
  609. Modem Info - This is used to send information to the modem before the
  610. execution of the event. If you wanted the modem to be taken offhook or Auto
  611. Answer disabled before that event was executed, then you would type in the
  612. appropriate information on this line. After the execution of that event,
  613. then the modem is reset to the default setting you have in your MODEM.DAT
  614. file.
  615.  
  616. The selection of days of the week and the times of the day for the event to
  617. run is works the same as explained under Edit Commands. It just tell the
  618. BBS to execute this event anytime between On At: to Off At:. This just
  619. means that if you have it set to Low priority and a user is online at the
  620. time the event is to be executed, then when the user logs off and the time
  621. is before the Off At time, then the event will still be executed.
  622.  
  623. Daily Schedule - This works the same as explained under Edit Commands.
  624.  
  625. Next - This will take you to the next event.
  626.  
  627. Previous - This will take you to the previous event.
  628.  
  629. Exit - This allows you to exit the editing of the event and it will ask you
  630. if you want to save the data.
  631.  
  632. * Reformat Events
  633.  
  634. This will zero out all the event information. You will be asked if you are
  635. sure you want to do this.
  636.  
  637. * Extend Events
  638.  
  639. If you have 3 events setup and you want to add a 4th one, then you would
  640. select this option and enter in the number of events you want to add. In
  641. this case, you would type in 1 since you only want 4 events and already
  642. have 3. You MUST do this if you want more events than you previously
  643. defined. You would then Select Edit Events and select Next until you reach
  644. the last event. There should be no data in any of the fields.
  645.  
  646. * Delete Event
  647.  
  648. This will allow you to delete an event. You will be asked which event to
  649. delete and then asked if you are sure. When you delete an event, all other
  650. events are pulled up. In other words, if you had 4 events and you delete
  651. event number 2, then event 3 will become event 2 and event 4 will become
  652. event 3.
  653.  
  654. * Reload Event Data
  655.  
  656. This allows you to reload the data from disk. This is in case you change
  657. your mind about the changes BUT, you have not saved the data yet.
  658.  
  659. ** Drives
  660.  
  661. This will allow you to edit the drives and paths that information is stored
  662. on. You can define up to 32 drives to hold the BBS files on and the folder
  663. in which that information is located. The BBS program will search for the
  664. drive with the most free space to store files on. This is done with some
  665. files the first time they are created and some file are done everytime.
  666. Example: When the BBS first creates the file description file, it will
  667. search for the drive with the most space to create F1.DAT and F1.IDX for
  668. file area number 1. Now, each time a file is uploaded, it will search for
  669. the drive with the most space to store that file on but, the description
  670. for that file will still be written to the drive that F1.DAT and F1.IDX
  671. was created on. If you only have drive G setup for the BBS's use, then
  672. just type in G. If you have drive C,D,E & F setup for the BBS's use, then
  673. you would enter CDEF on the drives line. You could have each folder that
  674. holds certain information on a different drive. Take a look at the drives
  675. screen and you will see what I mean. All folder information may be entered
  676. in upper or lowercase.
  677.  
  678. Data Files - This is where data files such as USERS.DAT, TRANS.LOG, etc.
  679. are stored.
  680.  
  681. Message Bases - This is where all the Message Base and Email files are
  682. stored.
  683.  
  684. File Areas - This is where all the File Area folders and information is
  685. stored.
  686.  
  687. Text Files - This is where all text files are stored. These are file such
  688. as MAINMENU.TXT, LOGOFF.TXT, etc.
  689.  
  690. Backups - This is where all files that are backed up by the BBS are stored.
  691.  
  692. Module Routines - This is where files such as ARC.TTP, XYZ.TTP, XFER.TTP,
  693. etc. are stored.
  694.  
  695. Fmail/Fmessages - This is where all Fmail and Files for Fmessages are
  696. stored. Fmail is just Email with a file attached and Fmessages are just
  697. messages in the Message Bases with file attached.
  698.  
  699. Temporary Files - This is where files such as Informer files are stored.
  700.  
  701. Main BBS Folder - This is where all the folders and information above is
  702. stored. If you wanted ALL files associated with the BBS in the folder
  703. TRANSBBS, then enter TRANSBBS here.
  704.  
  705. Cancel - This will exit the screen and not ask you if you want to save the
  706. data or not. All changes will be lost.
  707.  
  708. Exit - This will exit the screen and ask you if you want the program to 
  709. create the folders for you.
  710.  
  711. ** Userlog
  712.  
  713. This allows you to Reformat, Increase or Decrease the Userlog.
  714.  
  715. * Reformat - This will zero out ALL the information on ALL the users. You
  716. will be asked if you are sure you want to do this.
  717.  
  718. * Increase Userlog - This will allow you to have more users than you
  719. initially set the BBS up for. Use this if you have filled up your userlog.
  720.  
  721. * Decrease Userlog - This will allow you to decrease the number of users
  722. that you initially set the BBS up for. If you set it up to handle 200 users
  723. and you find that it is too much, then use this option to decrease it. The
  724. more users you set the BBS up for, the larger the file will be and the
  725. longer it will take to search for the user when he logs on. This option
  726. will search for the first slot with information in it from the end of the
  727. file. When it finds information in a lot, then it will stop and tell you
  728. how many slots you can decrease the log by. Enter any amount up to that
  729. point. After you have entered the amount, the program will create a Backup
  730. file called USERS.DA and USERS.ID. This is so that the BBS can copy the
  731. information from the old file to the new file and to allow you to have a
  732. backup in case you ever want to restore that information.
  733.  
  734. ** Reformat Masks
  735.  
  736. This will allow you to reformat your MASKS.DAT file. If it is found, then
  737. it will inform you that the file exist and ask if you want to overwrite it.
  738.  
  739. ** Cleanup
  740.  
  741. This allows you to set parameters for the Cleanup program. The Cleanup
  742. program is a program that you can run as an event to do certain BBS
  743. maintenance functions. Questions which contain a triangle to the left of
  744. the question may be toggled using the mouse or, you may enter the word Yes
  745. or No. It doesn't matter if it is upper or lowercase.
  746.  
  747. Delete Email after xx Days - This tells the program to delete any
  748. Email after it has been there xx number of days. If you want the option
  749. activated, enter in any number higher than 0. You will want to leave the
  750. receiver enough time to read it.
  751.  
  752. Delete Fmail after xx Days - This is the same as Email but for Fmail type
  753. messages.
  754.  
  755. Delete Fmail file also - This tells the program that when it deletes an
  756. Fmail message, to delete the associated file also.
  757.  
  758. Archive File Areas - This will tell the program to go through the File
  759. Areas and Archive any file that is not an ARC or LZH file.
  760.  
  761. Archive with ARC/LZH - This will tell the program what compression method
  762. to use when Archiving the File Areas. Clicking on this field will bring up
  763. a dialog box in which you can choose ARC or LZH. You may also type in ARC
  764. or LZH.
  765.  
  766. Delete Inactive user after xx Days - This tells the program to delete any
  767. user that has not logged on in the last xx Days. Provisions have been made
  768. in the User Editor to un-delete a user. This will only work if no other
  769. person has logged on as a New user and taken this slot.
  770.  
  771. Backup TRANS.LOG file each night - This tells the program to backup
  772. TRANS.LOG each night and start over with a fresh file. The file will be
  773. moved to the BACKUP folder.
  774.  
  775. Re-run Transcendence each night - This tells the program to re-run itself
  776. each night. This will help keep down any memory problems you may have and
  777. to help keep memory clean.
  778.  
  779. Reboot computer each night - This tells the program to reboot the computer
  780. each night. This will clear out memory completely and help keep things
  781. clean. You will need to make provisions for the BBS to be able to be
  782. auto-booted after the reset takes place.
  783.  
  784. ** Edit Settings
  785.  
  786. This option will present you with a menu. The menu contains selections for
  787. the five pages of settings. You can start at any one of the five. You can
  788. advance to the next page or go back to the previous page from any of the
  789. pages. I have tried to arrange text entry fields together on the first
  790. couple of pages and On/Off selectable fields together on the last couple of
  791. pages. ANY field that has a triangle beside it (on the left hand side), is
  792. mouse selectable. Some fields are a combination of text entry/mouse
  793. selectable. In other words, you can either select it with a mouse and it
  794. will display the status such as On or Off or, you can enter in the words
  795. On, Off, etc. These fields are usually found on screens where there is text
  796. entry type fields. Page 4 & 5 of the settings are mouse selectable only
  797. fields. Below is the page number and a description of each field on that
  798. page.
  799.  
  800. ** Page 1
  801.  
  802. BBS Name - This is the name of your BBS.
  803.  
  804. Sysop Password - This is the password that will be needed if the user has
  805. Sysop Access. Whenever the Secondary Password is asked for, this is the
  806. password that needs to be entered. It is also the password that is used
  807. when Local Security (explained later) is On.
  808.  
  809. System Password - This is the password that is needed when you have Private
  810. BBS (explained later) turned On.
  811.  
  812. Last Caller - This contains the Handle of the last caller to the BBS.
  813.  
  814. Last Run Date - This is the date the BBS was last ran.
  815.  
  816. Keep Last How Many Callers - This is the number of how many callers the
  817. BBS will track as who's called the BBS. When the user selects the command
  818. of 'Who's Called'. He will see this many callers.
  819.  
  820. Password Echo Character - This is the character that is echoed back to a
  821. user when a password is entered. You want it to be a character that is
  822. recognized by all computers. You may want to use something like '.' or '*'.
  823.  
  824. Idle Baud Rate - This is the Baud Rate that the modem idles at. In other
  825. words, the Baud Rate at which the modem starts at when a user logs on.
  826.  
  827. Min. Baud Rate - This is the minimum Baud Rate that you will accept from a
  828. user. If you don't want 300 baud callers, then enter 1200 here.
  829.  
  830. Max. Baud rate - This is the maximum Baud Rate you will accept.
  831.  
  832. Default Country - When a user is asked for his/her Country, if they press
  833. return, this is what the BBS will default to.
  834.  
  835. New User Mask - This is the mask that will be applied to ALL New Users. A
  836. user is considered New if he/she does not have an account on the BBS and
  837. answers Yes to the question of whether or not hey wish an account on the
  838. BBS.
  839.  
  840. Guest User Mask - This is the mask that will be applied to Guest users. A
  841. user is considered a Guest when he/she does not have an account on the BBS
  842. and answers No to the question of whether or not they want an account on
  843. the BBS.
  844.  
  845. Verified User Mask - Fill in here.
  846.  
  847. Idle Timeout - This is the amount of time that elapses when no interaction
  848. to the BBS has taken place by a user. After this amount of inactivity has
  849. taken place, the BBS will automatically log the user off. He/She will be
  850. warned before hand.
  851.  
  852. ** Page 2
  853.  
  854. Calls Today - This just displays the number of calls the BBS has received
  855. today. You can enter anything you want here or leave it as is.
  856.  
  857. Calls Total - This is the total amount of calls the BBS has received since
  858. it was created. Enter what you want here or leave it as is.
  859.  
  860. The next 3 questions deal with Fido networking. This information will be
  861. given to you when you join. If you are not going to use Fido, then this
  862. information does need to be entered. Just leave it at 0 or blank.
  863.  
  864. Node Number - 
  865.  
  866. Node Name - 
  867.  
  868. Node City- 
  869.  
  870. Send Feedback to User # - This will allow you to redirect Feedback to any
  871. valid user. Normally this is set to you number but, if you wanted to go on
  872. vacation and had a remote sysop handling things, you could tell it to
  873. redirect all feedback to that user number.
  874.  
  875. Local Dial - Fill in here
  876.  
  877. Long Distance Dial - Fill in here
  878.  
  879. Area Codes - These are the area codes that are acceptable when the BBS does
  880. a Long Distance Dial?
  881.  
  882. Chat On - This tell the BBS what time to start allowing the users to page
  883. you.
  884.  
  885. Chat Off - this tell the BBS what time to stop allowing the users to page
  886. you.
  887.  
  888. Initialize Modem Every xx Minutes - This tells the BBS how often to send
  889. the modem initialization string to the modem.
  890.  
  891. Warn Events activating in xx Minutes - This will tell the BBS when to start
  892. warning a user that an event is about to take place.
  893.  
  894. Upload File Area - This tells the BBS what file area to send ALL files to.
  895. This was designed to allow the Sysop to have all files sent to one area and
  896. then decide where to put them when validated. This setting works hand in
  897. hand with 'Uploads go to Sysop File Area' on page 5. One will not work
  898. without the other. This number (and File Area number) must be higher than
  899. 0 if this function is going to be used.
  900.  
  901. BBS Operation Hours - This is the time that the BBS will be active. If you
  902. only want the BBS active from 10:00 pm to 06:00 am, then enter 22:00:00 in
  903. On At and 06:00:00 at Off At. If it is to be active ALL the time, then
  904. enter 00:00:00 in both fields.
  905.  
  906. ** Page 3
  907.  
  908. Lock Baud At - This tell the BBS to lock the Baud settings in the computer
  909. to a certain baud rate. This is only needed if you have a high speed modem
  910. that changes the baud rate of the modem but, the rate at which it transfers
  911. data to the computer is always the same.
  912.  
  913. Auto-Informing Messages to User # - This works the same as Feedback goes to
  914. User #. Any Informer messages goes to this user.
  915.  
  916. Default Window Size - This is the default size of the window when
  917. Transcendence is booted up.
  918.  
  919.  
  920. These last 2 pages only have fields that can be toggled On/Off with the
  921. mouse. If it is highlighted, then it is On.
  922.  
  923. ** Page 4
  924.  
  925. RTS/CTS - This tell the BBS to set RTS/CTS On. This is only used for high
  926. speed modems. If you have TOS 1.0, you will need a file called TURBOCTS in
  927. order for this function to work properly. If you have TOS 1.4 or above, you
  928. will need a file called TOS14FIX. The latest version is 2.0.
  929.  
  930. Only 1 of the next 3 settings will be able to be chosen.
  931.  
  932. Use UL:DL Ratio - This tells the BBS to base the number of files a
  933. user can download on the number of files the user uploads.
  934.  
  935. Use MSG/DL Ratio - This tells the BBS to base the number of files a user
  936. can download on the number of messages the user enters or replies to.
  937.  
  938. Use File Points - This tells the BBS to base the amount of bytes the user
  939. can download on the number of bytes the user uploads.
  940.  
  941. Allow Remote Sysops - Fill in here.
  942.  
  943. Screen Saver - This tell the BBS to activate it's built in screen saver.
  944.  
  945. Allow Handles - This tells the BBS whether or not to allow handles. If Off,
  946. the user's handle will be the same as their real name.
  947.  
  948. Show VT52 Codes - Fill in here.
  949.  
  950. Snoop Mode - This tells the BBS whether or not to have Snoop Mode default
  951. to On or Off when it is booted up.
  952.  
  953. Printer Echo - This tells the BBS to echo everything to the printer. You
  954. can use a lot of paper this way. If you want to generate a lot of paper to
  955. recycle, then be my guest.
  956.  
  957. Disk Log - This tell the BBS to send all Log information to TRANS.LOG in
  958. the DATA folder.
  959.  
  960. Printer Log - This tells the BBS to send all Log information to the
  961. printer.
  962.  
  963. Fido - This tells the BBS that you are Using Fido.
  964.  
  965. Local Security - This tell the BBS that anytime the BBS is access from the
  966. keyboard, that it should ask for the Sysop Password. This is to help
  967. prevent those that come over to your place and decide they want to get at
  968. some information. This applies to access to the BBS, Sysop Functions (Dos
  969. commands) and the System Editor.
  970.  
  971. Term At Logon - This tell the BBS to ask for the terminal type each time a
  972. user logs on.
  973.  
  974. Hard Drive - This tell the BBS that you are using a HD for the BBS.
  975.  
  976. New User Email - This will force a New User into Email when they apply for
  977. an account on the BBS.
  978.  
  979. Warn Low Space - This tell the BBS to warn you when you are getting low on
  980. disk space.
  981.  
  982. Printer Bells - This tells the BBS to ring the printer bell also when it
  983. rings the system bell. This is handy if you have your monitor off and the
  984. system bell is sounded. You will need to have your printer on of course.
  985.  
  986. Post? During QuickScan - This will tell the BBS to ask the user if he/she
  987. wishes to post on that base during a QuickScan. If the user has QuickScan
  988. Message Bases turned on and comes to the end of the new messages, then the
  989. BBS will ask them if they wish to post on that base before it proceeds to
  990. the next base.
  991.  
  992. Acknowledge Local Call - Fill in here.
  993.  
  994. Settings, New User - This will force the user into the Settings menu. This
  995. is where they set a lot of their defaults that is to be used by the BBS
  996. while they are online.
  997.  
  998. Color Toggling - This will tell the BBS to cycle through the colors when
  999. Screen Saver is activated.
  1000.  
  1001. Ring Back Local - Fill in here.
  1002.  
  1003. ** Page 5
  1004.  
  1005. Ringback Long Distance - Fill in here.
  1006.  
  1007. Auto Verify Local - Fill in here.
  1008.  
  1009. Auto Verify Long Distance - Fill in here.
  1010.  
  1011. Uploads go to Sysop File Area - This will tell the BBS that all uploads
  1012. should go to the File Area defined in Sysop File Area. This goes hand in
  1013. hand with that question on page 2.
  1014.  
  1015. Visual Alerts - This will cause the screen to flash anytime the system bell
  1016. is rang. This is to help the hearing impaired and those that may have the
  1017. volume on their monitor turned down.
  1018.  
  1019. Inform New Logon - This tell the BBS to inform the user set in
  1020. Auto-Informer Messages to User # on page 3 that a new user has logged on.
  1021.  
  1022. See Passwords Locally - This tells the BBS whether or not to allow
  1023. passwords to be seen locally.
  1024.  
  1025. Inform of Bad User Logon - This works the same as Inform New Logon except
  1026. it informs the person that a user that has been flagged as Bad, has logged
  1027. on.
  1028.  
  1029. Questor LZH Mode - This tell the BBS that you are using the LZH programs
  1030. written by Questor. These program require information passed onto them in a
  1031. certain way. If you are not sure, then run the LZH program without any
  1032. parameters passed onto it and if it is a Questor program, then it will say
  1033. so at the top.
  1034.  
  1035. Private BBS - This tell the BBS not to allow anyone onto the BBS unless
  1036. they have the proper password. This is the System Password. There may be
  1037. times in which you only want to have certain users be able to logon.
  1038.  
  1039. *** Misc.
  1040.  
  1041. ** View Settings
  1042.  
  1043. This option will allow you to view your General settings and give you a
  1044. synopsis of your Message Bases and File Areas. Except for the Message Base
  1045. and File area displays, you will be presented with the dialog boxes that
  1046. appear when you edit your settings. The 'Next' button is the default exit
  1047. button so all you have to do is hit return to go to the next page.
  1048.  
  1049. ** Set Screen Colors - This will allow you to set the colors that the screen
  1050. will be at while the BBS is running. Use the mouse to increase or decrease
  1051. the numbers. + will increase and - will decrease the numbers. The colors
  1052. will change as you adjust them.
  1053.  
  1054.   Cancel - This will exit without setting the colors and return you to the
  1055. settings before you entered this screen.
  1056.  
  1057.   Reset - This will reset the colors to what they were before you entered
  1058. the screen but, it will remain at this screen.
  1059.  
  1060.   Exit - This will exit the screen and accept the changes.
  1061.  
  1062. ** Baud Rate Editor - This will allow you to set up certain times of the day
  1063. that the different bauds are allowed. Enter 00:00:00 in both fields to
  1064. allow this baud at all times.
  1065.  
  1066.   Cancel - This will exit without accepting the changes.
  1067.  
  1068.   Exit - This will exit and accept the changes.
  1069.  
  1070.  
  1071. That is about it. I hope I covered everything. If you find a problem with
  1072. this version of the System Editor, then leave feedback to Wayne Watson or
  1073. David Brown on any of the support boards. I am Sysop of Support Line 2.
  1074. If there is something left out of this documentation, or you find something
  1075. wrong, please let David or me know.
  1076.                                              Wayne Watson
  1077.  
  1078. Support Line 1 -  1-502-897-1582  David Brown's BBS       Louisville KY.
  1079. Support Line 2 -  1-803-879-4186  My BBS                  Greer SC.
  1080. Support Line 3 -  1-502-245-0386  Robert Goodwin's BBS    Louisville KY.
  1081. Support Line 4 -  1-407-699-7391  Greg Xynides' BBS       Winterpark FL.
  1082.  
  1083.