home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / tb_doc02 / the_box.doc
Text File  |  1988-06-13  |  24KB  |  679 lines
  1.  
  2.  
  3.                 THE-BOX
  4.                 -------
  5.  
  6.            Preliminary documentation for version 1.02
  7.                (C) 1988 by Jac Kersing.
  8.  
  9.  
  10.  
  11.   This is the first document about the The-Box Mailer.  The document is not
  12. perfect but it is all there is.  If anybody thinks (or may-be knows for sure)
  13. he/she can do a better job he/she is VERY welcome.  Till then you will have to
  14. do with this. 
  15.  
  16.  
  17.                  INTRODUCTION
  18.                  ------------
  19.  
  20. The-Box is a stand-alone mailer package to be used with PANDORA BBS or a (to be
  21. written) full-screen message editor. The mailer is capabel of sending and
  22. receiving mail (even without a sysop chaperoning...). The-Box can also be used
  23. as a front-end program for PANDORA or any other bulletin board program. It is
  24. not compatible with the OMMM or DUTCHIE message packing programs (use of
  25. different naming convention) so be carefull.
  26.  
  27.  
  28.                    LICENSE
  29.                    -------
  30.  
  31. Definitions:
  32.  
  33. IFNA:        The International FidoNet Association, which can be reached at
  34.         FidoNet node 1:1/0, or by mail at:
  35.  
  36.         International FidoNet Association
  37.         PO Box 41143
  38.         St. Louis, MO. 63141
  39.         U.S.A.
  40.  
  41. FidoNet:    A public amateur electronic mail network, whose members are
  42.         registered with IFNA in St. Louis.
  43.  
  44. BBS:        Electronic Bulletin Board System.
  45.  
  46. Registered BBS:    A bulletin board which is a registered member of FidoNet, as
  47.         shown by the most recent node list published by IFNA.
  48.  
  49. Sysop:        The person in charge of the maintenance and operation of any
  50.         given BBS.
  51.  
  52.  
  53. License:
  54.  
  55. Each sysop of a registered noncommercial BBS is hereby granted a limited
  56. license to use The-Box as follows:
  57.  
  58. - You may use the program ONLY in conjunction with the operation and
  59. maintenance of your BBS.
  60.  
  61. - You accept full responsebility for whatever happens or fails to happen.
  62.  
  63. - You may copy and distribute the program freely, but ONLY to other sysops.
  64.  
  65. - You may not charge a fee for copying and distributing the program.
  66.  
  67. - You may not distribute copies which have been modified in any way.
  68.  
  69. - You use the program in a friendly way, in accordance with the local law.
  70.  
  71. - You may only post this program in a BBS where it can be downloaded without
  72. any charges at all.
  73.  
  74. - You may not use this program in a commercial environment or in a governmental
  75. organisation.
  76.  
  77. - non-commercial users must register by sending a postcard to the adress below.
  78. You are not allowed to use The-Box in any way if you fail to do this! (Messages
  79. not allowed, a real postcard by the real old-fashioned mail!)
  80.  
  81. Commercial users:
  82. For commercial use please contact Jac Kersing at 2:283/102 or:
  83.  Jac Kersing
  84.  Akeleiweg 13
  85.  8042 CG  Zwolle
  86.  The Netherlands.
  87.  
  88. Support:
  89. User support is voluntary for noncommercial systems. You may not use this
  90. program in a commercial environment or in a governmental organisation without
  91. permission. Please contact above adress for this.
  92. If you have any questions regarding this program then please send them to:
  93. Jac Kersing 2:508/17, topic: The-Box. Or post them in the The-Box and Pandora
  94. Bugs Echomail area at any BBS supporting this echo.
  95. I will try to answer them as soon as possible, but no promisses! (as stated
  96. before user support is VOLUNTARY and I have only 24 hours a day.....)
  97.  
  98.                 DISCLAIMER
  99.                 ----------
  100.  
  101. I accept no responsibility for anything at all.  You use this program at your
  102. own risk, if it destroys your system and/or your software I am just VERY very
  103. sorry. 
  104.  
  105.  
  106.  
  107.  
  108.                  THE-BOX
  109.                  -------
  110.  
  111. The-Box is a mailer program. This means that the program is able to receive and
  112. send mail packets from/to other FidoNet compatible programs. The program can be
  113. used as a terminal with serveral down/upload protocols also. 
  114.  
  115. The-Box can be used in several different set-ups.  I will cover them first. 
  116.  
  117.  
  118.                  SET-UP
  119.                  ------
  120.  
  121. - Point setup.
  122.  This is the lowest level on wich The-Box can work.  In this configuration you
  123. do not need the external programs except the editor.  (There is no full screen
  124. editor at this moment.  You can simply use PANDORA for this purpose.) The-Box
  125. only knows about your boss node, so all mail will be routed through him.  Mail
  126. to all adresses will be accepted without check for existance of the destination
  127. node.
  128.  
  129. - Mail interface for BBS.
  130.  In this set-up The-Box accepts all mail for your bulletin board. If a human
  131. user tries to log on, The-Box will start the BBS (if allowed at that time).
  132. The-Box can also be set-up to take care of all other periodical tasks that have
  133. to be performed. In this mode you MUST have a valid node-number because all
  134. mail will be send according the FidoNet routes. 
  135.  
  136.  
  137. -------------------------------------------------------------------------------
  138. I will continue with this part later on.
  139. Will describe the control file with its valid commands now.
  140. Please read this part carrefully because it SEEMS to be just like BinkleyTerm
  141. BUT some things do differ!
  142. -------------------------------------------------------------------------------
  143.  
  144.  
  145.                 REQUIREMENTS
  146.                 ------------
  147.  
  148. What you absolutely need to run The-Box:
  149.  
  150. - Atari ST. The box is tested on an Atari 520ST. I don't expect any problems at
  151. 1040 machines. The MegaST may cause some problems because it has a different
  152. TOS version (I tested The-Box on my 520ST with MegaTos and no problems occured,
  153. so I think it's save to use it).
  154. - A command-line shell. This is not an easy subject cause the shell MUST have
  155. the following capabilities: environment (SET command), batch processing WITH
  156. errorlevels and (if the SPAWN mode of The-Box is used) ability to run a program
  157. or batch-file supplied at startup of the shell. If SPAWN is not used PCommand
  158. (shareware) will do, else you will need something like Michtrons Command.prg.
  159. (We're working on our own product. It will be supplied along with the other
  160. programs as soon as it is ready.)
  161. - Diskspace. It is difficult to specify the amount actualy needed, but for a
  162. point with about 3 echomail areas at least 720K must be present.
  163. - As much ram as possible. The ram is used for the program (about 160K ram at
  164. the moment) and (if possible) a ramdisk.
  165.  
  166.  
  167.  
  168.  
  169.                   THE CONTROL FILE
  170.                   ----------------
  171.  
  172. All changes from version 1.00 to version 1.02 can be located easily. They are
  173. marked by ==== under the keyword.
  174.  
  175. The behaviour of The-Box is controlled by a couple of files. The most important
  176. are the control file and the event file.
  177. This section covers the control file and all valid command. The next section is
  178. for the event file.
  179.  
  180. The control file is a free style ascii format, case is unimportant.  It can be
  181. made using any standart program editor (no Wordstar in document mode, WP or
  182. First Word here!). 
  183.  
  184. The file may be located at two positions.  The easiest way is to place it in
  185. the same directory in which The-Box is found.  The second (better way in my
  186. opinion) is to place the file in a sub-directory.  Now you'll have to tell
  187. The-Box where it can find the file.  This is done by an environment variable
  188. called MAILER.  The-Box will search the environment for this variable and use
  189. the path specified for almost all files it needs.  (See appendix for the use of
  190. environment.)
  191.  
  192. Example:
  193. If your control file is located on disk B, in the sub-dir MAILER, then use:
  194. SET MAILER=b:\mailer\
  195. The-Box will find the control file (and the other) correctly now.
  196.  
  197. Valid commands in the control file:
  198.  
  199. OVERWRITE
  200. ---------
  201.  This command means that if an incomming file (from another mailer) has the
  202. same name as an already existing file, the new file will overwrite the old one.
  203. This results in a loss of the old file.
  204.  If not specified the new file will be renamed, but this will be done only
  205. ONCE. If another file with the same name is received the second file will be
  206. lost. 
  207.  
  208. UNATTENDED
  209. ----------
  210.  Tell The-Box that it is running without a sysop controlling. The-Box will look
  211. for the correct event and execute this. Format:
  212.   UNATTENDED
  213.  
  214. NODE
  215. ----
  216.  Specify the nodenumber for this bulletin board. The correct format is:
  217.   NODE   <zone>:<net>/<node>
  218.  
  219. AKA
  220. ---
  221.  Specify an also know as adress. Mail for these nodes is not send but
  222. considered to be at the destination node. Only one AKA may be specified at a
  223. line. Format:
  224.  AKA <net>/<node>
  225.  
  226. POINTNET
  227. --------
  228.  Specify the netnumber of our pointnet. Only used by a normal BBS that has some
  229. points. Format:
  230.   POINTNET <number>
  231.  
  232. BOSS
  233. ----
  234.  Specifies the network number of your boss node. Used by points only. Format:
  235.   BOSS <net>/<node>
  236.  The zonenumber is not specified because it must be the equal to yours.
  237.  
  238. BOSSPHONE
  239. ---------
  240.  Specifies the phone number to be used when calling your boss. Used by points
  241. only. Format:
  242.  BOSSPHONE phonenumber
  243.  
  244. MAILER
  245. ======
  246.  This keyword must be followed by ONE of the following (insert more lines if
  247. more than one is needed):
  248.   no-zedzap - The mailer won't use zmodem file-transfers now.
  249.   no-init   - The modem won't be initialized every ten minutes.
  250.   no-smart  - The mailer will behave as stupid as possible.
  251.  The command is not usefull for normal users, but it may be usefull during
  252. testing or for advanced users. Format:
  253.   MAILER NO-INIT
  254.  
  255. NO-OVERDRIVE
  256. ============
  257.  Do not use the SEAlink overdrive mode when transmitting at baudrates higher
  258. than 2400 baud. The-Box will automatically select overdrive mode when the
  259. baudrate exceeds 2400bd.
  260.  
  261. NOPICKUP
  262. --------
  263.  Do not pickup mail for us when we're calling. The route-file of EXPORT may
  264. override this command. Format:
  265.   NOPICKUP
  266.  
  267. LOCAL-COST
  268. ==========
  269.  Specify the cost for the local events. All mail that can be sent without
  270. exceeding this cost will be sent. The cost for sending the mail to a node is
  271. extracted from the nodelist. Format:
  272.  LOCAL-COST <number>
  273.  
  274. EDITOR
  275. ------
  276.  Specifies the name of the external message editor. This editor can be started
  277. from The-Box. You should check if enough memory is available to run this
  278. program. Format:
  279.  EDITOR path\progname.ext
  280.  
  281. BBS
  282. ---
  283.  Specify the methode in which the bulletin board program should be started when
  284. a user calls in. The two possible methods are:
  285. - EXIT. This causes The-Box to terminate operation with an errorlevel equal to
  286. the baudrate of the caller.
  287. - SPAWN. Now The-Box will try to run the command-line shell with the command:
  288. SPAWNBBS baudrate 0 timeleft
  289.  You should have a batch file with the name SPAWNBBS for this function to work
  290. properly. (AND specified the SHELL in your environment, see appendix)
  291.  
  292. LOGLEVEL
  293. --------
  294.  Specifies the 'level' for message logging. The messages will be left in the
  295. log-file (if specified). All messages will be showed at the display.
  296. The different levels are:
  297. - 6    ERRORS only.  At this level only severe errors (OS errors etc.) will be
  298.                      written to the log-file.
  299. - 5    ......        All start and stop times (of events) are also logged.
  300. - 4    BRIEF.        Add received mail reports to log-file.
  301. - 3    NORMAL         Created mail also logged.
  302. - 2    DETAILED         Call information is also logged.
  303. - 1    VERBOSE       All file transfer information is added.
  304. - 0    SUPER VERBOSE Modem messages also logged.
  305. Use 0 only for debugging purposes because it creates a very very big log-file.
  306.  
  307. STATUSLOG
  308. ---------
  309.  This command defines the name of the file to be used for logging purposes.
  310. Format:
  311.  STATUSLOG path\name.ext
  312.  
  313. SYSTEM
  314. ------
  315.  Specify the name of your System. This name is send to the other system is
  316. advanced mail is used. Format:
  317.  SYSTEM <string>
  318. The name should be 59 or less character long. Longer names will be terminated
  319. by the program.
  320.  
  321. SYSOP
  322. -----
  323.  Specify your name. Used for the same purpose as the SYSTEM name. Format:
  324.  SYSOP <string>
  325.  
  326. HOLD
  327. ----
  328.  Specify the path for the packets (and other internal used files) The-Box has
  329. to send.
  330.  Example:
  331.  HOLD b:\outmail\
  332.  The directory outmail on the B drive will be used by EXPORT to store all
  333. outgoing mail.
  334.  Format:
  335.  HOLD <path>
  336. NOTE: This directory must be empty at the beginning and should not be used for
  337. ANY other purpose. Please do not use it yourself at any time. The-Box and
  338. utilities will take care of everything.
  339.  
  340. NETFILE
  341. -------
  342.  Specify the path for all incomming files. ALL files received by the mailer
  343. will be stored here. You should check the incomming files regulary.
  344.  format:
  345.  NETFILE <path>
  346. NOTE: Do not delete file with the extension .pkt, .su?, .mo?, .tu?, .we?, .th?,
  347. .fr? or .sa?  IMPORT will take care of these.
  348.  
  349. NETMAIL
  350. -------
  351.  Specify the path for the network messages. This path MUST include the number
  352. of the message file. Example:
  353.  NETMAIL b:\msgs\0004
  354.  Message area 4 is the netmail area. The message file can be found in the
  355. directory msgs at drive B. Format:
  356.  NETMAIL <path><areanumber>
  357. NOTE: The areanumber should contain 4 digits.
  358.  
  359. DOWNLOAD
  360. ========
  361.  Specify the directory for files downloaded from within the terminal mode.
  362.  Format:
  363.  DOWNLOAD <path>
  364.  
  365. BAUD
  366. ====
  367.  Specify the baudrate at which the modem will be initialised. This speed is
  368. only used at moment The-Box does not know the modem speed. If a caller is
  369. detected Pandora will switch to the correct speed automaticaly. 
  370.  It is also possible to have The-Box work at one baudrate all the time. This
  371. can be done by adding the keyword LOCKED between the other words. Format:
  372.   BAUD [LOCKED] <speed>
  373.  
  374. PORT
  375. ====
  376.  This is a PC only command.  It is used to specify the portnumber which The-Box
  377. has to use. Valid numbers are 1 through 8. Format:
  378.  PORT <number>
  379.  
  380. SLOWMODEM
  381. =========
  382.  If your modem is not that fast you should add this keyword to your control
  383. file. The-Box will send characters to the modem one by one afterwards.
  384.  Format:
  385.  SLOWMODEM
  386.  
  387. INIT
  388. ----
  389.  Specify the string for modem initialisation.  This string will be send to
  390. The-Box every 10 minutes when in unattended mode and at the start of the
  391. program.  The init string should NOT contain an auto-answer sequence.  The-Box
  392. will check for the phone rings itself and use the ANSWER string for answering
  393. the call.  See below for more information on modem strings.  Format:
  394.   INIT <string>
  395.  
  396. PREFIX
  397. ------
  398.  Specify the string for a dail command. This is the first part of the string
  399. (before the number). Format:
  400.  PREFIX <string>
  401.  
  402. SUFFIX
  403. ------
  404.  Specify the second part of the dail string. This part comes after the
  405. phonenumber. Format:
  406.  SUFFIX <string>
  407.  
  408. RESET
  409. -----
  410.  Specify the modem reset string. This string will be send to the modem at
  411. NORMAL program termination. Not send when a caller is connected. Format:
  412.  RESET <string>
  413.  
  414. ANSWER
  415. ------
  416.  Specify the modem answer string. This string will be send to the modem after
  417. detection (twice) of RING (or RINGING). This string should be used for
  418. answering the phone at this moment only, not for global responce! (So it should
  419. be something like AT A NOT AT S0=1!!!) Format:
  420.  ANSWER <string>
  421.  
  422. BUSY
  423. ====
  424.  The busy string is sended to the modem every time The-Box executes an external
  425. event (see later on) with an errorlevel of less than 50.  Users will get the
  426. busy tone when calling during these events.  In addition the INIT string should
  427. be set-up to make the modem hang-up the phone.  Format:
  428.  BUSY <string>
  429.  
  430. BANNER
  431. ------
  432.  Specify the string shown to the caller at the moment he is connected. This
  433. could be the name of your BBS or some important information. It can be one line
  434. only. If more information is needed the file BANNER.TB should be used (max 2K
  435. information!). The-Box will send a line with your node/point number itself. The
  436. caller sees something like this:
  437.  
  438. + The-Box v1.00; Node 2:508/17.0; (C) Copyright 1988 by Jac Kersing<CR><LF>
  439. Your banner<CR><LF>
  440.  
  441. Format:
  442.  BANNER <string>
  443.  
  444. START-BBS
  445. ---------
  446.  Specify the string to show to the caller when starting the bulletin board
  447. program. This string is send to the caller at the moment The-Box starts your
  448. bulletin board program. Format:
  449.  START-BBS <string>
  450.  
  451. PASSWORD
  452. ========
  453.  The password are used to protect mail. If a node polls (or The-Box is polling
  454. a node) the password will be transmitted by the calling side. If the passwords
  455. do not match The-Box will immediately hangup. In case a mailpacket was received
  456. it will be renamed to <name>.BAD.
  457.  The first argument of password is the password to use. Only 6 characters are
  458. used and all characters will be upper-cased by The-Box.
  459.  Next a list of nodenumbers occurs seperated by spaces. Valid numbers are:
  460. 2:508/17, 2:508/all, 2:all, all
  461.  Format:
  462.  PASSWORD <password> <nodenumber> ....
  463.  
  464. ABOUT
  465. =====
  466.  This specifies the name of a file containing some information about your
  467. system. This file will be transmitted whenever the other mailer requests a
  468. non-existend file or the ABOUT file. Format:
  469.  ABOUT <filename>
  470.  
  471. AVAIL
  472. =====
  473.  This specifies the name of a file containing a list of all files that can be
  474. requested at your system. This file does not have a standard format and is not
  475. used by The-Box (only transmitted on request). Format:
  476.  AVAIL <filename>
  477.  
  478. OKFILE
  479. ======
  480.  This is an extremely important file. It contains all filenames, wildcards etc
  481. for files that may be requested. See later on in this manual for details (not
  482. right now, I haven't got the time to write something, see Binkley man for now).
  483.  Format:
  484.  OKFILE <filename>
  485.  
  486. MAX-REQUEST
  487. ===========
  488.  Specifies the maximum number of files that may be requested.  The-Box will not
  489. send anymore files during this connection (so the other side may call back
  490. right after The-Box dropped the line) if this number is exceeded. Format:
  491.  MAX-REQUEST <number>
  492.  
  493.  
  494.  
  495. The modem strings may contain any valid modem command and the characters '|'
  496. and '!'. These character will be translated to a <CR>. Which of the two you use
  497. depents on the situation. Using a '|' will cause The-Box to wait for a valid
  498. responce from your modem (like OK) before the next command will be issued. When
  499. you are using '!' The-Box will only wait for 1 second after the command.
  500. For example, a valid INIT string is:
  501.  INIT AT Z|AT M0 E1 S0=0 X4|
  502. Not valid is:
  503.  INIT AT Z|AT M0 E1 S0=1 X4|
  504.                     ~~~~
  505. (Remember: no auto-answer in the init string!)
  506.  
  507. NOTE: The RESET and INIT strings must be terminated with '|' or '!', PREFIX may
  508. not be terminated at all and ANSWER and SUFFIX must be terminated with '|'. 
  509.  
  510.  
  511.  
  512.  
  513.                 THE SCHEDULE
  514.                 ------------
  515.  
  516. This section covers the schedule. The schedule determins the behaviour of
  517. The-Box at a certain moment. The configuration controls the overal behaviour,
  518. the schedule at a certain moment.
  519.  
  520. The file for the schedule is THE-BOX.EVT and it should be in the same directory
  521. as the config. The-Box will create a file named THE-BOX.SCD itself. This file
  522. is for internal purposes only and should not for any reason be modified (or
  523. accessed by any other program).
  524. If you change the event file The-Box will automatically detect it's a new
  525. version. All forced events earlier that day will not be executed. If they
  526. should be the command-line option FORCE must be used.
  527.  
  528. The schedule file contains lines like:
  529.  
  530. Tag   day(s)  start-time [end-time] [flags]
  531.  
  532. The meaning of these fields is:
  533.  
  534. TAG
  535. ---
  536. The tag for which the mail should be packed. As soon as The-Box finds an event
  537. with a valid tag it will exit to the external mail packer to pack the mail for
  538. this tag.
  539. There is a special tag called the 'Z'-tag. The-Box won't exit for a 'Z'-tag.
  540. This tag can be used non mail events (the packer won't pack any mail either,
  541. even if it is called!).
  542. The second special case is the '#'-tag. This is no valid tag as it is, but it
  543. has to be followed by a valid tag. The-Box won't exit for this tag, but if the
  544. packer is called (after receiving mail or something like that) all mail for
  545. this event will be packed.
  546. The third (and last) special case is the 'X'-tag. This tag must be followed by
  547. any number from 8 till 300. This causes The-Box to exit with the errorlevel
  548. specified by that number.
  549.  
  550. Valid tags are for example:
  551. A ,  Z ,  S ,  #A ,  #S ,  P ,  X10 and X255
  552. Not valid:
  553. A# ,  #Z , #X10 .
  554.  
  555. DAY(S)
  556. ------
  557.  
  558. This field may contain any of the next (or a combination of them):
  559.  
  560. SUN ,  MON ,  TUE ,  WED ,  THU ,  FRI ,  SAT , WEEK , WKEND and ALL
  561.  
  562. More days can be used by seperating them by '+'.
  563.  
  564. Examples:
  565. SAT+SUN   (== WKEND) , WEEK+SAT , MON+TUE+THU
  566.  
  567.  
  568. START-TIME
  569. ----------
  570. The time this event has to be executed. This may be any time between 0:00 and
  571. 23:59. The format is [h]h:mm. Only one event may be valid at any time, so no
  572. two start-times may be equal.
  573.  
  574. END-TIME
  575. --------
  576. The time this event ends. This may be any time between 0:00 and 23:59 as long
  577. as it is AFTER the start-time and does not pass into the next day. The end-time
  578. is optional for external events.
  579.  
  580. FLAGS
  581. -----
  582. Valid flags are:
  583.  
  584. A - Average wait time. The time (+-50%) in seconds to pause between two calls. 
  585.     Format: A=<nnn>  , with 0<nnn<240.
  586.  
  587. B - BBS. The-Box may start the BBS during this event. Format: B
  588.  
  589. C - Crash mail. Send waiting crashmail packets. Format: C
  590.  
  591. D - Dynamic event. This event will terminate as soon as all mail has been send.
  592.     Format: D
  593.  
  594. F - Forced event. This event is always executed, even if the current time is
  595.     after the ending time of the event. Format: F
  596.  
  597. L - Local mail only. During this event mail is only send to nodes with cost
  598.     zero. Format: L
  599.  
  600. M - Mail exit codes. Exit with the specified errorlevel after (arc)mail is
  601.     received. Format: M=<mail>,<arcmail>   8<(arc)mail<300.
  602.  
  603. R - Receive only. No outgoing calls will be made during this schedule.
  604.     Format: R
  605.  
  606. S - Send only. The-Box does not honour incomming calls during this schedule.
  607.     Format: S
  608.  
  609. T - Tries. The number of tries to get the mail to a certain node out.
  610.     Format: T=<connected calls>,<not connected calls>
  611.     ( 0 < calls < 36)
  612.  
  613.  
  614.  
  615.               COMMAND LINE OPTIONS
  616.               --------------------
  617.  
  618. The-Box has a couple of command line options, they are:
  619.  
  620. FORCE       - Force all old events. This can be used in those cases you have
  621. =====         changed the event file and you want to run all forced events
  622.          earlier that day.
  623.  
  624. DYNAM      - Restart dynamic events.
  625.  
  626. UNATTENDED - Tell The-Box it's running from a batch file.
  627.          (Avialable in the config file also.)
  628.  
  629.  
  630.  
  631.  
  632.                  BANNER
  633.                  ------
  634.  
  635. The banner is a text shown to the caller just after The-Box has told which node
  636. is called. It may be specified in two ways. The first is in the control file.
  637. This is the easiest way, but it can only be used for one line of text. If you
  638. want to use more than one line the file BANNER.TB must be used. This file
  639. should be in the some directory the config file is found.
  640.  
  641. The file may contain ANY printable ascii character. The maximum file length is
  642. 2048 characters.
  643.  
  644.  
  645.  
  646.                 APPENDIX A
  647.                 ----------
  648.  
  649. As stated before you should use a command-line shell to run The-Box. This
  650. because you will need the batch-file processing and the environment. GEM does
  651. not actively support the environment and no batch-files at all.
  652.  
  653. The environment:
  654. ----------------
  655.  
  656. First check for the existance of the word SET in the shell. This can be done
  657. easily by typing SET<return>. If the responce is something like 'command not
  658. found' or 'program not found' you will have to look for an other command-line
  659. shell.
  660.  
  661. To set the path for The-Box simply enter:
  662. SET MAILER=your_path<return>
  663. example:
  664. SET MAILER=b:\mailer\<return>
  665.  
  666. Notes:
  667. - Use no spaces in the SET command, they are used as delimiters.
  668. - Do not forget to add the backslash ('\') at the end of your path.
  669.  
  670.  
  671. The SHELL:
  672. ----------
  673. The-Box uses the environment to find the name of the shell it has to run. This
  674. name can be specified by SETting SHELL to the correct program name.
  675.  
  676. Example:
  677. SET SHELL=a:\command.prg
  678.  
  679.