Lock Symbol

This Subprogram locks the specified Symbol such that subsequent requests to modify the Symbol Equivalence Text or drop the Symbol will be treated as errors until the Symbol is unlocked.

Short Name Calling Sequence

STATUS = UILKSB(SYMNAM,PASSWD)

Long Name Calling Sequence

STATUS = UI_LOCK_SYMBOL(...)

Input Arguments

SYMNAM (Character) Symbol Name PASSWD (Integer*4) Password

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_SYMBOL ) Illegal Symbol UIILSB )

UI__LOCKED_SYMBOL ) Locked Symbol UISLOK ) Note:

1. The specified Symbol will be locked until a later call to UI_UNLOCK_SYMBOL with the same Password.
2. Error UI__LOCKED_SYMBOL will be signalled if the specified Symbol is already locked.
3. The Password must not be set to zero, or the request will be ignored.
4. Symbols are unlocked by default.