NCUPDATE

Purpose

Use at a workstation to automatically update users' NET.CFG files with a new name context after a container has been moved or renamed.

Syntax

NCUPDATE [/? | /VER] [/NP]

Parameter	Use to
/?	View online help. (Other parameters are ignored.)
/VER	View the version number of the utility and the files it uses to execute. (Other parameters are ignored.)
/NP	Avoid getting the prompt that asks whether to update the name context in the NET.CFG file.

Using NCUPDATE

You can execute NCUPDATE at the command line, but it is designed to be run from a container login script.
When you move or rename a container object using NetWare Administrator or NETADMIN, you can create an alias that points to the moved or renamed container.
An alias allows users who do not know the container has been moved or renamed to continue seeing the container (and the objects in it) by its original name or in its original location.
In addition, an alias allows users whose name context in their NET.CFG file refers to the moved or renamed container to continue to log in, even though their actual context in the Directory tree has changed.
Because moving or renaming a container object changes the context of both the container and any users below the container, users in and below that container must update their name context in their NET.CFG file.
To automatically update user NET.CFG files , place a command to execute NCUPDATE in the login script of the moved or renamed container and every container in and below it.
When users who are in or below the moved or renamed container log in, LOGIN recognizes that the context used to log in contains an alias . Then LOGIN sets the internal script variable LOGIN_ALIAS_CONTEXT to "Y."
The network supervisor can place a command to run NCUPDATE in the login script of a container using NetWare Administrator or NETADMIN.

Example

The network supervisor—or a user with the Supervisor object right to the moved or renamed container—can place the following lines in the login script of the container and every container in and below the container:

IF LOGIN_ALIAS_CONTEXT = "Y" THEN BEGIN

MAP INS S1:=<server name>/SYS:PUBLIC

#NCUPDATE /NP

MAP DEL S1:

END

When users log in to the server using an alias context, NCUPDATE updates each user's name context in the NET.CFG file.




	NOTE: NCUDATE updates the NET.CFG file that the Virtual Loadable Module™ (VLM™) programs load from. The location of this NET.CFG file on users' workstations may vary, so the path to the NET.CFG file that will be updated is listed on the screen as NCUPDATE executes.

In the example login script, the supervisor maps a temporary search drive to SYS:PUBLIC so the container login script can locate NCUPDATE.EXE in the PUBLIC directory. Then the search drive is deleted.

The supervisor deletes the /NP in the example login script if he or she wants the users to be prompted to update their NET.CFG files.

Once all user NET.CFG files are updated, the supervisor deletes the alias that points to the moved or renamed container.

Additional Information

Topic	See
Alias objects	"Alias object" in Concepts
Login scripts	"About Login Scripts" in Supervising the Network
Moving container objects	"Moving Container Objects Using NetWare Administrator" and "Moving Container Objects Using NETADMIN" in Supervising the Network
Renaming container objects	"Renaming Leaf and Container Objects" in Supervising the Network

NCUPDATE

Technical documentation

» Table of Contents

» Index

Purpose

Syntax

Using NCUPDATE

Example

Additional Information