home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / lan / alogin12 / alogin.doc < prev    next >
Text File  |  1990-02-16  |  12KB  |  272 lines
  1.  
  2.                          AutoLogin
  3.   
  4.   The automated login program for the LANtastic Network Operating System. 
  5.  
  6.  
  7.     "Real programmers don't write specs - users should consider 
  8.      themselves lucky to get any programs at all and take what they get."
  9.  
  10.                - From "Real Programmers Don't Write Specs"
  11.  
  12.  
  13. I have never really been good at writing documentation, but fortunately
  14. this program is pretty easy, so we're all in luck!  Anyway, I must first
  15. make the following disclaimer:
  16.  
  17. Yes, I wrote this program, and I have found that it works fine on my
  18. computer in my office.  If, for some very odd reason, it does not work on
  19. yours; or further, if it causes damage to your system for any reason,
  20. I will assume NO responsibility for such damages.  Also, noting that the
  21. programmer is an employee of Artisoft, Inc., note that Artisoft is not
  22. responsible for the contents of this documentation file; the functioning
  23. of the program which this documentation describes (or any damages
  24. resulting from the use or misuse of the program); and further, Artisoft
  25. Technical Support and other employees of Artisoft, Inc. (except J Gerring)
  26. are NOT RESPONSIBLE FOR SUPPORTING THIS PROGRAM!  If you have problems or
  27. suggestions when using this program, direct them to the author, J Gerring,
  28. using ONLY the following methods:
  29.  
  30.     US Mail:          4908 N. Via Carina, Tucson, AZ  85704
  31.         CompuServ:        IBMCOM forum, 76050,1210
  32.         Arti-facts BBS:   If you have a current account there.
  33.         Salt Air BBS:     Ibid.
  34.  
  35. Do NOT call the author during business hours for support, this program was
  36. not written during business hours, it will not be supported during
  37. business hours.
  38.  
  39. Which leads me to the following:  The ALOGIN program is hereby declared
  40. Public Domain (starting with version 1.2) and the source code is included.
  41. You may freely use it, distribute it as the file ALOGIN.ZIP (containing
  42. the files ALOGIN.EXE and ALOGIN.DOC and ALOGIN.C) and give as many copies
  43. to your friends as you like.  If you find it useful, fun, and interesting,
  44. drop me a postcard and say thanks!  This program is copyrighted, so if you
  45. are interested in using any part or all of the source code in your own
  46. programs, please contact me for licensing. 
  47.  
  48. Note:
  49. Previous versions of ALOGIN were designated as shareware.  I changed my
  50. mind.  Anybody could write this program, I just happened to take a weekend
  51. out to do it. Consider any earlier versions Public Domain also, but you
  52. should probably upgrade to this version anyway.
  53.  
  54.  
  55. -----------------------------------------------------------------------------
  56.  
  57. Release History:
  58.     
  59.     10-1-89   -  First release of program, I'm betting it won't need beta
  60.                      testing!
  61.  
  62. v1.0    10-2-89   -  Modified program to continue processing after encountering
  63.              an invalid command statement in user's data file.  Ok,
  64.              but at least I found this one before it was pointed out...
  65.              (this release says "AutoLogin 1.0 ..." in opening  
  66.                      message, previous version did not.)
  67.  
  68. v1.1    10-13-89  -  Added multiple adapter support. Previously, AutoLogin
  69.              would only work on adapter 0.  See documentation for 
  70.              further details.
  71.  
  72. v1.2    02-09-90  - Fixed a minor bug in the parser, re-designated the
  73.                     thing as Public Domain, and gave you the source code 
  74.                     so you can fix the rest of the bugs!  (just kidding, 
  75.                     if you find any, please let me know.)
  76.  
  77. -----------------------------------------------------------------------------
  78.  
  79.             Ok, here's the documentation! (finally...)
  80.  
  81. OVERVIEW     (or, after writing a program, how do I tell you about it?)
  82.  
  83. Note that this documentation file assumes that the reader has some
  84. experience with the LANtastic Network Operating System (LANOS).  If you're
  85. a brand new user, I'd suggest reading up on LANOS first.  The function of
  86. ALOGIN is to provide an easy interface for logging into, and using devices
  87. on LANOS servers from the workstation (or redirector).  In general, it
  88. does this by accepting as user keyed input a username and a password, then
  89. reading a data file which the system administrator (or whoever) has set up
  90. for the specified username.  Details follow:
  91.  
  92.  
  93. SETTING UP   (there's always a setup, but don't be paranoid...)
  94.   
  95. Before you run ALOGIN, you need to set up a data file for the user.  This
  96. file is just an ASCII file which you need to locate in your \LANTASTI file
  97. directory.  ALOGIN determines the file name by the following algorithm:
  98.  
  99.     if username (entered at run time) is less than 9 characters then
  100.         filename = \LANTASTI\username.DAT
  101.     else
  102.         concatonate first 4 characters of username with last 4 
  103.         characters and
  104.                 filename = \LANTASTI\username[1 to 4]+username[n-4 to n].DAT
  105.  
  106. Examples:   
  107.     
  108.     username entered                 filename extracted
  109.         ----------------                 ------------------
  110.         MARK                 MARK.DAT
  111.     $MANAGER             $MANAGER.DAT
  112.     PROGRAMMER             PROGMMER.DAT
  113.     ADMINISTRATION1             ADMIION1.DAT
  114.      ---------------------------------------------------
  115.  
  116. So, now that you know how the filename is extracted, then get into your
  117. favorite word processing program and create an ASCII username.DAT file
  118. following these easy rules:
  119.  
  120.     1. Basic rule of thumb: ALOGIN processes only NET LOGIN or NET USE 
  121.        statements.  Statments are entered one (1) per line, with the 
  122.        NET part omitted.  
  123.     2. If you feel like putting in a comment, start the line with a 
  124.        semicolon character (;).  
  125.     3. Put in as many blank lines and other white space characters BETWEEN
  126.        statement lines as you like.
  127.     4. Don't put comments on the same line as a command statment.
  128.     5. Don't put extra arguments on a statement line, or you will get an
  129.        error message from ALOGIN concerning that line.
  130.     6. LOGIN lines contain only the server name and an optional
  131.            adapter number, ALOGIN assumes that the  user has the same 
  132.            password on each server.  (ed's note: this
  133.        was done to create tight security; you don't have your password
  134.        published in an easily readable .BAT or .DAT file anywhere.  If you
  135.        don't use passwords, just hit the enter key when ALOGIN prompts
  136.        you for password.)  If an adapter number is not entered, ALOGIN
  137.            will attempt the login on all possible adapters, starting with
  138.            adapter 0.  If an adapter number is specified, ALOGIN will
  139.            attempt to login to that server ONLY on that adapter number.
  140.            DO NOT enter the '\\' in front of the server name on the LOGIN line.
  141.            E.g. LOGIN TECHDATA is right, LOGIN \\TECHDATA is wrong.
  142.     7. USE lines are done just like you were typing them into the
  143.            keyboard or in a BAT file, but without the NET part.
  144.  
  145. Here's a (real live) example file:
  146.  
  147. ;This file logs me into all the machines on the network that I want to use.
  148. ;Additionally, I can write a whole novel of comments!
  149.  
  150. ;login to techdata 
  151.  
  152. login techdata
  153. use f: \\techdata\rootd
  154. use g: \\techdata\root
  155. use m: \\techdata\rootd
  156. ;login to Lu's machine, try login only on adapter 1
  157. login lka 1
  158. use lpt1 \\lka\@laser
  159. use lpt2 \\lka\@lkalase
  160. use l: \\lka\root
  161. ;do bbs login
  162. login bbs
  163. use n: \\bbs\root
  164. use o: \\bbs\rootd
  165.  
  166. login bruce fun
  167. ;note that the above line WILL produce an error message!
  168. ;end of login file
  169.  
  170.  
  171.  
  172. RUNNING ALOGIN    (one small set of keystrokes for humankind...[apol. to N.A.])
  173.  
  174. ...is really quite easy.  I will leave the basics to the reader...
  175.  
  176. However, I will mention a couple of things.  First, as mentioned before,
  177. ALOGIN will prompt you for a USERNAME and a PASSWORD.  The assumption is
  178. that you use the same username and password across the LAN.  If this is
  179. not true, you will need to create a \LANTASTI\username.DAT file for each
  180. username that you use on the LAN and invoke ALOGIN multiple times.  Or,
  181. you can make it easy on yourself and use the same username across the
  182. LAN...  If you have different passwords on each server, the best solution
  183. is to change them all to be the same, it will save you a lot of headaches!
  184. There are two basic Ideas behind the function of ALOGIN: 
  185.  
  186. 1) To make it easy and fast to login to more than 1 server while providing
  187. good security.  ALOGIN prompts for a password (and echos *s) so that you
  188. don't have to prompt for it on each NET LOGIN line of a batch file.
  189. (which you should be doing if security matters at all on your LAN) The USE
  190. part of the program was thrown in for completeness. 
  191.  
  192. 2) To make it easy for different people who are using the same workstation
  193. at different times to obtain access to those resources that they need to
  194. access.  For example, say you have a part-time payroll accountant and a
  195. part-time student programmer who work for the same company.  They share
  196. the same machine and office (they work non-overlapping hours, of course),
  197. and obviously need access to very different resources - and you may not
  198. want them to have access to each others resources.  Maybe the programmer
  199. is paranoid that her programs might be "missing" one day...  So, create
  200. ALOGIN data files for each one and you've headed off some potential
  201. problems!  AND maintained security.  Wow!
  202.  
  203.  
  204. WHAT HAPPENS NEXT  (or "to function correctly or not to function crrecly")
  205.                         [apol. to you-know-who]
  206.                 
  207. Ok, so, you create your data file, run ALOGIN, and enter the username and
  208. password.  Did it work?  Here's how you know...
  209.  
  210. ALOGIN displays messages in the following order:
  211.  
  212. Opening message:           --- AutoLogin for LANtastic (tm) ---
  213.                                  (c) J Gerring, 1989, 1990 
  214.  
  215. Username prompt:           Enter username:
  216. Password prompt:           password:
  217.  
  218. Then, when you hit enter, it tries to open the data file for the username
  219. you entered.  If no file exists, you'll hear about it - this is the only
  220. aborting error condition, bad lines in the .DAT file produce error
  221. messages, but processing of the file continues.  If ALOGIN dies due to a
  222. non-existant data file (say, if you mistakenly type MMARK for your user
  223. name), the ERRORLEVEL is conveniently set to 1.  Next, it begins executing
  224. the statements from the data file, displaying info about what it's doing
  225. along the way.  You'll get messages which indicate success or failure of
  226. the data file statments.  To explain, here's a complete capture of the
  227. screen output of an ALOGIN run based on the example data file above:
  228.  
  229.           --- AutoLogin for LANtastic (tm) ---
  230.                  (c) J Gerring 1989, 1990 
  231.  
  232. Enter username: $jag
  233. password: **
  234. Logging in to all defined servers for your username...
  235.  
  236. Logged into: TECHDATA
  237. Device F: redirected to \\TECHDATA\ROOTD 
  238. Device G: redirected to \\TECHDATA\ROOT 
  239. Device M: redirected to \\TECHDATA\ROOTD 
  240. Error logging into LKA -> Duplicate redirection or login to network node LKA
  241. Error redirecting LPT1 -> Duplicate redirection or login to network node LKA
  242. Error redirecting LPT2 -> Duplicate redirection or login to network node LKA
  243. Error redirecting L: -> Duplicate redirection or login to network node LKA
  244. Error logging into BBS -> Cannot locate network name   
  245. Error redirecting N: -> Path not found 
  246. Error redirecting O: -> Path not found 
  247. Warning: Badly formatted LOGIN statement ->LOGIN BRUCE FUN<-
  248. Login finished!
  249.  
  250.  
  251. A LITTLE TROUBLE SHOOTING   (although they are often difficult targets)
  252.  
  253. Generally, your output should look like the first 4 message lines of the
  254. above example for each login and redirection in the data file (starting
  255. with the line "Logged into: TECHDATA").  If you see error messages (as in
  256. the above example), these are the most common reasons:
  257.  
  258. 1) The server specified in the LOGIN statement is not powered on.
  259. 2) Specified server is not currently running LANOS.
  260. 3) Specified server is not running the LANOS SERVER program.
  261. 4) You are already logged into that server, or have already redirected the
  262.    specified device.
  263.  
  264. If you are getting very odd error messages that look something like
  265.  
  266.    Error redirecting LPT1 -> \\LKA\@LASER
  267.  
  268. then you aren't running LANOS...
  269.  
  270.  
  271. THE END         (Well, I never claimed to be a "real" programmer anyway...)
  272.