delsysadm(1M)         UNIX System V(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 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


10/89                                                                    Page 1

delsysadm(1M)         UNIX System V(Essential Utilities)          delsysadm(1M)


      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                                                                    10/89