home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / dinfavt5.zip / DINFOAVT.DOC next >
Text File  |  1993-03-01  |  10KB  |  214 lines
  1.    ╒═══════════════════════════════════════════════════════════════════════╕
  2.    │  DINFOAVT 5; RemoteAccess 1.xx/2.xx ANSI/AVATAR DORINFO1.DEF utility  │
  3.    ╘═══════════════════════════════════════════════════════════════════════╛
  4.  
  5.  Dinfoavt.Exe/Dinfoavt.Doc written by geoffrey booher 1:2270/233.1@fidonet
  6.  Copyright (c) 1990 <-> 1993; boo s/w development hq
  7.  
  8.  disclaimer:
  9.  ───────────
  10.  DINFOAVT 5 is *ONLY* guaranteed to consume diskspace.  It has been very
  11.  extensively tested and found to be pretty reliable.  In no way is the
  12.  Author of this program responsible for any damages, consequential, or
  13.  otherwise from the neglect of DINFOAVT 5's use or misuse.  DINFOAVT 5
  14.  is provided as is, without warranty of any kind, either expressed or implied.
  15.  
  16.  DINFOAVT 5 may be distributed freely subject to the following conditions:
  17.  
  18.  1.  No fees are charged for distributing or obtaining the DINFOAVT files.
  19.      DINFAVT5.ZIP may be placed on pay/subscription systems, provided that
  20.      a fee is not charged for DINFAVT5.ZIP itself.
  21.  
  22.  2.  The files within the DINFAVT5 archive are not modified in ANY way, this
  23.      includes reprocessing/recompressing the DINFAVT5.ZIP to another type
  24.      of compression.
  25.  
  26.  questions:
  27.  ──────────
  28.  Send Netmail to geoffrey booher, 1:2270/233.0@fidonet.  Or I suppose any
  29.  questions you have could be addressed to me in the RA_UTIL conference.
  30.  
  31.  
  32.  files in the archive:
  33.  ─────────────────────
  34.  DINFOAVT.EXE - 80386 protect mode version of the program, this file is ready
  35.                 to use if you have a 386 or higher based CPU machine.
  36.  
  37.  DINFOAVT.XT  - 808X version of the program, rename to DINFOAVT.EXE and use
  38.                 this file if you have a 286 or below based CPU machine.
  39.  
  40.  DINFOAVT.DOC - You're reading it.
  41.  
  42.  WHATSNEW.5   - History and new features in DINFOAVT 5.
  43.  
  44.  README.1ST   - Notice about the distribution archive.
  45.  
  46.  overview and features:
  47.  ──────────────────────
  48.  DINFOAVT 5 is a DORINFO1.DEF utility specifically for use with
  49.  RemoteAccess 1.xx/2.xx.
  50.  
  51.  It's main purpose is to change the DORINFO1.DEF file if the user online has
  52.  BOTH ANSI/AVATAR emulation enabled to plain ANSI so software that does not
  53.  recognise the new 2 and 3 DORINFO1.DEF codes can still do ANSI if possible.
  54.  
  55.  I wrote this program because my users that are taking advantage of my AVATAR
  56.  screens were complaining there was 'no colors' on 'DOORS' and other Type 7
  57.  programs I run.  So ... I figured that these dudes were running the code '3'
  58.  in DORINFO1.DEF that they were using ANSI and AVATAR both.  If that was the
  59.  case, then temporarily change to code '1' ANSI to run the door, and restore
  60.  the ANSI/AVATAR code '3' after the door.  Simple enough.
  61.  
  62.                                                                      Page 2
  63.  setting up DINFOAVT 5:
  64.  ──────────────────────
  65.  Put the correct Dinfoavt.Exe anywhere in your DOS PATH, along with any of
  66.  your other utilities.
  67.  
  68.  
  69.  DINFOAVT Command line parameters:
  70.  
  71.  DINFOAVT     
  72.  DINFOAVT /?  - Shows a help screen.
  73.  
  74.  DINFOAVT /I  - Use this switch going INTO the door.  It will look for a
  75.                 DORINFO?.DEF file (yes, it will use DORINFO1, DORINFO2, etc)
  76.                 in the CURRENT DIRECTORY.  If line 10 is '2' or '3', AVATAR or
  77.                 ANSI/AVATAR, it will write a DORINFO?.$$$ file with the
  78.                 original DORINFO?.DEF contents, and change the DORINFO?.DEF
  79.                 file to '1' on line 10 for ANSI if ANSI/AVATAR is detected. It
  80.                 will change the DORINFO?.DEF to '0' if AVATAR alone is detected.
  81.                 If it's 0 - ASCII/TTY; or 1 - ANSI only, it won't update
  82.                 the DORINFO?.DEF file, and won't create the DORINFO?.$$$ file.
  83.  
  84.  DINFOAVT /O  - Use this switch on the way OUT the door.  It will look for the
  85.                 DORINFO?.$$$ if it was created by the DINFOAVT /I option.
  86.                 If it doesn't find it, it assumes ANSI/AVATAR both was NOT the
  87.                 initial emulation and will do nothing.  If it finds the
  88.                 DORINFO?.$$$ file, it will overwrite it with the CURRENT
  89.                 DORINFO?.DEF file, and then rewrite a new DORINFO?.DEF file
  90.                 with updated time remaining, etc from the door, and change
  91.                 line 10 back to '3' so ANSI/AVATAR is enabled again upon return
  92.                 to the BBS.  This is NOT needed by RemoteAccess, but may be
  93.                 by other programs following in a batchfile.
  94.  
  95.  DINFOAVT /IO - This switch just changes DORINFO1.DEF and does not attempt to
  96.                 change DORINFO1.DEF back when the DOOR is done.  Some DOORS
  97.                 use DORINFO1.DEF to get some settings like graphics, but RA
  98.                 actually uses EXITINFO.BBS to update the time used.
  99.  
  100.  DINFOAVT /R  - This switch adds the -R info to the line settings info if a
  101.                 "reliable" (error-free) connection is active.  If you do not
  102.                 have an error-correcting modem, then this parameter is of no
  103.                 use to you.  Example of what DINFOAVT /R will do :
  104.  
  105.                 14400 BAUD-R,N,8,1  (the -R is added in if error-free connect)
  106.                 2400 BAUD,N-8-1     (-R is NOT added if not error-free)
  107.  
  108.                 DINFOAVT reads the EXITINFO.BBS file in the current directory
  109.                 to determine if the connection is error-free.
  110.  
  111.                 NOTE:  Because RemoteAccess 2.00 already supports this, it
  112.                        is not needed upon initial entry intto a DOOR.  It can
  113.                        however be useful to change it back for use in your
  114.                        batchfile if you previously turned it off with /r-
  115.  
  116.  DINFOAVT /R-   this command removes the -R created by RemoteAccess 2.00
  117.                 DORINFO1.DEF file for DOORS that do not follow the RBBS
  118.                 DORINFO1.DEF standard.  it will only remove it on an error-
  119.                 free connection.
  120.  
  121.  DINFOAVT /D  - This switch displays the contents of the DORINFO?.DEF file.
  122.  
  123.                                                                      Page 3
  124.  
  125.  
  126.  using DINFOAVT 5:
  127.  ─────────────────
  128.  You will need to create a batchfile to run your door.  Here's an example:
  129.  
  130.  Type 7 - Optional Data: *C /C C:\RA\BBSLIST.BAT *M *N
  131.  
  132.  Bbslist.Bat:                    -OR-                        -OR-
  133.  
  134.  @Echo OFF                    @Echo OFF                   @Echo OFF
  135.  Dinfoavt /I /R-              Dinfoavt /IO /R-            Dinfoavt /R-
  136.  Bbslist Bbslist.Cfg          Bbslist Bbslist.Cfg         Bbslist Bbslist.Cfg
  137.  Dinfoavt /O                  Dinfoavt /R
  138.                               Door.Exe Door.Cfg
  139.  
  140.  I realise making batchfiles to run type 7's is not the most elegant way to
  141.  run things, but DINFOAVT 5 is really a kludge program to give ANSI Colors
  142.  AT LEAST in your doors until such time the doors become AVATAR 'smart'.  It
  143.  is also VERY handy to pass error-correcting status to those doors that
  144.  support the -R in DORINFO1.DEF.  it also allows removal of -R for doors not
  145.  being able to handle the -R error-free parameter in DORINFO1.DEF.
  146.  
  147.  
  148.  DINFOAVT 5 technical info:
  149.  ───────────────────────────
  150.  Dinfoavt.Cpp was written in C language with the CPlusPlus extension option.
  151.  Dinfoavt.Exe was compiled with Borland International's Borland C++ 3.1 using
  152.  the Small Memory Module ( < 64kb heap ).
  153.  
  154.  DINFOAVT.EXE has the following errorlevels:
  155.  
  156.  Errorlevel 4 - invalid parameter or no parameters (help screen)
  157.  Errorlevel 3 - DORINFO1.DEF successfully updated
  158.  Errorlevel 2 - File I/O error
  159.  Errorlevel 1 - Missing DORINFO?.DEF or EXITINFO.BBS (/R option)
  160.  Errorlevel 0 - DORINFO1.DEF not changed
  161.  
  162.  
  163.  NOTE!! DINFOAVT 5 expects to find ONE DORINFO?.DEF file in the CURRENT
  164.         DIRECTORY!  If you are running a multi-line system, this should not
  165.         pose a problem as the door will likely be executed in that nodes
  166.         directory.  The RemoteAccess documentation states doors must be run
  167.         from their own seperate directories when running multiple copies, so
  168.         DINFOAVT 55 should find the correct DORINFO1.DEF file in the
  169.         directory currently in.  if you rename it to DORINFO2.DEF in your
  170.         batchfile - that is okay - DINFOAVT will support that too.
  171.  
  172.         If the program finds more than ONE DORINFO?.DEF file in the current
  173.         directory it will use the first one it finds, whether valid or not!
  174.  
  175.                                                                      Page 4
  176.  
  177.  thanks:
  178.  ───────
  179.  Thanks to andrew milner and the RemoteAccess beta duders for the best BBS
  180.  software available anywhere hands down.  :-)
  181.  
  182.  Thanks to Kevin Zimmerman at The Boomtown BBS - 1:2270/868@fidonet for
  183.  sometimes getting 7 versions of my programs per day to pre-test out.
  184.  
  185.  Thanks to Bruce Bodger at The Truckstop BBS - 1:170/400@fidonet for helping
  186.  out with beta bashing some of my stuff.
  187.  
  188.  Thanks to Bob R. at The Anonymous BBS - 1:154/40@fidonet for some good
  189.  suggestions for DINFOAVT 2.00 through 5 (the /R and /R- commands).  :-)
  190.  
  191.  Thanks to Mark Howard at Rivendell TAP/NA - 1:260/340@fidonet for writing
  192.  RAEXIT for RemoteAccess 1.00 EXITINFO.BBS conversion.  It was his program
  193.  that gave me the idea for the display contents (/d) command and helped test
  194.  if the /R command worked properly for RA 1.11.
  195.  
  196.  misc:
  197.  ─────
  198.  The following products/examples are the Copyrighted materials of their
  199.  respective named holders:
  200.  
  201.  DINFOAVT 5                      boo s/w development hq
  202.  
  203.  Borland C++ 3.1                 Borland International
  204.  
  205.  RemoteAccess                    andrew milner and Continental Software
  206.  
  207.  BBSLIST                         Off The Wall Programming
  208.  
  209.  AVATAR                          George A. Stanislav
  210.  
  211.  Fidonet                         Tom Jennings
  212.  
  213.  
  214.