edsysadm(1M) edsysadm(1M)
NAME
edsysadm - sysadm interface editing tool
SYNOPSIS
edsysadm
DESCRIPTION
edsysadm is an interactive tool that adds or changes either menu and
task definitions in the sysadm interface. It can be used to make
changes directly online on a specific machine or to create changes
that will become part of a software package. The command creates the
administration files necessary to achieve the requested changes in the
interface and either places them in the appropriate place for on-line
changes or saves them to be included in a software package.
edsysadm presents several screens, first prompting for which type of
menu item you want to change, menu or task, and then for what type of
action to take, add or change. When you select add, a blank menu or
task definition (as described below) is provided for you to fill in.
When you select change, a series of screens is presented to help iden-
tify the definition you wish to change. The final screen presented is
the menu or task definition filled in with its current values, which
you can then edit.
The menu definition prompts and their descriptions are:
Menu Name
The name of the new menu (as it should appear in the lefthand
column of the screen). This field has a maximum length of 16
alphanumeric characters.
Menu Description
A description of the new menu (as it should appear in the right-
hand column of the screen). This field has a maximum length of 58
characters and can consist of any alphanumeric character except
at sign (@), carat (^), tilde (~), back grave (`), grave ('), and
double quotes (").
Menu Location
The location of the menu in the menu hierarchy, expressed as a
menu pathname. The pathname should begin with the main menu fol-
lowed by all other menus that must be traversed (in the order
they are traversed) to access this menu. Each menu name must be
separated by colons. For example, the menu location for a menu
entry being added to the Applications menu is main:applications.
Do not include the menu name in this location definition. The
complete pathname to this menu entry will be the menu location
plus the menu name defined at the first prompt.
This is a scrollable field, showing a maximum of 50 alphanumeric
characters at a time.
Page 1 Reliant UNIX 5.44 Printed 11/98
edsysadm(1M) edsysadm(1M)
Menu Help File Name
Pathname to the item help file for this menu entry. If it resides
in the directory from which you invoked edsysadm, you do not need
to give a full pathname. If you name an item help file that does
not exist, you are placed in an editor (as defined by $EDITOR) to
create one. The new file is created in the current directory and
named Help.
The task definition prompts and their descriptions are:
Task Name
The name of the new task (as it should appear in the lefthand
column of the screen). This field has a maximum length of 16
alphanumeric characters.
Task Description
A description of the new task (as it should appear in the right-
hand column of the screen). This field has a maximum length of 58
characters and can consist of any alphanumeric character except
at sign (@), carat (^), tilde (~), back grave (`), grave ('), and
double quotes (").
Task Location
The location of the task in the menu hierarchy, expressed as a
pathname. The pathname should begin with the main menu followed
by all other menus that must be traversed (in the order they are
traversed) to access this task. Each menu name must be separated
by colons. For example, the task location for a task entry being
added to the applications menu is main:applications. Do not
include the task name in this location definition. The complete
pathname to this task entry will be the task location as well as
the task name defined at the first prompt.
This is a scrollable field, showing a maximum of 50 alphanumeric
characters at a time.
Task Help File Name
Pathname to the item help file for this task entry. If it resides
in the directory from which you invoked edsysadm, you do not need
to give a full pathname. If you name an item help file that does
not exist, you are placed in an editor (as defined by $EDITOR) to
create one. The new file is created in the current directory and
named Help.
Task Action
The FACE form name or executable that will be run when this task
is selected. This is a scrollable field, showing a maximum of 58
alphanumeric characters at a time. This pathname can be relative
to the current directory as well as absolute.
Task Files
Any FACE objects or other executables that support the task
Page 2 Reliant UNIX 5.44 Printed 11/98
edsysadm(1M) edsysadm(1M)
action listed above and might be called from within that action.
Do not include the help file name or the task action in this
list. Pathnames can be relative to the current directory as well
as absolute. A dot (.) implies "all files in the current direc-
tory" and includes files in subdirectories.
This is a scrollable field, showing a maximum of 50 alphanumeric
characters at a time.
Once the menu or task has been defined, screens for installing the
menu or task or saving them for packaging are presented. The package
creation or on-line installation is verified and you are informed upon
completion.
NOTES
For package creation or modification, this command automatically
creates a menu information file and a prototype file in the current
directory (the directory from which the command is executed). The menu
information file is used during package installation to modify menus
in the menu structure. A prototype file is an installation file which
gives a listing of package contents. The prototype file created by
edsysadm lists the files defined under task action and gives them the
special installation class of "admin". The contents of this prototype
file must be incorporated in the package prototype file.
For on-line installation, edsysadm automatically creates a menu infor-
mation file and adds or modifies the interface menu structure
directly.
SEE ALSO
delsysadm(1M), pkgmk(1M), sysadm(1M), prototype(4).
Page 3 Reliant UNIX 5.44 Printed 11/98