home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / bye_pc1.zip / READ.ME < prev    next >
Text File  |  1987-01-20  |  12KB  |  236 lines
  1.  
  2.           -----------------------------------
  3.               BYE-PC for DOS      _____
  4.               and the     |ibm  |
  5.                IBM-PC, XT, AT     | (*) |
  6.                 by         |__U__|
  7.               MCODE Software
  8.           -----------------------------------
  9.  
  10.   BYE-PC is an implementation of the popular BYE program for cp/m
  11. machines designed to run on the IBM-PC family of computers. This system
  12. carries the latest copies of a demo package for BYE-PC as well as the
  13. source code for registered users. The demo package can be found in
  14. directory A5: and is available to all callers for distribution. To
  15. receive the source code you will have to purchase the package to become
  16. a registered user. The source code is completely written in assembly
  17. code and offers interrupt driven communications for optimal performance.
  18.  
  19.   This system will become the main distribution point for BYE-PC users
  20. and modifications will be returned to this point for re-distribution.
  21. Once a user is registered, all software written for use with BYE-PC
  22. is available and all modifications are available. The initial cost of
  23. BYE-PC is a one time cost and is required by the author due to the
  24. lengthy initial development time of the package. All rights to the
  25. source code are retained by the author and requires that persons who
  26. purchase the source code enter an aggreement upon purchase of the
  27. package. The source code aggrement is in the file 'COPYRGHT.BYE' in
  28. directory A5:. If you wish to purchase the code and enter the agreement
  29. then you can contact the author or the sys/op for more information.
  30.  
  31.  
  32.   Source Code Development Package Contents:
  33.  
  34.       BYE102.ASM  --> Complete ASM source code for BYE-PC.
  35.       BYEXFACE.C  --> BYE-PC inteface module to 'C' programs.
  36.       SHELL.C      --> DOS security shell for use with BYE-PC.
  37.       XMDM.C      --> Complete XMODEM source code for use with BYE-PC.
  38.       STAT.C      --> BYE-PC status control application program.
  39.       CHAT.C      --> Complete source code for CHAT program.
  40.  
  41.   All source code modules will compile using either Microsoft(TM)
  42. ASM or the MSC 'C' compiler. The author uses the Microsoft(TM) languages
  43. exclusivly. If a user feels that he/she has a made a modification of
  44. significance to other users, the module can be returned to this system
  45. for redistribtion to other users. This method will allow the package to
  46. mature into a full featured system just as the original version of
  47. BYE written for cp/m systems bye Irv Hoff, Kim Levitt and others.
  48.  
  49.   To order the develpment package you can contact the system operator
  50. or the address below. If you do not wish to modify the source code but
  51. still wish to purcase a copy of the program, the author can assist you
  52. in setting up a system for you. As of yet a RBBS has not been written
  53. for use with BYE-PC. I will leave this as a challenge to programmers
  54. who can do a better job of writting a bulletin board system. 'C' offers
  55. numerous advantages for bulletin board software developers compared to
  56. Basic. I have however, provided a complete interface for 'C'programers
  57. to access BYE-PC functions for status and hardware control of the modem.
  58. BYEXFACE.C greatly simplifies the task of writting any communications
  59. software to work in conjuncion with BYE-PC. Low level funcions are
  60. provided to allow complete control of the modem and set status levels
  61. within BYE-PC that other programs can reference (SHELL, XMDM, etc..).
  62.  
  63.  
  64.   Source Code Development Package Ordering:
  65.  
  66.   The source code development package sells for $49.95 and contains
  67. all of the source code for the modules described above. Once a user
  68. is registered, they will receive disks that contains all of the
  69. source code for all of the above specified modules. This pacakage
  70. is designed for programmers that program in Assembly and 'C' who
  71. wish to become a part of the BYE-PC network and contribute to the
  72. package as it grows. Modifications will not be re-sold by the author.
  73. The author has no intentions of exploiting other programmers work.
  74. Only the original distribution package is sent to people wishing to
  75. purchase the system. If newcomers want the latest revisions and updates
  76. by other programmers, then they will have to contact the Board Walk MBBS
  77. to receive the latest versions available. The initial cost has been
  78. implemented due to the total failure of the shareware approach to
  79. distribution of user developed software.
  80.  
  81.  
  82.     Contact the sys/ops of the Board Walk MBBS or write to the author
  83.     at the following address:
  84.  
  85.            MCODE Software
  86.            c/o R.E. Starr, Jr.
  87.            3444 Dresden Drive
  88.            Montgomery, Al. 36111
  89.            (205)284-0241 (7-8pm CST only!)
  90.  
  91.     You may also leave a message to me on the Board Walk. Address any
  92.     messages to author Bob Starr on the Board Walk MBBS.
  93.  
  94.  
  95.  
  96.       *********************************************
  97.       ** Setting up a the demo version of BYE-PC **
  98.       *********************************************
  99.  
  100.   This demo package contains several executable files that demonstrate
  101. how BYE-PC functions. In order to set up BYE-PC you will need to select
  102. the appropriate communications port on your system. After you select
  103. the appropriate you port, you need to set up the 'AUTOEXEC.BAT' file to
  104. reload BYE-PC after the call is completed or carrier is lost. I usually
  105. setup BYE-PC to operate off of drive A: and set the path to look on
  106. drive A: and then drive C:. In either case, all you need is something
  107. to set your path up correctly and put BYE.COM in the path somewhere.
  108. The disk should contain the system tracks and COMMAND.COM to boot.
  109. When the caller hangs up and the system warm boots it will reload BYE-PC
  110. for the next call. My autoexec file looks like the following:
  111.  
  112.   Example:  {AUTOEXEC.BAT}
  113.  
  114.         PATH A:\;A:\SYSTEM;C:\DOS
  115.         GETCLOCK
  116.         BYE              -->
  117. (optional)  SHELL             --> BYE Security Shell (opt.)
  118.  
  119. The demo package contains the following files:
  120.  
  121.     COPYRGHT.BYE --> BYE-PC Copyright Notice and License agreement.
  122.     BYE-COM1.COM --> BYE.COM  for use with COM1 systems (300/1200).
  123.     BYE-COM2.COM --> "     "  " " " " "  " COM2 "     " (300/1200).
  124.     SHELL    .EXE --> Demo sample of SHELL for DOS security.
  125.     CHAT    .EXE --> Demo sample of CHAT for BYE.
  126.     XMODEM    .EXE --> Complete Xmodem Protocol file transmissions.
  127.     STAT    .EXE --> BYE-PC status control program.
  128.     BYEXFACE.H   --> BYE interface header for MSC.
  129.     BYEXFACE.C   --> BYE-PC interface to MSC Compiler.
  130.  
  131.   Your will need to select either one of the BYE-COMx.COM files and
  132. rename it to BYE.COM and place it in the root directory of your
  133. BYE-PC system disk. Set the corresponding AUTOEXEC.BAT file up as
  134. shown above. Next copy all of the .EXE files to the BYE-PC sysetm
  135. disk to allow for Xmodem downloading, chat, and status checks.
  136. If you wish to see how security functions can be performed while in
  137. DOS add the name SHELL right after BYE in the AUTOEXEC file. As soon
  138. as a caller logson and BYE-PC becomes active the shell will load and
  139. allows for checking of invalid drive, and paths names.
  140.  
  141.  
  142.   The Modem
  143.  
  144.   These are only demo versions of BYE and only work withs Hayes
  145. compatable modems. I have not yet implemented the 2400 bps version
  146. yet and only 300 and 1200 baud are currently available. BYE-PC can
  147. be configured to work with other modems but, the Hayes seems to be
  148. the standard for use with PC's. The modem must have a ribbon cable
  149. that provides all standard modem interface signals to operate correctly.
  150. I am currently using an ADC Hayes compatable with the standard Hayes
  151. switch settings. You will have to check the switch settings in the
  152. modem manual to make sure that the following are set:
  153.  
  154.            Swtiches Settings (see modem manual)
  155.  
  156.         Command Reckognition.....................ON
  157.         Numeric result codes.....................ON
  158.         Auto answer enable ......................OFF
  159.         Echo commands enable.....................OFF
  160.         Send result codes........................ON
  161.         Ignore DTR line..........................OFF
  162.         Ignore DTR line..........................OFF
  163.         Response to Carrier Detect...............ON
  164.  
  165.   Once you have the switch settings correct and the ribbon cable
  166. hooked up to the correct port you can boot from the disk by using
  167. Ctrl-Alt-Del. As soon as BYE-PC loads the modem will reset and the
  168. initialization strings are sent to the modem. If the characters are
  169. printing one at a time very slowly, then you do not have the cables
  170. hooked up properly or the computer serial port is not set up properly.
  171. The standard serial port for an IBM PC is configured in DCE mode to
  172. work with devices such as a modem and should not cause any problems.
  173. If you are using a different type of serial port from the IBM-PC
  174. standard you make sure it is setup in DCE mode or the appropriate
  175. conversion cable is made.
  176.  
  177.   Once the modem is initialized it is ready to receive calls. To exit
  178. BYE-PC just press Ctl-C and the user is prompted for the Resume exit
  179. message. Depressing the Return key will exit BYE-PC and return to DOS.
  180. Depressing 'R' will resume the call wait mode. Once a caller calls the
  181. modem will begin testing for the correct baud rate of the call. The
  182. remote end must depress the Carriage Return key <CR/Return> until the
  183. nulls question responds back. The carriage return is used to determine
  184. the baud rate rather than the modem response codes. Once the number of
  185. nulls is answered the user will drop into DOS or the DOS SHELL program.
  186.  
  187.  
  188.   PC BIOS Draw Backs?
  189.  
  190.   Once in DOS users can run any program that writes to TTY functions
  191. such as DEBUG, EDLIN, TREE, (etc...). Note that you can not use
  192. programs such as Word Star, Lotus and other programs that write directly
  193. to video ram. While this is a major drawback, you can still upload and
  194. download files and run bulletin board systems just as the cp/m systems.
  195. In the quest for fast programs and fancy windows and screens programmers
  196. bypassed the BIOS on pc's and caused the rest of the world problems in
  197. compatability. BYE-PC traps BIOS calls from the keyboard and tty-video
  198. to provide remote operation of the system. Any program that is compiled
  199. in a high level language and uses <stdin> and <stdout> as the device
  200. streams should work fine without any problems. 'C' is a very good
  201. development language to use to write application programs in. I have
  202. not used BASIC yet for any application programs. Interpretive BASICA
  203. will not work because it re-initializes the serial port to the defaults
  204. when it loads up. When the port is initialized it disables all inter-
  205. rupts to the port and effectivly disables BYE-PC.
  206.  
  207.   While all of the above problems seem like major drawbacks, its really
  208. no worse than the cp/m systems because you have all of the same fun-
  209. ctions except for remote BASIC operation. ARC and LU programs will
  210. work fine as well as any programs written assembly language that
  211. adhere to a set minor rules.(1) Use the BIOS to test for keyboard
  212. data ready and to actually get the keyboard data, (2) Use all
  213. write to tty fucntions to display character strings. Coming from the
  214. old cp/m world, these facts present no problems compared to old cp/m
  215. systems. You still have a much faster and capable machine for handling
  216. data and the interrupt driven i/o allows for greater reliabilty and
  217. ease of use.
  218.  
  219.  
  220.   Using 'BYEXFACE.C' to write applications in 'C'
  221.  
  222.   If you are a programmer and wish to test some of the capabilities of
  223. BYE-PC I have included the source code for interfaceing BYE-PC to 'C'
  224. programs. This interface was used to create XMODEM, STAT, SHELL, and
  225. CHAT for the utilities provided in this demo package. This code will
  226. compile using the Microsoft C Compiler verison 3.0 or 4.0. Compile
  227. this module directly and link it to the application that make calls to
  228. BYE-PC. This interface can be used to create a RBBS system to interface
  229. with BYE-PC. A good bulletin board system will set the appropriate
  230. status levels before allowing a user to enter DOS. Once in DOS, SHELL
  231. will check the status with BYE-PC before allowing users to perform a
  232. task. The source to SHELL can lock users out of any DOS function that
  233. user requires. If you wish to develop a bulletin board sytem, please
  234. contact me and we can discuss setting up the status levels for SHELL.
  235.  
  236.