INTEGER destroy()
This function marks the current object for removal from the database. The object is destroyed when all methods executing on it are completed (suspended and preempted methods as well as the current task). Objects left orphaned by the destruction of their only parent are reparented to the parents of the parent which was destroyed.
Attempts to destroy the root or system objects will fail with the error ~perm.
ancestors() | children() | chparents() | create() | data() | del_objname() | destroy() | has_ancestor() | lookup() | objname() | objnum() | parents() | set_objname()