home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / lan / pls.arj / PLS.TXT < prev   
Text File  |  1992-01-27  |  7KB  |  209 lines
  1.                                         PLS
  2.                                Personal Login Script
  3.                                     Version 1.0
  4.                                Release date: 01/25/92
  5.                             Copyright 1992, Michael Volk
  6.  
  7.         PLS is a little utility I have written to solve a problem using
  8.         Novell Netware. There is no inherent way to know whether users have
  9.         a personal login script. If they do, it will be executed; if not,
  10.         the default login script will executed. Since as a network
  11.         administrator you wish to do as much as possible in the system
  12.         script, the user's HOME directory should be set there. However
  13.         SYS:%LOGIN_NAME (the assumption of the default login script) will
  14.         not work if SYS:DEPARTMENT\%LOGIN_NAME is used. Therefore I was left
  15.         with the choice either of making a script for every user (hoping
  16.         that no one erases it) or of using EXIT in the System login script
  17.         to prevent the DEFAULT USER SCRIPT from being executed.
  18.  
  19.         In many installations the solution is to place an EXIT command at
  20.         the end of the SYSTEM LOGIN SCRIPT, thereby preventing the user's
  21.         LOGIN SCRIPT or the DEFAULT SCRIPT from executing. I wanted to be
  22.         able to allow the users that are so inclined to use and learn more
  23.         about the network, including Login Scripts. At the same time, I
  24.         didn't want to waste the space required to create a script for every
  25.         user at 4k per file.
  26.  
  27.         Not being satisfied with either of these options, I decided to
  28.         provide a third solution. I wrote PLS, Personal Login Script, to
  29.         test for the existence of a user's script, to delete wasteful LOGIN
  30.         scripts (3 bytes or shorter), and to do it in a fashion that
  31.         involves no extra work for the Network Adminstrator once he has set
  32.         it up, even in the event that users delete their scripts.
  33.  
  34.                                 WARRANTY AND LICENSE
  35.  
  36.         No warranty of any kind is provided and the user assumes all risks
  37.         of operation. The program is provided AS-IS and the author shall not
  38.         be liable in the event of lost data or any other damage caused by
  39.         the program.
  40.  
  41.         The program was carefully written but if you do encounter errors or
  42.         bugs please report them to me.
  43.  
  44.         This program is FREEWARE. It is copyrighted software and you are
  45.         free to use it. You may distribute it ONLY under the following
  46.         conditions:
  47.  
  48.                 No modifications are made.
  49.                 This documentation must accompany the program.
  50.                 No fee is charged for the software.
  51.  
  52.         If you do use the software and find it helpful I would appreciate it
  53.         if you would drop me a note and let me know.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.         Compuserve - 70242,376
  68.         Internet - MVOLK@PUCC.PRINCETON.EDU
  69.  
  70.         Or via US Mail
  71.  
  72.         Mike Volk
  73.         91 Princeton Arms West
  74.         Cranbury, NJ 08512
  75.         609-448-2479  ( 6pm - 10pm EST only )
  76.  
  77.                                  USING THE PROGRAM
  78.  
  79.  
  80.  
  81.         Use is very easy.
  82.  
  83.         Copy PLS to you PUBLIC directory and flag it as SHARABLE, READ-ONLY.
  84.         For purposes of installation, knowledge of Netware is presumed.
  85.  
  86.         In your SYSTEM LOGIN SCRIPT
  87.  
  88.         MAP INSERT S16:=
  89.         ...
  90.         ...
  91.         ...
  92.         MAP h:=SYS:depart\%login_name
  93.  
  94.         #PLS
  95.         ;
  96.         ; If the script can't deleted or other error.
  97.         ;
  98.         IF "%ERROR_LEVEL">="3" then begin
  99.             Write "Please inform the Network Supervisor that there is a
  100.         problem";
  101.             EXIT
  102.         END
  103.         ;
  104.         ; If script is too short it is not run and it gets deleted.
  105.         ;
  106.         IF "%ERROR_LEVEL"="2" THEN BEGIN
  107.             Write "Your Script was too short and has been deleted."
  108.             EXIT
  109.         END
  110.         ;
  111.         ; If script isn't found
  112.         ;
  113.         IF "%ERROR_LEVEL"="1" THEN EXIT
  114.             WRITE "You have no personal Login script."
  115.             EXIT
  116.         END
  117.         ;
  118.         ; This line is not needed - Only there as feedback to verify
  119.         operation
  120.         ;
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.         IF "%ERROR_LEVEL"="0" THEN BEGIN
  134.             Write "Now executing %LOGIN_NAME's  Login Script"
  135.         END
  136.  
  137.  
  138.  
  139.                                     ERROR LEVELS
  140.  
  141.         0 - Login script exists and is more than 3 bytes long
  142.  
  143.         1 - Login script does not exist and EXIT should be executed to
  144.             prevent DEFAULT login script from executing.
  145.  
  146.         2 - Login script was 3 bytes or less and has been deleted. Exit
  147.             should be executed to prevent DEFAULT login script.
  148.  
  149.         3 - Error opening Login script - Exit should be executed.
  150.  
  151.         4 - Login script was not deleted, but should have been. You may want
  152.             to have a message that tells them to inform the Network
  153.             Supervisor to look into their script as there might be a
  154.             problem.
  155.  
  156.         Other error levels might appear but shouldn't. If they do, there
  157.         probably is an unrelated Netware error.
  158.  
  159.         This software has been tested on Novell Netware 386 v3.11 but should
  160.         work with older versions as well.
  161.  
  162.                                       CREDITS
  163.  
  164.         This program was written using Borland's Turbo Assembler v2.0 and
  165.         Base Two Development's Spontaneous Assembly.
  166.  
  167.         Programmer's Guide to Netware by Charles G. Rose, McGraw-Hill Lan
  168.         Times Book series.
  169.  
  170.         Mastering Turbo Assembler by Tom Swan, Hayden Books.
  171.  
  172.         I would also like to thank the following people:
  173.  
  174.         Charles G. Rose, not only for writing his book but also for his
  175.         prompt reply to my query that steered me into using a newer call to
  176.         obtain the information, and provided me with the correction to the
  177.         published information.
  178.  
  179.         Paul Troiano, for his assistance in getting me going with 80x86
  180.         assembly after so many years of not doing assembler.
  181.  
  182.         Malcolm DeBevoise, for assistance editing this document.
  183.  
  184.         I would also like to thank Charles L. Creesy, John E. Van Sant, Bob
  185.         LaFond and others whose names escape me just now for their
  186.         encouragement during this project and their kind ears whilst I
  187.         stumbled about when I started this.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                    OTHER PROGRAMS
  202.  
  203.         ONCE - meant to be used in conjection with utilities such as MIRROR
  204.         to run them ONCE a day -- using this allows you to run MIRROR the
  205.         first time you BOOT each day and not every time you reboot. File is
  206.         ONCE.ZIP
  207.  
  208.         Look for others to follow.
  209.