- -a solutiontext
Adds solutions text to the errors listed in the
Common Error Repository (CER).
You must have system administrative privileges to use the
-a
option.
Following are examples of using the
-a
option:
To add the solution text
"Check the power supply"
to error number 1234 and cause number 5678:
emtui -a "Check the power supply" -i 1234 -c 5678
To add the solution text
"Check the power supply"
to error number 1234 for all causes:
emtui -a "Check the power supply" -i 1234 -c all
To add the the solution text
"Check the power supply"
to error number 1234 and causes 5678, 123, 987:
emtui -a "Check the power supply" -i 1234 -c 5678 123 987
- -b
Provides brief information about an HP-UX error.
An example of using the
-b
option follows:
emtui -b -i 1234
- -c category
Searches for a specific category of errors.
category
can be one of the following:
- commands
Displays errors related to commands.
- hardware
Displays errors related to hardware devices.
- I/O
Displays I/O errors.
- kernel
Displays kernel errors.
- network
Displays network errors.
- SysFaultMgmt
Displays errors related to System Fault Management.
- others
Displays errors that do not belong to any specific category.
- all
Displays errors belonging to all categories.
This is the default category.
The following are examples using the
-c
option:
Display matching errors in the kernel category:
emtui -b -c kernel
Display brief information
(-b option)
about the matching network errors that contain the word
failure
(see the
-q
option):
emtui -b -c network -q failure
- -c causenumlist
Specifies a list of cause number(s).
Each cause number is associated with an error while adding
a custom solution.
To specify one cause, type one cause number.
For example:
emtui -c 371
To select more than one cause, type the unique
cause numbers separated by spaces.
For example:
emtui -C 37 21 145
To select all causes, specify
all
in the
causenumlist.
For example:
-C all
To add a solution to an error that does not have a
cause, use
-C all.
- -d
Deletes one or more custom solutions from the CER.
You must have system administrative privileges to use the
-d
option.
The
-d
option must be used with the
-i errornum
and
-u usersolution
options.
Examples using the
-d
option follow:
Delete user solution 5678 from error number 1234:
emtui -d -i 1234 -u 5678
Delete user solutions 123, 456, and 789 from error number 4321:
emtui -d -i 4321 -u 123 456 789
See the explanations for the
-i
and
-u
options also.
- -e etype
Searches for a specific type of error specified by
etype.
The values of
etype
are as follows:
- all
Displays all types of errors
- ems [[monitorname] [,eventid]]
Displays errors generated by the Event Monitoring System (EMS).
You can specify either a single monitor
(monitorname)
or a single event ID
(eventid)
or both.
If both the monitor name and the
event ID are specified, the search will include both
parameters.
- errno
Displays HP-UX errno errors only.
- evm [eventname]
Displays errors generated by the Event Manager (EVM).
See
evm(5).
Specify
eventname
as the search parameter.
The values for
eventname
are as follows:
- generic
Displays generic errors.
- ipmi-02
Displays box infrastructure problems.
- ipmi-e0
Displays forward progress errors.
- nettl [[subsysid] [,eventid]]
Displays errors generated by the Common Network Tracing and Logging (NetTL) systems.
See
nettl(1M).
subsysid
is the subsystem ID of a specific subsystem.
eventid
is the event ID of a single event.
Both the subsystem ID and the event ID are integers.
If you specify both subsystem ID and event ID, the search results
will match both parameters.
- others
Displays errors that do not belong to any specific category.
- snmp [[trapid] [,enterpriseid]]
Displays Simple Network Management Protocol (SNMP) errors.
trapid
is a specific trap ID
and
enterpriseid
is an enterprise ID.
Both of the trap ID and the enterprise ID are strings.
If you specify both
trapid
and
enterpriseid,
the search results that will match both parameters.
- wbem [[providername ] [,eventid]]
Displays errors generated by Web-Based Event Management (WBEM) providers.
providername
is a specific WBEM provider.
eventid
is a single event; it is an integer.
If both WBEM provider ID and event ID are specified,
the search results will match both parameters.
Examples using the
-e
option follow:
Display matching NetTL errors:
emtui -b -e nettl
Display matching NetTL errors from subsystem 1234:
emtui -b -e nettl 1234
Display matching NetTL errors from event ID 5678:
emtui -b -e nettl 5678
Display matching NetTL errors from subsystem 1234 and event ID 5678:
emtui -b -e nettl 1234,5678
- -h
Displays help information and the syntax for the
emtui
command.
If you invoke the
emtui
command without any options, the
-h
option is the default option.
- -i errornum
This option is used to search on a particular error number.
- -l sevop sevval
Enables a severity operator
(sevop)
and a severity level
(sevval)
for an error.
The various severity operators are as follows:
- lt
less than the specified severity level
- le
less than or equal to the specified severity level
- eq
equal to the specified severity level
- ge
greater than or equal to the specified severity level
- gt
greater than the specified severity level
The following lists the various severity levels of errors,
in the descending order of severity:
- fatal/nonrecoverable
Indicates an irreparable error condition.
- critical
Indicates that immediate action is needed or else an imminent
suspension of operation or critical resources will occur.
- major
Indicates that quick action is needed.
- minor
Indicates that action is needed but not immediately.
- warning
Indicates that action can be taken when appropriate.
- information
Indicates that the error is informative.
- unknown
Indicates that the severity level is unknown.
- other
Indicates that the value of severity is other than what is listed.
The severity level is cumulative and includes numerically lower
severity levels.
For example,
-l gt minor
includes major, critical, fatal or nonrecoverable.
-l lt minor
includes degraded/warning, information, unknown, and others.
For example,
to display matching errors with a severity greater than
minor,
use the
-l
option as follows:
emtui -b -l gt minor
- -m solutiontext
Modifies a custom solution.
You must have system administrative privileges to use the
-m
option.
For example,
to modify user solution 9876 of error number 1234 to have
"Contact John Doe in IT Support"
as
solutiontext,
use the
-m
option as follows:
-m "Contact John Doe in IT Support" -i 1234 -u 9876
- -q querystring
Provides a query string to query the CER for information about
errors, cause, and the recommended action.
Obtain specific search results by using the
-c,
-e,
-l,
and
-s
options or the
-w
option along with the
-q
option.
The
-q
option is optional.
An example command to display matching errors with a severity greater than
minor
and which contain the word
failure
is as follows:
emtui -b -l gt minor -q "failure"
An example command to display matching NetTL errors from
subsystem 1234 and event ID 5678 and which contain the word
failure
is as follows:
emtui -b -e nettl 1234,5678 -q "failure"
- -s scope
Defines the scope of the search.
HP enables external, registered non-HP partners, Independent
Software Vendors (ISVs) and Independent Hardware Vendors (IHV)
to add their error metadata (detailed information about an error)
to the CER.
Use the
-s
option to view the error metadata as specified in
scope.
scope
is one of the following values:
- all
Displays both HP and non-HP error messages.
This is the default.
- hp
Displays HP errors only.
- other
Displays non-HP ISV/IHV errors only.
An example to display HP errors that contain the word
corrupted
is as follows:
emtui -b -s hp -q "corrupted"
An example to display errors from vendors
(-s other)
that contain the word
memory
is as follows:
emtui -b -q "memory" -s other
- -u usersolution
The user can add his or her own solution for a particular error by
using the
-u
option.
This option takes the error id and the solution text as parameters
and associates them with a cause.
If the error id and solution text are applicable to all causes, the
-c ALL
option must be used.
- -v
Provides detailed information about an error.
An example of the
-v
option follows:
emtui -v -i 1234
- -w matchtype
Specifies how to parse the query string in the
-q querystring
option.
The query string is used to query the CER for information about
errors, causes, and recommended actions.
matchtype
is one of the following values:
- all
Searches the CER for all the words of the query string in any order.
- any
Searches the CER for one or more words of the query string in any order.
This is the default.
- "phrase"
Searches the CER for the exact phrase of the query string.
The phrase is enclosed in double quotes.
Examples using the
-w
option follow:
Display matching errors that contain any of the words
monitor,
memory,
or
failure:
emtui -b -q "monitor memory failure" -w any
Display matching errors that contain the exact phrase
emtui -b -q "the status value" -w phrase
Printable version
