Deassign Drop a Symbol

This Subprogram may be used to deassign (drop) a previously defined Symbol or all Symbols commencing with the specified characters.

Short Name Calling Sequence

STATUS = UIDRSB(SYMNAM)

Long Name Calling Sequence

STATUS = UI_DROP_SYMNAM(...)

Input Arguments

SYMNAM (Character) Symbol Name

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_SYMBOL ) Illegal Symbol UIILSB )

UI__ILLEGAL_SYNTAX ) Illegal Symbol Syntax UIILSY )

Note:

1. The SYMNAM Arguemnt should correspond to a single Symbol or may be of the form ``ABC*" where the ``*" character acts as a wildcard character and will cause all Symbols commencing with the characters ``ABC..." to be deleted. The wildcard may only appear at the end of the Symbol Name, not in the middle or at the beginning (unless it is the only character, in which case all symbols will be deleted).