delsysadm(1M)                                          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 include the name of all other menus
                    that must be traversed (in the order they are
                    traversed) to reach the menu or task, 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




                           Copyright 1994 Novell, Inc.               Page 1

      delsysadm(1M)                                          delsysadm(1M)


            3     Menu or task does not exist
            4     Menu not empty
            5     Unable to update interface menu structure

      NOTICES
            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 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 to continue.  If the answer is yes, the menu
            and all 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.

      REFERENCES
            edsysadm(1M), sysadm(1M)
























                          Copyright 1994 Novell, Inc.               Page 2