edsysadm(1M) edsysadm(1M)
NAME
edsysadm - sysadm interface editing tool
SYNOPSIS
edsysadm
DESCRIPTION
edsysadm is an interactive tool that adds or changes either
menu or 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, prompting first for which
type of menu item you want to change (a menu or a 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 want 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 are the following:
Menu Name The name of the new menu (as it
should appear in the left-hand 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
Copyright 1994 Novell, Inc. Page 1
edsysadm(1M) edsysadm(1M)
with the main menu followed 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:applmgmt. 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.
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) so you can create one.
The new file is created in the
current directory and is named Help.
The task definition prompts are the following: Task Name The
name of the new task (as it should appear in the left-hand
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
Copyright 1994 Novell, Inc. Page 2
edsysadm(1M) edsysadm(1M)
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:applmgmt. 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 FMLI 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 FMLI objects or other executables
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. Pathnames can be relative to
the current directory as well as
absolute. A dot (.) implies ``all
files in the current directory'' and
includes files in subdirectories.
Copyright 1994 Novell, Inc. Page 3
edsysadm(1M) edsysadm(1M)
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 on completion.
NOTICES
If the test option is selected, edsysadm places a copy of the
menu or task structure into the directory defined by the
TESTBASE environment variable in edsysadm.sh (default is
/var/tmp). When it begins processing, edsysadm determines if
there is enough disk space (at least 500 blocks) available in
the directory. If there is not enough disk space, you can
override the default by substituting a directory of your
choice for the TESTBASE environment variable.
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 [in the
format described on prototype(4)] that 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 information file and adds or modifies the interface menu
directly. When you request installation of your new menu (or
changes to an existing one), edsysadm will respond in one of
three ways: (a) it will install the menu (or changes) and
display a message verifying this; (b) it will not install the
menu (or changes) and display a message explaining why
installation failed; or (c) it will display a message
explaining that there's a conflict between the name you've
chosen for this menu and an existing menu.
In the latter case, you'll be prompted to choose from four
possible actions: (a) install (the menu or changes will be
installed despite the collision between the names); (b) rename
Copyright 1994 Novell, Inc. Page 4
edsysadm(1M) edsysadm(1M)
(the menu form will be displayed so you can change the name of
the entry); (c) relocate (the menu form will be displayed so
you can change the location of the entry); and (d) do not
install (the default action, which you can select by pressing
SAVE).
The item help file must follow the format shown in System
Administration about customizing the sysadm interface.
REFERENCES
delsysadm(1M), pkgmk(1), prototype(4), sysadm(1M)
Copyright 1994 Novell, Inc. Page 5