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 proceed to where the menu or the task
                    resides, separating each name with colons (see EXAM-
                    PLE).

     -r             If the -r option is used, this command will recursively
                    remove all submenus 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 "online"
     changes with the edsysadm command. Such an addition will have a pack-
     age instance tag of ONLINE. If the task or menu (and its submenus and
     tasks) have any package instance tags other than ONLINE, you are asked
     whether to continue with the removal or to exit. Under these cir-
     cumstances, 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.

EXAMPLE
     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








Page 1                       Reliant UNIX 5.44                Printed 11/98

delsysadm(1M)                                                 delsysadm(1M)

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 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                       Reliant UNIX 5.44                Printed 11/98