delsysadm(1M)              (Essential Utilities)              delsysadm(1M)


   NAME
         delsysadm - sysadm interface menu or task removal tool

   SYNOPSIS
         delsysadm task | [-r] menu

   DESCRIPTION
         The delsysadm command deletes a task or menu from the sysadm
         interface and modifies the interface directory structure on the
         target machine.

         task | menu    The logical name and location of the menu or task
                        within the interface menu hierarchy.  Begin with the
                        top menu main and proceed to where the menu or the
                        task resides, separating each name with colons.  See
                        EXAMPLES.

        If the -r option is used, this command will recursively remove all
        sub-menus and tasks for this menu.  If the -r option is not used, the
        menu must be empty.

        delsysadm should only be used to remove items added as "on-line"
        changes with the edsysadm command.  Such an addition will have a
        package instance tag of ONLINE.  If the task or menu (and its sub-
        menus and tasks) have any package instance tags other than ONLINE, you
        are asked whether to continue with the removal or to exit.  Under
        these circumstances, you probably do not want to continue and you
        should rely on the package involved to take the necessary actions to
        delete this type of entry.

        The command exits successfully or provides the error code within an
        error message.

   EXAMPLES
         To remove the nformat task, execute:
         delsysadm main:applications:ndevices:nformat.

   DIAGNOSTICS
         0   Successful execution
         2   Invalid syntax
         3   Menu or task does not exist
         4   Menu not empty
         5   Unable to update interface menu structure

   NOTES
         Any menu that was originally a placeholder menu (one that only
         appears if submenus exist under it) will be returned to placeholder
         status when a deletion leaves it empty.

         When the -r option is used, delsysadm checks for dependencies before
         removing any subentries.  (A dependency exists if the menu being


   7/91                                                                 Page 1

   delsysadm(1M)              (Essential Utilities)              delsysadm(1M)


         removed contains an entry placed there by an application package).
         If a dependency is found, the user is shown a list of packages that
         depend on the menu being deleted and asked whether or not to
         continue.  If the answer is yes, the menu and all of its menus and
         tasks are removed (even those shown to have dependencies).  If the
         answer is no, the menu is not deleted.

         delsysadm should only be used to remove menu or task entries that
         have been added to the interface with edsysadm.

   SEE ALSO
         edsysadm(1M), sysadm(1M).









































   Page 2                                                                 7/91