delsysadm(1M)     MISC. REFERENCE MANUAL PAGES      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, separat-
                    ing 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  dependen-
     cies  before  removing any subentries.  (A dependency exists



                Last change: Essential Utilities                1

delsysadm(1M)     MISC. REFERENCE MANUAL PAGES      delsysadm(1M)



     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 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).










































                Last change: Essential Utilities                2