home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / jsc058.zip / README!.DOC < prev   
Text File  |  1998-03-08  |  14KB  |  349 lines
  1. JSecureCom (c) 1998 by Gary L. Robinson
  2. ver. 0.58J  (3-8-98) 
  3. Formerly known as NetChat (on OS/2 and Windows)
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14. JSECURECOM EARLY BETA
  15. This is a Beta Release!
  16. JSecureCom ver. 0.58J - EARLY BETA
  17.  
  18.  
  19.  
  20.  
  21.  
  22. What is JSecureCom?
  23. ******************
  24. JSecureCom is a personal communication tool.  It is designed to hook 
  25. two people up directly (without using the IRC channels, servers, IP 
  26. servers, etc.) for a one-on-one  personal text mode chat.  JSecureCom 
  27. utilizes a "Hailing feature" to accomplish this.  The hailing feature 
  28. uses a built in seamless e-mail facility to send your current IP 
  29. address to another JSecureCom user in a specially coded e-mail letter.  
  30. Once the Hail message is detected at the receipients (by his running
  31. copy of JSecureCom) it connects the programs together in a private
  32. communication session.
  33. *The current versions of SecureCom for OS/2 and Windows (95/NT)
  34. also has SEVERAL other features and capabilities that this BETA
  35. does NOT currently have.  Most of these features, including the
  36. ability to transfer files, will be added in coming Betas or in the
  37. first released non-beta version, 1.00.
  38.  
  39.  
  40.  
  41.  
  42.  
  43. Why is JSecureCom - and who is it for?
  44. *********************************
  45. JSecureCom has primarily been written to be a low overhead, 
  46. personal, one-on-one, direct, communication program with no reliance on 
  47. any extraneous servers or web pages.  While I do intend to make it better 
  48. and to add numerous enhancements or features, I do not intend to change 
  49. the basic scope and goal of the program.  it is intended to be a direct 
  50. communication program and will remain that way.  It was also written 
  51. because of my general dislike of the IRC Chat channels.  
  52. My limited experience there has not generally been a good one.   
  53. That's why JSecureCom does not rely on IRC channels or any other 
  54. extraneous servers - or the mercy of their owners.  It also does not rely on 
  55. any servers to see who is on line.  It will remain that way.
  56. So, if you want to talk to many, many people and remain anonymous 
  57. then this program may not be for you.  If you want to get on and chat with 
  58. people about sex fantasies and act like adolescents, perverts, or worse 
  59. then this may not be what you want.  This program is for people who want 
  60. to communicate directly with friends, business acquaintences, or family 
  61. members - people they already know in personal one-on-one chats.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. JSecureCom requirements
  68. **********************
  69. JSecureCom requires having Java 1.1 or greater installed on your
  70. computer.  It has been tested with Java 1.1.3 on Windows NT, 1.1.5
  71. on Windows 95, and 1.1.4 on OS/2.  It also requires that you have 
  72. TCP/IP installed and a true PPP or Slip internet account with an 
  73. e-mail address.  This software will NOT work peoperly for America 
  74. On Line customers because AOL doesn't supply a true PPP or Slip
  75. account.
  76.  
  77.  
  78.  
  79.  
  80.  
  81. IMPORTANT INFORMATION!!!
  82. ***********************
  83. This README!.DOC is NOT a complete help file OR manual on how to install
  84. or use SecureCom.  If you are ALREADY familiar with OTHER versions then 
  85. you probably JUST need to read this file for NEW information.  However, 
  86. if you are looking at SecureCom for the first time then please read the 
  87. NETCHAT.DOC (NetChat was the former name of the OS/2 version) file that
  88. is included in this beta package.  While it does NOT specifically explain
  89. JSecureCom much of the information for NetChat is very similar and
  90. worth taking a look at.
  91.  
  92.  
  93.  
  94.  
  95.  
  96. KNOWN BUG!!!
  97. ************
  98. This program has ONE well known bug.  The DividerBar on the main
  99. screen, used to change the size of the top and bottom entry areas,
  100. does NOT work properly on OS/2.  If you ATTEMPT to use it on OS/2
  101. it will render the application useless AND you will have to shut
  102. JSecureCom off and restart it.  On Windows the DividerBar works
  103. perfectly.  This problem is apparently a defect in the component
  104. as supplied by Borland J Builder 1.00 (the environment used to
  105. make JSecureCom).  Hopefully they will fix it during my life time.
  106. It is also possible that on OTHER non-Windows operating systems
  107. that the divider bar also may screw up.
  108.  
  109.  
  110.  
  111.  
  112.  
  113. Installing JSecureCom ( Class name : JCApp )
  114. ******************
  115. After unzipping this archive, copy the JSCOM.JAR file to a directory of
  116. it's own.  If you are running OS/2 then ALSO copy the JSCOS2.CMD file
  117. to the SAME directory.  If you are running Windows 95 or NT copy the
  118. JSCWIN.BAT file to the same directory.  OS/2 and Windows users would
  119. then just run their respective .CMD or .BAT file to execute the
  120. program.
  121. Alternately, you can just run the Java runtime executable at the
  122. command line with the appropriate switches.  The class name you
  123. would use to start the application is : JCApp
  124. The JCApp class name is CASE sensitive.  jcapp, JCAPP, etc. will NOT 
  125. work.  ONLY JCApp will work.
  126. Users of other OS's besides OS/2 or Windows will have to make their
  127. own batch files to execute the JSCOM.JAR file and run the program.
  128. Unfortunately, I do not have the resources to maintain any more
  129. operating systems at the moment.  If anyone on any other OS that
  130. tries this program wants to send me instructions for their OS I would
  131. be grateful and be sure to include it with any other releases of this
  132. program.
  133.  
  134.  
  135.  
  136.  
  137.  
  138. Setting up JSecureCom .....
  139. **********************
  140. ******INTERNET ACCT. SETTINGS
  141. Select Configure on the main menu bar and then select Internet Acct. 
  142. settings on the sub menu.  Please fill out ALL entry areas or the
  143. program may not work properly.
  144.  
  145. ++++++Settings for sending Hail messages++++++++++++++++++++++++
  146. 1. Enter your SMTP mail server.  Quite often, but certainly NOT
  147. always, this may be the same as the Pop server entry.
  148. 2. Enter your Complete e-mail address.  
  149. 3. Enter your Password.  (May not be necessary depending on your
  150. internet provider and how they have their SMTP server set up BUT
  151. ENTER IT ANYWAY to make the program happy)
  152. 4. Enter the e-mail address that you want people to send mail to you at.
  153. For most people that will be the same as above BUT many people use a
  154. variety of aliases and multiple accounts.
  155. 5.  Enter your full real name.
  156.  
  157. ++++++Settings for receiving Hail messages++++++++++++++++++++++++
  158. 1. Enter your internet providers Pop Mail server  in the first entry area
  159. 2. Enter your COMPLETE e-mail address in the next entry area
  160. 3. Enter your Password, usually supplied by your internet provider, in
  161. the password entry field.
  162.  
  163. Press the Save button when you are finished.
  164. Then ..... 
  165. Select Configure on the main menu bar and then select Misc. 
  166. settings on the sub menu.  
  167.  
  168. ++++++Misc.++++++++++++++++++++++++++++++++++++++++++++++++
  169. 1.  Set the time interval for monitoring for Hail messages to a new
  170. value IF you don't like the default 120 (seconds).
  171. 2.  Depending on whether you want to be prompted when you disconnect
  172. from a chat session and/or close the program check/uncheck the 2
  173. appropriate boxes for that.
  174. 3.  Change the default nickname to YOUR real first name or whatever you
  175. are used to being called .... :-)
  176. 4.  Shut off bubble help if desired.
  177. 5.  Lastly, enter your first name, nickname, or whatever you like to be
  178. normally called in the Nickname field.
  179.  
  180. Most users will not need to change ANY other settings.  Unless you have
  181. some special reason, the port settings should stay on the defaults.
  182.  
  183. Most of the OTHER tabbed pages are NOT set up yet.  The DividerBar
  184. page does have ONE setting to set up the INITIAL relative position of the
  185. divider bar when the program is first started.
  186.  
  187. Press the OK button to save your settings changes (yes, it should say
  188. Save - not OK).
  189.  
  190. That's ALL!!
  191.  
  192.  
  193.  
  194.  
  195.  
  196. SecureCom Quick Start
  197. *******************
  198. Below is basically how to get SecureCom up and running quickly and how
  199. to test it and see if you have it set up correctly.
  200.  
  201. 1.  Dial into your ISP and log onto the internet.
  202. 2.  Start a single instance of JSecureCom.
  203. 3.  After it is started PRESS once on the Monitor OFF button on the button 
  204. bar.  IF you have your Pop Mail server setting correctly entered, the Monitor 
  205. OFF button should change to the Monotor ON button with RED text.  If it
  206. starts to change and then goes back to Monitor OFF then you either do NOT
  207. have the pop mail server entered correctly OR SecureCom can't connect
  208. with your mail server for other reasons.  
  209. 4.  If step 3 was successful then Press once on the Hail button located on the
  210. button bar.  That will activate the Hail list dialog.  
  211. 5.  Click on the Add button on the button bar at the bottom of that dialog.  
  212. This activates the "Add a new record" dialog box.
  213. 6.  Type in YOUR name in the Name entry field.  Type in YOUR e-mail address
  214. in the  E-mail address field.  Press the Add button to save that record and close
  215. the dialog.
  216. 7.  Now you have an entry for yourself in the hail list dialog box.  Select that 
  217. entry and double click on it (or press ENTER or use the Hail Now button) to 
  218. send the Hail.
  219. 8.  In the titlebar you should see messages indicating negotiations with your
  220. SMTP mail server.  It should send the Hail message and notify you.  If it fails
  221. or returns an error message you probably do NOT have the correct setting
  222. entered for your SMTP mail server in the Internet Acct. settings.  
  223. After Hailing is completed the Listen OFF button on the button bar will change
  224. to Yellow and say Listen ON.  It is now waiting to see if anyone tries to 
  225. connect with it via TCP/IP. 
  226. 9.  If step 8 was successful AND you still have JSecureCom in Monitor ON mode
  227. (Monitor ON button text is RED) then sit back and wait.  In a few seconds OR
  228. longer (depends on Hail monitor setting in Misc. settings) you should be notified
  229. by a dialog and and a beep that you are being hailed.  
  230. 10.  If step 9 was successful then DECLINE the Hail message by pressing the
  231. CANCEL button.  You can NOT connect with yourself with a single copy of 
  232. SecureCom.  Actually, this BETA will connect with itself BUT it will scew it 
  233. up and you would have to restart the app.  
  234.  
  235. This was ONLY a test.
  236.  
  237. NOW ..... LETS CONTINUE AND DO TEST NUMBER 2
  238. 11.  Keep SESSION number 1 of SecureCom up and running in Monitor ON mode (the
  239. Monitor ON button is RED)
  240. 12.  Start a SECOND session of JSecureCom.  (How to do this varies per platform)
  241. 13.  Leave it in Monitor OFF mode.
  242. 14.  Make sure BOTH are in Listen OFF mode.  (the button can be toggled on/off)
  243. 15.  Put an entry for yourself in the Hail list (as described above in parts 
  244. 4-7) in SESSION number 2 and Hail yourself again.
  245. 16.  This time (assuming all has gone well) SESSION number 1 will receive the
  246. Hail message you just sent with SESSION number 2 ..... in a few seconds.
  247. 17.  When SESSION number 1 receives the Hail notification select and press
  248. the Connect button.  
  249. 18.  This should connect the two copies of JSecureCom.  The titlebar on both
  250. copies should note it as well as a message passed back and forth in the top
  251. entry field.  Also, the Listen ON/OFF button will now be RED and say
  252. Connected!  Feel free to talk back and forth to yourself .... :-)  
  253.  
  254. Type text in the bottom entry area and press ENTER to send it to the other
  255. running copy of JSecureCom.  
  256.  
  257. Now that you are connected you can ALSO press the Monitor ON button on
  258. copy 1 of JSecureCom (it will toggle to OFF) and stop monitoring for Hail 
  259. messages if desired.
  260.  
  261. Play with it to get the feel of how the app works.  
  262.  
  263. Hint : try the "Remote party info" and the "Wake up" menu items on the
  264. File menu (or the popup menu on the top entry area)
  265.  
  266. Press the Echo button - it tells you if the connection is still alive (though,
  267. sometimes under real internet use there may be a 1-5 second delay
  268. depending on net conditions). 
  269.  
  270. To terminate the connection ... just press the Connected! button (and it 
  271. will toggle to Listen OFF).
  272.  
  273.  
  274.  
  275.  
  276.  
  277. WHAT DOES NOT WORK YET IN THIS BETA!!!
  278. ************************************
  279. 1.  File transfer is NOT yet implemented
  280. 2.  Current IP address menu item ONLY works correctly WHILE connected
  281. 3.  Hail Log not implemented yet
  282. 4.  Favorite Phrases not implemented yet
  283. 5.  Help not implemented yet
  284. 6.  Register screen not implemented yet
  285. 7.  Numerous settings pages not enabled yet.
  286. 8.  And other things!  :-)
  287.  
  288.  
  289.  
  290.  
  291.  
  292. A SPECIAL Thanks ...
  293. *****************
  294.  
  295. First off, I would like to thank Borland International Inc. for
  296. making J Builder 1.00.  A year ago, I considered Java a
  297. joke and a toy.  With great improvements in Java AND the
  298. advent of Java RAD tools like J Builder -- Java is NO longer
  299. a joke.  It is for real.  This program was made with J Builder
  300. 1.00.  Thanks Borland!   Now .....  where's version 2.0 ?
  301.  
  302. Also, a thank you to Barry Adams (of Duncan, Vancouver B.C.)
  303. and Junior Thompson (of W. Milton, Ohio) for helping me to test 
  304. this thing as it has progressed.  Beta testers help keep us 
  305. egocentric programmers honest .... :-)
  306.  
  307. And a thank you to I.B.M. for continuing to destroy the OS/2
  308. operating system.  Otherwise, I wouldn't even have looked at
  309. Java.  Thanks I.B.M.!  Hope Microsoft buys you next year and
  310. fires all the top management.
  311.  
  312.  
  313.  
  314.  
  315.  
  316. The END of this README!
  317. *********************
  318. Well you made it to the end of this README.DOC!
  319. I HIGHLY RECOMMEND that you also read the NETCHAT.DOC that is
  320. included in this archive IF you are not familiar with some of the 
  321. features of this program.
  322.  
  323. Please report ANY bugs, problems, anomolies, bad jokes, or otherwise
  324. to me at : grobin@iname.com OR grobin@coax.net.  
  325.  
  326. Or Hail me with JSecureCom at those e-mail addresses (best time to
  327. hail me is (00:30 - 06:30 E.S.D.S.T.)
  328.  
  329. I would be especially interested to hear from any NON Intel platform 
  330. users.  
  331.  
  332. One last note.  NetChat for OS/2 and Win95/NT are still on sale directly
  333. from me OR from BMT Micro.  Anyone, who buys NetChat will ALSO get
  334. JSecureCom 1.00 FREE when it is released.  
  335.  
  336.  
  337. Gary L. Robinson
  338. P.O. Box 359
  339. Christiansburg, OH  45389
  340.  
  341. grobin@coax.net
  342. grobin@iname.com
  343. http://www.coax.net/people/grobin
  344.  
  345.  
  346.  
  347.  
  348.  
  349.