home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / comm / Fido / TrapDoor / docs / TrapDoor.Man < prev    next >
Text File  |  1994-06-23  |  192KB  |  5,396 lines
  1.  
  2.  
  3.      Page 1               TrapDoor's Fifth Manual               Page 1
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                  TrapDoor®
  22.                           The Real Amiga Pleasure
  23.                                Version 1.84
  24.                           Copyright (c) 1989-1994
  25.                    Maximilian Hantsch and Martin Laubach
  26.                             All rights reserved
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                           TrapDoor's Fifth Manual
  34.                          Friday 27-May-94 23:00:19
  35.                           Copyright (c) 1989-1994
  36.                    Maximilian Hantsch and Martin Laubach
  37.                             All rights reserved
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                   This manual is intended to be read from
  48.                     front to back for more convenience.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.      Page 2               TrapDoor's Fifth Manual               Page 2
  66.  
  67.  
  68.   1. Introduction     
  69.  
  70.        This manual is a description of TrapDoor Amiga, explaining how
  71.      to set up the software in order to send and receive mail and
  72.      attached files.  Please refer to the documentation of other
  73.      Fidonet packages, for example oMMM, ConfMail, Foozle or even
  74.      better, the manual for TrapToss, for additional information on
  75.      file attaches, netmail routing, echomail and other topics you
  76.      are missing in here.  
  77.  
  78.        If you are new to Fidonet, we recommend to read TrapDoor's
  79.      Fidonet Manual (FidoNet.Man) first.  
  80.  
  81.        Please read the entire manual before using TrapDoor.  
  82.  
  83.        TrapDoor is a FidoNet-compatible front mailer for Amiga
  84.      systems. It transfers mail from/to other FidoNet-compatible
  85.      systems using WaZoo DietIfna and ZedZap technique as well as the
  86.      lowest common FidoNet protocol, FTS-0001 (Lotek). It also
  87.      features the latest EMSI (Electronic Mail Standard
  88.      Identification) handshake that allows two mailers to exchange
  89.      lots of interesting information at session startup, for example
  90.      AKA addresses.  
  91.  
  92.        TrapDoor handles both sending and receiving of files and mail
  93.      packets and is fairly easy to set up and use. It works well with
  94.      high speed modems, and includes all the features found on
  95.      standard FidoNet mailers, such as making and processing of
  96.      filerequests, password-protected mail sessions, automatic
  97.      nodelist lookup and much more.  
  98.  
  99.  
  100.  
  101.   2. Installation     
  102.  
  103.        TrapDoor is a CLI based application; it can't be run from
  104.      Workbench. It accepts a wide range of keywords that allow an
  105.      easy and accurate configuration.  
  106.  
  107.        Upon invocation, TrapDoor will try to find a file
  108.      "TrapDoor.cfg" in the current directory or in "MAIL:". This file
  109.      should contain your default configuration data for TrapDoor,
  110.      like your system's name, your nodenumber etc. (The option of
  111.      saving the configuration data within the program file, which was
  112.      available in earlier versions of TrapDoor, has been removed.)
  113.      You should set up at least the NAME, NODE, SYSOP, BOSS, and CALL
  114.      parameters.  
  115.  
  116.        If you wish to change any parameters from the settings in your
  117.      configuration file, just list the appropriate configuration
  118.      keywords on the command line when you invoke TrapDoor.  
  119.  
  120.        Please note that the keywords are neither case nor position
  121.      sensitive.  
  122.  
  123.  
  124.      Installation
  125.  
  126.  
  127.      Page 3               TrapDoor's Fifth Manual               Page 3
  128.  
  129.  
  130.   2.1. The Keyfile    
  131.  
  132.        TrapDoor is a Shareware program. The unregistered version will
  133.      pop up requesters at the start and end of the program, and you
  134.      will have to click some buttons with your mouse, or press some
  135.      keys. Also, a few other functions are disabled in the
  136.      unregistered version: 
  137.  
  138.        - it will exit after every call 
  139.        - it will not respond to file requests 
  140.  
  141.        Once you register, you will receive a so-called keyfile (to
  142.      "unlock" your TrapDoor), which will make these requesters go
  143.      away and enable all features of TrapDoor.  
  144.  
  145.        For more information about "Shareware", and the registration
  146.      process, please see the "Registration" chapter.  
  147.  
  148.  
  149.  
  150.  
  151.   2.2. Point Setup    
  152.  
  153.        In a typical Amiga point setup, the installation of TrapDoor
  154.      will merely consist of a few steps. If you are not familiar with
  155.      FidoNet and FidoNet Point Systems at all, please read TrapDoor's
  156.      FidoNet Manual (FidoNet.Man) first.  
  157.  
  158.        1. Copy the executable "TrapDoor" to a directory where you
  159.           store your executable files. Copy "traplist.library" to
  160.           "LIBS:".  
  161.  
  162.        2. Create a new subdirectory, and assign "MAIL:" to it, if you
  163.           do not already have one. Create subdirectories
  164.           "MAIL:Inbound" and "MAIL:Outbound".  
  165.  
  166.        2a. If you have already registered TrapDoor, and you have a
  167.           keyfile called "TrapDoor.key", copy this to your "MAIL:"
  168.           directory.  
  169.  
  170.        3. Copy the default configuration file to MAIL:TrapDoor.cfg.
  171.           There is an example Point configuration file in the
  172.           Examples/ directory, called Point.cfg.  
  173.  
  174.        4. Use a text editor to edit MAIL:TrapDoor.cfg to suit your
  175.           system. (You can use Ed or MicroEmacs for that purpose.)
  176.           Most important, change the NAME, NODE, BOSS, CALL and
  177.           PASSWORD parameters.  
  178.  
  179.        5. That's it, you're done. Type "TrapDoor Call Boss" to call
  180.           your boss system.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.      Installation                                       Point Setup
  187.  
  188.  
  189.      Page 4               TrapDoor's Fifth Manual               Page 4
  190.  
  191.  
  192.   2.3. Node Setup    
  193.  
  194.        A FidoNet node is more complicated to set up. First, follow
  195.      the steps in the "Point Setup" section. In addition to the
  196.      directories created there, you will also need to setup a
  197.      directory for the FidoNet nodelist. Create it on any partition
  198.      large enough for at least 3 Megabytes of additional disk space,
  199.      and assign "Nodelist:" to it. Now study the manual for TrapList
  200.      and compile the FidoNet nodelist. (If you do not have a nodelist
  201.      yet, you should use TrapDoor or a terminal program to obtain one
  202.      from another FidoNet node.) 
  203.  
  204.        Next, you need to create a scheduling script in which you tell
  205.      TrapDoor to call out on certain days or during certain hours and
  206.      what systems to call. This is usually done with a cron-like
  207.      utility. Cron is a tool which executes other programs at
  208.      regularly scheduled times.  
  209.  
  210.        There is a good cron from TelePro Technologies. It is called
  211.      TPTCron and freely available from many bulletin boards. TPTCron
  212.      has successfully been used in many installations with TrapDoor.  
  213.  
  214.        The main idea in a node setup is to run TrapDoor in answer
  215.      mode. It will accept incoming calls and wait for ARexx commands.
  216.      Then, you use cron to run "TrapPoll" every so often. TrapPoll is
  217.      a tool that will scan your outbound directory to see what mail
  218.      has to be delivered to which nodes, and send ARexx commands to
  219.      TrapDoor to cause these nodes to be called. If you have TrapPoll
  220.      executed by cron every ten minutes, TrapDoor will make outgoing
  221.      calls until all mail and files have been sent, or until an
  222.      accounting limit was reached (see the "Accounting" chapter for a
  223.      description of the accounting system).  
  224.  
  225.        By properly setting up your crontab file, you are able to
  226.      exactly specify at what times TrapDoor should place outgoing
  227.      calls, and when it should just sit around and wait for incoming
  228.      calls. Also, you can run other scripts from cron that change
  229.      TrapDoor's settings (like switching to BBSMODE ZMH during the
  230.      Zone Mail Hour).  
  231.  
  232.        Please see the Scripts/ directory for many example scripts for
  233.      running a node.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.      Installation                                        Node Setup
  249.  
  250.  
  251.      Page 5               TrapDoor's Fifth Manual               Page 5
  252.  
  253.  
  254.   2.4. The Modem    
  255.  
  256.        The Modem must be Hayes compatible. Other modem command
  257.      standards are currently not supported.  
  258.  
  259.        A word about cabling: you will need a seven-wire RS232C cable,
  260.      that is one that supports at least RxD, TxD, CTS, RTS, DTR, DSR,
  261.      DCD and last but not least, Gnd. Anything less (or other
  262.      connections) may not have the desired effect, although the
  263.      strict requirements which TrapDoor poses on the DSR signal can
  264.      be bypassed by use of the NODSR keyword. Also, seven wire
  265.      handshake can be disabled with NO7WIRE.  
  266.  
  267.        Be sure to set up your modem so that dropping DTR causes a
  268.      hangup, and a return to command state -- even better a complete
  269.      reset. If you don't do this, TrapDoor will be incapable of
  270.      hanging up correctly! On almost all Hayes compatible modems this
  271.      can be achieved with AT&D3, a few may require changes to their
  272.      DIP switch settings or S-registers. Please consult the manual
  273.      that comes with your modem if you feel unsure.  
  274.  
  275.        Also, take care that your modem should respond to successful
  276.      connects with a "CONNECT XXXX" message (where XXXX is the
  277.      baudrate), not just "CONNECT" (except at 300 baud). If your
  278.      modem returns only "CONNECT", TrapDoor assumes that the
  279.      connection takes place at 300 baud. On most Hayes compatible
  280.      modems you will have to use ATX1 or higher. If your modem
  281.      returns "CONNECT FAST" (Trailblazer modems do), TrapDoor will
  282.      continue to operate at the baudrate specified in the BAUD
  283.      statement.  
  284.  
  285.        When DTR is set high, DSR should follow. In case your modem is
  286.      reacting too slowly, try adjusting the SLOWMODEM parameter. If
  287.      your modem cannot properly handle DSR at all, use the NODSR
  288.      setting.  
  289.  
  290.        Some modems require a substantial delay between the "AT"
  291.      prefix and the actual command string. If this is the case with
  292.      your modem, put at least one tilde ("~") character between the
  293.      "AT" prefix and the command. This will cause TrapDoor to wait a
  294.      short time before sending the rest of the string. Fine tune the
  295.      time with SLOWMODEM. Some modems also require a substantial
  296.      delay after a reset (caused by DTR drop or ATZ) before they
  297.      respond to commands again -- insert tilde characters where
  298.      appropriate! 
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.      Installation                                         The Modem
  311.  
  312.  
  313.      Page 6               TrapDoor's Fifth Manual               Page 6
  314.  
  315.  
  316.   2.5. Example Modem Settings     
  317.  
  318.        These example setups for widely-used modems should get you
  319.      started quickly.  
  320.  
  321.   2.5.1. Ordinary 2400 Baud Modems  
  322.  
  323.        Set your modem to: 
  324.  
  325.           E1  echo modem commands
  326.           Q0  display result codes
  327.           V1  verbose results
  328.           X1  or higher
  329.           &C1 DCD follows carrier detect
  330.           &D3 reset on dtr drop
  331.           &S0 DSR always on
  332.  
  333.        To setup your modem, enter a terminal program and set the
  334.      baudrate to 2400 baud. Then type 
  335.  
  336.           AT&FE1Q0V1X4&C1&D3&S0&W 
  337.  
  338.      and press return. You modem is now set up for use with
  339.      TrapDoor.  
  340.  
  341.        In your TrapDoor.cfg file, use the lines 
  342.  
  343.           BAUD 2400
  344.           SLOWMODEM 10
  345.           MODEMINIT "~~AT~Z|~"
  346.           MODEMHANGUP "|^"
  347.           MODEMDIALPRE "~~AT~DP"
  348.           MODEMDIALPOST "|~"
  349.           MODEMANSWER "~~AT~A|~"
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.      Installation                             Example Modem Settings
  373.  
  374.  
  375.      Page 7               TrapDoor's Fifth Manual               Page 7
  376.  
  377.  
  378.   2.5.2. US Robotics Courier HST Modems 
  379.  
  380.        These are the settings for a Dual Standard HST modem. If you
  381.      have the HST only or V.32 only version of the Courier, just set
  382.      the parameters that apply to your modem only.  
  383.  
  384.      USRobotics Courier 14400 HST Dual Standard NRAM Settings...
  385.  
  386.         DIAL=PULSE  B1  F1  M3  X7
  387.         BAUD=19200  PARITY=N  WORDLEN=8
  388.  
  389.         &A3  &B1  &G0  &H1  &I0  &J0  &K3  &L0
  390.         &M4  &N0  &P0  &R2  &S0  &X0  &Y1
  391.  
  392.         S02=043   S03=013   S04=010   S05=008
  393.         S06=007   S07=060   S08=002   S09=006
  394.         S10=007   S11=070   S12=050   S13=001
  395.         S15=008   S19=002   S21=010   S22=017
  396.         S23=019   S24=150   S26=000   S27=000
  397.         S28=008   S38=000
  398.  
  399.         STORED PHONE #0: 
  400.                      #1: 
  401.                      #2: 
  402.                      #3: 
  403.  
  404.        To setup your modem, enter a terminal program. Select the
  405.      baudrate at which you want to "lock" your modem, usually 19200
  406.      baud. (Warning: the serial.device of the Amiga - up to AmigaOS
  407.      1.3.3 - can not keep up with 38400 baud. Unless you have a
  408.      faster processor, like a 68020 or 68030, you will get lots of
  409.      transmission errors if you choose a higher baudrate than 19200.)
  410.      Then type 
  411.  
  412.           AT&FM3X7&A3&B1&H1&K3&R2S13=1S15=8&W 
  413.  
  414.      and press return. Your modem is now set up for use with
  415.      TrapDoor.  
  416.  
  417.        In your TrapDoor.cfg file, use the lines 
  418.  
  419.           BAUD 19200 LOCK
  420.           7WIRE
  421.           SLOWMODEM 10
  422.           MODEMINIT "~~ATZ|"
  423.           MODEMHANGUP "|^"
  424.           MODEMDIALPRE "~~ATB1DP"
  425.           MODEMDIALPOST "|"
  426.           MODEMANSWER "~~ATB0S7=30A|"
  427.           ARQSTRING "ARQ" SNIFFARQ
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.      Installation                             Example Modem Settings
  435.  
  436.  
  437.      Page 8               TrapDoor's Fifth Manual               Page 8
  438.  
  439.  
  440.   2.5.3. Internal Supra 2400zi Modems  
  441.  
  442.        Set your modem to: 
  443.  
  444.             E1 L2 M1 Q0 V1 X4 B0 Y0
  445.             &C1 &D3 &G0 &J0 &L0 &M0 &P0 &S0
  446.  
  447.             S0=0 S2=43 S3=13 S4=10 S5=8 S6=2 S7=20 S8=2 S9=6
  448.             S10=14 S12=50 S25=5 S26=1
  449.  
  450.        To setup your modem, enter a terminal program that can talk to
  451.      "modem0.device" and set the baudrate to 2400 baud. Then type 
  452.  
  453.           AT&FE1Q0V1X4&C1&D3&S0&W 
  454.  
  455.      and press return. You modem is now set up for use with
  456.      TrapDoor.  
  457.  
  458.        In your TrapDoor.cfg file, use the lines 
  459.  
  460.           SERIALNAME "modem0.device"
  461.           BAUD 2400
  462.           SLOWMODEM 10
  463.           MODEMINIT "~~AT~Z|~"
  464.           MODEMHANGUP "|^"
  465.           MODEMDIALPRE "~~AT~DP"
  466.           MODEMDIALPOST "|~"
  467.           MODEMANSWER "~~AT~A|~"
  468.  
  469.  
  470.  
  471.  
  472.  
  473.   2.5.4. Supra V.32bis    
  474.  
  475.        Users of this modem recommend to set ATS95=2W2. We have not
  476.      tested this modem.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.      Installation                             Example Modem Settings
  497.  
  498.  
  499.      Page 9               TrapDoor's Fifth Manual               Page 9
  500.  
  501.  
  502.   2.5.5. ZyXEL Modems    
  503.  
  504.        These are the settings for a ZyXEL 1496 E modem, ROMs 6.11a or
  505.      higher. If you have one of the other models, the parameters are
  506.      the same.  
  507.  
  508.      Current   Setting.............
  509.  
  510.       B0   E1   L1   M1   N1   Q0   V1   X7  
  511.      &B1  &C1  &D3  &G0  &H3  &J0  &K4  &L0  &M0  &N0  &P0  &R1
  512.                                                   &S0  &X0  &Y1
  513.      *B0  *C0  *D0  *E0  *F0  *G0  *I0  *L0  *M0  *P9  *Q2  *S0  
  514.  
  515.      S00=000   S01=000   S02=043   S03=013   S04=010   
  516.      S05=008   S06=003   S07=060   S08=002   S09=006   
  517.      S10=015   S11=050   S12=000   S13=000   S14=002   
  518.      S15=002   S16=000   S17=018   S18=000   S19=000   
  519.      S20=001   S21=242   S22=000   S23=121   S24=034   
  520.      S25=000   S26=000   S27=156   S28=068   S29=000   
  521.      S30=000   S31=017   S32=019   S33=000   S34=030   
  522.      S35=000   S36=000   S37=000   S38=008   S39=000   
  523.      S40=000   S41=000   S42=002   S43=000   S44=000   
  524.      S45=000   S46=000   S47=000   S48=004   S49=000   
  525.  
  526.        To setup your modem, enter a terminal program. Select the
  527.      baudrate at which you want to "lock" your modem, usually 19200
  528.      baud. (Warning: the serial.device of the Amiga - up to AmigaOS
  529.      1.3.3 - can not keep up with 38400 baud. Unless you have a
  530.      faster processor, like a 68020 or 68030, you will get lots of
  531.      transmission errors if you choose a higher baudrate than 19200.)
  532.      Then type 
  533.  
  534.           AT&FX7&D3S42.1=1S48.2=1&W 
  535.  
  536.      and press return. Your modem is now set up for use with
  537.      TrapDoor.  
  538.  
  539.        In your TrapDoor.cfg file, use the lines 
  540.  
  541.           BAUD 19200 LOCK
  542.           7WIRE
  543.           SLOWMODEM 25
  544.           MODEMINIT "~~ATZ|"
  545.           MODEMHANGUP "|^"
  546.           MODEMDIALPRE "~~ATDP"
  547.           MODEMDIALPOST "|"
  548.           MODEMANSWER "~~ATA|"
  549.           ARQSTRING "ARQ" SNIFFARQ
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.      Installation                             Example Modem Settings
  559.  
  560.  
  561.      Page 10              TrapDoor's Fifth Manual              Page 10
  562.  
  563.  
  564.   3. Basics     
  565.  
  566.        This chapter is intended to give you a quick overview about
  567.      the operation of TrapDoor and certain selected topics. If you
  568.      wish to look up a specific command keyword, please see the
  569.      reference section "Configuration Commands".  
  570.  
  571.   3.1. FidoNet     
  572.  
  573.        FidoNet is a world-wide network of many "FidoNet-compatible"
  574.      bulletin boards, which communicate with each other using
  575.      "mailers". TrapDoor is one of these mailers, it allows you to
  576.      send and receive FidoNet mail and files.  
  577.  
  578.        If you are not familiar with FidoNet, or certain terms used in
  579.      this manual, please see "TrapDoor's FidoNet Manual"
  580.      (FidoNet.Man) and the glossary there.  
  581.  
  582.   3.2. Mailer Operation    
  583.  
  584.        A mailer transfers mail bundles and/or files to/from another
  585.      FidoNet system. You (or other mail packing software) prepare the
  586.      outgoing mail and files in a so-called "outbound directory". You
  587.      then tell TrapDoor to call another FidoNet system. TrapDoor will
  588.      use the modem to place a telephone call there, then proceed to
  589.      transfer mail/files with built-in protocols.  Also, TrapDoor
  590.      will receive mail and files that are waiting at the other system
  591.      for you. These incoming data will be stored in the "inbound
  592.      directory", from where you (or the mail tossing software) can
  593.      further process the mail and files.  
  594.  
  595.        A more detailed description of this process and the
  596.      interaction between TrapDoor and mail processing software is
  597.      given in TrapDoor's FidoNet Manual.  
  598.  
  599.   3.3. Nodelist     
  600.  
  601.        A "nodelist" is a directory listing all (or parts of) the
  602.      nodes in FidoNet. It stores the names of systems and sysops, the
  603.      node numbers, and the telephone number for each node. TrapDoor
  604.      can use the nodelist to look-up telephone numbers before placing
  605.      an outgoing call.  
  606.  
  607.        A separate program called "TrapList" is used to process the
  608.      nodelist before TrapDoor can reference it. TrapList builds index
  609.      files for the nodelist, which TrapDoor later uses. For more
  610.      information on TrapList and how to compile/index nodelists,
  611.      please see "TrapList's Faaaast Manual" (TrapList.Man).  
  612.  
  613.        Point systems do not necessarily need a nodelist, as they only
  614.      call one single "boss" system, the telephone number of which can
  615.      be stored in TrapDoor's configuration file.  
  616.  
  617.  
  618.  
  619.  
  620.      Basics                                               Nodelist
  621.  
  622.  
  623.      Page 11              TrapDoor's Fifth Manual              Page 11
  624.  
  625.  
  626.   3.4. Compatibility     
  627.  
  628.        A sensitive point in every FidoNet mailer is "compatibility".
  629.      FidoNet uses at least three different handshake methods and more
  630.      than three different transfer protocols. Not every mailer
  631.      implements all of them, and so it is very important that mailers
  632.      automatically detect the capabilities of the other system and
  633.      switch to the correct handshake and protocol. This detection
  634.      phase is also one of the sources of most errors and failures to
  635.      establish a proper connection between two FidoNet systems.  
  636.  
  637.        TrapDoor has been extensively tested with other mailers,
  638.      including various versions of BinkleyTerm, D'Bridge, FrontDoor,
  639.      Paragon and TrapDoor itself. It should work fine with most
  640.      systems.  
  641.  
  642.        There are two additional notes about compatibility, however.
  643.      The EMSI handshake method sometimes causes problems with some
  644.      BBSs with an integrated mailer, such as some older versions of
  645.      Opus or Paragon. Should you repeatedly experience strange
  646.      hangups with such a system, you should disable EMSI using the
  647.      NOEMSI keyword and try again. Especially older versions of
  648.      Paragon are known to not work correctly with EMSI. If you
  649.      regularly call such a system, you might want to set up a "custom
  650.      configuration" for that system (see the next chapter).  
  651.  
  652.        Second, the FTS-1 "Lotek" protocol is very often poorly
  653.      implemented in other mailers. TrapDoor uses a very strict
  654.      version of this protocol, and behaves exactly according to the
  655.      specifications. Other mailers with errors in their FTS-1
  656.      protocol code fail with TrapDoor. Two known cases are Tabby, a
  657.      Macintosh mailer, which fails completely, and old versions of
  658.      TIMS, an MS-DOS mailer, which sometimes failed to transfer the
  659.      names of inbound files. (Newer versions of TIMS are fine.)
  660.      TrapDoor will name the files "Unnamed.File", "Unnamed.File,1",
  661.      "Unnamed.File,2" etc. Also, in the case of unnamed files, the
  662.      files themselves may have some Ctrl-Z (hex 1A) characters at the
  663.      very end, padding their size to an even multiple of 128 bytes.  
  664.  
  665.   3.5. Custom Configuration Entries   
  666.  
  667.        Sometimes it is desirable to use a special custom
  668.      configuration when calling a certain node. For example, if you
  669.      regularly connect to a Paragon system which cannot handle EMSI,
  670.      you will want to disable EMSI when calling that node.  
  671.  
  672.        TrapDoor allows you to set up such custom configuration
  673.      entries.  There is a utility called "setconfig" to store a
  674.      configuration string for a certain node number. For example, to
  675.      disable EMSI for 2:314/471, enter 
  676.  
  677.           setconfig 2:314/471 "NOEMSI" 
  678.  
  679.  
  680.  
  681.  
  682.      Basics                             Custom Configuration Entries
  683.  
  684.  
  685.      Page 12              TrapDoor's Fifth Manual              Page 12
  686.  
  687.  
  688.        Custom configurations are very flexible. For example, you
  689.      might have to use special modem settings to call some node.
  690.      Using the setconfig utility, you enter 
  691.  
  692.           setconfig 3:504/132 "BAUD 7200 MODEMDIALPRE  \ on one 
  693.                                 ATS42.3=1X29S133=45DT" / line 
  694.  
  695.        Or, to override a telephone number from the nodelist: 
  696.  
  697.           setconfig 2:253/500 "CALL 0044-44-123-1234" 
  698.  
  699.        Here is another trick: if a node has been marked as
  700.      -Undialable- in the nodelist, TrapDoor will refuse to call it.
  701.      It will instead display something like "The Mad House (2:310/6)
  702.      is undialable". If you know the telephone number of that system,
  703.      you can enter 
  704.  
  705.           setconfig 2:310/6 "CALL 0043-1-556-7863 COST 833" 
  706.  
  707.        It is important that you specify the COST parameter here. Give
  708.      it the cost per minute for that call.  
  709.  
  710.        If you lose track of your custom configuration entries, the
  711.      listconfig utility will list them all: 
  712.  
  713.          Node       : Config
  714.         ------------------------
  715.         2:310/6.0   : call 12341234 cost 6700
  716.         2:512/17.0  : MODEMDIALPRE ATS7=60B0X7DP NOEMSI
  717.         1:125/111.0 : NOEMSI
  718.  
  719.         Total 3 nodes in database
  720.  
  721.   3.6. Accounting     
  722.  
  723.        TrapDoor can keep a count of all outgoing calls and incoming
  724.      calls, on a per node basis, and the cost for those calls. When
  725.      you have enabled accounting (see the (NO)ACCOUNTING keyword),
  726.      TrapDoor will maintain a database of 
  727.  
  728.        - the number of outgoing calls to a node
  729.        - the number of incoming calls from a node
  730.        - the number of successful sessions with a node
  731.        - the number of failed sessions with a node
  732.        - the number of BUSY signals when calling a node
  733.        - the number of NO CARRIER signals when calling a node
  734.        - the number of VOICE signals when calling a node
  735.        - the total cost of all outgoing calls to a node
  736.        - the TrxID (a timestamp) of the last successful connection
  737.          with that node 
  738.  
  739.        The "listacct" tool will display all the accounting
  740.      information, and "clearacct" will reset it, either on an
  741.      individual basis or for all nodes.  
  742.  
  743.  
  744.      Basics                                             Accounting
  745.  
  746.  
  747.      Page 13              TrapDoor's Fifth Manual              Page 13
  748.  
  749.  
  750.        By using the ACCTMAX keyword, you can specify maxima for all
  751.      of the above accounting items. You can set limits, and TrapDoor
  752.      will refuse to call a node when at least one of the limits is
  753.      exceeded. For example, you could set the maximum for the number
  754.      of failed sessions to 2, and TrapDoor will refuse to call a node
  755.      again after two failed connects (where a connection was made,
  756.      but the carrier was lost before the successful end of the
  757.      session).  
  758.  
  759.   3.7. Security     
  760.  
  761.        It is often important to make sure that a particular system is
  762.      really who it claims to be. For that reason, TrapDoor can use
  763.      passwords to protect mail sessions. You can set up a password
  764.      for each node you regularly exchange mail with, and TrapDoor
  765.      will check the password every time this node calls you. If the
  766.      password which the other end sends and the password that is
  767.      stored in the local database do not match, TrapDoor will hang
  768.      up, or, if the password for an AKA address is wrong, it will
  769.      simply "forget" that AKA and will continue the session without
  770.      sending mail or files for the AKA address.  
  771.  
  772.        The "setpasswd" tool allows you to set up or remove passwords.
  773.      For example, to setup a password of "vienna" for 2:313/28, enter 
  774.  
  775.           setpasswd 2:313/28 "vienna" 
  776.  
  777.        TrapDoor will always compare passwords using a
  778.      case-insignificant match. It will, however, send out passwords
  779.      exactly as you typed them, in case the other end does not use a
  780.      case-insensitive compare.  
  781.  
  782.        To protect you from losing your password database in case of a
  783.      system crash, you can also enter "Password" statements in your
  784.      TrapList configuration file and have TrapList set up all your
  785.      passwords. This is described in more detail in the manual for
  786.      TrapList.  
  787.  
  788.        If you are running a private system, and you do not want to
  789.      receive calls from any other nodes except the ones with which
  790.      you have established passwords, you can set up a secret password
  791.      using the PASSWORD keyword. Other mailers will only be able to
  792.      connect to your system if either (a) they know the secret
  793.      password or (b) you have set up another password for them (using
  794.      setpasswd) and they send the latter one.  
  795.  
  796.        If you are running a public FidoNet node, do not use the
  797.      PASSWORD configuration keyword.  
  798.  
  799.   3.8. File Tagging    
  800.  
  801.        Another security feature of TrapDoor is "file tagging". Each
  802.      received file will be tagged with a "Secure" field in the
  803.      filenote, if it was received either from a node listed in the
  804.  
  805.  
  806.      Basics                                            File Tagging
  807.  
  808.  
  809.      Page 14              TrapDoor's Fifth Manual              Page 14
  810.  
  811.  
  812.      nodelist or from a node with which a password was set up. The
  813.      "Secure"-Tag will contain either "NL" or "PW" or both "NL,PW"
  814.      depending on the particular security measures under which the
  815.      file was received. This can be used by a mail tosser to toss
  816.      only mail from password-protected sessions automatically, for
  817.      example.  
  818.  
  819.        Also, every file received will be tagged with the node number
  820.      of the system from which it was received, in a "From" field.  
  821.  
  822.        Every FidoNet session will be assigned a unique number. This
  823.      number will be recorded in the log file, and all files received
  824.      in this session will be tagged with a "Trx" field listing this
  825.      unique "transaction id".  
  826.  
  827.        If files were renamed during the receive operation (for
  828.      example, because the file already existed), the original
  829.      filename will be stored in another field in the filenote, tagged
  830.      as "FileName".  
  831.  
  832.   3.9. Refusing and Pickup Preferences  
  833.  
  834.        The Emsi handshake allows for "Refusing" and "Pickup
  835.      Preferences". These features work only when an Emsi handshake
  836.      was chosen at the beginning of the session.  
  837.  
  838.        Refusing means that a system may refuse to receive certain
  839.      files or certain mail packets at specific times. A system may
  840.      refuse 
  841.  
  842.        - file requests
  843.        - compressed mail
  844.        - file attaches
  845.        - all of the above
  846.  
  847.        TrapDoor will respect these wishes and not send the
  848.      appropriate items, unless NOALLOWREFUSING is in effect.  
  849.  
  850.        Pickup Preferences means that another system may choose what
  851.      mail or files to pick up from TrapDoor. A system may want to
  852.      pick up mail and files 
  853.  
  854.        - for all presented addresses
  855.        - for the primary address only (no AKAs)
  856.        - no pickup at all
  857.  
  858.        TrapDoor will respect these preferences and only send the
  859.      requested items. (NO)ALLOWREFUSING does not affect this
  860.      behaviour.  
  861.  
  862.        To set up your own Refusing or Pickup Preferences, use the
  863.      FORBID and PICKUP keywords. The default is to pick up mail for
  864.      all presented addresses, and to not refuse to receive anything.  
  865.  
  866.  
  867.  
  868.      Basics                           Refusing and Pickup Preferences
  869.  
  870.  
  871.      Page 15              TrapDoor's Fifth Manual              Page 15
  872.  
  873.  
  874.   3.10. The Keyboard    
  875.  
  876.        TrapDoor features sophisticated keyboard handling, including
  877.      the ability to assign arbitrary configuration commands to
  878.      function keys.  
  879.  
  880.        One of the most important keys is probably the ESC (Escape)
  881.      key. Pressing this key during a session will abort it. TrapDoor
  882.      will hangup as soon as possible and either return to answer
  883.      mode, or, if the call was not initiated from answer mode, exit.
  884.      When TrapDoor is idle and you press the ESC key, it will reset
  885.      the modem.  
  886.  
  887.        Next, TrapDoor makes use of the Alt (Alternate) key for system
  888.      functions.  When TrapDoor is idle and waiting in answer mode,
  889.      you can activate a number of things via Alt-key sequences. The
  890.      Alt key works like a shift key: you have to hold it down while
  891.      pressing another key. These are the Alt key sequences that
  892.      TrapDoor understands: 
  893.  
  894.          Alt-A ... immediately Answer the phone.  
  895.          Alt-C ... reread the Config file "MAIL:TrapDoor.cfg".  
  896.                    This is useful if you have changed the config file
  897.                    and want to reset TrapDoor to the new settings.  
  898.          Alt-Q ... Quit, same as Alt-X.  
  899.          Alt-R ... Reset modem.  
  900.          Alt-S ... toggle Showrexx mode (see SHOWREXX keyword).  
  901.          Alt-X ... eXit, same as Alt-Q.  
  902.  
  903.        If you get stuck and cannot remember a certain key, just press 
  904.  
  905.          HELP .... pop up the Help display.  
  906.                    Please note that TrapDoor will wait for the Help
  907.                    window to close before it exits.  
  908.  
  909.        From the main help window, you can select "Settings" or
  910.      "Keys". "Settings" will give you a short summary of all the
  911.      current settings of your TrapDoor, "Keys" will show you a
  912.      summary of all standard key assignments of TrapDoor. Select
  913.      "Done" when finished reading. From the "Keys" display, you can
  914.      also choose "F-Keys" which will show you a summary of the
  915.      current function key assignments.  
  916.  
  917.        Function key assignments can be put on any of the function
  918.      keys (reasonable, eh?). These are the keys in the topmost row of
  919.      your Amiga keyboard, beside the ESC key. The FKEY keyword is
  920.      used to assign function keys. When you press a function key, and
  921.      there is an assignment for it, TrapDoor will send the string
  922.      assigned to that key to its own ARexx port. From there, the
  923.      assignment will be processed. That way, you can put things like
  924.      "Call 2:310/6" or "NOEMSI" on your function keys, or you can
  925.      start external programs with the "Run" and "Spawn" keywords.  
  926.  
  927.  
  928.  
  929.  
  930.      Basics                                            The Keyboard
  931.  
  932.  
  933.      Page 16              TrapDoor's Fifth Manual              Page 16
  934.  
  935.  
  936.        Always remember that hitting a function key will cause
  937.      TrapDoor to send an ARexx-message to itself. Thus, it will only
  938.      process that keystroke when it is idle in answer mode. (It will
  939.      actually process the keypress immediately, but the ARexx-message
  940.      will be waiting at the ARexx-port until TrapDoor reads it when
  941.      it comes back to the "Waiting for call" state.) 
  942.  
  943.  
  944.   3.11. Return Values    
  945.  
  946.        When TrapDoor returns to the calling program, the following
  947.      returncodes indicate its success or failure: 
  948.  
  949.           0 ... everything successfully completed.  
  950.           5 ... some minor problem occurred 
  951.                 Either no session could be established (BUSY, NO
  952.                 CARRIER, VOICE etc.) or something went wrong during a
  953.                 session (timeouts, too many retries, carrier lost
  954.                 etc.). This can only occur if you do not start
  955.                 TrapDoor in answer mode, but immediately tell it to
  956.                 make a call, i.e. TrapDoor Call 2:310/6.  
  957.          20 ... some fatal error prohibited any further action.  
  958.                 TrapDoor could not open its window, screen, serial
  959.                 device or timer device, allocate memory or other
  960.                 necessary items.  
  961.  
  962.        More detailed result codes are available through the ARexx
  963.      interface. See the STATUS command.  
  964.  
  965.  
  966.   3.12. Fax and Voice Support  
  967.  
  968.        TrapDoor can detect special "fax connect" and "voice connect"
  969.      messages from the modem and run some external software to
  970.      receive incoming fax or voice calls. See the description of the
  971.      FAXSTRING, FAXCOMMAND, VOICESTRING and VOICECOMMAND keywords.  
  972.  
  973.  
  974.   3.13. Automatic Buffer Sizing   
  975.  
  976.        Some people have been complaining about the CPU usage of
  977.      TrapDoor. The new feature of Automatic Buffer Sizing (ABS for
  978.      short), if enabled, will try to reduce the CPU load of TrapDoor
  979.      during Zmodem receiving.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.      Basics                                  Automatic Buffer Sizing
  993.  
  994.  
  995.      Page 17              TrapDoor's Fifth Manual              Page 17
  996.  
  997.  
  998.   3.14. ARexx     
  999.  
  1000.        TrapDoor includes an ARexx port -- while in answer mode
  1001.      waiting for incoming calls, TrapDoor also accepts ARexx
  1002.      messages. The port name, which is also called the "host name" in
  1003.      ARexx parlance, is "TrapDoor", unless you change it with the
  1004.      REXXNAME keyword. Use this name in Rexx "Address ..." statements
  1005.      to select TrapDoor.  
  1006.  
  1007.        All commands and keywords listed in the "Configuration
  1008.      Keywords" section can be sent to the ARexx port and will be
  1009.      understood, although some might not behave as expected. (For
  1010.      example, if you change SERIALNAME while in answer mode, TrapDoor
  1011.      will not switch to the new device. Instead, you should terminate
  1012.      TrapDoor and run it again with a different setup.) 
  1013.  
  1014.        Apart from that, almost everything that can be set up from the
  1015.      command line (or a config file) can also be done via the ARexx
  1016.      port.  
  1017.  
  1018.        Some commands can only be used from ARexx (or TrapTell). Those
  1019.      keywords are marked with 
  1020.  
  1021.        (+) ARexx only command 
  1022.  
  1023.        Attempts to use them from the CLI will cause nothing but an
  1024.      error message.  
  1025.  
  1026.        Usually, ARexx commands will be executed whenever TrapDoor is
  1027.      idle and waiting for a call. Some ARexx commands can also be
  1028.      sent for immediate execution. In that case, the command will be
  1029.      executed immediately, no matter whether or not TrapDoor is just
  1030.      connected to another system and a mail session takes place. For
  1031.      immediate execution, the command must be prepended with an "at"
  1032.      character ("@"). Such keywords are marked with 
  1033.  
  1034.        (@) asynchronous execution possible 
  1035.  
  1036.        Here are a few examples: 
  1037.  
  1038.           /* This is a Rexx script to call my boss. TrapDoor must
  1039.              already be running in Answer mode. */
  1040.  
  1041.           options results
  1042.           address "TrapDoor"
  1043.  
  1044.           "Call Boss"
  1045.           "Status D"
  1046.           say "Modem returned" RESULT "from the last call."
  1047.           "Status X"
  1048.           say "The last call terminated with error" RESULT"."
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.      Basics                                                  ARexx
  1055.  
  1056.  
  1057.      Page 18              TrapDoor's Fifth Manual              Page 18
  1058.  
  1059.  
  1060.        Should you happen not to have a copy of ARexx handy, no
  1061.      problem -- the tool TrapTell simulates an ARexx server, sending
  1062.      a message to TrapDoor and waiting for the results.  
  1063.  
  1064.        Here is an example. It stops a running TrapDoor by sending it
  1065.      a "Quit" command.  
  1066.  
  1067.           TrapTell "Quit" 
  1068.  
  1069.        Here's another example. First, we start up TrapDoor in answer
  1070.      mode, but we do not want it to react to incoming calls, so we
  1071.      set the RINGS limit very high. Immediately after launching
  1072.      TrapDoor, we wait a few seconds so TrapDoor has time to
  1073.      initialize everything and open its ARexx port.  
  1074.  
  1075.           run TrapDoor answer rings 50000 
  1076.           wait 5 secs 
  1077.  
  1078.        Then, I'd like to call node 1:200/300 and get the connect
  1079.      result string: 
  1080.  
  1081.           TrapTell "call 1:200/300" 
  1082.           TrapTell "status d" 
  1083.  
  1084.        Try it, you should soon become familiar with that method of
  1085.      controlling programs. There are some example AmigaDOS scripts
  1086.      that use the TrapTell command in the Scripts/ subdirectory on
  1087.      the distribution disk (or in the distribution archive) and there
  1088.      are some more ARexx programs that make use of TrapDoor's ARexx
  1089.      port in the rexx/ subdirectory.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.   3.15. Dial Scripts    
  1097.  
  1098.        Sometimes, the built-in modem dialer in TrapDoor is not
  1099.      sophisticated enough. It will do fine for a normal telephone
  1100.      link between two nodes, but in some cases, two nodes might be
  1101.      linked via a packet switched network, a private network
  1102.      exchange, PCP, Telnet, Datex-P or whatever else there is.  
  1103.  
  1104.        In these networks, it is usually necessary to log onto the
  1105.      network, identify yourself, and then select the network address
  1106.      or data telephone number with which you'd like to connect. Then,
  1107.      the network system will connect you, and only after that you
  1108.      will be able to establish your normal FidoNet session.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.      Basics                                            Dial Scripts
  1117.  
  1118.  
  1119.      Page 19              TrapDoor's Fifth Manual              Page 19
  1120.  
  1121.  
  1122.        TrapDoor features a tiny script language to accommodate this
  1123.      method of communication. You will have to write ARexx-scripts
  1124.      for your specific data network using the STIMEOUT, SWRITE,
  1125.      SMODEM, SLINE, SCLEAR and SWAIT commands. As soon as you have
  1126.      connected to the other FidoNet system, you issue the
  1127.      STARTSESSION command. Then, TrapDoor will take over again and
  1128.      proceed with a normal FidoNet session.  
  1129.  
  1130.        Here is a short example: 
  1131.  
  1132.           /* This is a Rexx script to connect to some other system
  1133.              via a custom data network. TrapDoor should already be
  1134.              running in Answer mode. */
  1135.  
  1136.           address "TrapDoor"
  1137.  
  1138.           STIMEOUT 10
  1139.           SMODEM "~~ATZ|"      /* initialize the modem */
  1140.           SWAIT OK
  1141.           STIMEOUT 60
  1142.           SMODEM "ATDP1234"    /* call the data network */
  1143.           SWAIT CONNECT
  1144.           SWAIT "login:"       /* wait for login prompt */
  1145.           SWRITE "mad max"||d2c(13)    /* send username */
  1146.           SWAIT "password:"
  1147.           SWRITE "secret"||d2c(13)
  1148.           SWAIT "*"                  /* wait for prompt */
  1149.           SWRITE "c 345-17635132#"||d2c(13)
  1150.           SWAIT "connection ok"
  1151.           STARTSESSION             /* begin the session */
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.   3.16. Multiple Lines    
  1158.  
  1159.        TrapDoor can be run on multiple telephone lines. In order to
  1160.      reduce memory usage, we recommend making TrapDoor resident. This
  1161.      is achieved with the AmigaDOS Resident command as in 
  1162.  
  1163.           Resident Mail:bin/TrapDoor       ; or wherever TrapDoor
  1164.                                            ; resides on your system
  1165.  
  1166.        Next, you have to start each invocation of TrapDoor with
  1167.      different parameters for SERIALNAME or at least SERIALUNIT, and
  1168.      REXXNAME. TrapDoor will refuse to open if the serial device or
  1169.      the ARexx portname is already in use.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.      Basics                                          Multiple Lines
  1179.  
  1180.  
  1181.      Page 20              TrapDoor's Fifth Manual              Page 20
  1182.  
  1183.  
  1184.        Let us assume your configuration file contains, among other
  1185.      things, the statements 
  1186.  
  1187.           SerialName "serial.device"
  1188.           SerialUnit 0
  1189.  
  1190.      Now, the commands 
  1191.  
  1192.           Run TrapDoor SerialUnit 1 RexxName "TrapDoor-1"
  1193.           Run TrapDoor SerialUnit 2 RexxName "TrapDoor-2"
  1194.           Run TrapDoor SerialName other.device RexxName "TrapDoor-3"
  1195.  
  1196.      will start three copies of TrapDoor. The first one will use
  1197.      serial.device, unit 1, and its ARexx-port will be named
  1198.      "TrapDoor-1"; the second will use serial.device, unit 2,
  1199.      "TrapDoor-2"; and the third one will use a special serial device
  1200.      named other.device, unit 0, and an ARexx-port of "TrapDoor-3".  
  1201.  
  1202.        It is often useful to have separate configuration files for
  1203.      multiple lines, and change not only the above parameters, but
  1204.      also things like the window positions and sizes (LOGWINDOW,
  1205.      STATWINDOW) etc. Also note that there is a special SCREENMODE
  1206.      TRAPDOOR, which is very much like SCREENMODE CUSTOM, the
  1207.      difference being only that all invocations of TrapDoor will open
  1208.      their windows on the same shared TrapDoor-screen. (The first
  1209.      invocation of TrapDoor will open the screen, and the screen will
  1210.      close only after the last copy of TrapDoor has been shut down.).
  1211.      If you are using Kickstart 2.04 or higher, you can also use the
  1212.      new SCREENMODE PUBLIC, which works identically to SCREENMODE
  1213.      TRAPDOOR, but takes advantage of the KS 2.04 "Public Screens".
  1214.      That means that other programs can also share the TrapDoor
  1215.      screen, or TrapDoor can be made to run on other public screens.  
  1216.  
  1217.        To send ARexx-commands to a specific copy of TrapDoor, use the
  1218.      ARexx ADDRESS command to select the port name. Here is an
  1219.      example: 
  1220.  
  1221.           /* This ARexx-script closes down TrapDoor on line 3 */
  1222.  
  1223.           address "TrapDoor-3"
  1224.           "quit"
  1225.  
  1226.        If you use TrapTell or TrapPoll, use the -p switch to select
  1227.      the portname, for example: 
  1228.  
  1229.           TrapTell -pTrapDoor-3 "quit" 
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.      Basics                                          Multiple Lines
  1241.  
  1242.  
  1243.      Page 21              TrapDoor's Fifth Manual              Page 21
  1244.  
  1245.  
  1246.   3.17. Logfile Buffering    
  1247.  
  1248.        Older versions of TrapDoor (up to 1.80) would flush the
  1249.      logfile after every single line of log. This would slow down the
  1250.      program, especially when the logfile grew large. Thus, TrapDoor
  1251.      now allows you to configure a maximum number of lines and a
  1252.      maximum number of seconds, during which the logfile will not be
  1253.      flushed. If any of the two values has been exceeded, and a new
  1254.      line is written to the logfile, the file will be closed and
  1255.      reopened, thus forcing all data to be written to the disk.  
  1256.  
  1257.        This is a two-edged sword: on the one hand, your system will
  1258.      become speedier if you don't let your logfile be flushed so
  1259.      often; on the other hand, if your system crashes for any reason,
  1260.      part of the logfile might not have been updated on the disk and
  1261.      you might just miss the important information that lead to the
  1262.      crash. So, you should flush the logfile at least after 10
  1263.      seconds or so or after 10 lines of information.  
  1264.  
  1265.        The logfile will always be flushed before an external program
  1266.      is run, so that the external software can add data to the
  1267.      TrapDoor logfile. Also, the logfile will be kept flushed when
  1268.      TrapDoor is idle waiting in answer mode.  
  1269.  
  1270.   3.18. OwnDevUnit.library Support    
  1271.  
  1272.        Since version 1.84, TrapDoor now features support for
  1273.      OwnDevUnit.library. This is a freeware library that goes in your
  1274.      LIBS: directory and manages access to the serial port between
  1275.      multiple programs.  
  1276.  
  1277.        Imagine your TrapDoor is running in answer mode, idle, and
  1278.      waiting for a call. Now you want to make an outgoing uucp call.
  1279.      Fortunately, the AmigaUUCP package by Matt Dillon also supports
  1280.      OwnDevUnit.library, and so you simply have to start "uucico" to
  1281.      make the outgoing call. Through OwnDevUnit.library, uucico will
  1282.      automatically let TrapDoor know that it wants the serial port,
  1283.      and TrapDoor will close it and relinquish it to uucico until
  1284.      uucico is done. At that point, TrapDoor will reopen the serial
  1285.      port, reinitialize the modem, and will be ready to accept new
  1286.      incoming calls or place outgoing calls.  
  1287.  
  1288.        Support for OwnDevUnit.library is automatic. If the library
  1289.      can be opened, TrapDoor will use it.  
  1290.  
  1291.        Note a few details: While the serial device has been "taken
  1292.      away" from TrapDoor, it will be in a "sleeping" state and reject
  1293.      most ARexx messages. With the exception of the asynchroneous
  1294.      commands (those that start with an @ character), TrapDoor will
  1295.      return all ARexx messages with a result code of 50 in this
  1296.      mode.  
  1297.  
  1298.        OwnDevUnit.library is not provided with TrapDoor. It can be
  1299.      found on Fish Disk 650, for instance.  
  1300.  
  1301.  
  1302.      Basics                              OwnDevUnit.library Support
  1303.  
  1304.  
  1305.      Page 22              TrapDoor's Fifth Manual              Page 22
  1306.  
  1307.  
  1308.   4. Configuration Commands    
  1309.  
  1310.        All configuration keywords are listed in the section
  1311.      "Keywords". They can be used either in the configuration file or
  1312.      on the command line. The keywords are neither case nor position
  1313.      sensitive.  
  1314.  
  1315.        The meanings of the special notes 
  1316.  
  1317.        (+) ARexx only command 
  1318.        (@) asynchronous execution possible 
  1319.  
  1320.      are explained in the "ARexx" chapter.  
  1321.  
  1322.        If you wish to include space characters (blanks) in a string
  1323.      parameter, you must surround the string with double-quote
  1324.      characters, as in 
  1325.  
  1326.           SYSOP "Maximilian Hantsch" 
  1327.  
  1328.        The backslash ('\') is used as an escape-character. For
  1329.      example, if you want to include a double-quote within a string,
  1330.      you need to use 
  1331.  
  1332.           NAME "The \"quoted\" node" 
  1333.  
  1334.        Of course, if you need a single backslash in a string, you
  1335.      need to escape it too, so you have to double each occurrance: 
  1336.  
  1337.           BANNER "A Slash / and a Backslash \\ ..." 
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.      Configuration Commands
  1365.  
  1366.  
  1367.      Page 23              TrapDoor's Fifth Manual              Page 23
  1368.  
  1369.  
  1370.   4.1. Embedded Percent-Commands    
  1371.  
  1372.        The AFTERSESSION, BBSCOMMAND, DIALER, FAXCOMMAND, FREQUEST,
  1373.      RINGCOMMAND and VOICECOMMAND keywords allow you to specify a
  1374.      commmand-string that will be executed. In these command-strings,
  1375.      the following embedded %-commands are permitted. All of them are
  1376.      case-sensitive.  
  1377.  
  1378.           %a ... aka of the remote system (one aka per %a)
  1379.           %A ... all akas of the remote system (space separated)
  1380.           %b ... baudrate (between computer and modem)
  1381.           %B ... baudrate (of the actual connection)
  1382.           %C ... full CONNECT message from the modem
  1383.           %s ... serial device name
  1384.           %u ... serial device unit number
  1385.           %f ... serial device flags
  1386.           %r ... unique random number (timestamp)
  1387.           %l ... name of logfile
  1388.           %Z ... zone number of the other system
  1389.           %N ... net number of the other system
  1390.           %F ... fido node number of the other system
  1391.           %P ... point number of the other system
  1392.           %n ... complete FidoNet address of the other system
  1393.           %S ... name of Sysop of other system
  1394.           %R ... name of the ARexx port of this TrapDoor
  1395.           %p ... name of the public screen
  1396.           %I ... name of inbound directory
  1397.           %O ... name of outbound directory
  1398.           %d ... direction: 1 if inbound call, -1 if outbound call
  1399.           %% ... %
  1400.  
  1401.        For the FREQUEST keyword, the following sequences are allowed
  1402.      in addition to the above: 
  1403.  
  1404.           %i ... name of the .REQ file (input file)
  1405.           %o ... name of the .RLO file (output file)
  1406.  
  1407.        Please note that %b and %B are equivalent unless you use LOCK.
  1408.      In that case, %b will reflect the LOCKed baudrate, whereas %B
  1409.      will give you the baudrate of the actual connection (that was
  1410.      returned by the modem in a "CONNECT XXXX" message).  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.      Configuration Commands               Embedded Percent-Commands
  1427.  
  1428.  
  1429.      Page 24              TrapDoor's Fifth Manual              Page 24
  1430.  
  1431.  
  1432.   4.2. Modem Commands    
  1433.  
  1434.        All the modem commands (MODEMINIT, MODEMDIALPRE,
  1435.      MODEMDIALPOST, MODEMANSWER and MODEMHANGUP -- all explained
  1436.      later on) accept a few special characters in the configuration
  1437.      string. These are: 
  1438.  
  1439.           ~ ... short delay
  1440.           ^ ... drop DTR, wait a while, raise DTR again
  1441.           | ... send a carriage return character
  1442.           \ ... escape character, send next character as is
  1443.  
  1444.        All other characters will be sent to the modem unchanged and
  1445.      without any further action.  
  1446.  
  1447.        As with configuration keywords, the backslash ('\') is used as
  1448.      an escape-character for the following character, which is then
  1449.      just sent out unchanged. For example, if you need to send AT~Z4
  1450.      to your modem, use 
  1451.  
  1452.           AT\~Z4| 
  1453.  
  1454.        If you put this command into the configuration file, beware
  1455.      that the backslash needs to be escaped there. So you would have
  1456.      to use 
  1457.  
  1458.           MODEMINIT "AT\\~Z4|" 
  1459.  
  1460.      which gets even worse if you need to send a backslash to the
  1461.      modem. For example, some modems know commands such as AT\N0. In
  1462.      the configuration file, this needs to be written as: 
  1463.  
  1464.           MODEMINIT "AT\\\\N0|" 
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.      Configuration Commands                          Modem Commands
  1489.  
  1490.  
  1491.      Page 25              TrapDoor's Fifth Manual              Page 25
  1492.  
  1493.  
  1494.   4.3. Keywords     
  1495.  
  1496.        This section lists each configuration keyword and ARexx
  1497.      command that TrapDoor understands and explains the parameters
  1498.      and function of each keyword. The keywords are listed in
  1499.      alphabetical order. Boolean keywords, which can be preceeded by
  1500.      "NO" are listed under their main name; for example (NO)DIETIFNA
  1501.      is listed under "D".  
  1502.  
  1503.   4.3.1. (NO)7WIRE     
  1504.  
  1505.        Enable/disable 7-wire cabling. This will instruct the serial
  1506.      device to use (or not to use) the CTS and RTS signals. If you
  1507.      are using high speed modems with data compression, such as a US
  1508.      Robotics Courier HST, you must use 7WIRE handshake and you must
  1509.      set your modem to "hardware handshake" mode, otherwise various
  1510.      difficulties will arise. This keyword defaults to 7WIRE.  
  1511.  
  1512.      Examples: 7Wire 
  1513.                No7Wire 
  1514.  
  1515.   4.3.2. ABORT signals     
  1516.  
  1517.        Abort is the ARexx equivalent of ^C, ^D, ^E and ^F. To
  1518.      "simulate" such a keypress, just send an "ABORT k" message,
  1519.      where k can be any of C, D, E or F. Multiple signals are OK,
  1520.      i.e. "ABORT CDEF" works as intended. For example, to terminate a
  1521.      TrapDoor that runs in answer mode, use "ABORT F".  
  1522.  
  1523.        (+) ARexx only command 
  1524.        (@) asynchronous execution possible (@ABORT) 
  1525.  
  1526.      Example: TrapTell "Abort F" 
  1527.  
  1528.   4.3.3. (NO)ABS     
  1529.  
  1530.        Enables/disables Automatic Buffer Sizing. If this is turned
  1531.      on, TrapDoor will try to reduce its CPU usage during Zmodem
  1532.      receiving. ABS has no effect whatsoever on
  1533.      Telink/DietIfna/Xmodem/FTS1 sessions, on the YooHoo or EMSI
  1534.      handshake or on Zmodem sending. It defaults to NOABS.  
  1535.  
  1536.      Examples: ABS 
  1537.                NoABS 
  1538.  
  1539.   4.3.4. (NO)ACCOUNTING     
  1540.  
  1541.        Turn accounting on or off. When enabled, TrapDoor will keep
  1542.      track of the number of calls made to a node, the total cost of
  1543.      all outgoing calls to that node, the number of calls received
  1544.      from that node, the number of successful and failed sessions as
  1545.      well as the number of calls that failed because of BUSY, NO
  1546.      CONNECTION or VOICE modem result strings. This keyword defaults
  1547.      to NOACCOUNTING.  
  1548.  
  1549.  
  1550.      Configuration Commands                               Keywords
  1551.  
  1552.  
  1553.      Page 26              TrapDoor's Fifth Manual              Page 26
  1554.  
  1555.  
  1556.      Example: Accounting 
  1557.  
  1558.   4.3.5. ACCTMAX limits     
  1559.  
  1560.        When accounting is enabled, TrapDoor, when instructed to call
  1561.      a certain node, will check whether or not this node exceeds the
  1562.      accounting limits set by this keyword.  
  1563.  
  1564.        The limits parameter, a single string enclosed in quotes, sets 
  1565.  
  1566.        - the maximum costs, 
  1567.        - the number of calls out, 
  1568.        - number of failed sessions (where a connection could be
  1569.          established, but the carrier was lost before the successful
  1570.          end of the session), 
  1571.        - number of "busy" results, 
  1572.        - number of "no connection/no carrier/no dialtone" results, 
  1573.        - number of "voice" results, 
  1574.  
  1575.      in that order. To disable a certain limit, just set it to minus
  1576.      one. This keyword defaults to ACCTMAX "-1 -1 -1 -1 -1 -1".  
  1577.  
  1578.      Example: AcctMax "100 50 10 -1 -1 0" 
  1579.  
  1580.      sets the limits for further outgoing calls to 
  1581.  
  1582.        - Total cost thus far <= 100.  
  1583.        - Number of calls made <= 50.  
  1584.        - Number of failed sessions <= 10.  
  1585.        - Number of BUSY, NO CONNECTION doesn't matter.  
  1586.        - Number of VOICE <= 0 (i.e. don't call when there was VOICE
  1587.          only once).  
  1588.  
  1589.   4.3.6. ADJUST factor     
  1590.  
  1591.        NOTE: the following explanation is only valid for AmigaOS up
  1592.      to 1.3. The serial device has been dramatically improved in
  1593.      AmigaOS 2.04. If you have AmigaOS 2.04 or higher, set ADJUST to
  1594.      zero or leave it out completely. The value defaults to AJUST 0.  
  1595.  
  1596.        Unfortunately, the Amiga serial.device software has a small
  1597.      problem with baudrates: not only will it calculate the value to
  1598.      stuff into the baudrate register of the serial hardware
  1599.      incorrectly and therefore use baudrates that are a bit offset
  1600.      from the correct value, but also this behaviour is different on
  1601.      NTSC and PAL machines, which makes it even worse.  
  1602.  
  1603.        Some modems will work fine with such slightly wrong baudrates,
  1604.      others will not tolerate this and give a lot of transmission
  1605.      errors. By the way, this - it seems - is the main reason why
  1606.      programs such as BinkleyTerm Amiga fail to work with high-speed
  1607.      modems.  
  1608.  
  1609.        TrapDoor offers you a cure for such problems: ADJUST allows
  1610.  
  1611.  
  1612.      Configuration Commands                               Keywords
  1613.  
  1614.  
  1615.      Page 27              TrapDoor's Fifth Manual              Page 27
  1616.  
  1617.  
  1618.      you to specify how much TrapDoor will vary any given baudrate
  1619.      before it passes it on to the serial.device. This value should
  1620.      be given in thousands (1/1000).  An example: at a value of -11,
  1621.      a baudrate of 2400 will be adjusted to 2400-1.1% = 2400-26.4 =
  1622.      2373.6 baud. This value will be rounded to an integer and passed
  1623.      to the serial.device, which will then miscalculate the values
  1624.      for the hardware registers and set the hardware to almost
  1625.      exactly 2400 baud.  
  1626.  
  1627.        Normally, you should leave this parameter at the default
  1628.      value. If you are using AmigaOS 1.3 or lower, and you seem to
  1629.      have serial problems, try setting it to -11, or maybe even
  1630.      something else. Experiment! 
  1631.  
  1632.      Example: Adjust -11 
  1633.  
  1634.   4.3.7. AFTERSESSION command-string     
  1635.  
  1636.        As soon as TrapDoor finishes a FidoNet session with another
  1637.      mailer, and hangs up the modem, it will call the command you
  1638.      specify here. There may be embedded %-commands, which will be
  1639.      substituted by the parameters of the session that just ended; a
  1640.      list of them can be found in the chapter "Embedded
  1641.      Percent-Commands". To turn off the AFTERSESSION command, use
  1642.      AFTERSESSION "" or omit the statement completely. The default is
  1643.      to have no AFTERSESSION command.  
  1644.  
  1645.      Examples: AfterSession "run Execute Script:CheckInbound" 
  1646.                AfterSession "" 
  1647.  
  1648.   4.3.8. AKA akalist     
  1649.  
  1650.        During the EMSI handshake, not only your main address, but
  1651.      also a list of other "also-known-as" addresses will be sent to
  1652.      the other system. Using the AKA keyword, you can specify all
  1653.      your AKA addresses. <akalist> should be a single string, listing
  1654.      all your other addresses.  
  1655.  
  1656.        There is a limit of 20 AKAs for your system. The default is to
  1657.      have no AKAs.  
  1658.  
  1659.      Example: Aka "2:3160/0 2:31/0 27:47/11" 
  1660.  
  1661.   4.3.9. (NO)ALLOWREFUSING     
  1662.  
  1663.        Enables (disables) AllowRefusing mode. Default is
  1664.      ALLOWREFUSING.  
  1665.  
  1666.        When AllowRefusing is enabled, TrapDoor respects the other
  1667.      end's wishes in the EMSI handshake. When the other end states it
  1668.      does not want to receive any compressed mail, for example,
  1669.      TrapDoor won't send it. With NoAllowRefusing, TrapDoor will
  1670.      always send what has to be sent. This keyword defaults to
  1671.      ALLOWREFUSING.  
  1672.  
  1673.  
  1674.      Configuration Commands                               Keywords
  1675.  
  1676.  
  1677.      Page 28              TrapDoor's Fifth Manual              Page 28
  1678.  
  1679.  
  1680.      Examples: AllowRefusing 
  1681.                NoAllowRefusing 
  1682.  
  1683.   4.3.10. ANSWER     
  1684.  
  1685.        Forces TrapDoor to operate in "answer mode". TD will then wait
  1686.      for a call, answer the phone and try to start a session with the
  1687.      remote system.  While in answer mode, TrapDoor will accept
  1688.      commands via its ARexx interface.  
  1689.  
  1690.      Example: Answer 
  1691.  
  1692.   4.3.11. ARQSTRING string     
  1693.  
  1694.        Tells TrapDoor what string the modem returns when it connects
  1695.      to another modem under an error-control protocol. HST modems,
  1696.      for example, return the string "ARQ" as in "CONNECT
  1697.      9600/ARQ/HST/HST".  
  1698.  
  1699.        You must setup the correct ARQSTRING for your modem when you
  1700.      use FLOATLOCK and/or SNIFFARQ.  
  1701.  
  1702.      Example: ArqString "ARQ" 
  1703.  
  1704.   4.3.12. (NO)AUTOADJUST     
  1705.  
  1706.        When AutoAdjust is set, TrapDoor will try to move or resize
  1707.      its status and/or log window to make them fit on screen, should
  1708.      their position and/or size be inadequate for the screen on which
  1709.      TrapDoor opens.  This works only under KS 2.04 and higher.  The
  1710.      default is NOAUTOADJUST.  
  1711.  
  1712.      Examples: AutoAdjust 
  1713.                NoAutoAdjust 
  1714.  
  1715.   4.3.13. (NO)AUTOOVERSCAN     
  1716.  
  1717.        When using the SCREENMODE CUSTOM, SCREENMODE TRAPDOOR or
  1718.      SCREENMODE PUBLIC option, switching this on forces TrapDoor to
  1719.      open its screen not to the standard NTSC or PAL size, but to the
  1720.      maximum size of the Workbench screen. If you use a program like
  1721.      "MoreRows" to expand your Workbench screen (under Kickstart
  1722.      1.2/1.3) or use extended Overscan settings under AmigaOS 2.04
  1723.      (or higher), and you would like TrapDoor to use the same
  1724.      expanded screen size, use this parameter. This keyword defaults
  1725.      to NOAUTOOVERSCAN.  
  1726.  
  1727.      Examples: AutoOverScan 
  1728.                NoAutoOverScan 
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.      Configuration Commands                               Keywords
  1737.  
  1738.  
  1739.      Page 29              TrapDoor's Fifth Manual              Page 29
  1740.  
  1741.  
  1742.   4.3.14. (NO)BACKGROUND     
  1743.  
  1744.        When BACKGROUND is turned on, TrapDoor will open its screen
  1745.      behind all other screens. Also, when the log and status window
  1746.      are opened, they will not be activated, so your currently
  1747.      activated window will stay activated. The default is
  1748.      NOBACKGROUND.  
  1749.  
  1750.      Examples: NoBackGround 
  1751.                BackGround 
  1752.  
  1753.   4.3.15. BANNER bannerline     
  1754.  
  1755.        This line will be sent to the other side when TrapDoor answers
  1756.      a call.  This typically identifies your system, says "hi", or
  1757.      tells human callers to hang up.  
  1758.  
  1759.        Instead of a single line, TrapDoor can also send a text file.
  1760.      In that case, use "<filename" as your BANNER (where filename
  1761.      should indicate your banner file). Note that your banner file
  1762.      should not be too long. A few lines will suffice. TrapDoor will
  1763.      automatically convert LFs to CRLFs when sending the file.  
  1764.  
  1765.      Examples: Banner "TrapDoor Development, online 00:00-06:00" 
  1766.                Banner "<mail:banner.txt" 
  1767.  
  1768.   4.3.16. BAUD baudrate     
  1769.  
  1770.        This is the baudrate to initially talk to the modem -- after
  1771.      power-on or a reset. This speed may change during a session,
  1772.      when you did not lock the baud rate (see LOCK) and a different
  1773.      speed is reported by the modem.  
  1774.  
  1775.      Example: Baud 2400 
  1776.  
  1777.   4.3.17. BBSCHAR character     
  1778.  
  1779.        This option was included to allow for other "drop-to-the-BBS"
  1780.      keys, especially useful for users on machines that do not have
  1781.      an ESC key (some Macintosh models, C64). The ascii value you
  1782.      indicate here will be recognized and treated as if it were ESC,
  1783.      in addition to the ESC key.  
  1784.  
  1785.        There are three ways to specify the character: 
  1786.  
  1787.        - decimal ASCII code: just specify the decimal digits of the
  1788.          ASCII code 
  1789.        - hexadecimal ASCII code: use a dollar sign ("$") followed by
  1790.          the hexadecimal ASCII code 
  1791.        - the ASCII character itself: either prepend it with a single
  1792.          quote ("'"), or use just the character if it does not
  1793.          conflict with the other options (such as the dollar sign).  
  1794.  
  1795.        The default is BBSCHAR '!'.  
  1796.  
  1797.  
  1798.      Configuration Commands                               Keywords
  1799.  
  1800.  
  1801.      Page 30              TrapDoor's Fifth Manual              Page 30
  1802.  
  1803.  
  1804.      Examples: BBSChar 35 
  1805.                BBSChar $21 
  1806.                BBSChar ! 
  1807.                BBSChar '!' 
  1808.  
  1809.   4.3.18. BBSCOMMAND command-string     
  1810.  
  1811.        This is used to set the command line that TrapDoor will
  1812.      execute to start a BBS. There may be embedded %-commands, which
  1813.      are described in the chapter "Embedded Percent-Commands".  
  1814.  
  1815.        When a human caller presses ESC, the %-commands will be
  1816.      replaced with the corresponding value and then the resulting
  1817.      string will be executed.  
  1818.  
  1819.        BBSCOMMAND will only be used if the BBSMODE is set to SPAWN or
  1820.      EXIT.  
  1821.  
  1822.      Examples: BBSCommand "immed TR0 %b %B" 
  1823.                BBSCommand "uucico -r0" 
  1824.  
  1825.   4.3.19. BBSINOUT device     
  1826.  
  1827.        This can be used to set stdin and stdout for the BBSCOMMAND to
  1828.      something else than those of the initial CLI from which TrapDoor
  1829.      was started. Just set it to any valid AmigaDOS device, like AUX: 
  1830.  
  1831.        To switch off this feature, use BBSINOUT "". The default is to
  1832.      not use BBSINOUT.  
  1833.  
  1834.      Example: BBSInOut AUX: 
  1835.  
  1836.   4.3.20. BBSMESSAGE text     
  1837.  
  1838.        With this keyword, you can override the standard messages that
  1839.      TrapDoor sends out just after the banner has been sent to a
  1840.      human caller. As you can see in the description of BBSMODE,
  1841.      TrapDoor will usually send a different message depending on the
  1842.      BBSMODE. You can override this message with the BBSMESSAGE
  1843.      command.  
  1844.  
  1845.        A text you set up with BBSMESSAGE will be in effect until
  1846.      another BBSMESSAGE command is sent to TrapDoor. Your BBSMESSAGE
  1847.      text will even stay active if you change BBSMODE. So don't
  1848.      forget to set up the right BBSMESSAGE in your (ARexx) scripts
  1849.      when you switch BBSMODE! 
  1850.  
  1851.        To re-establish the original behaviour (i.e. TrapDoor will
  1852.      automatically select a suitable text depending on the BBSMODE),
  1853.      use BBSMESSAGE "". This is also the default.  
  1854.  
  1855.      Examples: BBSMessage "Bitte druecken Sie zweimal Escape." 
  1856.                BBSMessage "This system is closed until 5:30." 
  1857.                BBSMessage "" 
  1858.  
  1859.  
  1860.      Configuration Commands                               Keywords
  1861.  
  1862.  
  1863.      Page 31              TrapDoor's Fifth Manual              Page 31
  1864.  
  1865.  
  1866.   4.3.21. BBSMODE mode     
  1867.  
  1868.        There are four modes available for connecting a BBS to
  1869.      TrapDoor. The default is BBSMODE NONE.  
  1870.  
  1871.           NONE ... There is no BBS, TrapDoor will display
  1872.                    "Mail only system -- please hang up" to
  1873.                    human callers.
  1874.  
  1875.           SPAWN .. TrapDoor will use the BBSCOMMAND setting
  1876.                    to start the BBS when a human caller
  1877.                    enters an ESC character. When the command
  1878.                    returns, TrapDoor will reinitialize the
  1879.                    modem and continue to wait for a call.
  1880.  
  1881.           EXIT ... TrapDoor will start the BBSCOMMAND just
  1882.                    as with SPAWN, but as soon as the command
  1883.                    returns, TrapDoor will exit.
  1884.  
  1885.           ZMH .... There is a BBS, but at the moment, human
  1886.                    access to the BBS is closed due to
  1887.                    "Zone Mail Hour". TrapDoor will display
  1888.                    "Mail only period -- please call later"
  1889.                    to human callers.
  1890.  
  1891.      Examples: BBSMode Spawn 
  1892.                BBSMode None 
  1893.                BBSMode ZMH 
  1894.  
  1895.   4.3.22. (NO)BEEPDISPLAY     
  1896.  
  1897.        When BEEPDISPLAY is enabled (the default), TrapDoor will flash
  1898.      the screen when the modem sends a CONNECT message. You can
  1899.      disable this with NOBEEPDISPLAY.  
  1900.  
  1901.      Example: NoBeepDisplay 
  1902.  
  1903.   4.3.23. BOSS zone:net/node.point     
  1904.  
  1905.        Specifies the FidoNet address of your boss, as in "2:310/3".
  1906.      Please be careful as not to leave out the zone and point
  1907.      information when your boss node is capable of four dimensional
  1908.      addressing.  
  1909.  
  1910.        Note: the setting of BOSS also specifies what mail will be
  1911.      sent to the other system when you call out using a telephone
  1912.      number. So, if you are calling 2:310/3 with "TrapDoor call
  1913.      0043-1-454330" to request a file, you have to set BOSS to
  1914.      2:310/3 for that call, too.  
  1915.  
  1916.        Just to be on the safe side: if you are running a node, set
  1917.      this to your own address.  
  1918.  
  1919.      Example: Boss 2:310/6 
  1920.  
  1921.  
  1922.      Configuration Commands                               Keywords
  1923.  
  1924.  
  1925.      Page 32              TrapDoor's Fifth Manual              Page 32
  1926.  
  1927.  
  1928.   4.3.24. CALL number | fido-address   
  1929.  
  1930.        Tells TrapDoor to call out. The number dialed can either be
  1931.      set in the configuration file with another CALL statement, or
  1932.      given directly in the command line: when the string following
  1933.      the CALL keyword is not BOSS, it will be interpreted as the
  1934.      number to call. Otherwise, the number from the configuration
  1935.      file will be used.  
  1936.  
  1937.        If you have enabled nodelist support (see NODELIST), you can
  1938.      also specify a FidoNet node number instead of the telephone
  1939.      number. Please note that you always have to prepend a zone
  1940.      number to the node number, as TrapDoor will use the
  1941.      zone-separating colon (":") to distinguish node numbers from
  1942.      phone numbers. When TrapDoor detects that you have given it a
  1943.      node number, it will consult the nodelist to find out the
  1944.      telephone number, the password and the baudrate (unless LOCKed)
  1945.      for that node and use these settings.  
  1946.  
  1947.        Here are a few examples: 
  1948.  
  1949.        To call your boss using the telephone number and node number
  1950.      you have specified in the configuration file, use: 
  1951.  
  1952.           TrapDoor Call Boss 
  1953.  
  1954.        Note that you should have the statements 
  1955.  
  1956.           Call 603-8532 Boss 2:310/6 
  1957.  
  1958.      somewhere in your config file.  
  1959.  
  1960.        To call another system that is not your boss, don't forget to
  1961.      change the BOSS keyword as well as other settings such as
  1962.      password, baud rate, etc.: 
  1963.  
  1964.           TrapDoor Call 454330 Boss 2:310/3 Password "" 
  1965.  
  1966.        If you want to call a certain FidoNet node via the nodelist,
  1967.      just use 
  1968.  
  1969.           TrapDoor Call 2:310/3 
  1970.  
  1971.      and TrapDoor will figure out the password and other important
  1972.      configuration data for that node from the nodelist. Note that
  1973.      you have to have nodelist support enabled for this function to
  1974.      work (see NODELIST).  
  1975.  
  1976.      Examples: Call Boss 
  1977.                Call 0043-1-556-7854 
  1978.                Call 2:310/6 
  1979.  
  1980.        (@) asynchronous execution possible (@CALL) 
  1981.  
  1982.  
  1983.  
  1984.      Configuration Commands                               Keywords
  1985.  
  1986.  
  1987.      Page 33              TrapDoor's Fifth Manual              Page 33
  1988.  
  1989.  
  1990.        @CALL can be used to trigger a call if this TrapDoor is not
  1991.      currently busy with another session. You can send TrapDoor the
  1992.      asynchronous @CALL command, and it will report either OUTGOING
  1993.      or INCOMING if it is already making or taking a call, CLOSED if
  1994.      it has closed its serial device due to another program using it,
  1995.      SPAWNING if TrapDoor is waiting for an external program to
  1996.      return, or it will return the string CALLING if your @CALL
  1997.      statement is executing. So basically, @CALL is a combination of
  1998.      @STATUS S and a CALL command, but the operation is atomic. This
  1999.      is necessary for external schedulers.  
  2000.  
  2001.      Example: @Call 2:253/400 
  2002.  
  2003.   4.3.25. COLORS palette-specification     
  2004.   4.3.26. COLOURS palette-specification     
  2005.  
  2006.        When you use SCREENMODE CUSTOM, SCREENMODE TRAPDOOR or
  2007.      SCREENMODE PUBLIC (see SCREENMODE), you can change the colours
  2008.      with this option. The palette specifier looks rather like a
  2009.      window specification, starting with colour 0 (the background
  2010.      colour) and continuing to colour 3. The value for each colour is
  2011.      given in decimal, using the formula 
  2012.  
  2013.          colour = red * 256 + green * 16 + blue 
  2014.  
  2015.      where red, green and blue specify the intensity of each colour
  2016.      (0 is none, 15 is highest intensity). As an alternative, each
  2017.      value can also be given in hexadecimal notation, if prepended
  2018.      with a dollar sign ("$").  
  2019.  
  2020.        If you don't specify the colours yourself (i.e. if you omit
  2021.      the COLOURS statement), TrapDoor will use the colours of the
  2022.      Workbench screen.  
  2023.  
  2024.      Examples: Colours 2730/0/2560/10 
  2025.                Colors $aaa/$000/$a00/$00a 
  2026.  
  2027.   4.3.27. CONCEPTS     
  2028.  
  2029.        Display some ideas about the concepts of ShareWare. Also tells
  2030.      you how to register your copy of TrapDoor (and why to register).
  2031.      Read this! 
  2032.  
  2033.      Example: Concepts 
  2034.  
  2035.   4.3.28. CONFIG config-file     
  2036.  
  2037.        This is for people with a command-linophobia. It allows you to
  2038.      put yet another config file in your favorite config directory in
  2039.      addition to the standard "TrapDoor.cfg" that TrapDoor looks for.
  2040.      The format of such a file is just the same as that of the
  2041.      command line -- only that linefeeds will be ignored. Also, you
  2042.      may have comments embedded in the config file.  Just preceed
  2043.      them with a semicolon (";"), and TrapDoor will ignore the rest
  2044.  
  2045.  
  2046.      Configuration Commands                               Keywords
  2047.  
  2048.  
  2049.      Page 34              TrapDoor's Fifth Manual              Page 34
  2050.  
  2051.  
  2052.      of the line starting at the semicolon.  
  2053.  
  2054.        Please note that even if you specify a different config file
  2055.      with the CONFIG keyword on the commandline, TrapDoor will always
  2056.      read TrapDoor.cfg (in the current directory) or
  2057.      Mail:TrapDoor.cfg first, and then continue to process whatever
  2058.      was specified on the command line.  
  2059.  
  2060.        Also note that several config files chaining one to the other
  2061.      are quite possible -- but you may have to increase your stack
  2062.      size when you have a try at this. Also note that a recursive
  2063.      config file (i.e. calling itself) is a rather bad idea since you
  2064.      may not have set your stack size to plus infinity.  
  2065.  
  2066.      Example: Config Mail:TrapDoor.cfg 
  2067.  
  2068.   4.3.29. COST cost-value     
  2069.  
  2070.        This allows you to specify a default cost for calls. This cost
  2071.      will be in effect if you do not use a nodelist. This cost factor
  2072.      should be in units/min.  
  2073.  
  2074.        You can also use COST to allow calls to undialable nodes. Use
  2075.      a special config to set up the CALL and COST parameters, and
  2076.      your TrapDoor will be able to call that node. This is also
  2077.      explained in the chapter "Custom Configuration Entries".  
  2078.  
  2079.      Example: Cost 400 
  2080.  
  2081.   4.3.30. CREDITS     
  2082.  
  2083.        Displays some "About" information. Read this first -- it will
  2084.      tell you a bit about this program and its authors.  
  2085.  
  2086.      Example: Credits 
  2087.  
  2088.   4.3.31. DIALER command-string     
  2089.  
  2090.        Use this if you have a custom dial-out program that will
  2091.      perform special PCP-dialing, for example. If a string other than
  2092.      "" has been specified and TrapDoor is about to call out, instead
  2093.      of sending a dial command to the modem, TrapDoor will call the
  2094.      external command. When the external program returns, TrapDoor
  2095.      will immediately start the session handshake, just as if the
  2096.      IMMEDIATE option had been used.  
  2097.  
  2098.        To turn off the special DIALER feature and use the built-in
  2099.      modem handling, use DIALER "" or omit the statement completely.
  2100.      There may be embedded %-commands, these are described in the
  2101.      chapter "Embedded Percent-Commands".  
  2102.  
  2103.      Examples: Dialer "callpcp" 
  2104.                Dialer "" 
  2105.  
  2106.  
  2107.  
  2108.      Configuration Commands                               Keywords
  2109.  
  2110.  
  2111.      Page 35              TrapDoor's Fifth Manual              Page 35
  2112.  
  2113.  
  2114.   4.3.32. DIALTIMEOUT seconds     
  2115.  
  2116.        Specifies the time in seconds how long TrapDoor will wait for
  2117.      a CONNECT, BUSY, NO CARRIER, VOICE or ERROR response from the
  2118.      modem after sending a dial command. If the given timeout
  2119.      expires, TrapDoor will give up waiting and re-initialize the
  2120.      modem.  
  2121.  
  2122.        The default is 120 seconds.  
  2123.  
  2124.      Example:  DialTimeOut 120 
  2125.  
  2126.   4.3.33. (NO)DIETIFNA     
  2127.  
  2128.        Enable (disable) DietIfna mode. Choose this, when you only
  2129.      transfer small files or when the line quality is rather poor
  2130.      since it might then be faster than ZModem. The default is
  2131.      DIETIFNA.  
  2132.  
  2133.      Examples: NoDietIfna 
  2134.                DietIfna 
  2135.  
  2136.   4.3.34. (NO)DIRECTZAP     
  2137.  
  2138.        Enable (disable) DirectZap mode. DirectZap is a slight variant
  2139.      of the ZedZap transfer protocol, which is a slight variant of
  2140.      Zmodem -- on large files, this is the fastest protocol TrapDoor
  2141.      has to offer. Like ZedZap, DirectZap will automatically switch
  2142.      block sizes depending on modem speed and quality of the line. It
  2143.      will also resume an interrupted transfer if possible.  
  2144.  
  2145.        DirectZap only works in EMSI mode and only if the other side
  2146.      also supports it. Also, DirectZap only works on 8-bit
  2147.      transparent lines. You should disable it (use NODIRECTZAP) if
  2148.      you are working over a non-transparent line like a
  2149.      packet-switching network, for example. The keyword defaults to
  2150.      DIRECTZAP.  
  2151.  
  2152.      Examples: NoDirectZap 
  2153.                DirectZap 
  2154.  
  2155.   4.3.35. DISPLAYID integer     
  2156.  
  2157.        Specify the mode in which TrapDoor should open its screen.
  2158.      This works only under Kickstart 2.04 and above. The number after
  2159.      the DISPLAYID keyword may be a decimal or hex number (hex
  2160.      numbers are to be preceeded with a '$' sign), and should be one
  2161.      of the mode ids from <graphics/modeid.h>. Below are a few useful
  2162.      mode ids.  
  2163.  
  2164.        Note that if you use DISPLAYID, the keywords INTERLACE and
  2165.      AUTOOVERSCAN have no effect. If you do not specify DISPLAYID,
  2166.      TrapDoor will use a Hires screen, either interlace or not
  2167.      depending on the (NO)INTERLACE keyword.  
  2168.  
  2169.  
  2170.      Configuration Commands                               Keywords
  2171.  
  2172.  
  2173.      Page 36              TrapDoor's Fifth Manual              Page 36
  2174.  
  2175.  
  2176.      Examples: DisplayID $19000   ; NTSC Hires 
  2177.                DisplayID $29000   ; PAL Hires 
  2178.                DisplayID $19020   ; NTSC Superhires 
  2179.                DisplayID $29020   ; PAL Superhires 
  2180.                DisplayID $19004   ; NTSC Hires Interlace 
  2181.                DisplayID $29004   ; PAL Hires Interlace 
  2182.                DisplayID $19024   ; NTSC Superhires Interlace 
  2183.                DisplayID $29024   ; PAL Superhires Interlace 
  2184.                DisplayID $39024   ; VGA Productivity 
  2185.                DisplayID $39025   ; VGA Productivity Lace 
  2186.                DisplayID $39020   ; VGA Productivity Dbl (AA) 
  2187.                DisplayID $69024   ; Euro72 Productivity 
  2188.                DisplayID $69025   ; Euro72 Productivity Lace 
  2189.                DisplayID $99000   ; DblNtsc Hires (AA) 
  2190.                DisplayID $99005   ; DblNtsc Hires Lace (AA) 
  2191.                DisplayID $a9000   ; DblPal Hires (AA) 
  2192.                DisplayID $a9005   ; DblPal Hires Lace (AA) 
  2193.                DisplayID $41000   ; A2024 10 Hz 
  2194.                DisplayID $49000   ; A2024 15 Hz 
  2195.  
  2196.   4.3.36. DROPBBSSECS seconds     
  2197.  
  2198.        When TrapDoor cannot detect a Fidonet handshake after
  2199.      DROPBBSSECS seconds, it will assume the caller is a human and
  2200.      pass the call to the BBS just as if the human had pressed Escape
  2201.      twice. You may not set DROPBBSSECS to anything lower than 10
  2202.      seconds. The value defaults to 20 seconds.  
  2203.  
  2204.      Example: DropBBSSecs 45 
  2205.  
  2206.   4.3.37. (NO)DSR     
  2207.  
  2208.        After TrapDoor opens the serial.device, it will wait a short
  2209.      while (depending on SLOWMODEM) and then sample the DSR line.
  2210.      This line should be activated when a valid data set (i.e. a
  2211.      functioning modem) is connected to the serial line. If TrapDoor
  2212.      doesn't find DSR activated, it will report "modem not ready" and
  2213.      abort. This is the default.  
  2214.  
  2215.        There are a few modems that cannot properly handle DSR. For
  2216.      these modems, use the NODSR setting. Note that when using NODSR,
  2217.      TrapDoor can't tell whether the modem is powered-on, on-line and
  2218.      ready.  
  2219.  
  2220.        Also note that if you have not connected DSR to the modem (if
  2221.      you have a wrong/bad cable), RTS/CTS handshake might not work
  2222.      correctly. This is due to the way the Amiga serial.device
  2223.      handles things.  
  2224.  
  2225.      Examples: NoDsr 
  2226.                Dsr 
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.      Configuration Commands                               Keywords
  2233.  
  2234.  
  2235.      Page 37              TrapDoor's Fifth Manual              Page 37
  2236.  
  2237.  
  2238.   4.3.38. (NO)EMSI     
  2239.  
  2240.        Turns the EMSI handshake on or off. The default is on.  
  2241.  
  2242.        Note that the EMSI handshake is the newest of all Fidonet
  2243.      protocols. Although EMSI is designed to be backwards compatible
  2244.      to older mailers, some fail when presented an EMSI handshake
  2245.      packet. If you experience any session handshake failures with
  2246.      other mailers, try again with EMSI disabled (use the NOEMSI
  2247.      switch).  
  2248.  
  2249.        If you regularly call a node that cannot handle EMSI, you can
  2250.      set up a custom configuration string for that node. See the
  2251.      chapter "Custom Configuration Entries".  
  2252.  
  2253.      Examples: NoEmsi 
  2254.                Emsi 
  2255.  
  2256.   4.3.39. (NO)ESCAPERESETSMODEM     
  2257.  
  2258.        When you press the Escape key during a session, TrapDoor will
  2259.      immediately stop the transfer and hang up the phone. With
  2260.      ESCAPERESETSMODEM set, it will also send the MODEMINIT command
  2261.      afterwards. With NOESCAPERESETSMODEM (the default), TrapDoor
  2262.      will only hang up and wait for further instruction; you will
  2263.      have to press Escape a second time to re-initialize the modem.  
  2264.  
  2265.      Example: NoEscapeResetsModem 
  2266.  
  2267.   4.3.40. (NO)FASTEMSI     
  2268.  
  2269.        Per default, FASTEMSI is enabled and this is what TrapDoor has
  2270.      been doing all the time since it could do EMSI: immediately
  2271.      after the connect, it will try to detect whether the other
  2272.      system can do EMSI, and if the other end indicates this, it will
  2273.      immediately start the handshake.  
  2274.  
  2275.        This "fast" variant of EMSI can however, under very rare
  2276.      circumstances, give problems. One of the things that might lead
  2277.      to problems are asterisks ('*') in banner texts. If you call a
  2278.      system and repeatedly experience EMSI handshake failures, try
  2279.      turning off "fast" emsi with the NOFASTEMSI switch.  
  2280.  
  2281.        When fast EMSI is turned off, EMSI handshakes will be a little
  2282.      bit slower (about 1-2 secs).  
  2283.  
  2284.      Examples: FastEmsi 
  2285.                NoFastEmsi 
  2286.  
  2287.   4.3.41. FAXCOMMAND commandline     
  2288.  
  2289.        When TrapDoor detects a fax connect (it looks for FAXSTRING in
  2290.      messages from the modem), it will spawn this external program.
  2291.      Using this technique you can run your fax software to accept
  2292.  
  2293.  
  2294.      Configuration Commands                               Keywords
  2295.  
  2296.  
  2297.      Page 38              TrapDoor's Fifth Manual              Page 38
  2298.  
  2299.  
  2300.      incoming fax calls, while at the same time allowing ordinary
  2301.      modem callers to go to the bulletin board or to run a FidoNet
  2302.      session with your system. There may be embedded %-commands in
  2303.      the string, these are described in the chapter "Embedded
  2304.      Percent-Commands".  
  2305.  
  2306.        This will also work on outgoing calls. You can use the
  2307.      embedded percent command "d" to tell your fax software if this
  2308.      is an outgoing or incoming call.  
  2309.  
  2310.      Example: FaxCommand "Fax %d" 
  2311.  
  2312.   4.3.42. FAXSTRING string     
  2313.  
  2314.        Tells TrapDoor what string the modem returns when it connects
  2315.      to a fax machine or another fax modem using the fax protocol.
  2316.      Some fax modems, for example, return the string "FAX" as in
  2317.      "CONNECT FAX"; others return "+FCON". You must setup the correct
  2318.      FAXSTRING for your modem when you use the FAXCOMMAND keyword.  
  2319.  
  2320.      Examples: FaxString "FAX" 
  2321.                FaxString "+FCON" 
  2322.  
  2323.   4.3.43. FKEY function-key-assignment     
  2324.  
  2325.        Assign a configuration command string to a function key. The
  2326.      keyword must be followed by a single string, starting with the
  2327.      number of the function key (F1=1, F2=2,...; Shift-F1=11,
  2328.      Shift-F2=12,...), followed by a colon (":"), followed by the
  2329.      assignment.  
  2330.  
  2331.        If you wish to include spaces in the assignment, the argument
  2332.      must be enclosed in double-quotes; to include quotes within the
  2333.      quoted string, use the backslash ("\") as an escape character.  
  2334.  
  2335.      Examples: FKey "1:Emsi" 
  2336.                FKey "11:NoEmsi" 
  2337.                FKey "5:Call Boss" 
  2338.                FKey "6:Run CE" 
  2339.                FKey "7:Run \"Execute Scripts:Import\"" 
  2340.                FKey "8:Run \"TrapPoll +r\"" 
  2341.  
  2342.   4.3.44. (NO)FLOATLOCK     
  2343.  
  2344.        HST modems support a mode (&B2) in which they will drop the
  2345.      DTE baud rate (the baud rate used between modem and computer)
  2346.      when a connection is made without error-correction, but will
  2347.      keep the DTE baud rate locked on a connection with
  2348.      error-correction. FLOATLOCK allows you to use this mode.  
  2349.  
  2350.        If you have FLOATLOCK enabled, whenever TrapDoor reads a
  2351.      CONNECT xxx string from the modem, it will try to find the
  2352.      ARQSTRING string in the CONNECT result. If it finds it, it will
  2353.      keep the baudrate locked, otherwise it will switch to the
  2354.  
  2355.  
  2356.      Configuration Commands                               Keywords
  2357.  
  2358.  
  2359.      Page 39              TrapDoor's Fifth Manual              Page 39
  2360.  
  2361.  
  2362.      baudrate found in the CONNECT string. You have to have LOCK
  2363.      enabled when you wish to use FLOATLOCK.  
  2364.  
  2365.        To turn off FLOATLOCK mode, use NOFLOATLOCK or omit the
  2366.      statement completely; it defaults to NOFLOATLOCK.  
  2367.  
  2368.        NOTE: we do not recommend using FLOATLOCK. Instead, set your
  2369.      HST to &B1 and S15=8. This can provide slightly higher troughput
  2370.      on non-ARQ connections than using &B2 and FLOATLOCK.  
  2371.  
  2372.      Examples: FloatLock 
  2373.                NoFloatLock 
  2374.  
  2375.   4.3.45. (NO)FORBID...     
  2376.  
  2377.        Select what type of mail/files you do _not_ want to be sent.
  2378.      In an EMSI handshake, TrapDoor will ask the remote system to not
  2379.      send these files (the other end may override this with the
  2380.      NOALLOWREFUSING switch): 
  2381.  
  2382.        - FORBIDXMAIL   Compressed mail and file attaches 
  2383.        - FORBIDFREQ    File requests 
  2384.        - FORBIDALL     All of the above 
  2385.  
  2386.        The default is to not forbid anything.  
  2387.  
  2388.      Examples: ForbidXMail 
  2389.                NoForbidFreq 
  2390.  
  2391.   4.3.46. FREQUEST command-string     
  2392.  
  2393.        Sets the command to be executed as a file-request server on
  2394.      received file requests from remote systems. There may be
  2395.      embedded %-commands, these are described in the chapter
  2396.      "Embedded Percent-Commands".  
  2397.  
  2398.        The called command should then read the remote's request from
  2399.      the %i file, perform any action that it wants to do, and write a
  2400.      list of files that it wishes to send to the other side
  2401.      (including directory path) to the %o file.  
  2402.  
  2403.        To turn off the file-request capability, use FREQUEST "". This
  2404.      is also the default.  
  2405.  
  2406.        Please note that the answering of file-requests is disabled in
  2407.      unregistered versions of TrapDoor. The external file-request
  2408.      server will not be called.  
  2409.  
  2410.      Examples: FRequest "rx frequest %i,%o,%l" 
  2411.                FRequest "" 
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.      Configuration Commands                               Keywords
  2419.  
  2420.  
  2421.      Page 40              TrapDoor's Fifth Manual              Page 40
  2422.  
  2423.  
  2424.   4.3.47. HELP     
  2425.  
  2426.        Output some descriptive text, explaining the usage and
  2427.      commandline syntax of TrapDoor.  
  2428.  
  2429.      Example: Help 
  2430.  
  2431.   4.3.48. (NO)IMMEDIATE     
  2432.  
  2433.        If you specify IMMEDIATE, TrapDoor will not care about modem
  2434.      commands, dialing, resetting the modem etc, but will go directly
  2435.      and immediately to the session handshake (EMSI, YooHoo or
  2436.      TSynch). So, if you have two Amigas connected via a serial
  2437.      cable, you can use TrapDoor to transfer files between them.  
  2438.  
  2439.        On the first machine, start TrapDoor with 
  2440.  
  2441.           TrapDoor ANSWER IMMEDIATE NODSR 
  2442.  
  2443.        TrapDoor will start up, open the serial device, ignore the DSR
  2444.      line (which has not been set high at that time because the other
  2445.      computer has not opened its serial device yet) and wait for
  2446.      approximately 30 seconds for a session handshake.  
  2447.  
  2448.        Now, on the other computer, run 
  2449.  
  2450.           TrapDoor CALL BOSS IMMEDIATE 
  2451.  
  2452.        TrapDoor will open its windows, and within a few seconds you
  2453.      should see the banner line of the other system appear in the
  2454.      status window. TrapDoor will then go on as usual with the
  2455.      session handshake and the actual file transfers.  
  2456.  
  2457.        IMMEDIATE has another use: if you send IMMEDIATE to a TrapDoor
  2458.      which is waiting in answer mode, it will react just as if it had
  2459.      just detected a RING from the modem. TrapDoor will send out the
  2460.      MODEMANSWER command and take an incoming call.  
  2461.  
  2462.        This keyword defaults to NOIMMEDIATE.  
  2463.  
  2464.      Example: Immediate 
  2465.  
  2466.   4.3.49. INBOUND inbound-mail-directory     
  2467.  
  2468.        This should point to the directory where incoming files will
  2469.      be put.  The default is "Mail:Inbound". Make sure that the
  2470.      TrapDoor inbound directory is the same as the one for your mail
  2471.      tosser, or your attempts to import mail will fail miserably.
  2472.      Additionally, TrapDoor uses this directory for temporary files
  2473.      during receiving and for files that store information about
  2474.      aborted/interrupted file transfers, so that receiving these
  2475.      files can be resumed in the next ZedZap session. For more
  2476.      information, see the chapter "Inbound Directory".  
  2477.  
  2478.  
  2479.  
  2480.      Configuration Commands                               Keywords
  2481.  
  2482.  
  2483.      Page 41              TrapDoor's Fifth Manual              Page 41
  2484.  
  2485.  
  2486.      Examples: Inbound "Mail:Inbound" 
  2487.  
  2488.   4.3.50. (NO)INTERLACE     
  2489.  
  2490.        Specify whether TrapDoor should open its screen in the
  2491.      interlace mode or not. It defaults to NOINTERLACE.  
  2492.  
  2493.      Examples: NoInterlace 
  2494.                Interlace 
  2495.  
  2496.   4.3.51. (NO)KEEPALL     
  2497.   4.3.52. (NO)KEEPXMAIL     
  2498.  
  2499.        These two keywords disallow (allow) the sending of files and
  2500.      mail to the other system on incoming calls. KEEPALL suppresses
  2501.      the sending of all kinds of mail and files, whereas KEEPXMAIL
  2502.      will allow the sending of mail packets (.PKT files), but no
  2503.      compressed mail or files will be sent.  
  2504.  
  2505.        Please note the difference between the FORBID.. and the KEEP..
  2506.      keywords. FORBID will ask the other system in the EMSI handshake
  2507.      not to send certain kinds of files, whereas KEEP will turn off
  2508.      the sending of these types of files on your own system, and only
  2509.      on incoming calls. Even with KEEP in effect, your system will
  2510.      deliver all mail and files on outgoing calls.  
  2511.  
  2512.        Per default, everything will be send and nothing kept. Both
  2513.      keywords default to NO.  
  2514.  
  2515.      Examples: KeepAll 
  2516.                NoKeepXMail 
  2517.  
  2518.   4.3.53. (NO)KIWIPULSE     
  2519.  
  2520.        Applies a special number translation to the dial string before
  2521.      sending it to the modem. Special feature for kiwi people with
  2522.      vanilla modems. Defaults to NOKIWIPULSE.  
  2523.  
  2524.      Examples: NoKiwiPulse 
  2525.                KiwiPulse 
  2526.  
  2527.   4.3.54. (NO)LISTEN     
  2528.  
  2529.        LISTEN is a synonym for NOUNLISTEN and NOLISTEN is a synonym
  2530.      for UNLISTEN.  Please see the description of the (NO)UNLISTEN
  2531.      command for a detailed explanation of these keywords.  
  2532.  
  2533.   4.3.55. (NO)LOCK     
  2534.  
  2535.        Lock (do not lock) the baudrate. If the baudrate is locked,
  2536.      and TrapDoor receives a "CONNECT XXXX" message from the modem,
  2537.      TrapDoor will not adjust the baud rate to XXXX, but continue to
  2538.      operate at the rate specified with the BAUD keyword. Use this
  2539.      for buffered modems that convert the baud rates internally (for
  2540.  
  2541.  
  2542.      Configuration Commands                               Keywords
  2543.  
  2544.  
  2545.      Page 42              TrapDoor's Fifth Manual              Page 42
  2546.  
  2547.  
  2548.      example, HST). Be sure to also configure the modem for a locked
  2549.      baudrate in that case (i.e. on HSTs, use &B1). This keyword
  2550.      defaults to NOLOCK.  
  2551.  
  2552.      Examples: NoLock 
  2553.                Lock 
  2554.  
  2555.   4.3.56. LOG level:text     
  2556.  
  2557.        Upon receipt of this ARexx command, TrapDoor will write the
  2558.      specified text with the specified log level to the log file.  
  2559.  
  2560.        (+) ARexx only command 
  2561.        (@) asynchronous execution possible 
  2562.            !!! not yet implemented !!! 
  2563.  
  2564.      Example: Log "3:Filerequest TRAPDOOR -> files:TD_1_50.LZH" 
  2565.  
  2566.   4.3.57. LOGCALLERID filename     
  2567.  
  2568.        When LOGCALLERID is in use, TrapDoor will log all strings that
  2569.      the modem sends between the first and the second RING into the
  2570.      given file. External software can then be used to parse the data
  2571.      in that file and act upon it. This allows BBS software to
  2572.      receive CallerID information, for example.  
  2573.  
  2574.        Since the CallerID data is sent between the first and second
  2575.      RING, you will need to set at least RINGS 2. To switch off
  2576.      CallerID logging, specify an empty string for the filename ("").
  2577.      This is also the default.  
  2578.  
  2579.      Examples: LogCallerID Mail:CallerID.log 
  2580.                LogCallerID "" 
  2581.  
  2582.   4.3.58. LOGFILE filename     
  2583.  
  2584.        Sets the name of the logfile. The default is
  2585.      "Mail:TrapDoor.Log".  
  2586.  
  2587.      Example: Logfile "Mail:TrapDoor.Log" 
  2588.  
  2589.   4.3.59. LOGLEVEL group:level     
  2590.  
  2591.        Sets the amount of logging information to be put into the
  2592.      logfile.  There are ten logging groups, each of which deals with
  2593.      a different part of messages (such as modem, outbound, session
  2594.      protection, file transfers, general messages, external messages
  2595.      etc.). Each group maintains its own loglevel, which ranges from
  2596.      0 to 7. A list of all log messages together with their groups
  2597.      and levels can be found in the file "LogMsgs.doc".  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.      Configuration Commands                               Keywords
  2605.  
  2606.  
  2607.      Page 43              TrapDoor's Fifth Manual              Page 43
  2608.  
  2609.  
  2610.        The groups: 
  2611.  
  2612.          0  Debugger    ?  debugging messages, internal errors 
  2613.          1  Link        -  line is too bad, baudrate too low 
  2614.          2  Transfer    |  receiving xyz.txt, cps rates 
  2615.          3  System      !  deleting file xyz.txt, user break, out of
  2616.                            mem 
  2617.          4  Modem       ~  NO CARRIER, BUSY, RING, VOICE 
  2618.          5  Session     =  Begin of session, picking up mail, session
  2619.                            aborted, giving mail to, session connect
  2620.                            time, cost 
  2621.          6  Security    *  bad password, unlisted system, node is
  2622.                            undialable 
  2623.          7  Outside     x  spawning dialer, executing aftersession,
  2624.                            spawning bbs 
  2625.          8  Information :  sysop, name, aka, place, flags, using,
  2626.                            trxid 
  2627.          9  Scheduler   +  waiting for call, incoming call detected,
  2628.                            calling node 
  2629.  
  2630.        The levels: 
  2631.  
  2632.          0  Silent         minimum logging 
  2633.          1  Terse          terse logging 
  2634.          2  Discreet       normal logging 
  2635.          3  Verbose        detailed logging 
  2636.          4  Talkative      extensive logging 
  2637.          5  Excessive      very much logging 
  2638.          6  Annoying       even more logging 
  2639.          7  Monologue      maximum logging 
  2640.  
  2641.        Two (Discreet) seems to be a rather nice logging level and is
  2642.      the default for all groups. You might want to turn on more
  2643.      detailed logging in the Security and Information groups.  
  2644.  
  2645.      Examples: Loglevel 5:3 
  2646.                Loglevel 4:4 
  2647.  
  2648.   4.3.60. LOGWINDOW window-specification     
  2649.  
  2650.        Use this keyword to change the position and size of the log
  2651.      window that TrapDoor opens. The window specification looks
  2652.      rather similar to a normal AmigaDOS CON:, RAW: or NEWCON:
  2653.      specification, but omit the device name and the window name. The
  2654.      correct format is: LeftEdge/TopEdge/Width/Height i.e. something
  2655.      like 0/20/640/150 
  2656.  
  2657.      Example: LogWindow 0/20/640/150 
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.      Configuration Commands                               Keywords
  2667.  
  2668.  
  2669.      Page 44              TrapDoor's Fifth Manual              Page 44
  2670.  
  2671.  
  2672.   4.3.61. (NO)MAXBAUD     
  2673.  
  2674.        If turned on, the MINBAUD parameter will automatically be set
  2675.      to the baudrate of the called system (found in the nodelist) or
  2676.      the own baudrate (set with BAUD) on outgoing calls, whichever is
  2677.      lower. The default is NOMAXBAUD.  
  2678.  
  2679.        What is this good for? Let us assume you have a 2400 baud
  2680.      modem, and you wish to call a node that is also capable of 2400
  2681.      baud. His nodelist entry also says he can do 2400 baud. Now, if
  2682.      you call him, sometimes, when line noise appears just when the
  2683.      modems negotiate the connect speed, this may cause a connection
  2684.      only at 1200 baud, or even worse, at 300 baud. If you have
  2685.      MAXBAUD enable, TrapDoor will immediately hang up in such a
  2686.      case.  
  2687.  
  2688.        On the other hand, if you are using an HST modem, and you are
  2689.      calling a system with a Trailblazer PEP modem, you might have
  2690.      problems when you use MAXBAUD: if the nodelist entry for the PEP
  2691.      modem specifies 9600 baud, TrapDoor will hang up if the connect
  2692.      speed is lower than 9600 baud. But: HST modems and PEP modems
  2693.      use a different high speed protocol and can only talk at 2400
  2694.      baud to each other. So, TrapDoor will hang up every time you
  2695.      call such a system.  
  2696.  
  2697.        You have to decide whether the usage of MAXBAUD is appropriate
  2698.      for you or not. You can also set up custom configuration entries
  2699.      to select specific MINBAUD values for selected nodes. See the
  2700.      chapter "Custom Configuration Entries" for more details.  
  2701.  
  2702.        Note: setconfig <node> NOMAXBAUD won't work. See the chapter
  2703.      "Bugs? Poof! They're all features!".  
  2704.  
  2705.      Examples: NoMaxBaud 
  2706.                MaxBaud 
  2707.  
  2708.   4.3.62. MAXLOGLINES number     
  2709.  
  2710.        This allows you to specify the number of log-lines that will
  2711.      be buffered, i.e. after so many lines have been written to the
  2712.      logfile, the file will be flushed (closed and reopened, in order
  2713.      to force all the data to disk).  
  2714.  
  2715.        If you set this to 0, the behaviour is as in TrapDoor 1.80 and
  2716.      earlier (and this is also the default): the logfile will be
  2717.      flushed after every single line.  
  2718.  
  2719.      Example: MaxLogLines 5 
  2720.  
  2721.   4.3.63. MAXLOGSECS seconds     
  2722.  
  2723.        This specifies the number of seconds that may expire before
  2724.      TrapDoor will flush the logfile. It will actually flush it when
  2725.      the next line is written to the logfile.  
  2726.  
  2727.  
  2728.      Configuration Commands                               Keywords
  2729.  
  2730.  
  2731.      Page 45              TrapDoor's Fifth Manual              Page 45
  2732.  
  2733.  
  2734.        If you set this to 0, the behaviour is as in TrapDoor 1.80 and
  2735.      earlier (and this is also the default): the logfile will be
  2736.      flushed after every single line.  
  2737.  
  2738.      Example: MaxLogSecs 7 
  2739.  
  2740.   4.3.64. MINBAUD baudrate     
  2741.  
  2742.        Minimal baudrate to establish a connection. Connections at
  2743.      baud rates below this limit will not be allowed, no matter if
  2744.      incoming or outgoing. TrapDoor will hang up immediately if the
  2745.      baud rate is lower than the value specified. Defaults to 300.  
  2746.  
  2747.      Example: MinBaud 1200 
  2748.  
  2749.   4.3.65. MODEMANSWER modem-answer-string     
  2750.  
  2751.        Modem answer string like "AT~A|". For special characters like
  2752.      "~", "^" and "|" that are allowed in the string, see chapter
  2753.      "Modem Commands". The total length of the string may not exceed
  2754.      100 characters.  
  2755.  
  2756.        This string is sent to the modem whenever TrapDoor detects a
  2757.      "RING" and wants to answer the phone. The default is MODEMANSWER
  2758.      "~~AT~A|~".  
  2759.  
  2760.      Example: ModemAnswer "ATA|" 
  2761.  
  2762.   4.3.66. MODEMDIALPRE modem-pre-dial-string     
  2763.  
  2764.        Modem dial string such as "AT~DP" or "AT~DT". For special
  2765.      characters like "~", "^" or "|" that are allowed in the string,
  2766.      see chapter "Modem Commands".  The total length of the string is
  2767.      limited to 100 characters.  
  2768.  
  2769.        This string is sent to the modem whenever TrapDoor wants to
  2770.      dial a number. After sending this string, TrapDoor will send the
  2771.      telephone number to dial, followed by the MODEMDIALPOST string.
  2772.      The default is MODEMDIALPRE "~~AT~DP".  
  2773.  
  2774.      Example: ModemDialPre "ATDP" 
  2775.  
  2776.   4.3.67. MODEMDIALPOST modem-post-dial-string     
  2777.  
  2778.        Final part of the modem dial string such as "|". For special
  2779.      characters like "~", "^" and "|" that are allowed in the string,
  2780.      see chapter "Modem Commands".  The total length of the string is
  2781.      limited to 20 characters.  
  2782.  
  2783.        This string is sent to the modem after the telephone number,
  2784.      when TrapDoor wants to dial a number. Also see the description
  2785.      of MODEMDIALPRE. The default is MODEMDIALPOST "|~".  
  2786.  
  2787.      Example: ModemDialPost "|" 
  2788.  
  2789.  
  2790.      Configuration Commands                               Keywords
  2791.  
  2792.  
  2793.      Page 46              TrapDoor's Fifth Manual              Page 46
  2794.  
  2795.  
  2796.   4.3.68. MODEMHANGUP modem-hangup-string     
  2797.  
  2798.        This string will be sent to the modem whenever TrapDoor wants
  2799.      to hang up the line. There are many methods to accomplish this,
  2800.      including the strange "~~~+++~~~ATH|" method. We do not
  2801.      recommend this. If you have configured your modem according to
  2802.      the descriptions in the chapter "The Modem", it should hang up
  2803.      as soon as DTR is lowered. So, the recommended hangup string is
  2804.      "|^|". This is also the default.  
  2805.  
  2806.        For special characters like "~", "^" and "|" that are allowed
  2807.      in the string, see chapter "Modem Commands". The total length of
  2808.      the string is limited to 40 characters.  
  2809.  
  2810.      Example: ModemHangup "|^|" 
  2811.  
  2812.   4.3.69. MODEMINIT modem-init-string     
  2813.  
  2814.        This string will be sent to the modem during the
  2815.      initialization phase of TrapDoor. Things like "AT~S7=20|" can be
  2816.      done here. For special characters like "~", "^" and "|" that are
  2817.      allowed in the string, see chapter "Modem Commands". The total
  2818.      length of the string is limited to 160 characters.  
  2819.  
  2820.        TrapDoor will also check if it gets any response from the
  2821.      modem after sending this init string. The modem should at least
  2822.      send something like "OK". In fact, any carriage-return
  2823.      terminated string from the modem will suffice.  
  2824.  
  2825.        If TrapDoor is unable to detect a response from the modem, it
  2826.      will report "Initializing modem failed" and exit. The default is
  2827.      MODEMINIT "~~AT~Z|~".  
  2828.  
  2829.      Example: ModemInit "ATZ|" 
  2830.  
  2831.   4.3.70. MODEMRESETINTERVAL minutes     
  2832.  
  2833.        Per default, TrapDoor resets the modem by sending the
  2834.      MODEMINIT command every 15 minutes if it has nothing else to do.
  2835.      Using this switch, you can set the time in minutes between
  2836.      automatic modem resets. Specifying a very large number (-1 for
  2837.      example), will yield no automatic resets.  
  2838.  
  2839.      Example: ModemResetInterval 15 
  2840.  
  2841.   4.3.71. NAME board's name    
  2842.  
  2843.        Name of this system -- to be sent to the other system during
  2844.      the beginning of a mail session. The length of the string is
  2845.      limited to 60 characters.  
  2846.  
  2847.      Example: Name "The Mad House -- TrapDoor Development" 
  2848.  
  2849.  
  2850.  
  2851.  
  2852.      Configuration Commands                               Keywords
  2853.  
  2854.  
  2855.      Page 47              TrapDoor's Fifth Manual              Page 47
  2856.  
  2857.  
  2858.   4.3.72. NODE zone:net/node.point     
  2859.  
  2860.        Sets your own FidoNet address.  
  2861.  
  2862.        For points: 
  2863.  
  2864.             If your boss uses a mailer that is not point smart, be
  2865.           sure to insert your private pointnet number here and not
  2866.           your full address. In this case, you should not use your
  2867.           complete four dimensional address (2:310/3.24), but rather
  2868.           the fake pointnet addressing method "2:3000/24".  
  2869.  
  2870.             FrontDoor, D'Bridge and newer versions of BinkleyTerm on
  2871.           the other hand do already support the four dimensional
  2872.           addressing method. Use your full address then.  
  2873.  
  2874.        For nodes: 
  2875.  
  2876.             Just set this to your own address.  
  2877.  
  2878.      Examples: Node 2:310/3.14 
  2879.                Node 2:310/6 
  2880.  
  2881.   4.3.73. NODELIST nodelist-directory     
  2882.  
  2883.        Set this to the directory where you keep your nodelist files.
  2884.      TrapDoor understands only nodelist files generated by its own
  2885.      nodelist processor, TrapList.  TrapDoor needs the library
  2886.      "traplist.library" to access the nodelist, so make sure it is in
  2887.      your LIBS: directory.  
  2888.  
  2889.        To disable the nodelist support in TrapDoor, use NODELIST "".
  2890.      This is also the default.  
  2891.  
  2892.      Examples: Nodelist "Mail:Nodelist" 
  2893.                Nodelist "" 
  2894.  
  2895.   4.3.74. OUTBOUND outbound-mail-directory     
  2896.  
  2897.        This should point to the directory where outgoing files are
  2898.      kept. It should contain all the necessary #?.REQ, #?.FLO, #?.HLO
  2899.      and #?.CLO files and the associated mail bundles. TrapDoor will
  2900.      automatically maintain and delete these files as they get sent
  2901.      out. The default is "Mail:Outbound". For more information, see
  2902.      chapter "Outbound directory".  
  2903.  
  2904.      Example: OutBound "Mail:Outbound" 
  2905.  
  2906.   4.3.75. PASSWORD password     
  2907.  
  2908.        Specifies the password to be used for mail sessions. The
  2909.      default is no password.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.      Configuration Commands                               Keywords
  2915.  
  2916.  
  2917.      Page 48              TrapDoor's Fifth Manual              Page 48
  2918.  
  2919.  
  2920.        On an outgoing call, if your password does not match the
  2921.      password that the other system has set up for you, you will be
  2922.      disconnected at the session handshake.  
  2923.  
  2924.        On incoming calls, if the password of the remote system does
  2925.      not match the password you specified here, this will be detected
  2926.      during the session handshake, recorded in the log file and the
  2927.      caller/callee will politely be shown the way out (i.e.
  2928.      disconnected).  
  2929.  
  2930.        If Nodelist support has been enabled by setting the NODELIST
  2931.      parameter, passwords will be fetched from there, unless the
  2932.      other system is not found in the nodelist.  
  2933.  
  2934.      Example: Password "secret" 
  2935.  
  2936.   4.3.76. PICKUP what     
  2937.  
  2938.        Select what mail and files to pickup (receive) from the remote
  2939.      system. These "Pickup Preferences" will only work if an EMSI
  2940.      handshake was used at the beginning of the session. There are
  2941.      three possible pickup values. The default is PICKUP ALL.  
  2942.  
  2943.        - ALL     Pick up mail and files for all of my addresses
  2944.                  (primary address + AKAs) 
  2945.        - PRIMARY Pick up mail and files for the primary address only 
  2946.        - NONE    Do not pick up mail or files at all 
  2947.  
  2948.      Examples: Pickup Primary 
  2949.                Pickup All 
  2950.                Pickup None 
  2951.  
  2952.   4.3.77. PUBSCREENNAME name     
  2953.  
  2954.        If you use SCREENMODE PUBLIC, this keyword allows you to
  2955.      specify the name of the public screen that TrapDoor should use.
  2956.      If a public screen with this name already exists, TrapDoor will
  2957.      open its windows there. If it does not exist, TrapDoor will open
  2958.      one.  
  2959.  
  2960.        Expert Notice: when TrapDoor opens the public screen, it will
  2961.      AllocVec() a buffer for the screen title. If any other program
  2962.      than TrapDoor closes the public screen, a few bytes of memory
  2963.      will be lost. If you are confused now and don't quite understand
  2964.      what I mean, just ignore it. :-) 
  2965.  
  2966.        PUBSCREENNAME defaults to "TrapDoor".  
  2967.  
  2968.      Example: PubScreenName "Hugo" 
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.      Configuration Commands                               Keywords
  2977.  
  2978.  
  2979.      Page 49              TrapDoor's Fifth Manual              Page 49
  2980.  
  2981.  
  2982.   4.3.78. QUIT     
  2983.  
  2984.        This tells TrapDoor to exit (when waiting in answer mode) and
  2985.      is exactly the same as "ABORT F" or pressing Alt-X or Alt-Q.  
  2986.  
  2987.        (+) ARexx only command 
  2988.        (@) asynchronous execution possible 
  2989.  
  2990.      Examples: Quit 
  2991.                @Quit 
  2992.  
  2993.   4.3.79. (NO)QUIET     
  2994.  
  2995.        If enabled, TrapDoor will run quietly in the background
  2996.      without opening any windows, screens etc. The logfile will still
  2997.      be written and you can still send ARexx commands to a TrapDoor
  2998.      running in QUIET mode. The default is NOQUIET.  
  2999.  
  3000.      Examples: NoQuiet 
  3001.                Quiet 
  3002.  
  3003.   4.3.80. REDIALDELAY seconds     
  3004.  
  3005.        This specifies the amount of time TrapDoor spends idling
  3006.      between calls to a system. Note that TrapDoor will not accept
  3007.      incoming calls while in "redial" state, so this option is only
  3008.      suited for points and will only work if you start TrapDoor with
  3009.      "TrapDoor Call ..." (i.e. you do not start it in answer mode).
  3010.      The default is 123 seconds.  
  3011.  
  3012.      Example: RedialDelay 120 
  3013.  
  3014.   4.3.81. RESET     
  3015.  
  3016.        This forces TrapDoor to reset/reinitialize the modem.  
  3017.  
  3018.        (+) ARexx only command 
  3019.  
  3020.      Example: Reset 
  3021.  
  3022.   4.3.82. RETRIES count     
  3023.  
  3024.        When calling a system, this instructs TrapDoor not to exit on
  3025.      a failed call (eg. line is busy), but to try it thus often
  3026.      again. Between the calls, TrapDoor will spend REDIALDELAY
  3027.      seconds waiting. Note that this automatic redialing does _not_
  3028.      apply if you place the call from within ANSWER mode. You have to
  3029.      start TrapDoor directly with the CALL parameter. The default is
  3030.      to not retry.  
  3031.  
  3032.      Example: Retries 5 
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.      Configuration Commands                               Keywords
  3039.  
  3040.  
  3041.      Page 50              TrapDoor's Fifth Manual              Page 50
  3042.  
  3043.  
  3044.   4.3.83. REXXNAME portname     
  3045.  
  3046.        Using this configuration keyword, you can select the ARexx
  3047.      port name (the "host address" in ARexx terminology) of TrapDoor.
  3048.      If you run TrapDoor on multiple lines, be sure to set up a
  3049.      different REXXNAME for every invocation. TrapDoor will not start
  3050.      up if the port name is already in use. The default rexx port
  3051.      name is "TrapDoor".  
  3052.  
  3053.      Example: RexxName "TrapDoor" 
  3054.  
  3055.   4.3.84. RINGCOMMAND commandline     
  3056.  
  3057.        This command will be spawned whenever TrapDoor detects a
  3058.      "RING" from the modem. When it returns, TrapDoor will answer the
  3059.      call (if RINGS "RING"s have passed). You can use it to trigger
  3060.      some sound effects, if you like. The default is RINGCOMMAND "",
  3061.      i.e. to not spawn any command.  
  3062.  
  3063.      Example: RingCommand "rx \"address upd play 12\"" 
  3064.  
  3065.   4.3.85. RINGINGS number     
  3066.  
  3067.        This is the number of times TrapDoor will allow another system
  3068.      to keep the phone "ringing" on an outgoing call. TrapDoor
  3069.      increments a counter every time it receives the string "RINGING"
  3070.      or "RRING" from your modem. When the counter exceeds the number
  3071.      specified with RINGINGS, TrapDoor will hang up, report the call
  3072.      as "NO ANSWER", and account it as an unanswered call (similar to
  3073.      "NO CARRIER"). Per default, TrapDoor will never abort a call
  3074.      because of the RINGINGS count.  
  3075.  
  3076.        Please note that not all modems support this feature.  
  3077.  
  3078.      Example: Ringings 3 
  3079.  
  3080.   4.3.86. RINGS number     
  3081.  
  3082.        Number of rings to wait before answering an incoming call. To
  3083.      turn off the answering feature, you can set this to any
  3084.      high-enough value (RINGS 5000 will probably never answer the
  3085.      phone).  
  3086.  
  3087.        This keyword defaults to RINGS 1.  
  3088.  
  3089.      Example: Rings 1 
  3090.  
  3091.   4.3.87. RUN command-string     
  3092.  
  3093.        Causes TrapDoor to execute the given command asynchronously.
  3094.      If the command includes spaces, it must be enclosed in
  3095.      double-quotes; to include quotes within the quoted string, use
  3096.      the backslash ("\") as an escape character. Embedded Percent
  3097.      Commands can also be used here.  
  3098.  
  3099.  
  3100.      Configuration Commands                               Keywords
  3101.  
  3102.  
  3103.      Page 51              TrapDoor's Fifth Manual              Page 51
  3104.  
  3105.  
  3106.        TrapDoor will not wait until the command returns, but merely
  3107.      continue to process ARexx messages and answer incoming calls.
  3108.      This is the big difference to the SPAWN keyword. In fact, "Run
  3109.      XXX" is exactly the same as "SPAWN \"Run XXX\"".  
  3110.  
  3111.        (+) ARexx only command 
  3112.  
  3113.      Examples: Run "ed mail:TrapDoor.cfg" 
  3114.                Run "echo \"This command was started from TrapDoor.\"" 
  3115.  
  3116.   4.3.88. SCLEAR     
  3117.  
  3118.        This command will clear the serial (receive) buffer.  
  3119.  
  3120.        (+) ARexx only command 
  3121.  
  3122.      Example: SClear 
  3123.  
  3124.   4.3.89. SCREENMODE mode     
  3125.  
  3126.        This allows you to specify the screen where TrapDoor opens its
  3127.      windows.  There are five possible modes; the default is
  3128.      SCREENMODE WORKBENCH.  
  3129.  
  3130.           WORKBENCH -- TrapDoor will open its windows on the
  3131.         workbench screen.  
  3132.  
  3133.           CUSTOM -- TrapDoor will open its own screen and place the
  3134.         windows there.  
  3135.  
  3136.           TRAPDOOR -- Similar to CUSTOMSCREEN, TrapDoor will open its
  3137.         windows on its own screen. However, if you have multiple
  3138.         TrapDoors running at the same time, all invocations of
  3139.         TrapDoor will share the same "TrapDoor" screen. The screen
  3140.         will only close when the last copy of TrapDoor quits
  3141.         running.  
  3142.  
  3143.           PUBLIC -- Similar to TRAPDOOR, but will use a Kickstart
  3144.         2.04 Public Screen instead of the proprietary and
  3145.         undocumented method that SCREENMODE TRAPDOOR uses. Thus,
  3146.         other programs can open their windows on the public TrapDoor
  3147.         screen, too. Or you can also make TrapDoor open its windows
  3148.         on a foreign public screen if you use SCREENMODE PUBLIC in
  3149.         conjunction with PUBSCREENNAME (to define the name of the
  3150.         public screen that TrapDoor should use).  
  3151.  
  3152.           ACTIVE -- TrapDoor will use the screen with the currently
  3153.         active window and open its windows there. Note that this is
  3154.         rather dangerous as TrapDoor cannot control when the other
  3155.         program will close the screen. If this happens, TrapDoor will
  3156.         try to write to a screen that no longer exists and this will
  3157.         in most cases immediately crash the machine.  
  3158.  
  3159.           In spite of these restrictions, SCREENMODE ACTIVE looks
  3160.  
  3161.  
  3162.      Configuration Commands                               Keywords
  3163.  
  3164.  
  3165.      Page 52              TrapDoor's Fifth Manual              Page 52
  3166.  
  3167.  
  3168.         very nice in conjunction with Chameleon, a wonderful message
  3169.         editor written by Jürgen Hermann. Try sticking the following
  3170.         command into your 'CE.CFG' file: 
  3171.  
  3172.            External CustomScreen "Call Boss" \ 
  3173.               "TrapDoor call boss screenmode active" 
  3174.  
  3175.           Now start Chameleon, pull down the "External" menu, select
  3176.         this item and see for yourself ...  
  3177.  
  3178.      Examples: ScreenMode Workbench 
  3179.                ScreenMode TrapDoor 
  3180.  
  3181.   4.3.90. SCREENTOBACK     
  3182.  
  3183.        Will cause the TrapDoor screen to move behind all other
  3184.      screens.  
  3185.  
  3186.        (+) ARexx only command 
  3187.        (@) asynchronous execution possible 
  3188.  
  3189.      Example: ScreenToFront 
  3190.  
  3191.   4.3.91. SCREENTOFRONT     
  3192.  
  3193.        Will cause the TrapDoor screen to move to the front of all
  3194.      other screens.  
  3195.  
  3196.        (+) ARexx only command 
  3197.        (@) asynchronous execution possible 
  3198.  
  3199.      Example: ScreenToFront 
  3200.  
  3201.   4.3.92. SERIALBUFSIZE size-in-bytes     
  3202.  
  3203.        This keyword can be used to set the serial receive buffer. It
  3204.      defaults to 8192 bytes.  
  3205.  
  3206.      Example: SerialBufSize 4096 
  3207.  
  3208.   4.3.93. SERIALFLAGS serial-flags     
  3209.  
  3210.        If you use some other device than "serial.device", you might
  3211.      need to change this, too. Consult the documentation that came
  3212.      with your other device or use the default of zero.  
  3213.  
  3214.      Example: SerialFlags 0 
  3215.  
  3216.   4.3.94. SERIALNAME serial-device-name     
  3217.  
  3218.        If you happen to have a modem connected to some other device
  3219.      than the standard Amiga "serial.device", you can use this
  3220.      parameter to set up the correct device name. Usually, the
  3221.      default of "serial.device" will just be about perfect. For Supra
  3222.  
  3223.  
  3224.      Configuration Commands                               Keywords
  3225.  
  3226.  
  3227.      Page 53              TrapDoor's Fifth Manual              Page 53
  3228.  
  3229.  
  3230.      2400zi modems, use SERIALNAME "modem0.device".  
  3231.  
  3232.      Example: SerialName "serial.device" 
  3233.  
  3234.   4.3.95. SERIALUNIT serial-unit-number     
  3235.  
  3236.        If your modem is connected to some other unit number than zero
  3237.      (on the device you set with SERIALNAME), change this
  3238.      appropriately.  
  3239.  
  3240.      Example: SerialUnit 0 
  3241.  
  3242.   4.3.96. (NO)SHARED     
  3243.  
  3244.        (Don't) Open the serial device in shared mode. If you are
  3245.      running TrapDoor in conjunction with a BBS program or similar,
  3246.      you need to switch the serial device to SHARED mode, so that
  3247.      both programs can have it open at the same time. The default is
  3248.      NOSHARED.  
  3249.  
  3250.      Examples: NoShared 
  3251.                Shared 
  3252.  
  3253.   4.3.97. (NO)SHOWREXX     
  3254.  
  3255.        In SHOWREXX mode, TrapDoor will display all ARexx commands
  3256.      that it processes in the status window. The default is
  3257.      NOSHOWREXX.  
  3258.  
  3259.        You can toggle showrexx mode from the keyboard using Alt-S.  
  3260.  
  3261.      Examples: NoShowRexx 
  3262.                ShowRexx 
  3263.  
  3264.   4.3.98. SLINE     
  3265.  
  3266.        This command will receive one line of text from the serial
  3267.      port and return it in the ARexx RESULT variable. The timeout
  3268.      specified with STIMEOUT will be used.  
  3269.  
  3270.        (+) ARexx only command 
  3271.  
  3272.      Example: SLine 
  3273.  
  3274.   4.3.99. SLOWMODEM modem-command-delay     
  3275.  
  3276.        Some modems won't understand incoming data at full speed while
  3277.      in command mode. Others take some time after a reset (ATZ or DTR
  3278.      dropped) until they will react to incoming commands again. If
  3279.      your modem doesn't seem to understand the commands TrapDoor is
  3280.      trying to send, feel free to change (increase) this parameter.
  3281.      Also see chapter "The Modem" for some suggested values.
  3282.      SLOWMODEM defaults to 10.  
  3283.  
  3284.  
  3285.  
  3286.      Configuration Commands                               Keywords
  3287.  
  3288.  
  3289.      Page 54              TrapDoor's Fifth Manual              Page 54
  3290.  
  3291.  
  3292.        SLOWMODEM changes a number of timings in TrapDoor, the most
  3293.      important being: 
  3294.  
  3295.        (a) the time that TrapDoor waits between lowering and raising
  3296.            of DTR when it tries to reset the modem or hang up, 
  3297.  
  3298.        (b) the time that TrapDoor waits when it encounters a tilde
  3299.            ("~") character in a modem command string (MODEMINIT,
  3300.            MODEMDIAL, MODEMANSWER).  
  3301.  
  3302.      Example: SlowModem 7 
  3303.  
  3304.   4.3.100. SMODEM modem-command     
  3305.  
  3306.        This ARexx-only command will send a command to the modem. It
  3307.      is similar to SWRITE, but the specified string will be run
  3308.      through the modem command processor first, allowing the use of
  3309.      "~", "^" and "|" special characters. For more information about
  3310.      these characters, see chapter "Modem Commands".  
  3311.  
  3312.        (+) ARexx only command 
  3313.  
  3314.      Example: SModem "~~AT~H1|~~" 
  3315.  
  3316.   4.3.101. (NO)SNIFFARQ     
  3317.  
  3318.        If you have a modem that will detect MNP, LAP-M, V42 and
  3319.      similar error-correction protocols, you can enable SNIFFARQ.
  3320.      With SNIFFARQ, TrapDoor will minimize session-startup delays.  
  3321.  
  3322.        The default is NOSNIFFARQ. You should _not_ use SNIFFARQ with
  3323.      modems that have no error correction. You must specify the
  3324.      correct ARQSTRING for your modem if you use SNIFFARQ.  
  3325.  
  3326.      Examples: NoSniffArq 
  3327.                SniffArq 
  3328.  
  3329.   4.3.102. SPAWN command-string     
  3330.  
  3331.        Causes TrapDoor to execute the given command. If the command
  3332.      includes spaces, it must be enclosed in double-quotes; to
  3333.      include quotes within the quoted string, use the backslash ("\")
  3334.      as an escape character. Embedded Percent Commands can also be
  3335.      used here.  
  3336.  
  3337.        TrapDoor will wait until the command returns. It will not
  3338.      execute any other ARexx commands, nor will it answer incoming
  3339.      calls while the command is executing.  
  3340.  
  3341.        (+) ARexx only command 
  3342.  
  3343.      Examples: Spawn "ed mail:TrapDoor.cfg" 
  3344.                Spawn "echo \"Spawned from TrapDoor!\"" 
  3345.  
  3346.  
  3347.  
  3348.      Configuration Commands                               Keywords
  3349.  
  3350.  
  3351.      Page 55              TrapDoor's Fifth Manual              Page 55
  3352.  
  3353.  
  3354.   4.3.103. STARTSESSION     
  3355.  
  3356.        When TrapDoor receives this command, it will immediately start
  3357.      waiting for a banner line from the remote system, then begin
  3358.      with the session handshake.  
  3359.  
  3360.        This command is intended to be used in outdialing scripts as
  3361.      the final command, giving control to TrapDoor to begin a
  3362.      session.  
  3363.  
  3364.        (+) ARexx only command 
  3365.  
  3366.      Example: StartSession 
  3367.  
  3368.   4.3.104. STATUS what     
  3369.  
  3370.        Depending on the argument, this command will return various
  3371.      information about the state TrapDoor is in, the result of
  3372.      previous calls etc.  
  3373.  
  3374.        The following status specifiers are recognized: 
  3375.  
  3376.        C ... Returns the cost of the last call made.  
  3377.  
  3378.        D ... Reports the result string of the dial (or call), such as
  3379.              BUSY, NO DIALTONE, CONNECT 2400.  
  3380.  
  3381.        F ... Reports the number of files that have been sent and
  3382.              received during the last session, separated by a slash
  3383.              ('/').  
  3384.  
  3385.        N ... Reports the node number that the last session was had
  3386.              with.  
  3387.  
  3388.        S ... Reports the serial status of TrapDoor, which indicates
  3389.              whether TrapDoor is currently waiting for a call,
  3390.              answering a call, making an outgoing call, waiting for
  3391.              an external program to return or whether it has the
  3392.              serial port closed. Valid return values are: 
  3393.  
  3394.              IDLE:     TrapDoor is idle, waiting for a call.
  3395.              OUTGOING: TrapDoor is making an outgoing call.
  3396.              INCOMING: TrapDoor is answering an incoming call.
  3397.              CLOSED:   TrapDoor has closed its serial port;
  3398.                        another program is using it.
  3399.              SPAWNING: TrapDoor is currently spawning an external
  3400.                        program and waiting for it to return.
  3401.  
  3402.        U ... Reports the "deafness" status of TrapDoor. It will
  3403.              return either UNLISTEN or LISTEN depending on the
  3404.              current status of TrapDoor (set with (NO)UNLISTEN).  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.      Configuration Commands                               Keywords
  3411.  
  3412.  
  3413.      Page 56              TrapDoor's Fifth Manual              Page 56
  3414.  
  3415.  
  3416.        X ... Queries the status of the last call. It returns an
  3417.              integer number, where: 
  3418.  
  3419.              0: everything okay
  3420.              1: (internal) unused
  3421.              2: protocol error (too many retries)
  3422.              3: (internal) end-of-transmission, Telink complete
  3423.              4: (internal) file skipped
  3424.              5: user break (Ctrl-C or ESC)
  3425.              6: carrier lost
  3426.              7: disk i/o error
  3427.              8: remote canceled transmission
  3428.              9: internal program error
  3429.              10: human caller (BBS user) detected
  3430.              11: remote didn't answer
  3431.              12: (internal) object in use, can't send
  3432.              13: node not found in nodelist
  3433.              14: accounting limit reached
  3434.              15: node is undialable
  3435.              16: no response from modem while dialing
  3436.              17: baudrate too low
  3437.              18: BUSY
  3438.              19: VOICE
  3439.              20: NO DIALTONE
  3440.              21: NO CARRIER
  3441.              22: RINGING limit (NO ANSWER)
  3442.              23: RING (incoming call detected while dialing)
  3443.              24: ERROR
  3444.  
  3445.        (+) ARexx only command 
  3446.        (@) asynchronous execution possible 
  3447.  
  3448.      Examples: Status D 
  3449.                @Status S 
  3450.  
  3451.   4.3.105. STATWINDOW window-specification     
  3452.  
  3453.        Similar to LOGWINDOW, this changes the position and size of
  3454.      the status window.  
  3455.  
  3456.      Example: StatWindow 30/155/580/37 
  3457.  
  3458.   4.3.106. STIMEOUT timeout     
  3459.  
  3460.        Sets the timeout, in seconds, for the SWAIT and SLINE
  3461.      commands.  
  3462.  
  3463.      Example: STimeout 3 
  3464.  
  3465.   4.3.107. (NO)STRIPDASHES     
  3466.  
  3467.        A few modems do not allow dashes ("-") in dial strings. The
  3468.      Fidonet nodelist, however, contains dashes. Specifying
  3469.      STRIPDASHES will tell TrapDoor to remove all dashes from dial
  3470.  
  3471.  
  3472.      Configuration Commands                               Keywords
  3473.  
  3474.  
  3475.      Page 57              TrapDoor's Fifth Manual              Page 57
  3476.  
  3477.  
  3478.      strings before sending them to the modem.  
  3479.  
  3480.      Example: StripDashes 
  3481.  
  3482.   4.3.108. SWAIT string     
  3483.  
  3484.        Waits until the given string is received on the serial line,
  3485.      or until the timeout set with STIMEOUT has expired.  
  3486.  
  3487.      Example: SWait "login:" 
  3488.  
  3489.   4.3.109. (NO)SWEPULSE     
  3490.  
  3491.        Applies a special number translation to the dial string before
  3492.      sending it to the modem. Special feature for swedish people with
  3493.      non-swedish modems. The default is NOSWEPULSE.  
  3494.  
  3495.      Examples: NoSwePulse 
  3496.                SwePulse 
  3497.  
  3498.   4.3.110. SWRITE string     
  3499.  
  3500.        Sends the given string to the modem. The string will be sent
  3501.      as given, without any modification.  
  3502.  
  3503.      Example: SWrite "Mad Max" 
  3504.  
  3505.   4.3.111. SYSOP sysop's-name     
  3506.  
  3507.        Sysop's name, will be sent to the other system during session
  3508.      negotiation. The length of this string is limited to 20
  3509.      characters in the YooHoo/WaZoo handshake and to 30 characters
  3510.      when using EMSI.  
  3511.  
  3512.      Example: Sysop "Maximilian Hantsch" 
  3513.  
  3514.   4.3.112. TASKPRI priority     
  3515.  
  3516.        Use this to select the AmigaDOS/Exec task priority of
  3517.      TrapDoor. Normal tasks operate at priority 0. It is often
  3518.      advisable to set the priority of TrapDoor to 1 or 2, so that
  3519.      mail sessions are not slowed down by other activity such as mail
  3520.      importing/exporting.  
  3521.  
  3522.        If the keyword is not used, TrapDoor will run at the priority
  3523.      of the invoking process.  
  3524.  
  3525.      Example: TaskPri 1 
  3526.  
  3527.   4.3.113. TESTFREQ     
  3528.  
  3529.        To be able to test your file request server programs and
  3530.      scripts, call TrapDoor with "TrapDoor testfreq". This will cause
  3531.      TrapDoor to look for a TrapDoor.FReq file in the inbound
  3532.  
  3533.  
  3534.      Configuration Commands                               Keywords
  3535.  
  3536.  
  3537.      Page 58              TrapDoor's Fifth Manual              Page 58
  3538.  
  3539.  
  3540.      directory and, if one is found, call the file request server
  3541.      (specified with the FREQUEST keyword). The result of the file
  3542.      request server should be a .RLO file in your outbound directory,
  3543.      which you can check to see whether everything works all right.  
  3544.  
  3545.         Please note that the request file should be called
  3546.      "TrapDoor.FReq", or to be more exact,
  3547.      "<name-of-your-arexx-port>.FReq".  
  3548.  
  3549.      Example: TestFreq 
  3550.  
  3551.   4.3.114. (NO)TIMESTAMP     
  3552.  
  3553.        If TIMESTAMP is switched on, TrapDoor will always use
  3554.      timestamps for converting 4D echomail bundle names to 2D for
  3555.      sending. Note: this might be incompatible with some old Echomail
  3556.      tossers when they are switched to "check security" mode.  
  3557.  
  3558.        If NOTIMESTAMP is in effect (the default), TrapDoor will try
  3559.      to use the standard hex net/node difference naming, unless: 
  3560.  
  3561.        - either system has a point address.  
  3562.        - the main addresses of the two systems are in different
  3563.          zones, but have the same net and node numbers.  
  3564.  
  3565.                    "Fidonet peculiarities? Don't worry,
  3566.                    we got them all under control... ;-)"
  3567.  
  3568.      Examples: NoTimeStamp 
  3569.                TimeStamp 
  3570.  
  3571.   4.3.115. (NO)TRAPZAP     
  3572.  
  3573.        Enable (disable) TrapZap mode. TrapZap is a slight variant of
  3574.      the DirectZap transfer protocol, which is a slight variant of
  3575.      ZedZap/Zmodem -- on large files, TrapZap is the fastest protocol
  3576.      TrapDoor has to offer. Like ZedZap and DirectZap, TrapZap will
  3577.      automatically switch block sizes depending on modem speed and
  3578.      quality of the line. It will also resume an interrupted transfer
  3579.      if possible. TrapZap also has an improved control flow to make
  3580.      error recovery easier and hopefully more successful in the
  3581.      session turnaround phase. TrapZap also keeps the upper/lowercase
  3582.      spelling of the names of files being transferred and has a
  3583.      slightly faster protocol startup time when receiving.  
  3584.  
  3585.        TrapZap only works in EMSI mode and only if the other side
  3586.      also supports it. Also - like DirectZap - TrapZap only works on
  3587.      8-bit transparent lines. You should disable it (use NOTRAPZAP)
  3588.      if you are working over a non-transparent line like a
  3589.      packet-switching network. The keyword defaults to NOTRAPZAP.  
  3590.  
  3591.      Examples: NoTrapZap 
  3592.                TrapZap 
  3593.  
  3594.  
  3595.  
  3596.      Configuration Commands                               Keywords
  3597.  
  3598.  
  3599.      Page 59              TrapDoor's Fifth Manual              Page 59
  3600.  
  3601.  
  3602.   4.3.116. TURNAROUND command-string     
  3603.  
  3604.        TrapDoor will execute the given commandline when the session
  3605.      "turnaround" is about to take place. Session turnaround is when
  3606.      the sender and the receiver change sides, and files are
  3607.      transferred in the other direction afterwards. Since TrapDoor
  3608.      waits for the external command to complete before continuing
  3609.      with the session, it should return quickly. The default is to
  3610.      not execute any external command in the turnaround phase.  
  3611.  
  3612.      Examples: Turnaround "run Execute Scripts:TossMail" 
  3613.                Turnaround "" 
  3614.  
  3615.   4.3.117. (NO)(UN)LISTEN     
  3616.  
  3617.        Per default, TrapDoor will be in the "listen" state and keep
  3618.      waiting for messages from the modem (RING etc.).  
  3619.  
  3620.        If you send TrapDoor a NOLISTEN or UNLISTEN ARexx message, you
  3621.      will make it terminate all its serial I/O. It will still keep
  3622.      the serial device open, but not send any I/O requests to it. In
  3623.      this mode, TrapDoor will keep hanging around idle until you send
  3624.      it a NOUNLISTEN or LISTEN ARexx message. If you tell TrapDoor to
  3625.      make an outgoing call, it will do so, but return to its silent
  3626.      UNLISTEN state as soon as the call is over.  
  3627.  
  3628.        Please note that NOUNLISTEN is a synonym for LISTEN and
  3629.      NOLISTEN is a synonym for UNLISTEN.  
  3630.  
  3631.      Examples: UnListen 
  3632.                NoUnListen 
  3633.                Listen 
  3634.                NoListen 
  3635.  
  3636.   4.3.118. (NO)USESYSFONT     
  3637.  
  3638.        If enabled, TrapDoor will use the system screen font
  3639.      (proportional) for the TrapDoor screen instead of the default
  3640.      monospaced (non-proportional) system font. It defaults to
  3641.      NOUSESYSFONT.  
  3642.  
  3643.      Examples: UseSysFont 
  3644.                NoUseSysFont 
  3645.  
  3646.   4.3.119. (NO)USEUSERSHELL     
  3647.  
  3648.        This command will select whether TrapDoor passes external
  3649.      commands (such as FREQUEST, RINGCOMMAND, BBSCOMMAND, TURNAROUND
  3650.      and the like) to the standard AmigaOS system shell or to a
  3651.      user-selectable "UserShell" (such as WShell for instance). It
  3652.      defaults to NOUSEUSERSHELL.  
  3653.  
  3654.  
  3655.  
  3656.  
  3657.  
  3658.      Configuration Commands                               Keywords
  3659.  
  3660.  
  3661.      Page 60              TrapDoor's Fifth Manual              Page 60
  3662.  
  3663.  
  3664.   4.3.120. VOICECOMMAND commandline     
  3665.  
  3666.        When TrapDoor detects a voice connect (it looks for
  3667.      VOICESTRING in messages from the modem), it will spawn this
  3668.      external program. Using this technique you can run your voice
  3669.      software to accept incoming voice calls while at the same time
  3670.      allowing ordinary modem callers to go to the bulletin board or
  3671.      to run a FidoNet session with your system. There may be embedded
  3672.      %-commands in the string; these are described in the chapter
  3673.      "Embedded Percent-Commands".  
  3674.  
  3675.        This will also work on outgoing calls. You can use the
  3676.      embedded percent command "d" to tell your voice software if this
  3677.      is an outgoing or incoming call.  
  3678.  
  3679.      Example: VoiceCommand "VoiceAnswer %d" 
  3680.  
  3681.   4.3.121. VOICESTRING string     
  3682.  
  3683.        Tells TrapDoor what string the modem returns when it senses a
  3684.      voice connect.  You must setup the correct VOICESTRING for your
  3685.      modem when you use the VOICECOMMAND keyword.  
  3686.  
  3687.      Example: VoiceString "+VCON" 
  3688.  
  3689.   4.3.122. (NO)WAZOO     
  3690.  
  3691.        Enable (disable) WaZoo mode. With WaZoo disabled, TrapDoor
  3692.      will only attempt to connect using the FTS-0001 (Lotek) protocol
  3693.      or EMSI handshake. No YooHoo will be done. It defaults to
  3694.      WAZOO.  
  3695.  
  3696.      Examples: NoWaZOO 
  3697.                WaZOO 
  3698.  
  3699.   4.3.123. (NO)WRAPLINES     
  3700.  
  3701.        With WrapLines enabled, TrapDoor will try to wrap lines that
  3702.      are sent to the log window and continue them in the next line,
  3703.      if they are too long to be displayed on a single line. The
  3704.      logfile will be unaffected by the setting of this switch. Only
  3705.      the output in the window is reformatted. It defaults to
  3706.      NOWRAPLINES.  
  3707.  
  3708.      Examples: WrapLines 
  3709.                NoWrapLines 
  3710.  
  3711.   4.3.124. VERSION     
  3712.  
  3713.        This ARexx-only command will return the version identifier of
  3714.      TrapDoor, e.g. "1.84".  
  3715.  
  3716.        (+) ARexx only command 
  3717.        (@) asynchronous execution possible 
  3718.  
  3719.  
  3720.      Configuration Commands                               Keywords
  3721.  
  3722.  
  3723.      Page 61              TrapDoor's Fifth Manual              Page 61
  3724.  
  3725.  
  3726.      Example:  Version 
  3727.  
  3728.   4.3.125. (NO)XMAIL     
  3729.  
  3730.        Enable (disable) eXtended Mail, whatever that is. There is a
  3731.      flag in the EMSI handshake packet called "XMA". The EMSI
  3732.      documentation is very unclear about what it means. Anyway, you
  3733.      got the choice now :-) 
  3734.  
  3735.        This keyword defaults to XMAIL, as this was the behaviour of
  3736.      TrapDoor 1.80.  
  3737.  
  3738.      Examples: NoXMail 
  3739.                XMail 
  3740.  
  3741.   4.3.126. (NO)ZEDZAP     
  3742.  
  3743.        Enable (disable) ZedZap mode. ZedZap is a slight variant of
  3744.      the ZModem transfer protocol -- on large files, this is one of
  3745.      the fastest protocols around. ZedZap will automatically switch
  3746.      block sizes depending on modem speed and quality of the line. It
  3747.      will also resume an interrupted transfer if possible.  
  3748.  
  3749.        ZedZap only works in WaZoo or EMSI mode and only if the other
  3750.      side also supports it. This keyword defaults to ZEDZAP.  
  3751.  
  3752.      Examples: NoZedZap 
  3753.                ZedZap 
  3754.  
  3755.   4.3.127. (NO)ZEDZIP     
  3756.  
  3757.        Enable (disable) ZedZip mode. ZedZip is the ZModem transfer
  3758.      protocol -- it will not switch block sizes, but use a fixed
  3759.      block size of 1kb. It will resume an interrupted transfer if
  3760.      possible.  
  3761.  
  3762.        ZedZip only works in WaZoo or EMSI mode and only if the other
  3763.      side also supports it. This keyword defaults to ZEDZIP.  
  3764.  
  3765.      Examples: NoZedZip 
  3766.                ZedZip 
  3767.  
  3768.   4.3.128. (NO)ZOOMFULLSIZE     
  3769.  
  3770.        Select whether using the Zoom/Zip-Gadgets on TrapDoor's
  3771.      windows will cause them to become full-sized windows or shrink
  3772.      to a very small size. The keyword defaults to NOZOOMFULLSIZE,
  3773.      because this is what the behaviour of all TrapDoors up to
  3774.      version 1.83 was.  
  3775.  
  3776.  
  3777.  
  3778.  
  3779.  
  3780.  
  3781.  
  3782.      Configuration Commands                               Keywords
  3783.  
  3784.  
  3785.      Page 62              TrapDoor's Fifth Manual              Page 62
  3786.  
  3787.  
  3788.        Please note that ZOOMFULLSIZE will not work when using
  3789.      SCREENMODE WORKBENCH. If you have AmigaOS 2.04 or higher, you
  3790.      can use 
  3791.  
  3792.          SCREENMODE PUBLIC
  3793.          PUBSCREENNAME ""
  3794.  
  3795.      or
  3796.  
  3797.          SCREENMODE PUBLIC
  3798.          PUBSCREENNAME "Workbench"
  3799.  
  3800.      instead and ZOOMFULLSIZE will work again.  
  3801.  
  3802.      Examples: NoZoomFullSize 
  3803.                ZoomFullSize 
  3804.  
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.  
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.  
  3835.  
  3836.  
  3837.  
  3838.  
  3839.  
  3840.  
  3841.  
  3842.  
  3843.  
  3844.      Configuration Commands                               Keywords
  3845.  
  3846.  
  3847.      Page 63              TrapDoor's Fifth Manual              Page 63
  3848.  
  3849.  
  3850.   5. Example Setup     
  3851.  
  3852.           ; ****************************************************
  3853.           ; **                                                **
  3854.           ; **    TrapDoor 1.83 Example Configuration File    **
  3855.           ; **                                                **
  3856.           ; ****************************************************
  3857.  
  3858.           ; This is my FidoNet node number
  3859.  
  3860.           NODE 2:310/6.0
  3861.  
  3862.           ; here are my AKAs
  3863.  
  3864.           AKA "2:3160/0 7:123/456 13:13/42"
  3865.  
  3866.           ; This is my node's name
  3867.  
  3868.           NAME "The Mad House -- TrapDoor Development"
  3869.  
  3870.           ; This is the sysop's name
  3871.  
  3872.           SYSOP "Maximilian Hantsch"
  3873.  
  3874.           ; Point setup: set up the password for your boss node here.
  3875.           ; Leave this unset ("") to operate a node or set it to
  3876.           ; something else to not accept calls from unlisted nodes.
  3877.  
  3878.           PASSWORD ""
  3879.  
  3880.           ; Here I set up the baudrate that TrapDoor should use to
  3881.           ; talk to the modem
  3882.  
  3883.           BAUD 19200
  3884.  
  3885.           ; For modems that can lock the baudrate, use LOCK.
  3886.  
  3887.           LOCK
  3888.  
  3889.           ; This is the minimum baudrate at which TrapDoor will
  3890.           ; keep a connection. If the modem responds with a
  3891.           ; "CONNECT xxx" message where xxx is lower than
  3892.           ; the MINBAUD value, TrapDoor will hang up.
  3893.  
  3894.           MINBAUD 300
  3895.  
  3896.           ; Point setup: set this to your boss' FidoNet address.
  3897.           ; Set this to your own address when running a node.
  3898.  
  3899.           BOSS 2:310/6.0
  3900.  
  3901.  
  3902.  
  3903.  
  3904.  
  3905.  
  3906.      Example Setup
  3907.  
  3908.  
  3909.      Page 64              TrapDoor's Fifth Manual              Page 64
  3910.  
  3911.  
  3912.           ; Point setup: set this to the telephone number of your
  3913.           ; boss. When operating with a nodelist, you can also put
  3914.           ; the FidoNet address of your boss here and TrapDoor will
  3915.           ; consult the nodelist to find out the phone number.
  3916.           ; Note that TrapDoor uses the colon (":") in the FidoNet
  3917.           ; node number ot distinguish it from a telephone number,
  3918.           ; so always specify the zone if you want to give it a
  3919.           ; nodenumber.
  3920.  
  3921.           CALL 2:310/6
  3922.  
  3923.           ; The path to your outbound directory where .FLO, .OUT
  3924.           ; and such stuff is.
  3925.  
  3926.           OUTBOUND "Mail:Outbound"
  3927.  
  3928.           ; The path to your inbound directory where incoming files
  3929.           ; are put.
  3930.  
  3931.           INBOUND "Mail:Inbound"
  3932.  
  3933.           ; If you specify a path here, TrapDoor will use this
  3934.           ; directory to find nodelist index/extra files.
  3935.           ; To disable nodelist support, use NODELIST "".
  3936.  
  3937.           NODELIST "NodeList:"
  3938.  
  3939.           ; Use MAXBAUD to automatically adjust MINBAUD to the
  3940.           ; highest possible baudrate.
  3941.  
  3942.           MAXBAUD
  3943.  
  3944.           ; This is the number of rings that TrapDoor will wait
  3945.           ; before answering the phone. If you don't want TrapDoor
  3946.           ; to answer the phone, just set this to RINGS 9999.
  3947.  
  3948.           RINGS 1
  3949.  
  3950.           ; A banner line that will be displayed to human callers.
  3951.           ; Instead of specifying a string, you could also send out
  3952.           ; a complete banner file here. The second line gives you
  3953.           ; an example of that.
  3954.  
  3955.           BANNER "TrapDoor Development, online Mon-Sun 00:00-06:00"
  3956.           ; BANNER "<mail:Banner"
  3957.  
  3958.           ; This is the commandline that TrapDoor will execute when
  3959.           ; a user presses Escape to enter the BBS.
  3960.           ; To disable the BBS, use BBSMODE NONE or leave it out.
  3961.  
  3962.           ; BBSCOMMAND "DLG:immed TR0 %b %B -w"
  3963.           ; BBSINOUT ""
  3964.           ; BBSMODE SPAWN
  3965.  
  3966.  
  3967.  
  3968.      Example Setup
  3969.  
  3970.  
  3971.      Page 65              TrapDoor's Fifth Manual              Page 65
  3972.  
  3973.  
  3974.           ; In addition to the Escape key, you can specify another
  3975.           ; character that users can press twice to enter the BBS.
  3976.           ; WARNING: Do not use an asterisk ('*') here!
  3977.  
  3978.           ; BBSCHAR '.'
  3979.  
  3980.           ; This defines the name of the logfile for TrapDoor.
  3981.  
  3982.           LOGFILE "Mail:TrapDoor.Log"
  3983.  
  3984.           ; Here are the loglevels for various logging groups.
  3985.  
  3986.           LOGLEVEL 0:2    ; debugger
  3987.           LOGLEVEL 1:2    ; link
  3988.           LOGLEVEL 2:2    ; transfer
  3989.           LOGLEVEL 3:2    ; system
  3990.           LOGLEVEL 4:2    ; modem
  3991.           LOGLEVEL 5:2    ; session
  3992.           LOGLEVEL 6:7    ; security
  3993.           LOGLEVEL 7:2    ; outside
  3994.           LOGLEVEL 8:7    ; information
  3995.           LOGLEVEL 9:2    ; scheduler
  3996.  
  3997.           ; I want faster logging.
  3998.  
  3999.           MAXLOGSECS 5
  4000.           MAXLOGLINES 10
  4001.  
  4002.           ; If you have a "slow" modem, set this to higher values.
  4003.  
  4004.           SLOWMODEM 10
  4005.  
  4006.           ; MODEMINIT     will be sent to the modem to reset it.
  4007.           ; MODEMDIALPRE  will be sent to the modem to dial out,
  4008.           ;               followed by the phone number, followed by
  4009.           ; MODEMDIALPOST
  4010.           ; MODEMANSWER   will be sent to answer the phone.
  4011.           ; MODEMHANGUP   will be sent to hangup the modem.
  4012.  
  4013.           MODEMINIT "~~ATZ|~~~~"
  4014.           MODEMHANGUP "||^|"
  4015.           MODEMDIALPRE "~~ATS7=60B1X7DP"
  4016.           MODEMDIALPOST "|"
  4017.           MODEMANSWER "~~ATS7=25B0A|"
  4018.  
  4019.           ; If your modem is an error correcting modem, ARQSTRING
  4020.           ; tells TrapDoor what the modem returns when it
  4021.           ; establishes a connection under error control. If you
  4022.           ; have such a modem, you can also specify SNIFFARQ and
  4023.           ; handshakes can become a bit faster.
  4024.  
  4025.           ; ARQSTRING "ARQ"
  4026.           ; SNIFFARQ
  4027.  
  4028.  
  4029.  
  4030.      Example Setup
  4031.  
  4032.  
  4033.      Page 66              TrapDoor's Fifth Manual              Page 66
  4034.  
  4035.  
  4036.           ; This informs TrapDoor which Amiga device is your
  4037.           ; serial device. For example, a Supra 2400zi modem
  4038.           ; needs SERIALNAME "modem0.device".
  4039.  
  4040.           SERIALNAME "serial.device"
  4041.           SERIALUNIT 0
  4042.           SERIALFLAGS 0
  4043.  
  4044.           ; If you want to spawn a BBS, you must use the SHARED
  4045.           ; option. Otherwise, you can use NOSHARED to prevent
  4046.           ; other programs from using the serial device when
  4047.           ; TrapDoor has it open.
  4048.  
  4049.           SHARED
  4050.  
  4051.           ; If your modem does not support the DSR line, use NODSR.
  4052.           ; Otherwise, use DSR and TrapDoor will be able to tell
  4053.           ; whether your modem is switched on or not.
  4054.  
  4055.           DSR
  4056.  
  4057.           ; If you have a buffering modem, you need to have a full
  4058.           ; 7-wire cable and enable hardware handshaking with 7WIRE.
  4059.  
  4060.           7WIRE
  4061.  
  4062.           ; Please read TrapDoor's manual for a more detailed
  4063.           ; explanation of the ADJUST parameter. If you are not
  4064.           ; sure what to do with it, leave it at -11.
  4065.           ; If you have AmigaOS 2.0 or higher, use ADJUST 0 or
  4066.           ; leave it out completely.
  4067.  
  4068.           ;ADJUST -11
  4069.  
  4070.           ; This tells TrapDoor what command to execute to handle
  4071.           ; incoming File Requests. Please consult the manual for
  4072.           ; a more detailed description.
  4073.           ; To turn off File Requests, use FREQUEST "".
  4074.  
  4075.           FREQUEST "RequestHandler %i,%o,%l"
  4076.  
  4077.           ; This is the name of TrapDoor's ARexx port.
  4078.           ; If you have multiple lines, you need to change this
  4079.           ; for each line.
  4080.  
  4081.           REXXNAME "TrapDoor"
  4082.  
  4083.           ; Where should TrapDoor put its windows?
  4084.           ; Note that on NTSC machines and their smaller screens,
  4085.           ; you will have to change the value of STATWINDOW.
  4086.  
  4087.           LOGWINDOW 30/15/580/133
  4088.           STATWINDOW 30/155/580/93
  4089.           ; STATWINDOW 30/155/580/44 ; use this on NTSC
  4090.  
  4091.  
  4092.      Example Setup
  4093.  
  4094.  
  4095.      Page 67              TrapDoor's Fifth Manual              Page 67
  4096.  
  4097.  
  4098.           ; Use SCREENMODE CUSTOM to have TrapDoor open its own
  4099.           ; screen, SCREENMODE WORKBENCH to have it open its
  4100.           ; windows on the Workbench Screen, SCREENMODE ACTIVE
  4101.           ; to open the windows on the currently active screen,
  4102.           ; and SCREENMODE TRAPDOOR for special magic.
  4103.           ; If you have AmigaOS 2.04, you might also want to
  4104.           ; try SCREENMODE PUBLIC.
  4105.           ; Beware: Please read the instructions in the manual
  4106.           ; before using SCREENMODE ACTIVE.
  4107.  
  4108.           SCREENMODE TRAPDOOR
  4109.  
  4110.           ; If you want TrapDoor to open its screen in the
  4111.           ; background, use BACKGROUND.
  4112.           ; To have it open the screen to the same size your
  4113.           ; Workbench Screen has (including overscan set with
  4114.           ; MoreRows), use AUTOOVERSCAN.
  4115.           ; If you don't want any screens or windows, use
  4116.           ; QUIET.
  4117.  
  4118.           NOBACKGROUND
  4119.           AUTOOVERSCAN
  4120.           ; QUIET
  4121.  
  4122.           ; For a nice colourful TrapDoor screen, change this as
  4123.           ; desired.
  4124.  
  4125.           COLOURS 2560/4095/10/160
  4126.  
  4127.           ; Point setup: If a call to your boss fails (BUSY,
  4128.           ; VOICE, NO CARRIER ...), you can use these keywords
  4129.           ; to have TrapDoor redial automatically after a
  4130.           ; certain amount of time. Use RETRIES to set the maximum
  4131.           ; number of retries and REDIALDELAY to specify the number
  4132.           ; of seconds to wait between calls.
  4133.  
  4134.           RETRIES 0
  4135.           REDIALDELAY 3
  4136.  
  4137.           ; Enable accounting with ACCOUNTING and specify
  4138.           ; accounting limits. The template for ACCTMAX is:
  4139.           ; ACCTMAX "cost calls-out failed busy nocarrier voice"
  4140.  
  4141.           ACCOUNTING
  4142.           ACCTMAX "3000 20 2 20 5 2"
  4143.  
  4144.           ; Node systems: If you want your TrapDoor to automatically
  4145.           ; start in answer mode when you just "run TrapDoor",
  4146.           ; specify ANSWER
  4147.  
  4148.           ; ANSWER
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.      Example Setup
  4155.  
  4156.  
  4157.      Page 68              TrapDoor's Fifth Manual              Page 68
  4158.  
  4159.  
  4160.           ; Some function key assignments
  4161.  
  4162.           FKEY "1:EMSI"
  4163.           FKEY "11:NOEMSI"
  4164.           FKEY "2:WAZOO"
  4165.           FKEY "12:NOWAZOO"
  4166.           FKEY "3:ZEDZAP ZEDZIP DIRECTZAP"
  4167.           FKEY "13:NOZEDZAP NOZEDZIP NODIRECTZAP"
  4168.           FKEY "4:DIETIFNA"
  4169.           FKEY "14:NODIETIFNA"
  4170.           FKEY "5:BBSMODE SPAWN"
  4171.           FKEY "15:BBSMODE ZMH"
  4172.           FKEY "6:Run \"CE\""
  4173.           FKEY "16:Run \"FFSA Node 2:310/6 ActiveScreen\""
  4174.           FKEY "7:Run \"Execute DLGConfig:Batch/UnPackMail\""
  4175.           FKEY "17:SMODEM |~ATH1|~~~~~~~~~~~~~~~~~|~ATH0|~"
  4176.           FKEY "8:Run \"Execute DLGConfig:Batch/PackMail\""
  4177.           FKEY "18:Run \"Execute DLGConfig:Batch/NComm.batch\""
  4178.           FKEY "9:Run \"Execute DLGConfig:Batch/Poll\""
  4179.           FKEY "19:acctmax \"-1 -1 -1 -1 -1 -1\""
  4180.           FKEY "10:Run \"local\""
  4181.           FKEY "20:Run \"getport -p tr0:\""
  4182.  
  4183.           ; NOTE: Not all possible configuration keywords are used
  4184.           ;       in this example configuration. Please see the
  4185.           ;       chapter "Configuration Commands" for a more
  4186.           ;       detailed and more complete description of
  4187.           ;       TrapDoor's configuration.
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.  
  4213.  
  4214.  
  4215.  
  4216.      Example Setup
  4217.  
  4218.  
  4219.      Page 69              TrapDoor's Fifth Manual              Page 69
  4220.  
  4221.  
  4222.   6. The Outbound Directory   
  4223.  
  4224.        The outbound directory stores packet files (#?.OUT, #?.CUT,
  4225.      #?.DUT, #?.HUT), file attach files (#?.FLO, #?.CLO, #?.DLO,
  4226.      #?.HLO) and request files (#?.REQ).  
  4227.  
  4228.        TrapDoor uses two different methods of naming these files.
  4229.      First, there are the "compatibility" names for compatibility
  4230.      with older packers.  Second, there are full 4-dimensional
  4231.      filenames for state-of-the-art software that wants to make use
  4232.      of full 4-dimensional FidoNet addressing.  
  4233.  
  4234.   6.1. 2-dimensional Filenames     
  4235.  
  4236.        The first eight characters of the filename indicate the net
  4237.      and node number for which this file is designated. These numbers
  4238.      are encoded in hexadecimal and expanded to 4 digits each
  4239.      (leading zeros).  
  4240.  
  4241.        Zone and Point information is not included in these filenames.
  4242.      This is a major disadvantage, but unfortunately many older mail
  4243.      Scanners/Tossers for the Amiga only support this format.  
  4244.  
  4245.   6.2. 4-dimensional Filenames    
  4246.  
  4247.        TrapDoor introduced the concept of four-dimensional filenames
  4248.      several releases ago and many program authors have taken up on
  4249.      it and have included support for this scheme in their software.
  4250.      These 4-dimensional files are named "zone.net.node.point.ext",
  4251.      with all fields in decimal.  
  4252.  
  4253.   6.3. Extensions     
  4254.  
  4255.        File extensions tell TrapDoor how to treat a certain file.  
  4256.  
  4257.   6.4. Packet files    
  4258.  
  4259.        These files contain packed mail (Note: not compressed
  4260.      (ARC)mail). This is often used for matrix mail, as these packets
  4261.      are easily built and matrix mail normally doesn't get so large
  4262.      that it needs compression. They are sent 'as is' to the other
  4263.      system. During the transfer, the name of such a file is changed
  4264.      to "abcdefgh.PKT", where "abcdefgh" is a unique 8-digits
  4265.      hexadecimal number (in fact, a timestamp).  
  4266.  
  4267.           #?.OUT ... Normal, meaning that this packet hasn't been
  4268.                      processed further.  If left unprocessed, it will
  4269.                      be treated the same as a .DUT packet.  
  4270.           #?.HUT ... Hold this packet for pickup by the remote
  4271.                      system.  
  4272.           #?.CUT ... The other system can receive Continuous Mail.  
  4273.           #?.DUT ... Direct, meaning the other system can NOT receive
  4274.                      Continuous Mail.  
  4275.  
  4276.  
  4277.  
  4278.      The Outbound Directory                            Packet files
  4279.  
  4280.  
  4281.      Page 70              TrapDoor's Fifth Manual              Page 70
  4282.  
  4283.  
  4284.   6.5. Flow files    
  4285.  
  4286.        Files are also sent through FidoNet. File attach files tell
  4287.      TrapDoor what files to send (or hold) for whom. File attach
  4288.      files are also called 'flow files' after the .FLO file
  4289.      extension.  
  4290.  
  4291.        Flow files store the path and name of files that should be
  4292.      sent to the other system. Each line in the flow file refers to
  4293.      one file. Additionally, there may be one of the following
  4294.      special characters at the first position in the line (preceeding
  4295.      the path/name), indicating that the file needs special
  4296.      processing after sending.  
  4297.  
  4298.        Valid special characters: 
  4299.  
  4300.           # ... Truncate this file to zero length 
  4301.           ^ ... Delete this file (with logging) 
  4302.           - ... Delete this file (without logging) 
  4303.           @ ... No special processing after sending (but allow
  4304.                 filenote tagging -- see below) 
  4305.           ~ ... Don't send this file (has been sent previously) 
  4306.  
  4307.        Examples: 
  4308.  
  4309.           DH0:Files/outgoing/special/sendme.zoo
  4310.           t:trapdoor.zoo
  4311.           #MAIL:Outbound/FFEB0034.MO1
  4312.           -t:delete.me
  4313.  
  4314.        Flow file extensions are: 
  4315.  
  4316.           #?.FLO ... Normal, meaning that this flow file hasn't been
  4317.                      processed further. If left unprocessed, it will
  4318.                      be treated the same as a .DLO flow file.  
  4319.           #?.HLO ... Hold these files for pickup by the remote
  4320.                      system.  
  4321.           #?.CLO ... The other system can receive Continuous Mail.  
  4322.           #?.DLO ... Direct, meaning the other system can NOT receive
  4323.                      Continuous Mail.  
  4324.  
  4325.   6.6. Compressed Mail files   
  4326.  
  4327.        These files are not automatically sent. Their names must be
  4328.      listed in one of the #?.?LO files. Usually, the filename of
  4329.      these files follows a 2-dimensional naming method: The first 4
  4330.      hex digits contain the difference between the net numbers of the
  4331.      originating and the destination system, the second 4 hex digits
  4332.      the difference between the node numbers.  
  4333.  
  4334.        The extension of compressed mail files is built of the first
  4335.      two digits of the name of a weekday, i.e. MO, TU, WE, TH, FR, SA
  4336.      or SU, plus one decimal digit to prevent duplicates, for
  4337.      example, "MO3" or "FR0".  
  4338.  
  4339.  
  4340.      The Outbound Directory                    Compressed Mail files
  4341.  
  4342.  
  4343.      Page 71              TrapDoor's Fifth Manual              Page 71
  4344.  
  4345.  
  4346.        TrapDoor 1.80 and higher also support 4-dimensional compressed
  4347.      mail bundles. These are named just like the other 4-dimensional
  4348.      files, with the same extension as their 2-dimensional
  4349.      counterpart, for example "2.310.6.4.TU3". The names of
  4350.      4-dimensional compressed mail files must be listed in #?.?LO
  4351.      files, just as with their 2D counterpart.  
  4352.  
  4353.  
  4354.  
  4355.   6.7. Request files    
  4356.  
  4357.        These files are sent to the other system 'as is' for further
  4358.      processing. Each line in these files contains the name of a file
  4359.      you'd like to request from the other system and possibly,
  4360.      following a space and an exclamation mark, a password for the
  4361.      file.  
  4362.  
  4363.        Example: 
  4364.  
  4365.           FILES
  4366.           TRAPDOOR.ZOO
  4367.           SECRET.ARC !ILBM
  4368.  
  4369.   6.8. Examples      
  4370.  
  4371.           0136000b.out ... a normal mail packet for 310/11 
  4372.           01360003.clo ... a file attach file for 310/3, will be sent
  4373.                            as continuous mail 
  4374.           0136000c.hlo ... a file attach file, held for pickup by
  4375.                            310/12 
  4376.  
  4377.        Or, using the 4-dimensional naming scheme: 
  4378.  
  4379.           1.163.109.0.hut ... a normal mail packet, held for pickup
  4380.                               by 1:163/109 
  4381.           2.310.6.5.dlo ..... a direct file attach file for 2:310/6.5 
  4382.           2.310.6.4.MO2 ..... a compressed mail bundle for 2:310/6.4 
  4383.           2.246.3.0.req ..... a request file for 2:246/3 
  4384.  
  4385.  
  4386.  
  4387.  
  4388.   6.9. Outbound File Tagging   
  4389.  
  4390.        Similar to the tag fields that TrapDoor uses for incoming
  4391.      files (please see the next chapter for a detailed description of
  4392.      the tag system), TrapDoor also employs this tag scheme for
  4393.      outgoing files.  
  4394.  
  4395.        Sometimes TrapDoor sends out a file under a different name
  4396.      than the one the file has on the local harddisk. For example,
  4397.      outbound mail packets (those that are called .OUT, .HUT, .DUT or
  4398.      .CUT) will be named .PKT when being transferred. TrapDoor
  4399.      records the new name in a "Name" tag in the filenote of these
  4400.  
  4401.  
  4402.      The Outbound Directory                    Outbound File Tagging
  4403.  
  4404.  
  4405.      Page 72              TrapDoor's Fifth Manual              Page 72
  4406.  
  4407.  
  4408.      files, so that if a file transfer fails, and the file is
  4409.      transmitted a second time, the same name will be used again.  
  4410.  
  4411.        Sometimes it is undesireable that TrapDoor modifies a file's
  4412.      comment. TrapDoor will only change a filenote in the following
  4413.      cases: 
  4414.  
  4415.        - the file is a packet file in the outbound directory 
  4416.  
  4417.        - the file is listed in a flow file, and one of the special
  4418.          characters was specified. If truncating or deletion of the
  4419.          file is not desired, the special character "@" can be used
  4420.          to indicate that filenote tagging is allowed for this file.  
  4421.  
  4422.        TrapDoor will not modify a file's comment if the file is
  4423.      listed in a flow file without any preceding special character.  
  4424.  
  4425.        On the other hand, whenever TrapDoor starts sending a file, it
  4426.      checks the file comment for a "Name" tag. If one exists, the
  4427.      filename will be extracted and the file will be sent under that
  4428.      name. This will happen no matter where the file is stored or
  4429.      whether it was listed in a flow file.  
  4430.  
  4431.        This means you can make TrapDoor send out arbitrary files
  4432.      under any name you want. Just use the filenote command to set an
  4433.      appropriate "Name" tag. For example, 
  4434.  
  4435.          filenote RAM:testdir/myfile.txt "Name file-1.test;" 
  4436.  
  4437.      will tell TrapDoor to send the file "myfile.txt" as
  4438.      "file-1.test". You will need to list "RAM:testdir/myfile.txt" in
  4439.      a flow file as well, of course, so that TrapDoor knows what node
  4440.      the file is for.  
  4441.  
  4442.  
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.  
  4454.  
  4455.  
  4456.  
  4457.  
  4458.  
  4459.  
  4460.  
  4461.  
  4462.  
  4463.  
  4464.      The Outbound Directory                    Outbound File Tagging
  4465.  
  4466.  
  4467.      Page 73              TrapDoor's Fifth Manual              Page 73
  4468.  
  4469.  
  4470.   7. The Inbound Directory   
  4471.  
  4472.        The inbound directory stores all files received from other
  4473.      systems.  TrapDoor does not associate inbound filenames with a
  4474.      certain meaning, this is left for the Scanner/Tosser software
  4475.      (i.e. TrapToss, ConfMail).  
  4476.  
  4477.        TrapDoor currently manages the inbound directory filenames &
  4478.      filenotes like this: 
  4479.  
  4480.         <filename> := <msdos_filename>
  4481.                       '!.' <msdos_filename> '.' <fido_adr>
  4482.         <fido_adr> := <zone> '.' <net> '.' <node> '.' <point>
  4483.         <zone>     := integer
  4484.         <net>      := integer
  4485.         <node>     := integer
  4486.         <point>    := integer
  4487.  
  4488.         <filenote> := <field> <field> ...
  4489.         <field>    := <tag> ' ' <contents> '; '
  4490.         <tag>      := anything_except_space
  4491.         <contents> := anything_except_semicolon
  4492.  
  4493.         Currently defined tags are:
  4494.  
  4495.              FileName
  4496.              From
  4497.              Length
  4498.              Secure
  4499.              Time
  4500.              Trx
  4501.  
  4502.        When a file comes in, it is received under a temporary
  4503.      filename. When the file has been received successfully, it is
  4504.      renamed to the final filename.  Should a file with this name
  4505.      already exist, TrapDoor does the usual filename bumping (see
  4506.      "Bumping Filenames"), but stores the original filename in the
  4507.      filenote in a "FileName" field. Additionally, each inbound file
  4508.      is tagged with a "From" field in the filenote.  
  4509.  
  4510.        When a file transfer fails (carrier lost etc.), the temporary
  4511.      file is renamed to "!.filename.zz.nnn.ooo.pp", where <filename>
  4512.      is the original filename, and <zz.nnn.ooo.pp> is the FidoNet
  4513.      address of the sender. These files are also tagged with a
  4514.      "FileName" field in the FileNote. Additionally, TrapDoor adds a
  4515.      "Length" field to the FileNote, which specifies how long the
  4516.      file should be.  
  4517.  
  4518.        When TrapDoor begins to receive a new file, it tries to find a
  4519.      "!.filename.zz.nnn.ooo.pp" file that matches the incoming file.
  4520.      If such a file exists, and the filesize compares successfully
  4521.      (remember: "Length" tag in the filenote!), TrapDoor will resume
  4522.      transfer (ZedZap sessions) at the end of the file. FTS-1 and
  4523.      DietIfna can't resume transfer, but you can abort such a file
  4524.  
  4525.  
  4526.      The Inbound Directory
  4527.  
  4528.  
  4529.      Page 74              TrapDoor's Fifth Manual              Page 74
  4530.  
  4531.  
  4532.      transfer and later on resume with ZedZap.  
  4533.  
  4534.        When TrapDoor resumes receiving a file, it will first rename
  4535.      it to a temporary filename again and clear the filenote. Further
  4536.      actions are taken as described above.  
  4537.  
  4538.        The "Secure" tag stores the security measures under which a
  4539.      file was received. Files received from systems listed in the
  4540.      nodelist get the "NL" flag, and files received during
  4541.      password-protected sessions are marked "PW". Both flags can be
  4542.      set if a file was received from a listed system in a
  4543.      password-protection session, in which case they will be
  4544.      separated by a comma (",").  
  4545.  
  4546.        The "Trx" tag is used to store the Transaction ID of the
  4547.      session in which the file was received. Every session, or
  4548.      "transaction" with another system is associated with a unique
  4549.      identifier, the "transaction id". This identifier is also listed
  4550.      in the logfile as "TrxID". A transaction id consists of one
  4551.      single hexadecimal number, plus possibly a slash and another
  4552.      hexadecimal number giving the transaction id which the remote
  4553.      system associated with this particular transaction. The latter
  4554.      is only shown if the other end sent us their transaction id,
  4555.      which can only happen in an EMSI handshake.  
  4556.  
  4557.        When a file is received with Zmodem (or any of its
  4558.      derivatives), the original date and time of the file is also
  4559.      transferred and will be stored in a "Time" tag by TrapDoor. The
  4560.      number behind the "Time" tag is a hexadecimal unix timestamp
  4561.      (seconds since 1.1.1970, midnight).  
  4562.  
  4563.        Please note that the order of the filenote fields is
  4564.      insignificant.  
  4565.  
  4566.        Examples: 
  4567.  
  4568.           Normal inbound file, received from a known node with
  4569.           password-protection:
  4570.                ffeb0034.mo1
  4571.                : From 2:310/3; Secure NL,PW; Trx 27b23ba7;
  4572.  
  4573.           Bumped inbound file:
  4574.                ffeb0034.mo1,1
  4575.                : From 2:310/3; FileName ffeb0034.mo1; Trx 27c138f7/27c138fb;
  4576.  
  4577.           Aborted transfer:
  4578.                !.ffeb0034.mo1.2.310.3.0
  4579.                : FileName ffeb0034.mo1; Length 23862; Trx 27c139ae;
  4580.  
  4581.        This format should be rather flexible if future extensions
  4582.      have to be added (limit is 80 chars for all the filenote
  4583.      fields), but still remains totally compatible with ConfMail &
  4584.      other utilities that assume MS-Dos style filenames.  
  4585.  
  4586.  
  4587.  
  4588.      The Inbound Directory
  4589.  
  4590.  
  4591.      Page 75              TrapDoor's Fifth Manual              Page 75
  4592.  
  4593.  
  4594.   7.1. Bumping Filenames    
  4595.  
  4596.        TrapDoor does not overwrite inbound files. Instead, the
  4597.      incoming filename is "bumped", i.e. a unique name is created by
  4598.      cautiously modifying the original filename until a new, unique
  4599.      name is found.  
  4600.  
  4601.        Bumping proceeds like this: 
  4602.  
  4603.        (a) If the filename matches "#?.?UT", it is renamed to a
  4604.            random "#?.PKT" file. This is necessary, as some MS-Dos
  4605.            software does not rename .OUT files into .PKT when
  4606.            transmitting them with the DietIfna protocol. Therefore,
  4607.            TrapDoor tries to correct this mistake. After this step,
  4608.            bumping continues at (b). [00bf13f4.OUT -> 27bc34f5.PKT] 
  4609.  
  4610.        The following steps will only be performed as long as the name
  4611.        is not unique, i.e. as long as there exists already a file
  4612.        with that name.  
  4613.  
  4614.        (b) If the filename matches "#?.PKT", it is given some random
  4615.            hexadecimal number plus the ".PKT" extension again. Thus,
  4616.            packet files stay packet files, even when bumped. Only if
  4617.            a unique name cannot be found within ten tries, method (d)
  4618.            is used for renaming the file. [27bc34f5.PKT ->
  4619.            28c39d7f.PKT] 
  4620.  
  4621.        (c) If the filename matches
  4622.            "#?.(MO|TU|WE|TH|FR|SA|SU)([0-9])", the very last digit of
  4623.            the filename is modified. If a unique name cannot be found
  4624.            by changing the last digit, method (d) is used.
  4625.            [00bf3f55.mo0 -> 00bf3f55.mo1] 
  4626.  
  4627.        (d) If the filename is not unique, TrapDoor will append a
  4628.            comma (",") and a number. The number will be incremented
  4629.            as long as the name is not unique. [test.txt -> test.txt,1
  4630.            -> test.txt,2 -> etc.] 
  4631.  
  4632.        (e) continue at (d) until a unique name is found.  
  4633.  
  4634.  
  4635.  
  4636.  
  4637.  
  4638.  
  4639.  
  4640.  
  4641.  
  4642.  
  4643.  
  4644.  
  4645.  
  4646.  
  4647.  
  4648.  
  4649.  
  4650.      The Inbound Directory                        Bumping Filenames
  4651.  
  4652.  
  4653.      Page 76              TrapDoor's Fifth Manual              Page 76
  4654.  
  4655.  
  4656.   8. Bugs? Poof! They're all features! 
  4657.  
  4658.        Most problems we have encountered are caused by wrong or
  4659.      incomplete RS232 cabling, modem settings, and last, but not
  4660.      least, people not reading the documentation. Be sure to
  4661.      especially examine the chapter about the modem carefully if you
  4662.      encounter problems. Please also read the frequently asked
  4663.      questions in file "TrapDoor.FAQ".  
  4664.  
  4665.        There is a minor inconvenience for people using NTSC Amigas:
  4666.      You have to change the default setting of STATWINDOW, as this
  4667.      window won't open on a standard non-interlaced NTSC screen.  
  4668.  
  4669.        If you find that you have trouble communicating with another
  4670.      Fidonet system, you might try using different protocols.
  4671.      Experiment with the (NO)EMSI, (NO)WAZOO, (NO)TRAPZAP,
  4672.      (NO)DIRECTZAP, (NO)ZEDZAP, (NO)ZEDZIP and (NO)WAZOO keywords.  
  4673.  
  4674.        (NO)MAXBAUD does not have any effect if used in custom
  4675.      configuration entries (set via setconfig). You need to set a
  4676.      MINBAUD value instead. So, instead of 
  4677.  
  4678.           setconfig 2:310/6 "NOMAXBAUD"     ; WRONG! 
  4679.      use 
  4680.           setconfig 2:310/6 "MINBAUD 2400"  ; much better.  
  4681.  
  4682.        TrapDoor usually runs with the standard 4000 bytes stack size.
  4683.      Should you experience strange hangups, crashes or Guru
  4684.      Meditations, try raising the stack size with the CLI command
  4685.      "Stack" before running TrapDoor.  
  4686.  
  4687.        If you place a call using a telephone number (as opposed to
  4688.      calling via a nodelist), be sure to also set the BOSS parameter
  4689.      to the node number of the system you are calling, and PASSWORD
  4690.      to the correct password (or "") for that node. Here is an
  4691.      example: 
  4692.  
  4693.           TrapDoor Call 02236-87178 Boss 2:310/48 Password "" 
  4694.  
  4695.  
  4696.  
  4697.             "Remember, any minor imperfections in this product
  4698.               are just evidence of its hand crafted nature."
  4699.  
  4700.  
  4701.  
  4702.  
  4703.   8.1. Real Bugs    
  4704.  
  4705.        When sending in bug reports, please state exactly under what
  4706.      circumstances the bug occurred, what equipment was used and what
  4707.      happened. If possible, please give us a step-by-step description
  4708.      of how to reproduce the bug. Statements like "TrapDoor sometimes
  4709.      crashes on my system" don't help us to track down the problem.  
  4710.  
  4711.  
  4712.      Bugs?                              There are no bugs in our code.
  4713.  
  4714.  
  4715.      Page 77              TrapDoor's Fifth Manual              Page 77
  4716.  
  4717.  
  4718.   9. Past & Future   
  4719.  
  4720.        TrapDoor started back in spring 1989, when our boss got his
  4721.      first dual standard HST modem. Suddenly, BinkleyTerm Amiga
  4722.      stopped working, it could not successfully send/receive files.
  4723.      So mjl and I sat down and started writing a new mailer that
  4724.      would overcome this and many other disadvantages of BinkleyTerm
  4725.      Amiga, at that time the only mailer available for the Amiga.
  4726.      First, we created a point version; simple to use, it allowed you
  4727.      to setup a state-of-the-art point system. The point version was
  4728.      released in October 1989, and no major bugs have been found.
  4729.      That was version is 1.11; Registered users were shipped 1.12,
  4730.      which was almost the same, except the ShareWare reminders, which
  4731.      always open when you start the unregistered version, had been
  4732.      removed in that version.  
  4733.  
  4734.        After the enormous feedback we received from the first
  4735.      version, we decided we'd go ahead and make TrapDoor a fully
  4736.      node-capable mailer. We implemented the basic FidoNet protocol
  4737.      that all mailers must support, FTS-1, added ARexx capabilities,
  4738.      bbs spawning, nodelist support and all the other nice features
  4739.      noone wants to miss anymore. The first node capable version of
  4740.      TrapDoor 1.50, was followed by TrapDoor 1.80 a year later. This
  4741.      version enhanced the original node version with a couple of
  4742.      exciting new features: it offered new nodelist support via the
  4743.      traplist.library, improved ARexx commands, new bbs handling
  4744.      modes, special dialer and special node-dependent configuration
  4745.      options, EMSI session handshake, and lots more. As always, this
  4746.      node version could also be used in a point environment.  
  4747.  
  4748.        As always, bugs creep into software, and neither TrapDoor 1.80
  4749.      nor the next version, 1.83 were totally bug-free. So we had to
  4750.      sit down and look into these little problems, plus include some
  4751.      more features here and there as they came in handy. So this is
  4752.      our fifth release version, and this number is also the reason
  4753.      for the name of this TrapDoor's manual.  
  4754.  
  4755.        Of course, development does not stop here. We will continue to
  4756.      improve TrapDoor and its related utilities to give you the
  4757.      hopefully most advanced mailer on the Amiga. Our future work
  4758.      will go especially in the direction of providing you with an
  4759.      integrated package which takes away a lot of the hassle
  4760.      currently involved in writing AmigaDOS or ARexx scripts to
  4761.      handle event scheduling and putting together the different tools
  4762.      necessary for a FidoNet system. Depending on your ShareWare
  4763.      registration efforts and our time permitting, one day there will
  4764.      hopefully be a much better and more beautiful TrapDoor II.  
  4765.  
  4766.        When this new and majorly improved TrapDoor becomes ready,
  4767.      already registered users will receive the new version for a
  4768.      moderate update fee.  
  4769.  
  4770.  
  4771.  
  4772.  
  4773.  
  4774.      Past & Future
  4775.  
  4776.  
  4777.      Page 78              TrapDoor's Fifth Manual              Page 78
  4778.  
  4779.  
  4780.   10. Registration     
  4781.  
  4782.        TrapDoor is a copyrighted product that has been made available
  4783.      to you under the concept of "Shareware". It has never been, nor
  4784.      will it ever be in the "Public Domain". You are granted a
  4785.      limited licence in order to evaluate these programs. If, after a
  4786.      3 or 4 week period of evaluation, you find that TrapDoor suits
  4787.      your telecommunication needs, please register. By cooperating
  4788.      with this concept you help to ensure continued development of
  4789.      this product.  
  4790.  
  4791.        Registered users will be shipped a disk with the latest
  4792.      release version of TrapDoor together with a keyfile. This
  4793.      keyfile, once copied to your system, will disable the ShareWare
  4794.      reminders that always open when you start or quit TrapDoor.  
  4795.  
  4796.        Site licence information for commercial and government use as
  4797.      well as source code licences can be obtained directly from the
  4798.      authors.  
  4799.  
  4800.        No person(s) or businesses other than the authors are
  4801.      authorized to accept any registration or distribution fees in
  4802.      any form whatsoever, except the official registration and
  4803.      support centers as specified by the authors. The only people who
  4804.      will be acknowledged as registered users are those who have sent
  4805.      ATS 350,- (plus another ATS 150,- if you send foreign cheques or
  4806.      money orders) to: 
  4807.  
  4808.                            TrapDoor Development
  4809.                             Maximilian Hantsch
  4810.                       Matzleinsdorfer Platz 3-4/3/10
  4811.                                 A-1050 Wien
  4812.                              Austria / Europe
  4813.  
  4814.      or registered at one of the registration and support centers as
  4815.      specified by the authors. A list of these can be found in the
  4816.      file "SupportCenters.txt".  
  4817.  
  4818.        As one of the safest and possibly easiest ways to send in your
  4819.      registration fee from other countries, we would suggest an
  4820.      international postal money order -- your local post office will
  4821.      happily provide you with more information about this. It also
  4822.      has the advantage that the exchange of currencies is handled
  4823.      automatically and the surcharge is negligible.  
  4824.  
  4825.        Alternatively, you can either send us a Eurocheque payable to
  4826.      Maximilian Hantsch in Austrian Schillings or have your bank
  4827.      transfer the registration fee to the "Österreichische
  4828.      Postsparkasse (PSK)" (BLZ 60000), account 6.777.234, "Maximilian
  4829.      Hantsch". Beware: international transfers via banks are rather
  4830.      expensive.  
  4831.  
  4832.  
  4833.  
  4834.  
  4835.  
  4836.      Registration
  4837.  
  4838.  
  4839.      Page 79              TrapDoor's Fifth Manual              Page 79
  4840.  
  4841.  
  4842.        Note: IF YOU SEND CHEQUES, PLEASE SEND ONLY EUROCHEQUES MADE
  4843.      OUT IN AUSTRIAN SCHILLINGS! We have to impose a surcharge of ATS
  4844.      150,- on all other cheques, money orders or bank drafts.  
  4845.  
  4846.        Until now, we have accepted other foreign cheques, money
  4847.      orders and bank drafts as well, but our bank has raised the
  4848.      charge for these by more than 50% over the past two years to
  4849.      more than ATS 100,- per cheque. We can no longer afford this and
  4850.      are thus forced to pass on this charge. Sorry.  
  4851.  
  4852.        In any case, be sure to provide us with your name, address,
  4853.      fido-nodenumber and international phone number for our files.
  4854.      You can send this information via electronic mail, if you wish.
  4855.      If you don't mind, this data will be stored and processed in
  4856.      electronic form. There is also a sample registration form you
  4857.      can fill out in the file "Registration.txt".  
  4858.  
  4859.        Please allow up to eight weeks for delivery.  
  4860.  
  4861.  
  4862.  
  4863.  
  4864.  
  4865.  
  4866.  
  4867.  
  4868.  
  4869.  
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.                   You, too, can have a receding hairline,
  4878.                         suffer a nervous breakdown,
  4879.                 and precipitate disputes with your spouse.
  4880.                            Here is all you need.
  4881.  
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.  
  4889.  
  4890.  
  4891.  
  4892.  
  4893.  
  4894.  
  4895.  
  4896.  
  4897.  
  4898.      Registration
  4899.  
  4900.  
  4901.      Page 80              TrapDoor's Fifth Manual              Page 80
  4902.  
  4903.  
  4904.   11. Politics     
  4905.  
  4906.        This chapter tells you about the allowed methods of
  4907.      Distribution for TrapDoor, about where to find Support, lists
  4908.      the exact terms of the software Licence, under which you may use
  4909.      the software, and finally, there is an important Disclaimer in
  4910.      this chapter too.  
  4911.  
  4912.  
  4913.  
  4914.   11.1. Distribution     
  4915.  
  4916.        In a nutshell, TrapDoor may be distributed freely as long as
  4917.      the following restrictions are met: 
  4918.  
  4919.        The distributor may only charge a fee up to the costs of
  4920.      obtaining a public domain diskette from Fred Fish. The
  4921.      distributor agrees to cease distributing the programs and data
  4922.      involved if requested to do so by the authors. The distributor
  4923.      may only distribute an unmodified copy of the original program,
  4924.      with all the supplied documentation and copyright notices
  4925.      intact.  
  4926.  
  4927.        For more details, see the chapter called "Licence".  
  4928.  
  4929.  
  4930.  
  4931.   11.2. Support     
  4932.  
  4933.        The latest version of TrapDoor (with all its associated tools)
  4934.      is always available for filerequest from FidoNet node 2:310/6,
  4935.      "The Mad House" under the magic filename "TRAPDOOR".  
  4936.  
  4937.        If you have any suggestions, bug reports etc., feel free to
  4938.      contact the authors of TrapDoor at the address given in the
  4939.      chapter "Registration". Additionally, you can reach us at: 
  4940.  
  4941.           Maximilian Hantsch      Martin Laubach
  4942.           Fido: 2:310/6           Fido: 2:310/3.14
  4943.           Uucp: max@madvie.co.at  Uucp: mjl@alison.co.at
  4944.  
  4945.        Also, there is a FidoNet Echomail conference called TRAPDOOR,
  4946.      which should be available at major backbones. This conference is
  4947.      in English and intended for the users of TrapDoor. There, you
  4948.      can freely exchange your experience with TrapDoor, discuss
  4949.      future enhancements you would like to see etc. Both authors will
  4950.      participate in the conference and try to assist you. The
  4951.      availability of new versions of TrapDoor will be announced
  4952.      there, too.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957.  
  4958.  
  4959.  
  4960.      Politics                                              Support
  4961.  
  4962.  
  4963.      Page 81              TrapDoor's Fifth Manual              Page 81
  4964.  
  4965.  
  4966.   11.3. Licence     
  4967.  
  4968.        1. This licence applies to the product called "TrapDoor", a
  4969.      set of programs for the Amiga computer, published by Maximilian
  4970.      Hantsch and Martin Laubach under the concepts of ShareWare, and
  4971.      the accompanying documentation, example files and anything else
  4972.      that comes with the original distribution. The terms "Programs"
  4973.      and "TrapDoor" below, refer to this product. The licencee is
  4974.      addressed as "you".  
  4975.  
  4976.        2. You may copy and distribute verbatim copies of the
  4977.      programs' executable code and documentation as you receive it,
  4978.      in any medium, provided that you conspicuously and appropriately
  4979.      publish only the original, unmodified programs, with all
  4980.      copyright notices and disclaimers of warranty intact and
  4981.      including all the accompanying documentation, example files and
  4982.      anything else that came with the original.  
  4983.  
  4984.        3. You may not copy and/or distribute these programs without
  4985.      the accompanying documentation and other additional files that
  4986.      came with the original. You may not copy and/or distribute
  4987.      modified versions of these programs.  
  4988.  
  4989.        4. You may not copy, modify, sublicence, distribute or
  4990.      transfer the programs except as expressly provided under this
  4991.      licence. Any attempt otherwise to copy, modify, sublicence,
  4992.      distribute or transfer the programs is void, and will
  4993.      automatically terminate your rights to use the programs under
  4994.      this licence. However, parties who have received copies, or
  4995.      rights to use copies, from you under this licence will not have
  4996.      their licences terminated so long as such parties remain in full
  4997.      compliance.  
  4998.  
  4999.        5. By copying, distributing and/or using the programs you
  5000.      indicate your acceptance of this licence to do so, and all its
  5001.      terms and conditions.  
  5002.  
  5003.        6. Each time you redistribute the programs, the recipient
  5004.      automatically receives a licence from the original licensor to
  5005.      copy, distribute and/or use the programs subject to these terms
  5006.      and conditions.  You may not impose any further restrictions on
  5007.      the recipients' exercise of the rights granted herein.  
  5008.  
  5009.        7. You may not disassemble, decompile, re-source or otherwise
  5010.      reverse engineer the programs.  
  5011.  
  5012.        8. You may use the programs for a period of up to 30 days for
  5013.      evaluation.  After that, you have to register.  
  5014.  
  5015.        9. If you wish to incorporate parts of the programs into other
  5016.      programs, write to the authors to ask for permission.  
  5017.  
  5018.        10. You agree to cease distributing the programs and data
  5019.      involved if requested to do so by the authors.  
  5020.  
  5021.  
  5022.      Politics                                              Licence
  5023.  
  5024.  
  5025.      Page 82              TrapDoor's Fifth Manual              Page 82
  5026.  
  5027.  
  5028.        11. You may charge a fee to recover distribution costs. The
  5029.      fee for diskette distribution may not be more than the cost to
  5030.      obtain a public domain diskette from Fred Fish.  
  5031.  
  5032.  
  5033.   11.4. No Warranty    
  5034.  
  5035.        THERE IS NO WARRANTY FOR THE PROGRAMS, TO THE EXTENT PERMITTED
  5036.      BY APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE
  5037.      COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAMS "AS
  5038.      IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
  5039.      INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  5040.      MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE
  5041.      ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAMS IS
  5042.      WITH YOU.  SHOULD THE PROGRAMS PROVE DEFECTIVE, YOU ASSUME THE
  5043.      COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.  
  5044.  
  5045.        IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  5046.      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  5047.      REDISTRIBUTE THE PROGRAMS AS PERMITTED ABOVE, BE LIABLE TO YOU
  5048.      FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
  5049.      CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
  5050.      THE PROGRAMS (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
  5051.      BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
  5052.      PARTIES OR A FAILURE OF THE PROGRAMS TO OPERATE WITH ANY OTHER
  5053.      PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED
  5054.      OF THE POSSIBILITY OF SUCH DAMAGES.  
  5055.  
  5056.  
  5057.   11.5. Disclaimer     
  5058.  
  5059.        No warranty, either express or implied, is made with respect
  5060.      to the fitness or merchantability of TrapDoor.  
  5061.  
  5062.        Maximilian Hantsch and Martin Laubach (referred to as "the
  5063.      authors"), reserve the right to not develop any future versions
  5064.      of TrapDoor.  
  5065.  
  5066.        The authors will try to make a good faith attempt at
  5067.      correcting any problems if any are discovered, but are in no way
  5068.      required, nor bound to correct them.  
  5069.  
  5070.        The authors neither assume nor accept any responsibility for
  5071.      the use or misuse of these programs. They also will not be held
  5072.      liable for damages or any compensation beyond the original
  5073.      registration fee due to loss of profit or any other damages
  5074.      arising out of the use, or inability to use these programs.  
  5075.  
  5076.        Neither Maximilian Hantsch nor Martin Laubach will be liable
  5077.      for any damage arising from the failure of these programs to
  5078.      perform as described, or any destruction of other programs or
  5079.      data residing on a system attempting to run the programs.  While
  5080.      we know of no damaging errors, the user of these programs uses
  5081.      it at his or her own risk.  
  5082.  
  5083.  
  5084.      Politics                                           Disclaimer
  5085.  
  5086.  
  5087.      Page 83              TrapDoor's Fifth Manual              Page 83
  5088.  
  5089.  
  5090.   12. Acknowledgements     
  5091.  
  5092.        The following names are either trademarks or the efforts of
  5093.      the person and/or company listed: 
  5094.  
  5095.        Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  5096.        ARexx by William S. Hawes, Wishful Thinking Development Corp.
  5097.        BinkleyTerm Amiga by Jürgen Hermann.
  5098.        BinkleyTerm by Alan D. Applegate, Robert Hartman
  5099.                       and Vincent Perriello.
  5100.        Chameleon Editor by Jürgen Hermann.
  5101.        ConfMail by Bob Hartman, Spark Software Inc.
  5102.        D'Bridge by Chris Irwin.
  5103.        Diamonds & Pearls by Prince.
  5104.        DLG Professional by TelePro Technologies.
  5105.        EchoMail by Jeff Rush.
  5106.        EMSI by the EMSC.
  5107.        Excelsior! BBS by Sycom Design.
  5108.        feline Helsingissä.
  5109.        Fido and FidoNet are trademarks of Tom Jennings, Fido Software.
  5110.        FrontDoor by Joaquim Homrighausen.
  5111.        "Hey, there's Another Feature!"-Award: Roger Nordin.
  5112.        Inspiration by US Robotics' Courier HST Dual Standard.
  5113.        Jessi, our TrapBunny ;)
  5114.        Kittens, Katze and Yvonne.
  5115.        Licence Agreement inspired by Jack Radigan
  5116.                       and the GNU General Public License.
  5117.        Many Thanks to Alan Bland, Alexander Holy, Arnout Grootveld,
  5118.                       Eric De Jong, Fredrik Kjellberg, Heiko Richter,
  5119.                       Iljitsch van Beijnum, Johannes Mistelbauer,
  5120.                       Lawrence Freeman, Manfred Schädler, Many Others,
  5121.                       Marcus Kuba, Peer Hasselmeyer, Peter Deane,
  5122.                       Roger Nordin, Tony Miller, Werner Schlagnitweit.
  5123.        Moral Support by MTNLION.
  5124.        More Moral Support from Tasmania.
  5125.        MS-DOS is a trademark of Microsoft Corporation.
  5126.        Neelie yekom.
  5127.        Opus by Wynn Wagner III.
  5128.        OwnDevUnit.library by Christopher A. Wichura.
  5129.        Paragon by Jon Radoff.
  5130.        Proofreading of this manual by Arnout Grootveld.
  5131.        SEAlink, SEAdog are trademarks of System Enhancement Associates.
  5132.        Spaces, Pigs, Ships and their Stars.
  5133.        Special Thanks to all our Registered Users.
  5134.        TrapDog by Peter Wlcek.
  5135.        TrapDoor is a registered trademark of Maximilian Hantsch
  5136.                                          and Martin Laubach.
  5137.        TrapList, TrapPoll, TrapTell and traplist.library
  5138.                       by Maximilian Hantsch and Martin Laubach.
  5139.        TrapToss by René Hexel.
  5140.        Typesetting of this manual by proff.
  5141.        Warm Wet Circles by Marillion.
  5142.        YooHoo by Wynn Wagner III.
  5143.        ZModem by Chuck Forsberg.
  5144.  
  5145.  
  5146.      Acknowledgements
  5147.  
  5148.  
  5149.      Road Map             TrapDoor's Fifth Manual             paM daoR
  5150.  
  5151.  
  5152.   Road Map
  5153.  
  5154.  
  5155.         1. Introduction    .....................................    2
  5156.         2. Installation    .....................................    2
  5157.            2.1. The Keyfile   ..................................    3
  5158.            2.2. Point Setup   ..................................    3
  5159.            2.3. Node Setup   ...................................    4
  5160.            2.4. The Modem   ....................................    5
  5161.            2.5. Example Modem Settings    ......................    6
  5162.               2.5.1. Ordinary 2400 Baud Modems .................    6
  5163.               2.5.2. US Robotics Courier HST Modems.............    7
  5164.               2.5.3. Internal Supra 2400zi Modems ..............    8
  5165.               2.5.4. Supra V.32bis   ...........................    8
  5166.               2.5.5. ZyXEL Modems   ............................    9
  5167.         3. Basics    ...........................................   10
  5168.            3.1. FidoNet    .....................................   10
  5169.            3.2. Mailer Operation   .............................   10
  5170.            3.3. Nodelist    ....................................   10
  5171.            3.4. Compatibility    ...............................   10
  5172.            3.5. Custom Configuration Entries  ..................   11
  5173.            3.6. Accounting    ..................................   12
  5174.            3.7. Security    ....................................   13
  5175.            3.8. File Tagging   .................................   13
  5176.            3.9. Refusing and Pickup Preferences ................   14
  5177.            3.10. The Keyboard   ................................   14
  5178.            3.11. Return Values   ...............................   16
  5179.            3.12. Fax and Voice Support .........................   16
  5180.            3.13. Automatic Buffer Sizing  ......................   16
  5181.            3.14. ARexx    ......................................   17
  5182.            3.15. Dial Scripts   ................................   18
  5183.            3.16. Multiple Lines   ..............................   19
  5184.            3.17. Logfile Buffering   ...........................   21
  5185.            3.18. OwnDevUnit.library Support   ..................   21
  5186.         4. Configuration Commands   ............................   22
  5187.            4.1. Embedded Percent-Commands   ....................   23
  5188.            4.2. Modem Commands   ...............................   24
  5189.            4.3. Keywords    ....................................   25
  5190.               4.3.1. (NO)7WIRE    ..............................   25
  5191.               4.3.2. ABORT signals    ..........................   25
  5192.               4.3.3. (NO)ABS    ................................   25
  5193.               4.3.4. (NO)ACCOUNTING    .........................   25
  5194.               4.3.5. ACCTMAX limits    .........................   26
  5195.               4.3.6. ADJUST factor    ..........................   26
  5196.               4.3.7. AFTERSESSION command-string    ............   27
  5197.               4.3.8. AKA akalist    ............................   27
  5198.               4.3.9. (NO)ALLOWREFUSING    ......................   27
  5199.               4.3.10. ANSWER    ................................   28
  5200.               4.3.11. ARQSTRING string    ......................   28
  5201.               4.3.12. (NO)AUTOADJUST    ........................   28
  5202.               4.3.13. (NO)AUTOOVERSCAN    ......................   28
  5203.               4.3.14. (NO)BACKGROUND    ........................   28
  5204.               4.3.15. BANNER bannerline    .....................   29
  5205.               4.3.16. BAUD baudrate    .........................   29
  5206.  
  5207.  
  5208.      Road Map
  5209.  
  5210.  
  5211.      Road Map             TrapDoor's Fifth Manual             paM daoR
  5212.  
  5213.  
  5214.               4.3.17. BBSCHAR character    .....................   29
  5215.               4.3.18. BBSCOMMAND command-string    .............   30
  5216.               4.3.19. BBSINOUT device    .......................   30
  5217.               4.3.20. BBSMESSAGE text    .......................   30
  5218.               4.3.21. BBSMODE mode    ..........................   30
  5219.               4.3.22. (NO)BEEPDISPLAY    .......................   31
  5220.               4.3.23. BOSS zone:net/node.point    ..............   31
  5221.               4.3.24. CALL number | fido-address  ..............   31
  5222.               4.3.25. COLORS palette-specification    ..........   33
  5223.               4.3.26. COLOURS palette-specification    .........   33
  5224.               4.3.27. CONCEPTS    ..............................   33
  5225.               4.3.28. CONFIG config-file    ....................   33
  5226.               4.3.29. COST cost-value    .......................   34
  5227.               4.3.30. CREDITS    ...............................   34
  5228.               4.3.31. DIALER command-string    .................   34
  5229.               4.3.32. DIALTIMEOUT seconds    ...................   34
  5230.               4.3.33. (NO)DIETIFNA    ..........................   35
  5231.               4.3.34. (NO)DIRECTZAP    .........................   35
  5232.               4.3.35. DISPLAYID integer    .....................   35
  5233.               4.3.36. DROPBBSSECS seconds    ...................   36
  5234.               4.3.37. (NO)DSR    ...............................   36
  5235.               4.3.38. (NO)EMSI    ..............................   36
  5236.               4.3.39. (NO)ESCAPERESETSMODEM    .................   37
  5237.               4.3.40. (NO)FASTEMSI    ..........................   37
  5238.               4.3.41. FAXCOMMAND commandline    ................   37
  5239.               4.3.42. FAXSTRING string    ......................   38
  5240.               4.3.43. FKEY function-key-assignment    ..........   38
  5241.               4.3.44. (NO)FLOATLOCK    .........................   38
  5242.               4.3.45. (NO)FORBID...    .........................   39
  5243.               4.3.46. FREQUEST command-string    ...............   39
  5244.               4.3.47. HELP    ..................................   39
  5245.               4.3.48. (NO)IMMEDIATE    .........................   40
  5246.               4.3.49. INBOUND inbound-mail-directory    ........   40
  5247.               4.3.50. (NO)INTERLACE    .........................   41
  5248.               4.3.51. (NO)KEEPALL    ...........................   41
  5249.               4.3.52. (NO)KEEPXMAIL    .........................   41
  5250.               4.3.53. (NO)KIWIPULSE    .........................   41
  5251.               4.3.54. (NO)LISTEN    ............................   41
  5252.               4.3.55. (NO)LOCK    ..............................   41
  5253.               4.3.56. LOG level:text    ........................   42
  5254.               4.3.57. LOGCALLERID filename    ..................   42
  5255.               4.3.58. LOGFILE filename    ......................   42
  5256.               4.3.59. LOGLEVEL group:level    ..................   42
  5257.               4.3.60. LOGWINDOW window-specification    ........   43
  5258.               4.3.61. (NO)MAXBAUD    ...........................   43
  5259.               4.3.62. MAXLOGLINES number    ....................   44
  5260.               4.3.63. MAXLOGSECS seconds    ....................   44
  5261.               4.3.64. MINBAUD baudrate    ......................   45
  5262.               4.3.65. MODEMANSWER modem-answer-string    .......   45
  5263.               4.3.66. MODEMDIALPRE modem-pre-dial-string    ....   45
  5264.               4.3.67. MODEMDIALPOST modem-post-dial-string    ..   45
  5265.               4.3.68. MODEMHANGUP modem-hangup-string    .......   45
  5266.               4.3.69. MODEMINIT modem-init-string    ...........   46
  5267.               4.3.70. MODEMRESETINTERVAL minutes    ............   46
  5268.  
  5269.  
  5270.      Road Map
  5271.  
  5272.  
  5273.      Road Map             TrapDoor's Fifth Manual             paM daoR
  5274.  
  5275.  
  5276.               4.3.71. NAME board's name   ......................   46
  5277.               4.3.72. NODE zone:net/node.point    ..............   46
  5278.               4.3.73. NODELIST nodelist-directory    ...........   47
  5279.               4.3.74. OUTBOUND outbound-mail-directory    ......   47
  5280.               4.3.75. PASSWORD password    .....................   47
  5281.               4.3.76. PICKUP what    ...........................   48
  5282.               4.3.77. PUBSCREENNAME name    ....................   48
  5283.               4.3.78. QUIT    ..................................   48
  5284.               4.3.79. (NO)QUIET    .............................   49
  5285.               4.3.80. REDIALDELAY seconds    ...................   49
  5286.               4.3.81. RESET    .................................   49
  5287.               4.3.82. RETRIES count    .........................   49
  5288.               4.3.83. REXXNAME portname    .....................   49
  5289.               4.3.84. RINGCOMMAND commandline    ...............   50
  5290.               4.3.85. RINGINGS number    .......................   50
  5291.               4.3.86. RINGS number    ..........................   50
  5292.               4.3.87. RUN command-string    ....................   50
  5293.               4.3.88. SCLEAR    ................................   51
  5294.               4.3.89. SCREENMODE mode    .......................   51
  5295.               4.3.90. SCREENTOBACK    ..........................   52
  5296.               4.3.91. SCREENTOFRONT    .........................   52
  5297.               4.3.92. SERIALBUFSIZE size-in-bytes    ...........   52
  5298.               4.3.93. SERIALFLAGS serial-flags    ..............   52
  5299.               4.3.94. SERIALNAME serial-device-name    .........   52
  5300.               4.3.95. SERIALUNIT serial-unit-number    .........   53
  5301.               4.3.96. (NO)SHARED    ............................   53
  5302.               4.3.97. (NO)SHOWREXX    ..........................   53
  5303.               4.3.98. SLINE    .................................   53
  5304.               4.3.99. SLOWMODEM modem-command-delay    .........   53
  5305.               4.3.100. SMODEM modem-command    .................   54
  5306.               4.3.101. (NO)SNIFFARQ    .........................   54
  5307.               4.3.102. SPAWN command-string    .................   54
  5308.               4.3.103. STARTSESSION    .........................   54
  5309.               4.3.104. STATUS what    ..........................   55
  5310.               4.3.105. STATWINDOW window-specification    ......   56
  5311.               4.3.106. STIMEOUT timeout    .....................   56
  5312.               4.3.107. (NO)STRIPDASHES    ......................   56
  5313.               4.3.108. SWAIT string    .........................   57
  5314.               4.3.109. (NO)SWEPULSE    .........................   57
  5315.               4.3.110. SWRITE string    ........................   57
  5316.               4.3.111. SYSOP sysop's-name    ...................   57
  5317.               4.3.112. TASKPRI priority    .....................   57
  5318.               4.3.113. TESTFREQ    .............................   57
  5319.               4.3.114. (NO)TIMESTAMP    ........................   58
  5320.               4.3.115. (NO)TRAPZAP    ..........................   58
  5321.               4.3.116. TURNAROUND command-string    ............   58
  5322.               4.3.117. (NO)(UN)LISTEN    .......................   59
  5323.               4.3.118. (NO)USESYSFONT    .......................   59
  5324.               4.3.119. (NO)USEUSERSHELL    .....................   59
  5325.               4.3.120. VOICECOMMAND commandline    .............   59
  5326.               4.3.121. VOICESTRING string    ...................   60
  5327.               4.3.122. (NO)WAZOO    ............................   60
  5328.               4.3.123. (NO)WRAPLINES    ........................   60
  5329.               4.3.124. VERSION    ..............................   60
  5330.  
  5331.  
  5332.      Road Map
  5333.  
  5334.  
  5335.      Road Map             TrapDoor's Fifth Manual             paM daoR
  5336.  
  5337.  
  5338.               4.3.125. (NO)XMAIL    ............................   61
  5339.               4.3.126. (NO)ZEDZAP    ...........................   61
  5340.               4.3.127. (NO)ZEDZIP    ...........................   61
  5341.               4.3.128. (NO)ZOOMFULLSIZE    .....................   61
  5342.         5. Example Setup    ....................................   63
  5343.         6. The Outbound Directory  .............................   69
  5344.            6.1. 2-dimensional Filenames    .....................   69
  5345.            6.2. 4-dimensional Filenames   ......................   69
  5346.            6.3. Extensions    ..................................   69
  5347.            6.4. Packet files   .................................   69
  5348.            6.5. Flow files   ...................................   70
  5349.            6.6. Compressed Mail files  .........................   70
  5350.            6.7. Request files   ................................   71
  5351.            6.8. Examples     ...................................   71
  5352.            6.9. Outbound File Tagging  .........................   71
  5353.         7. The Inbound Directory  ..............................   73
  5354.            7.1. Bumping Filenames   ............................   75
  5355.         8. Bugs? Poof! They're all features!....................   76
  5356.            8.1. Real Bugs   ....................................   76
  5357.         9. Past & Future  ......................................   77
  5358.         10. Registration    ....................................   78
  5359.         11. Politics    ........................................   80
  5360.            11.1. Distribution    ...............................   80
  5361.            11.2. Support    ....................................   80
  5362.            11.3. Licence    ....................................   80
  5363.            11.4. No Warranty   .................................   82
  5364.            11.5. Disclaimer    .................................   82
  5365.         12. Acknowledgements    ................................   83
  5366.  
  5367.  
  5368.  
  5369.  
  5370.  
  5371.  
  5372.  
  5373.  
  5374.  
  5375.  
  5376.  
  5377.  
  5378.  
  5379.  
  5380.  
  5381.  
  5382.  
  5383.  
  5384.  
  5385.  
  5386.             "And you try to tell that the young people of today
  5387.                        and they won't believe you."
  5388.  
  5389.  
  5390.  
  5391.  
  5392.  
  5393.  
  5394.      Road Map
  5395.  
  5396.