home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_ra / type7v2.arj / TYPE7.DOC next >
Text File  |  1991-03-12  |  4KB  |  114 lines
  1.                                -=( Type7.doc )=-
  2.  
  3. What is Type7:
  4. ==============
  5.  
  6. Type7 is a little utility which I wrote to make it possible to use
  7. LiveSystems doors as a type 15 menu-command. It reads the DORINFO1.DEF
  8. and translates the *x commandline parameters normaly used for a type 7 in
  9. the needed values. It doesn't translate ALL the Type7 Parameters though,
  10. only those which have to do with the user or system information.
  11.  
  12. Which parameters:
  13. =================
  14.  
  15.  *B    User Baudrate (DorInfo1.Def)
  16.  *C    The value of COMSPEC (From the environment)
  17.  *F    The First name of the user (all uppercase!, DorInfo1.def)
  18.        Due to the fact that RA doesn't force points between parts of names
  19.        it is possible (easy) to get the name split the wrong way..
  20.        f.e. 'Jean Paul Longname' will return 'Jean' as first name and
  21.        'Paul Longname' as last name.. Don't blame me..
  22.  *G    Graphics (0:ASCII/1:ANSI/2:AVATAR/3:ANSI&AVATAR, Dorinfo.def)
  23.  *L    Users lastname. (DorInfo1.def)
  24.  *P    Communication port (Dorinfo.def)
  25.  *N    Node nr. (Special case);
  26.  
  27.  
  28. How to use:
  29. ===========
  30.  
  31.  - First of all set the RA environment variable if you don't use it yet...
  32.  
  33.  - Make sure the program is started from within the CURRENT RA directory!
  34.  
  35.  - In the batchfile you should use the commandstring as if it was a type 7
  36.    call, but with TYPE7 in front of it..
  37.  
  38. F.e.
  39.  
  40.  If you use my trivia doorgame it would normaly be called from a type 7 as:
  41.  
  42.       C:\TRIVIA\TRIVIA.EXE -T:*T -N:*N -P:*P -S:OFF
  43.  
  44.  it should be in the batchfile as:
  45.  
  46.       TYPE7 C:\TRIVIA\TRIVIA.EXE -T:*T -N:*N -P:*P -S:OFF
  47.  
  48.  Parameters not know are passed untranslated.
  49.  
  50.  
  51.  The doorgame is started as:
  52.  
  53.    Type7
  54.       DoorGame
  55.       Leave Doorgame
  56.    Leave Type7
  57.  
  58.  As you see, Type7 remains in memory while the door is run, but as it only
  59.  uses 8224 bytes of memory, that shouldn't be a problem.
  60.  Before Type7 returns control to the BBS it shows the
  61.  
  62.    programname     Translated in case of *C
  63.    Parameters      Params as translated by TYPE7
  64.    DosError        DOS error
  65.    Exitcode        Exitlevel returned by the door.
  66.  
  67.  This can be handy when you want to see why a program didn't run...
  68.  Just put a PAUSE behind Type7 while setting up the program.
  69.  
  70.  DosErrors:
  71.       2   File not found
  72.       8   not enough memory
  73.       10  invalid environment | You shouldn't get one of those.
  74.       11  Invalid format      |
  75.  
  76.  
  77. Which node on a multiline system:
  78. =================================
  79.  
  80. Type7 also looks in the current directory for a file NODE.# Where # is the
  81. number of the node. It only looks for the filename, so you can use a null-file.
  82. This is the only way to get node info outside RA as RA doesn't write the
  83. nodenumber in one of the other files.
  84.  
  85. F.e.:
  86.  
  87. \ - RA -+- Line1 -- NODE.1
  88.         |
  89.         +- Line2 -- NODE.2
  90.  
  91. If no NODE.# file is found, TYPE7 defaults to node 1.
  92.  
  93. What else:
  94. ==========
  95.  
  96. Type7.exe first searches the local directory for the dorinfo1.def and the
  97. door.sys if not found (single node setup) it searched the directory pointed
  98. to by the RA environment variable.
  99.  
  100. If an error occurs while reading one of the files the program is halted.
  101.  
  102.  
  103. Disclaimer:
  104. ===========
  105.  
  106. Use this program at your own risk, NEVER will the author be responcible for
  107. any damage as result of running this program. I only garanthee is that
  108. it takes (some) diskspace..
  109.  
  110. This program with source code is hereby donated to the public domain..
  111.  
  112. Enjoy,
  113.  Gerhard
  114.