PLEASE READ THIS FILE IN ITS ENTIRETY BEFORE ATTEMPTING TO SET UP SHORT_LN ON YOUR NETWORK. What is SHORT_LN? ----------------- SHORT_LN is a FREE utility designed to provide a fast and easy way to create a Novell Netware drive mapping for user's with login names greater than 8 characters. SHORT_LN is a much faster alternative than using login script commands to shorten the login name. How does SHORT_LN work? ----------------------- SHORT_LN is executed from within the system login script by using the # command with several parameters, including the user's login name. SHORT_LN creates a file called NAMEMAP.INC which contains the Netware MAP command necessary to map a user's login name to a directory. If the login name is greater than 8 characters, SHORT_LN generates a MAP command with only the first 8 letters. Once the NAMEMAP.INC file is created, the next line in the login script uses the login script INCLUDE command to execute the commands in the NAMEMAP.INC file for processing. That's all there is to it! System Requirements ------------------- Server: SHORT_LN has been tested on Netware 2.15x or later and Netware 3.1x or later servers. Workstation: Netware DOS clients Contents of Archive ------------------- The following files are contained in this archive: SHORT_LN.EXE - the program file SHORT_LN.TXT - the documentation (this file) FILE_ID.DIZ - SHORT_LN description file Distribution Conditions ----------------------- You are free to distribute SHORT_LN as long as the following conditions are met: 1) The distributed archive must contain ONLY the files listed above. 2) The contents of the archive are NOT MODIFIED in any way. 3) This program is NOT sold in any way. 4) This program is NOT bundled with a commercially sold package (or book) without permission from HyeWare Incorporated. Installing SHORT_LN ------------------- SHORT_LN is relatively simple to install, however we recommend not testing it on an active network (please try it out after hours). If you want, after reading these instructions, you can test the functionality of SHORT_LN before adding it to your system login script by just running it from a DOS prompt with the necessary parameters and examining the NAMEMAP.INC file. 1) To install SHORT_LN, copy the program file SHORT_LN.EXE into a directory which has be mapped to a location where all users have read rights (e.g., SYS:PUBLIC). NOTE: This mapping should occur prior to running SHORT_LN from the system login script. Next, in the system login script, run the SHORT_LN program from the login script with the following command line parameters: #SHORT_LN login_name server_path output_path { -sN or -mL } [options] Where: 'login_name' is the user's login name. You should simply specify the login script variable %LOGIN_NAME as the login name. 'server_path' is the path on the network where the user's home directories are located. (e.g., If you specify SERVER_1/USER:HOME as the server_path. SHORT_LN will create a command to map a directory to SERVER_1/USER:HOME\. 'output_path' is the path where you want SHORT_LN to create the include file NAMEMAP.INC. This needs to be somewhere on the local hard disk of the workstation. The directory where network client files are located is a good choice (i.e., C:\NWCLIENT) Putting it in a common place on the network might cause a potential problem if two users log in at the exact same time. If you have diskless workstations, refer to Example #3 below. Either '-sN' or '-mL' must be provided on the command line to identify the type of MAP command to generate. -sN = Create a MAP command as a search drive, where 'N' is the position number of the search drive map (a number from 1 to 16) -mL = Create a MAP command as a normal drive letter map, where 'L' is a drive letter from F to Z. An asterisk in place of L will map to the first drive letter (i.e., MAP *1:= ...) The following options can also be provided on the command line: -?, -h = Display a usage screen -q = Quiet mode, don't display any processing information -r = Include the ROOT qualifier in the MAP command -i = Include the INS qualifier in the MAP command SHORT_LN generates a file called NAMEMAP.INC which contains the following information: DOS SET USER = "normal login name" DOS SET USER_8 = "shortened login name" MAP :=SERVER_1/USER:HOME\ For example, running SHORT_LN with the following parameters: SHORT_LN SUPERVISOR SERVER_1/USER:HOME C:\NWCLIENT -s1 -r -i would create the NAMEMAP.INC file in the C:\NWCLIENT directory with the following information: DOS SET USER = "SUPERVISOR" DOS SET USER_8 = "SUPERVIS" MAP ROOT INS S1:=SERVER_1/USER:HOME\SUPERVIS 2) Next, on the following line in the system login script, add a command to include the NAMEMAP.INC file for processing. For example: INCLUDE C:\NWCLIENT\NAMEMAP.INC Installation is complete. Refer to the examples section below for several ways to configure SHORT_LN. Examples -------- Example #1: ---------- Here's an excerpt from a system login script where a user's home directory is map rooted to drive X: on SERVER_1/USER:HOME\, where is the shortened login name. The NAMEMAP.INC file is stored in the C:\NWCLIENT directory. -------------------------------------------------------------------------- Remark: ******************************************************************* Remark: Map the Z: drive to the PUBLIC directory on the SYS volume Remark: of server SERVER_1 as search path #1 Remark: ******************************************************************* Remark: MAP ROOT INS S1:=SERVER_1/SYS:PUBLIC Remark: ******************************************************************* Remark: Run SHORT_LN from Z:\ to truncate the login name to 8 characters. Remark: Create a MAP ROOTED command using the X: drive as the user's home Remark: directory Remark: ******************************************************************* Remark: #Z:\SHORT_LN %LOGIN_NAME SERVER_1/USER:HOME C:\NWCLIENT -mX -r -q Remark: ******************************************************************* Remark: Execute the login script commands in the NAMEMAP.INC file to correctly Remark: map to the user's home directory. Remark: ******************************************************************* Remark: INCLUDE C:\NWCLIENT\NAMEMAP.INC -------------------------------------------------------------------------- If user ALEXANDER logged on with example #1 configured, the NAMEMAP.INC file would contain the following lines: DOS SET USER = "ALEXANDER" DOS SET USER_8 = "ALEXANDE" MAP ROOT X:=SERVER_1/USER:HOME\ALEXANDE Example #2: ---------- Here's an excerpt from a system login script where a user's home directory is map rooted, and inserted in the path as a search drive in position #1 on SERVER_1/USER:HOME\. Where is the shortened login name. The NAMEMAP.INC file is stored in the C:\NWCLIENT directory. -------------------------------------------------------------------------- Remark: ******************************************************************* Remark: Map the Z: drive to the PUBLIC directory on the SYS volume Remark: of server SERVER_1 as search path #1 Remark: ******************************************************************* Remark: MAP ROOT INS S1:=SERVER_1/SYS:PUBLIC Remark: ******************************************************************* Remark: Run SHORT_LN from Z:\ to truncate the login name to 8 characters. Remark: Create a MAP ROOTED drive letter inserted into the path as a search Remark: drive at position #1. Remark: ******************************************************************* Remark: #Z:\SHORT_LN %LOGIN_NAME SERVER_1/USER:HOME C:\NWCLIENT -s1 -r -i -q Remark: ******************************************************************* Remark: Execute the login script commands in the NAMEMAP.INC file to correctly Remark: map to the user's home directory. Remark: ******************************************************************* Remark: INCLUDE C:\NWCLIENT\NAMEMAP.INC -------------------------------------------------------------------------- If user RICHARDSON logged on with example #2 configured, the NAMEMAP.INC file would contain the following lines: DOS SET USER = "RICHARDSON" DOS SET USER_8 = "RICHARDS" MAP ROOT IN S1:=SERVER_1/USER:HOME\RICHARDS Example #3: ---------- Here's an excerpt from a system login script where a user's home directory is map rooted as the F: drive on SERVER_1/USER:HOME\, where is the shortened login name. The NAMEMAP.INC file is stored in the user's SYS:MAIL directory. -------------------------------------------------------------------------- Remark: ******************************************************************* Remark: Map the Z: drive to the PUBLIC directory on the SYS volume Remark: of server SERVER_1 as search path #1 Remark: ******************************************************************* Remark: MAP ROOT INS S1:=SERVER_1/SYS:PUBLIC Remark: ******************************************************************* Remark: Map the M: drive as a temporary drive to point to this user's Remark: SYS:MAIL directory. Remark: ******************************************************************* Remark: MAP ROOT M:=SERVER_1/SYS:MAIL\%USER_ID Remark: ******************************************************************* Remark: Run SHORT_LN from Z:\ to truncate the login name to 8 characters. Remark: Create a MAP ROOTED command using the F: drive as the user's home Remark: directory and storing the NAMEMAP.INC file in the M: drive Remark: ******************************************************************* Remark: #Z:\SHORT_LN %LOGIN_NAME SERVER_1/USER:HOME M:\ -mF -r -q Remark: ******************************************************************* Remark: Execute the login script commands in the NAMEMAP.INC file to correctly Remark: map to the user's home directory. Remark: ******************************************************************* Remark: INCLUDE M:\NAMEMAP.INC Remark: ******************************************************************* Remark: Remove the temporary MAP to the M: drive Remark: ******************************************************************* Remark: MAP REM M: -------------------------------------------------------------------------- If user JROBINSON logged on with this example, the NAMEMAP.INC file in the user's SYS:MAIL directory would contain the following lines: DOS SET USER = "JROBINSON" DOS SET USER_8 = "JROBINSO" MAP ROOT F:=SERVER_1/USER:HOME\JROBINSO NOTE: This example is ideal for sites with diskless workstations. Support ------- If you find a bug in SHORT_LN, you have suggestions, or you would like to have some additional features added, please send mail to us at one of the following: Internet: HyeWare@aol.com Compuserve: 74007,1007 America Online: HyeWare Postal: HyeWare Incorporated 1070-E Highway 34, Suite 196 Matawan, NJ 07747-3459, USA When you send a bug report, please include a description of the procedure for reproducing the bug and a description of your system's configuration. History ------- Version Date Release Description/Changes ------- --------- --------------------------------------------------------- 1.00 16 Sep 94 Initial free public release Minor fixes 0.95b 9 Sep 94 Second beta release Added more control to configure the MAP command -sN option for search mappings -mL option for regular drive letter mappings -r option for MAP ROOT ... -i option for MAP INS S1:= ... Minor bug fixes 0.91b 6 Sep 94 Internal beta release Added the capability to verify that output_path was valid Minor bug fixes 0.90b 25 Aug 94 First beta release Acknowledgements ---------------- Novell and Netware are registered trademarks of Novell, Inc. Disclaimer ---------- Users of SHORT_LN must accept this disclaimer of warranty: The author, HyeWare Incorporated, disclaims any warranty or representation, either express or implied, with respect to this software and documentation, including its quality, performance, merchantability, or fitness for a particular purpose. As a result, this software and documentation are supplied "as is", therefore use at your own risk. In no event will HyeWare Incorporated be liable for direct, indirect, incidental or consequential damage arising out of the use or inability to use the software or documentation, even if advised of the possibility of such damages. In particular HyeWare Incorporated is not responsible for any costs including but not limited to those occurring as a result of lost profits or revenues, loss of use of computer program, loss of data, the cost of substitute programs, claims by third parties or for similar costs.