edsysadm(1M) SYSTEM ADMINISTRATION COMMANDS 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 on-line 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 identify
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 righthand
column of the screen). This field
has a maximum length of 58 charac-
ters and can consist of any
alphanumeric character except at
sign (@), carat (^), tilde (~),
back grave (`), grave ('), and dou-
ble 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 followed
by all other menus that must be
traversed (in the order they are
traversed) to access this menu.
1
edsysadm(1M) SYSTEM ADMINISTRATION COMMANDS edsysadm(1M)
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 char-
acters at a time.
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 righthand
column of the screen). This field
has a maximum length of 58 charac-
ters and can consist of any
alphanumeric character except at
sign (@), carat (^), tilde (~),
back grave (`), grave ('), and dou-
ble 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
2
edsysadm(1M) SYSTEM ADMINISTRATION COMMANDS edsysadm(1M)
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 char-
acters 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 execut-
ables that support the task 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. Path-
names can be relative to the
current directory as well as abso-
lute. A dot (.) implies "all files
in the current directory" and
includes files in subdirectories.
This is a scrollable field, showing
a maximum of 50 alphanumeric char-
acters at a time.
Once the menu or task has been defined, screens for instal-
ling the menu or task or saving them for packaging are
presented. The package creation or on-line installation is
3
edsysadm(1M) SYSTEM ADMINISTRATION COMMANDS edsysadm(1M)
verified and you are informed upon completion.
4
edsysadm(1M) SYSTEM ADMINISTRATION COMMANDS edsysadm(1M)
NOTES
For package creation or modification, this command automati-
cally creates a menu information file and a prototype file
in the current directory (the directory from which the com-
mand 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 list-
ing 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 con-
tents of this prototype file must be incorporated in the
package prototype file.
For on-line installation, edsysadm automatically creates a
menu information file and adds or modifies the interface
menu structure directly.
The item help file must follow the format shown in the
Application Programmer's Guide in the ``Customizing the
Administration Interace'' chapter or in the System
Administrator's Guide in he ``Customizing the sysadm Inter-
face'' appendix.
SEE ALSO
delsysadm(1M)
pkgmk(1)
prototype(4)
sysadm(1M)
5