home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR10 / GT1800_3.ZIP / GT1800_1.LZH / README.176 < prev    next >
Text File  |  1992-07-23  |  30KB  |  788 lines

  1. ===============================================================================
  2.                      Release Notes for GT POWER 17.06
  3.                             June 29, 1992
  4. ===============================================================================
  5.  
  6.  -» If you are running a modem with a fixed DTE and floating DCE, the
  7.     two baud rates will now be displayed on the status line... it will
  8.     look something like this:
  9.  
  10.           24:192
  11.  
  12.     Which means: DCE Baud = 2400 and DTE Baud = 19200.  The zeros are
  13.     dropped off to conserve space on the status line.
  14.  
  15.  
  16.  
  17.  -» GT now supports COM1 through COM8, and IRQs 0 through 15.  These
  18.     extra IRQs, above 7, are only available on AT/286 and 386 machines.
  19.     I must admit I don't have a COM port above IRQ 7 to test with, I have
  20.     followed the instructions for implementation of the higher IRQs that
  21.     is found in the book "PC System Programming" published by Abacus... it
  22.     is about the size of a large phone book <GRIN>.  The COM ports have the
  23.     following pre-assigned addresses and IRQs:
  24.  
  25.                      COM PORT    HEX ADDRESS    IRQ
  26.                      --------    -----------    ---
  27.                         1            03F8        4
  28.                         2            02F8        3
  29.                         3            03E8        4
  30.                         4            02E8        3
  31.                         5            4220        3
  32.                         6            4228        3
  33.                         7            5220        3
  34.                         8            5228        3
  35.  
  36.     The port addresses for COM5 through COM8 were obtained from a book called
  37.     "Windows 3.1 Secrets" published by Info World, and correspond to those
  38.     used on MCA-bus machines.  However, please note, GT requires any COM port
  39.     it uses to have an IRQ all to itself, despite that fact that most of these
  40.     are shown as IRQ3.
  41.  
  42.     GT uses the addresses for COM1 through COM4 that are normally used on
  43.     ISA-bus machines, in other words, MCA-bus machines use 3220 and 3228
  44.     for COM3 and COM4 respectively, and IRQ3 for COM3.
  45.  
  46.     Remember the command line option to specify these odd-ball ports...
  47.  
  48.                           /3 $3220:10
  49.  
  50.     Would specify COM3 at address 3220 hex and IRQ10.
  51.  
  52.     Of the high IRQs, normally 10,11,12 and 15 are unused.  According to
  53.     the book, IRQ9 may also be available, but it is less clear.
  54.  
  55.  
  56.  
  57.  -» At the recent convention in North Carolina, many people expressed the
  58.     desire to bypass the new files inquiry for directories that are located
  59.     on a CD-ROM drive.  Therefore, I have added a switch to the GTDIR.BBS
  60.     file to allow this to happen.  The switch is ",CD", and here is an
  61.     example of its usage:
  62.  
  63.        E C:\GT\GENERAL,,C:\GT\FILES\GENERAL.BBS,CD General file area
  64.        ^ ^            ^ ^                      ^
  65.        | |            | |                      |
  66.        | |            | |              This switch forces GT to bypass the
  67.        | |            |  |             new files inquiry on this file area.
  68.        | |           |    |
  69.        | |          |     This is the full pathname of the file containing
  70.        | |         |      the file descriptions for this file area.
  71.        | |         |
  72.        |  |        This is an empty field, reserved for future usage, it
  73.        |   |       will contain the symbolic name associated with the file
  74.       |     |      area, for use with a future "GOTO" command.
  75.      |      |
  76.     |       This is the pathname for the file area, i.e. where the files
  77.     |       for download are actually located.  If there is not a separate
  78.     |       path name for file descriptions, then the FILES.BBS will be
  79.     |       placed in this directory.
  80.     |
  81.     The minimum access level required to gain access to this file area.
  82.  
  83.  
  84.  
  85.  -» The (M)ove command appears on the message reading sub-menu.  With this
  86.     new command, messages can be copied to any other message base, even moved
  87.     to netmail.  The original message can be deleted or retained.  A note can
  88.     be added to the message, if the sysop wishes to explain why the message
  89.     was moved.
  90.  
  91.     The "MV" permission has been added to the GTPASSWD.BBS authorization
  92.     list, so that non-sysops can be given the ability to execute the (M)ove
  93.     command.
  94.  
  95.  
  96.  
  97.  -» The carbon copy feature allows us to send the same message to a group
  98.     of people.  The list of names may appear in the message itself or be
  99.     contained in a separate file.  This feature is controlled via dot
  100.     commands.  Like other dot commands, a '.' is put into column 1 of any
  101.     line of the message, followed immediately by the appropriate commands.
  102.     Probably the most familiar dot commands are: .CS, .GL, .GM and .RR.
  103.  
  104.     Now there are a couple of new ones:
  105.  
  106.        .CC ..... Carbon Copy.  For example:
  107.  
  108.                      .cc John Doe,64/2
  109.  
  110.                  This command would send a "carbon copy" of the current
  111.                  message to "John Doe" on net/node 064/002.
  112.  
  113.                      .cc John Brown
  114.  
  115.                  This command would send a "carbon copy" of the current
  116.                  message to "John Brown" in the current conference.
  117.  
  118.        .BC ..... Blank Carbon.  This command works like the .CC command,
  119.                  except that this carbon is not included in the distribution
  120.                  list.  This is neat, if you want to send a carbon to someone,
  121.                  but not alert the others receiving carbons.
  122.  
  123.     Pre-canned distribution lists.
  124.  
  125.        It is anticipated that folks will have distributions that they repeat
  126.        over and over again.  So, by using the '@' syntax, the .CC command
  127.        can be used to call up a pre-written distribution... as follows:
  128.  
  129.            .cc @c:\gt\betadist.lst
  130.  
  131.        The full pathname must be declared for this entry.  If the pathname
  132.        is omitted, it will default to the GTPATH directory.  The contents
  133.        of the distribution file, is the same syntax as would appear in the
  134.        regular message (given above).  For example:
  135.  
  136.            .cc John Fisher,22/1
  137.            .cc Rob Roesch,64/3
  138.            .cc Red Gambrell,33/16
  139.            .cc Stephen Ricciardelli,9/400
  140.  
  141.        This is an excerpt from my BETADIST.LST file.  Also, it is possible,
  142.        in pre-canned distributions, to blank out the names and replace them
  143.        with a comment.  For example:
  144.  
  145.            .la Beta Distributors
  146.            .cc John Fisher,22/1
  147.            .cc Rob Roesch,64/3
  148.            .cc Red Gambrell,33/16
  149.            .bc John Doe,1/33
  150.            .cc Stephen Ricciardelli,9/400
  151.  
  152.        Notice the .LA command on the first line.  The .LA command can only
  153.        appear in pre-canned distributions, and if it appears, it must be the
  154.        first entry in the file.  .LA is short for .LABEL, which can be spelled
  155.        out if desired.  If a .LA line is at the beginning of the pre-canned
  156.        distribution file, then no names are shown on the carbon copy list in
  157.        the message, rather it would show like this:
  158.  
  159.            Carbon Copy: Whatever your label designates goes here
  160.  
  161.         In my example above:
  162.  
  163.            Carbon Copy: Beta Distributors
  164.  
  165.     Note, it is possible to mix netmail responses with local conference
  166.     responses.  For example, this is okay:
  167.  
  168.            .cc Stephen Ricciardelli,9/400
  169.            .cc John Doe
  170.            .cc Perry Alexander,32/1
  171.  
  172.     The first and third carbons would be delivered via netmail.  The 2nd
  173.     carbon would be placed into the currently selected conference.
  174.  
  175.     The "CC" permission has been added to the GTPASSWD.BBS authorization
  176.     list, so that non-sysops can be given the ability to send carbon
  177.     copies.
  178.  
  179.  
  180.  
  181.  -» The number of external protocols supported has risen from 16 to 18.
  182.  
  183.  
  184.  -» There is a new switch in the external protocol table (under Alt-I).
  185.     The DSZ Log switch.  If this switch is set to 'Y', then GT will get
  186.     the transferred filenames from the DSZ log.
  187.  
  188.     IMPORTANT: Care must be taken when upgrading, to make sure the DSZ Log
  189.                switch isn't turned on accidentally -- since it is in the
  190.                same position that used to be occupied by the redundant
  191.                overlay switch.
  192.  
  193.     To enable this feature to work properly, several things must be done:
  194.  
  195.     a.  The DSZLOG environment variable must be setup, probably in your
  196.         AUTOEXEC.BAT file.  And it must contain a full pathname for the
  197.         DSZ log file.  For example:
  198.  
  199.                 set DSZLOG=c:\gt\logs\dsz.log
  200.  
  201.     b.  The DSZ log should be emptied before the external protocol driver
  202.         runs, since GT will process all the names in the log!  Here is an
  203.         example that I have used:
  204.  
  205.             del %DSZLOG%
  206.             dsz port %1 handshake both rz
  207.             if not exist %DSZLOG% goto end
  208.             type %DSZLOG% >>c:\gt\zmodem.log
  209.             echo ******** >>c:\gt\zmodem.log
  210.             :end
  211.  
  212.         This is my DZRX.BAT file.  Notice that I first delete the DSZ log,
  213.         then run the DSZ program.  Finally, I save the DSZ log, by appending
  214.         it to the end of my ZMODEM.LOG (just in case <GRIN).
  215.  
  216.         My DZTX.BAT file looks very similar, so I didn't see any reason to
  217.         include it here.
  218.  
  219.     c.  Make sure that the protocol driver is setup and able to produce
  220.         DSZ logs.  This is very important, as some protocol drivers, or
  221.         unregistered protocol drivers, may not produce DSZ logs.
  222.  
  223.     d.  The final thing you must do to enable the DSZ log inside of GT is
  224.         to put a 'Y' in the DSZ log column of the external protocol table,
  225.         so that GT knows which protocols are going to use the DSZ log.  At
  226.         this time, I assume DSZ, GSZ and HSlink are the only ones.
  227.  
  228.         Here is a sample DSZLOG... for whatever it is worth!  Detailed
  229.         descriptions of this format are given in the HSlink docs.
  230.  
  231.            h 227596 10100 bps 1138 cps   0 errors   112 2316 C:\GT\UP\TEST1.DAT 0
  232.            H 177901 10100 bps 1116 cps   1 errors     0  749 C:\GT\UP\TEST2.DAT 0
  233.            Z   6121 19200 bps 1020 cps   0 errors     0 1024 gateway2.arj 0
  234.            Z  14144 19200 bps  943 cps   0 errors     0 1024 duser110.arj 0
  235.  
  236.  
  237.  
  238.  -» Caller selectable multiple upload directories ARE now supported.  This
  239.     is optional, like most new features.  To enable the option, the sysop
  240.     must create a GTUDIR.BBS (an upload directory list).  The format is
  241.     similar to the format used in GTDIR.BBS.  Here is a sample:
  242.  
  243.             Upload directories
  244.  
  245.         z C:\GT\OBJ Home GT directory #2
  246.         z C:\GT\C General file area
  247.         =E C:\SPECIAL Special Purpose Area
  248.         A C:\PRIVATE Private upload directory
  249.  
  250.     If you have a GTUDIR.BBS, when the caller begins an upload, he/she will
  251.     be presented with a list of directories to choose the upload to go
  252.     into.  Directories can be dedicated to a particular class of caller
  253.     by using the '=' notation, as shown.  The selected upload directory
  254.     will override the upload path from the GTPASSWD.BBS (in fact, if you
  255.     use the GTUDIR.BBS, the upload path from GTPASSWD.BBS is redundant).
  256.  
  257.  
  258.  
  259.  -» The (Y)our info command, on the host main menu, has been expanded to
  260.     include the change of phone number, city/state, and password.  Any
  261.     changes made are logged... both old and new values are logged.
  262.  
  263.     In order for the caller to change any value, he/she must know their
  264.     old phone number to verify his identity.
  265.  
  266.     In addition, the caller must have the PW authorization to change the
  267.     password.  If you don't give the caller the PW authorization, then
  268.     the password will not be presented for change.
  269.  
  270.     For security purposes, all passwords are now erased from the screen
  271.     after the ENTER key is pressed.  To keep people from easily reading
  272.     them over-your-shoulder.
  273.  
  274.  
  275.  
  276.  -» Rudimentary support for the Chinese Big-5 character set is being
  277.     introduced with this release.  Specifically, in the past, it was common
  278.     for a Big-5 character to be split between two lines of a message.  Half
  279.     at the end of the first line, and the 2nd half at the start of the next
  280.     line.  I have attempted to correct this situation, with the kind help
  281.     of Raymond Wood and the Taiwanese Sysops... many thanks to everyone who
  282.     helped.  I hope it works <GRIN>.
  283.  
  284.  
  285.  
  286.  -» Multi-language support.  The sysop now has the option of creating
  287.     a file called GTLDIR.BBS, which will contain the definition of a
  288.     menu.  This menu will be presented to the caller immediately after
  289.     the GTSYSID.BBS screen has been displayed, and prior to the ANSI
  290.     graphics question.
  291.  
  292.     The GTLDIR.BBS will have the following format:
  293.  
  294.         starting in column 1: the name of a batch file to be executed
  295.                               if the related menu option is selected by
  296.                               the caller.
  297.  
  298.                               At least 1 blank must follow the batch
  299.                               filename.
  300.  
  301.                               Following the blank there must be the text
  302.                               to appear on the menu.
  303.  
  304.         Any line beginning with a blank character is display for the
  305.         caller as explanatory text.  Comments may be included by placing
  306.         a semi-colon in column 1.
  307.  
  308.             For example:
  309.             ------------
  310.             ;  This semi-colon is in column 1, and makes this a comment.
  311.  
  312.                Language Selection Menu
  313.  
  314.             ;  Language 1 is probably the most likely choice.
  315.             GTLANG_1  Language Number 1
  316.             GTLANG_2  Language Number 2
  317.             GTLANG_3  Language Number 3
  318.             ;  The end
  319.  
  320.         This would appear on-screen for the caller like this:
  321.  
  322.            Language Selection Menu
  323.  
  324.            1.  Language Number 1
  325.            2.  Language Number 2
  326.            3.  Language Number 3
  327.  
  328.            Enter Language Selection:
  329.  
  330.  
  331.         The batch files, GTLANG_1.BAT, GTLANG_2.BAT, GTLANG_3.BAT
  332.         should contain simple copy commands.  Copy commands that move
  333.         into place BBS/CBS screens matching the selected language entry.
  334.         Nothing heavy duty should be done in these batch runs, as there
  335.         will be limited memory available.
  336.  
  337.         After the language batch file has been run, GT will display
  338.         a new screen, GTANSI.BBS, for the caller.  This is just prior
  339.         to the ANSI Graphics question.
  340.  
  341.  
  342.  
  343.  -» The mail check command has been added to the main menu via the [CK]
  344.     command keys.  Be sure to update menus and help screens as appropriate.
  345.  
  346.  
  347.  
  348.  -» A new parameter has been added to the Alt-I Misc options configuration.
  349.     The expired access level, item #20 on the Misc options screen.  This
  350.     defaults to 'z'.  But is now provided so that the sysop can specify
  351.     the access level he/she desires for callers that have had their
  352.     subscription expire.
  353.  
  354.  
  355.  
  356.  -» A new caller questionnaire has been added.  Sysops may now define the
  357.     QUEST0.BBS file.  New callers will be forced to fill it out, between
  358.     the bullet menu and the mail check (before they get to the main menu).
  359.     If they don't fill it out, for whatever reasons (say they drop carrier)
  360.     then they will remain "new" callers, and be forced to face the
  361.     questionnaire on their next call.
  362.  
  363.     PQUEST0.BBS is _NOT_ supported.  Answers are stored in the ANSWER0.BBS.
  364.  
  365.  
  366.  
  367.  -» A batch file for virus scan of uploads is now available.  GT_VSCAN.BAT
  368.     will be executed, like a door, if it exists in the GTPATH, after a
  369.     caller upload.  The filenames of the uploaded files will be passed
  370.     to the GT_VSCAN.BAT in a log file called GT_RECV.LOG.  The format of
  371.     this log file is quite simple: (a) full pathnames are used, (b) a
  372.     single filename per line, (c) entries begin in column 1.
  373.  
  374.     GT will not automatically erase or create the GT_RECV.LOG.  To get
  375.     things started, the sysop must create an empty GT_RECV.LOG, the
  376.     following DOS command works nicely:
  377.  
  378.            rem >GT_RECV.LOG
  379.  
  380.     If the GT_RECV.LOG is created, GT will append the uploaded filenames
  381.     to it after each upload.  After the GT_VSCAN.BAT runs, GT does not
  382.     automatically erase the GT_RECV.LOG, so the sysop must clear the
  383.     file after the scan is done.  Again, this DOS command works well:
  384.  
  385.            rem >GT_RECV.LOG
  386.  
  387.     Remember to create the GT_RECV.LOG in the GT log path (which may or may
  388.     not be the same as the GTPATH).
  389.  
  390.     In order to scan the upload files after the caller logs off, the sysop
  391.     should not create the GT_VSCAN.BAT, instead the virus scan logic should
  392.     be placed in the GTLOGOFF.BAT.  Remember to clear the GT_RECV.LOG after
  393.     the scan is done... using this method, the virus scan can be delayed
  394.     and done on a periodic basis (for example, during daily or weekly
  395.     maintenance).  The GT_RECV.LOG will run until the sysop manually resets
  396.     it, and full pathnames are recorded.
  397.  
  398.     IMPORTANT: GT does not automatically create the GT_RECV.LOG.  The
  399.                sysop must create it to start with, using the "rem"
  400.                command, as shown above.  If the sysop forgets to do this
  401.                GT *WILL NOT* record anything in the GT_RECV.LOG.
  402.  
  403.  
  404.  
  405.  -» Questionnaires are now programmable.  The following features are
  406.     currently supported:
  407.  
  408.          a.  If statement.
  409.          b.  Goto command.
  410.          c.  Dump caller command.
  411.          d.  Access level change command.
  412.          e.  Access level test command.
  413.          f.  Set expiration date.
  414.          g.  Display a "More?" prompt.
  415.          h.  Loop command.
  416.          i.  Answer labels.
  417.          j.  Line labels.
  418.          k.  Date/time stamp.
  419.          l.  Join caller to a message base.
  420.          m.  Test for blank answer.
  421.          n.  Test for ASCII answer.
  422.          o.  Force save of questionnaire answers.
  423.          p.  Terminate questionnaire and discard answers.
  424.  
  425.     IF - The "IF" statement allows the sysop to test the previous entry
  426.          made by the caller.  The entry can be treated as a number or
  427.          a string of characters (if a string of characters, only the
  428.          first character can be tested).  Here is the syntax:
  429.  
  430.              [%IF,N,1-18=MINOR]
  431.  
  432.          The first 5 characters, "[%IF," is constant.  The 'N' indicates
  433.          that the test will be numeric.  The range 1 through 18 is
  434.          tested against the caller input, if found to be true, the
  435.          questionnaire will branch to the label "MINOR".
  436.  
  437.              [%IF,X,Y=SYSOP]
  438.  
  439.          Again, the first 5 characters are constant.  The 'X' indicates
  440.          that the test will be made on a alphanumeric basis (i.e. as if
  441.          the entry was a string of characters).  The caller input is
  442.          tested to see if the first character entered was a 'Y', if true
  443.          the questionnaire will branch to the label "SYSOP".
  444.  
  445.          Ranges can also be used with "[%IF,X,".  Like this:
  446.  
  447.              [%IF,X,A-Z=GOOD_ANS]
  448.  
  449.          If the caller entry was in the range A through Z, then the test
  450.          evaluates true and the branch is done.
  451.  
  452.          The 'X' option can test multi-character answers.  The first test
  453.          value is the key to the number of characters that will be tested.
  454.          For example:
  455.  
  456.              [%IF,X,YES=NEXT]
  457.  
  458.          In this case, the first 3 characters of the previous answer will
  459.          be tested for equal to "YES".  If the caller gave a longer answer,
  460.          the extra will be ignored.  If a match is made, the questionnaire
  461.          will branch to the specified label, "NEXT".
  462.  
  463.          If the "IF" statement finds the test condition false, then the
  464.          questionnaire will fall-through to the next line of the
  465.          questionnaire.
  466.  
  467.     GO - The "GO" command allows the sysop to branch un-conditionally
  468.          to the indicated label.  For example:
  469.  
  470.              [%GO,ADULT]
  471.  
  472.          Again, the first 5 characters are constant, "[%GO,".  When
  473.          found in the questionnaire, this causes an un-conditional
  474.          branch to the label ADULT.
  475.  
  476.     XX - The "XX" command causes the caller to be disconnected from
  477.          your BBS.  An example:
  478.  
  479.              [%XX,reason]
  480.  
  481.          The "reason" is logged to the GT.LOG file, then the caller
  482.          is disconnected.  If done during a new caller questionnaire,
  483.          the caller will be unable to get to your main menu.
  484.  
  485.     XD - The "XD" command allows the sysop to adjust the expiration
  486.          date of the caller.  An example:
  487.  
  488.              [%XD,nnn]
  489.  
  490.          Where the 'nnn' is the number of days from today that the
  491.          program should set the expiration date.  If 'nnn' was 365
  492.          then the expiration date would be 1 year from today.
  493.  
  494.     TL - The "TL" command allows the sysop to test the callers current
  495.          access level.  For example:
  496.  
  497.              [%TL,E=LV_NORM]
  498.  
  499.          If the callers access level is equal to 'E', execution of the
  500.          questionnaire will branch to 'LV_NORM'.
  501.  
  502.          A range of values may be tested... as follows:
  503.  
  504.              [%TL,A-E=LV_USERS]
  505.  
  506.          Which would execute the branch to LV_USERS, if the caller's
  507.          access level is in the range A through E.
  508.  
  509.     MO - The "MO" command will cause a "More? " to appear for the caller.
  510.          For example:
  511.  
  512.              [%MO]
  513.  
  514.  
  515.     JN - This command join the caller to a message base.  For example:
  516.  
  517.              [%JN,c:\gtbbs\netsys]
  518.  
  519.          Would join the caller to the Network Sysop's Confernce, assuming
  520.          it was in "c:\gt\netsys" on your system <GRIN>.
  521.  
  522.     TB - Test last answer for blanks.  For example:
  523.  
  524.               [%TB,BLANKS]
  525.  
  526.          If the answer last given was all blank (or empty), the question-
  527.          naire will branch execution to 'BLANKS'.
  528.  
  529.     TA - Test last answer for ASCII data.  For example:
  530.  
  531.               [%TA,MOR_TEST]
  532.  
  533.          If the answer last given was all ASCII characters (32-125 decimal),
  534.          the questionnaire will branch to 'MOR_TEST'.
  535.  
  536.     SV - Force the questionnaire to be saved.  For example:
  537.  
  538.               [%SV]
  539.  
  540.          The command should be placed near the beginning of the
  541.          questionnaire, to insure it is "in effect", before the
  542.          caller decides to drop carrier <GRIN>.  Once it has taken
  543.          effect, the questionnaire WILL be saved, unless the computer
  544.          crashes.
  545.  
  546.     AB - In an ordinary questionnaire, other than quest0, the [%AB
  547.          command causes the questionnaire to terminate immediately,
  548.          returning the caller to the main menu... and discarding the
  549.          answers given to the questionnaire.  It will not, however,
  550.          cause a QUEST0.BBS to be discarded.  For example:
  551.  
  552.              [%AB]
  553.  
  554.     LV - The "LV" command allows the sysop to adjust the access level
  555.          of the caller.  An example:
  556.  
  557.              [%LV,x]
  558.  
  559.          Where the 'x' is any valid access level.  And the first five
  560.          character are constant.
  561.  
  562.     LP - The "LP" command allows the previous question to be re-asked.
  563.          This is very handy for cases where the caller response appears
  564.          incorrect.  For example:
  565.  
  566.  
  567.              :ASK_SYS
  568.  
  569.                                  [---]
  570.                 Are you a sysop?
  571.  
  572.              [%IF,X,Y=IS_SYS]
  573.              [%IF,X,N=NOT_SYS]
  574.              [%LP,3,ASK_SYS]
  575.  
  576.          In this example, the responses 'Y' and 'N' are tested, if found
  577.          to be true, the "IF" statements will branch out to the indicated
  578.          labels.  If the "IF" statements fall-through, the "LP" statement
  579.          will execute twice (asking the question a total of '3' times).
  580.          ASK_SYS is a line label (because it begins with a ':' in column 1).
  581.          Line labels must be no longer than 8 characters.
  582.  
  583.     DT - Date/Time stamp the answers given.  For example:
  584.  
  585.              [%DT]
  586.  
  587.     Answer Labels
  588.     -------------
  589.     One of the biggest problems that I've seen with questionnaires in the
  590.     past, has been that there has been no way to easily identify the
  591.     answers, without some way to cross-reference with the questionnaire.
  592.  
  593.     Answer labels can be added to the questionnaire by making an addition
  594.     to the prompt line.  Take the sample question above:
  595.  
  596.                          [---]
  597.         Are you a sysop?
  598.  
  599.     As it stands, the answer will be saved without any label.  To add a
  600.     label the following change must be made:
  601.  
  602.                          [---]
  603.         Are you a sysop?        [%SYSOP]
  604.  
  605.     This sort of label is not to be confused with line labels (line labels
  606.     should be on a line by themselves).  However, answer labels are limited
  607.     to 8 characters, like line labels.
  608.  
  609.     In the ANSWERx.BBS file, the label would look like this:
  610.  
  611.           AGE     : 12
  612.           SYSOP   : no
  613.           BBS_PHON: 602-897-9549
  614.           VOICE_PH: 602-897-9557
  615.  
  616.     Line Labels
  617.     -----------
  618.     A line label is used by the new branching commands, so that points
  619.     that control needs to be transferred to, can be identified.  A line
  620.     label begins in column 1 with a ':' and the name chosen must be 8
  621.     characters or less.
  622.  
  623.     Here is an example script (that I wrote to test the new features):
  624.     The [%DT] adds a date/time stamp to the answers.
  625.  
  626.     Start of Sample Questionnaire
  627.     -----------------------------
  628.     [%DT]
  629.  
  630.  
  631.                          NEW USER QUESTIONNAIRE
  632.  
  633.     :ASK_AGE
  634.  
  635.                             [---]
  636.            How old are you?             [%AGE]
  637.     [%IF,N,1-18=MINOR]
  638.     [%IF,N,19-100=ADULT]
  639.  
  640.         Really!   That is too old!
  641.  
  642.     [%LP,3,ASK_AGE]
  643.     [%GO,DUMP]
  644.     :ADULT
  645.  
  646.        You are an adult.
  647.  
  648.     [%GO,ASK_SYS]
  649.     :MINOR
  650.  
  651.        Hey!  You are a minor.
  652.  
  653.     :ASK_SYS
  654.                             [---]
  655.            Are you a sysop?             [%SYSOP]
  656.  
  657.     [%IF,X,Y=SYSOP]
  658.     [%IF,X,N=REGULAR]
  659.     [%LP,3,ASK_SYS]
  660.     :DUMP
  661.  
  662.        Sorry.  You gotta go...
  663.  
  664.     [%XX,DUMB BELL SYNDROME]
  665.     [%GO,FINAL]
  666.     :REGULAR
  667.  
  668.        You aren't a sysop.
  669.  
  670.     [%GO,FINAL]
  671.     :SYSOP
  672.  
  673.        Hey!  You are a sysop!
  674.  
  675.     [%LV,A]
  676.     :FINAL
  677.  
  678.     the end
  679.     ---------------------------
  680.     End of Sample Questionnaire
  681.  
  682.  
  683.  
  684.  -» New DOS Environment variable: GTVBUF
  685.  
  686.     The user may set the size of GT's VROOM buffer with this
  687.     environment variable.  The buffer defaults to 100k.  If the
  688.     buffer is too small, GT will run extremely slowly, and probably
  689.     beat your disk to death.  Minimum value 30, maximum value 160.
  690.  
  691.     For example:
  692.  
  693.               set GTVBUF=128
  694.  
  695.     This would set the VROOM buffer to 128k.
  696.  
  697.     The GTVBUF variable should be set so that between 150 and 200k are
  698.     available when GT starts.  If available memory is too low, then
  699.     GTVBUF can be reduced, if available memory is too high, then GTVBUF
  700.     should be increased.  However, values above 160 have very little
  701.     merit.
  702.  
  703.  
  704.  
  705.  -» New DOS Environment variable: NO_EMS
  706.  
  707.     The user without EMS memory (or who is having trouble with EMS
  708.     memory) can use this variable to disable GT's usage of EMS.  The
  709.     default is to use EMS memory.
  710.  
  711.     For example:
  712.  
  713.               set NO_EMS=TRUE
  714.  
  715.     This would disable the usage of EMS memory by GT.
  716.  
  717.     If your system has no EMS memory, then this variable can be used
  718.     to speed up program loading (since GT will not bother checking for
  719.     EMS memory).
  720.  
  721.  
  722.  
  723.  -» New script commands.
  724.  
  725.         STATUS CLEAR
  726.             Purpose: to clear the status line.
  727.  
  728.         STATUS RESET
  729.             Purpose: to return the status line to the original condition.
  730.  
  731.         STATUS nn "...."
  732.             Purpose: to write a string of data at column 'nn' of the
  733.             status line.
  734.  
  735.             Example:
  736.  
  737.                 status 5 "F1=Menu Option"
  738.  
  739.  
  740.         Modified script command.
  741.  
  742.             CAPTURE ON
  743.                 Purpose: to turn on capture mode.
  744.  
  745.             CAPTURE OFF filename
  746.                 Purpose: to turn off capture mode and store the text
  747.                 in "filename".
  748.  
  749.  
  750.  
  751.  -» The /V command line option is now obsolete.  All external processes
  752.     executed during host mode operation will be overlay the memory
  753.     occupied by GT.
  754.  
  755.  
  756.  
  757.  -» The overlay switch in the external protocol table is now obsolete.
  758.     All protocols will overlay the memory occupied by GT, unless they
  759.     are executed from a script (in which case, GT will remain in memory).
  760.  
  761.  
  762.  
  763.  -» The programs DOOR.EXE and TDOOR.EXE are now obsolete.  The program
  764.     structure has been rearranged into a small GT1706.EXE and the main
  765.     body of the program, GT1706.OVL.
  766.  
  767.  
  768.  
  769.  -» The program is now able to use up to 512k of EMS memory, if it is
  770.     available.
  771.  
  772.  
  773.  
  774.  -»  A new parameter is now passed to door batch files: %3 = the baud rate.
  775.      If the door requires some other parameter to be passed, such as user
  776.      input or message base info, then the baud rate will be overridden by
  777.      such required information.
  778.  
  779.      Normally, doors should not require both the baud rate and the other
  780.      information (the baud rate is useful, so that doors can do file
  781.      transfers with external protocols).
  782.  
  783.  
  784.  
  785. Regards,
  786. Paul Meiners
  787. 6-28-92
  788.