SYNTAX

LockNameRevisions name… [-a] [-password password] [-project project]
[-r] [-u user]

DESCRIPTION

The LockNameRevisions command lets you lock a symbolic name so it cannot be changed with the NameRevisions command. You can use the UnlockNameRevisions command to remove the lock on the symbolic name. You can optionally specify a password which must be matched in the UnlockNameRevisions command.

This built-in command was added in the v. 3.5 MPW Shell.

INPUT

None

OUTPUT

None

STATUS

LockNameRevisions can return the following status codes:

PARAMETERS

name…

Specifies one or more symbolic names to lock.

OPTIONS

-a

Represents all the symbolic names in the current project. Can be used in place of the names parameter.

-password password

Names the password for this lock. The password can be omitted. In this case, the symbolic name is unlocked by omitting the password from the UnlockNameRevisions command also.

-project project

Names the project which contains the symbolic name to lock. This becomes the current project for this command.

-r

Executes LockNameRevisions recursively on the current project and all of its subprojects.

-u user

Names the current user, overriding the {User} MPW Shell variable.

EXAMPLES

The following command locks the symbolic name "v7.6" and specifies that the password "harmony" must be used to unlock it.

LockNameRevisions v7.6 -password "harmony"

SEE ALSO

DeleteNames

DuplicateNameRevisions

NameRevisions

ObsoleteNameRevisions

ProjectInfo

UnlockNameRevisions

UnobsoleteNameRevisions