
                4LOGIN -- NetWare v4.x Login Utility

              Copyright (c) 1994 Maxwell Nairn Andrews

                           KENT, ENGLAND

                     CompuServe ID: 100065,531



Date: 27-6-94, 16:51 PM

   Last 4LOGIN Version: v1.45
Current 4LOGIN Version: v1.47


Introduction
------------


4LOGIN is a NetWare v4.x LOGIN DOS program that contains
the following features:


        (1.     Automatic searching of the NDS tree for a LOGIN name

        (2.     A graphical front-end to the standard LOGIN.EXE program

        (3.     Error Logging of common LOGIN faults


4LOGIN was written by Maxwell Nairn Andrews with Borland C++ v4.0, with 
Turbo Vision. 4LOGIN is copyrighted but this product is FreeWare. Users
note that they use this program at their own risk. Also note that this 
program is ONLY for use as a NetWare v4.x LOGIN. It will not function with
NetWare v3.1x servers. VLMs are a mandatory requirement for the 4LOGIN 
program. The NDS.VLM must be loaded for the 4LOGIN program to work.


Installation
------------


Just copy the 4LOGIN.EXE file to your SYS:LOGIN directory on your NetWare v4.x
file server. Note that Novells LOGIN.EXE must be present in this directory, or
available via a search mapping. After installation you should use 4LOGIN as you
would LOGIN.EXE. Please use Novells NetWare v4.x LOGIN.EXE v4.08 or later with
4LOGIN.


Using the 4LOGIN Program
------------------------


The 4LOGIN program can be used with the keys:


        ESC

        TAB

        ENTER

        SPACE BAR


but loading a DOS MOUSE driver before the 4LOGIN program will enable full support.


To login just enter the LOGIN name (Without any NDS Context), hit the TAB key to go
to the Password entry (or select it with a Mouse), and then hit the ENTER key. The
search for the user will begin from the Context SET in the users NET.CFG. If this
setting is Not enabled the NDS search will begin at the [ROOT] of the NDS tree. The
F10 Expert options can be SET before any LOGIN searches commence. Any errors that
occur will be logged in the Monitor Window. The Error Monitor Window can be scrolled 
up, or down by using the PG-UP, and PG-DWN keys. To scroll left, and right use the 
Ctrl-Right, and Ctlr-Left keys. The history list for the Context, and Login name can
be enabled with the Down-Arrow key.

4LOGIN if executed in a BAT batch file returns the SAME ERRORLEVEL code as LOGIN.EXE.
An ERRORLEVEL code of 0 is returned for SUCCESS. The following ERRORLEVEL return codes
are returned for 4LOGIN errors:


                ERRORLEVEL 1 -- Novell NetWare Problem
                
                ERRORLEVEL 2 -- Invalid Password Length
                
                ERRORLEVEL 3 -- Can't EXECute Novells LOGIN.EXE Program
                
                ERRORLEVEL 4 -- User CANCELed the 4LOGIN program


4LOGIN Command Line Options
---------------------------

At present there is one command line parameter to change the default Login Banner.

For Example:


            4LOGIN "ANOTHER Corp System -- Accounting Department"


The above example will change the default login banner to:


            ANOTHER Corp System -- Accounting Department


4LOGIN Limitations
------------------

The 4LOGIN program at present needs to call Novells LOGIN.EXE so that LOGIN scripts,
PROFILEs etc can be executed. Since the password needs to be STUFFed into the keyboard
buffer a Maximum of 14 characters (15 - 1 for the CR) can be placed in the Password entry.
Please ensure that the Password length does NOT execeed 14 characters. The 4LOGIN program is only
supported on 286 CPU computers and above. Also, a VGA graphics card and monitor is required.
Grace Logins MUST be 'doubled' with the 4LOGIN program. If the User must have 6 Grace Logins
set, then the Grace Logins must be set to 12, when using the 4LOGIN program.


4LOGIN Environment Variable
---------------------------

4LOGIN uses the 4LOGIN environment variable. At present the following options
are implemented:


        (1.     ALIAS -- Enables Searching for Alias User Objects
        
        (2.     DEBUG -- Enables DEBUG Mode

        (3.     SDNC  -- Enables 'Set Default Name Context'
        
        (4.     SCOPE -- Changes the Default Referral Scope
        
        (5.     CONFIDENCE -- Changes the Default Confidence Level
                           -- The Default Confidence is HIGH 
        
        (6.     REQUESTER_CONTEXT -- Overrides the initial Search Context
                                  -- The default is the NAME CONTEXT in the
                                  -- NET.CFG. The context of [Root] is SET 
                                  -- if the NAME CONTEXT is Not located in 
                                  -- the NET.CFG.

        (7.     UTC_TIME -- Sets the PC clock to UTC time
        

        (8.     XMS_OVERLAY -- Sets the Overlay Buffer to use XMS Memory
        
        (9.     EMS_OVERLAY -- Sets the Overlay Buffer to use EMS Memory


        Example: SET 4LOGIN=<option1>;<option2>;<optionX>;<optionY>!ParameterX


Each valid option is seperated by a semi-colon ';'

For example:
                

                SET 4LOGIN=DEBUG;SDNC


The above example enables both DEBUG mode, and also the 'Set Default Name Context'


XMS_OVERLAY and EMS_OVERLAY Option
----------------------------------

If you are using the 4LOGIN Overlay version e.g 4LOGINOV.EXE the XMS_OVERLAY, and the
EMS_OVERLAY Options can be enabled. The XMS_OVERLAY/EMS_OVERLAY option instructs the
4LOGIN program to use either XMS, or EMS memory to swap instead of the disk. By using
this option the performance of 4LOGIN can be improved. For example:


                SET 4LOGIN=XMS_OVERLAY
                

The above example informs 4LOGIN to try to use XMS memory for Overlay Swapping. If XMS
memory cannot be used but EMS memory can, then EMS will be used instead.


DEBUG Option
------------

DEBUG is being developed by me to display additional NetWare 4 process that go on
in the background. You should not need to use this option as present.


SDNC Option
-----------

SDNC 'Set Default Name Context' option is used to alter the NDS Context after a valid
LOGIN name was located. By default after a LOGIN name is located that user is logged
in, but the NDS Name Context is NOT changed. To change the NDS Context to the located
user SET the SDNC option e.g:


                SET 4LOGIN=SDNC

ALIAS Option
------------

ALIAS enables the 'Searching' of Alias User Objects. By default Alias User Objects are
NOT searched for. To enable searching for Alias Objects, either check the Alias box in
the 'Advanced' options, or set the ALIAS option in the 4LOGIN environment variable e.g


                SET 4LOGIN=ALIAS

                
The DEBUG ALIAS, and SDNC options can be enabled with the F10 'Expert' mode.


EXPERT Option
-------------

To always display the 'Advanced' F10 options the 4LOGIN environemnt variable Expert can
be set. For example:


                SET 4LOGIN=Expert
                

The above example will always enable the F10 Expert Mode.

 
UTC_TIME Option
---------------

To have the PC date/time set to that of a DS Server e.g UTC time, then you can set the
the UTC_TIME option. For example:


                SET 4LOGIN=UTC_Time
                

The above example will set the PCs date/time to UTC. Ensure that the TZ environment variable
is set for your location. By default the date/time is read from the PC clock.


REQUESTER_CONTEXT Option
------------------------

The REQUESTER_CONTEXT option can only be set in the 4LOGIN environment variable. By
default the NAME CONTEXT is read from the NET.CFG, and this is used as the initial
search context. If the NAME CONTEXT is not found in the NET.CFG then the context of 
[ROOT] is set. For example:


                SET 4LOGIN=REQUESTER_CONTEXT!X.Y.Z
                

The above example initial sets the search context to: X.Y.Z


CONFIDENCE Option
-----------------

The CONFIDENCE option overrides the default Confidence for search operations. The
Confidence variable defines the expense, and level of risk you are willing to tolerate
to receive reliable information for the Directory Services. This Confidence can either
be 'Low', 'Medium', or 'High'. By default the Confidence will be High. Directory
Services currently supports 'High' Confidence Mode only. To set the Confidence using
the 4LOGIN environment variable use the following syntax:


                SET 4LOGIN=CONFIDENCE!<Level>
                

Where <Level> is either: Low Medium, or High. For example:


                SET 4LOGIN=CONFIDENCE!Medium
                

sets the Confidence Level to Medium.


REFERRAL SCOPE
--------------

The REFERRAL SCOPE option overrides the default Referral Scope for search operations.
The default Referral Scope is ANY. The Referral Scope can determine whether one server
refers you to another server to pursue a particular request. Referrals can occur when 
the directory client software is attempting to resolve a particular name, or when it's
fulfilling a search operation. There are 4 referral scopes namely:


                (1.     ANY      --  Any available server can respond to the request
                
                (2.     COUNTRY  --  Any server physically located in the same country
                
                (3.     COMPANY  --  Any server physically located in the clients organization
                
                (4.     LOCAL    --  Any server conected to the client by a local link
                
                
To set the Referral Scope using the 4LOGIN environment variable, use the following syntax:


                SET 4LOGIN=SCOPE!<contextScope>
                


Where <contextScope> is either: Any Country (Company/Organization), or Local. For example:


                SET 4LOGIN=SCOPE!Country
                

sets the Referral Scope to Country


To set the Referral Scope back to ANY then use the ALT-SPACE BAR key combination.

Note: Company and Organization can be interchanged with the 4LOGIN environment variable.


F2 Close
--------


Closes Dialog Windows


F10 Expert Mode
---------------


The F10 key in 4LOGIN toggles the Expert Mode. This is currently being developed, and
only the 'NDS Options', and 'NDS Context' have any effect in this released version.

                                 
Other FreeWare Programs by the Author
-------------------------------------

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
^ INIMgr v2.00 INI Management for Windows INI files ^
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Supports Windows v3.10, and Windows v3.11

Supports Windows for WorkGroups v3.11

Supports Novell NetWare v3.1x, and NetWare v4.x.

Fully Supports Novells v4.x NDS Schema using an ILM (INIMGR Loadable Module) module

Requires 580k free memory for NDS Support
