emtui(1)emtui(1)NAMEemtui - provides different displaying options for HP-UX errors which
are defined in the Common Error Repository (CER)
SYNOPSIS
{
{ |
[
}]
}]
[ R -e { all |
] [ , eventid ]] |
eventname ] |
<subsystemid> ] [ , <eventid> ]] |
<trapid> ] [ , <enterpriseid> ]] |
[[ <providername> ] [ , <eventid> ]]}]
{ [ [ <severity> ]}
{[ { <cause1> <cause2> ... <causeN> |
{ <errornum> }
{ }
{ } ]
DESCRIPTION
The command obtains various information about HP-UX errors which are
defined in the Common Error Repository (CER). The CER is a database of
error metadata and is available locally on every system.
To view help information about how to use type at the command prompt.
To use the command, you must have system administrative privileges.
Options
If no option is specified with the command, the (help) is the default
option. The command supports the following options:
Adds solutions text to the errors listed in the
Common Error Repository (CER). The You must have administrative
privileges to use the option. Examples of using the option are
as follows:
· To add solution text of
to error number 1234 and cause number 5678:
· To add solution text of to error number 1234 for all causes:
· To add solution text of to error number 1234 and causes 5678,
123, 987:
Provides brief information about an error in brief.
An example of using the option to display an error number in
brief format is as follows:
Searches for a specific category of errors.
The category parameter can be one of the following categories:
Displays errors related to commands.
Displays errors related to hardware devices.
Displays I/O errors.
Displays kernel errors.
Displays network errors.
Displays errors related to System Fault Management.
Displays errors that do not belong to any specific category.
Displays errors belonging to all categories. This is the default
category.
Examples of using the option are as follows:
· Display matching errors in the kernel category:
· Display brief information about the matching network errors
that contain the word
Specifies cause number(s) to be associated with an error while adding
a custom solution. causenumlist is a list of the cause numbers.
To select more than one cause, type the unique cause numbers
separated by a space.
To select all causes, specify from causenumlist.
To add solution to an error that does not have a cause, use
Examples of using the option are as follows:
Deletes one or more custom solution from the CER.
You must have administrative privileges to use the option.
Examples of using the option are as follows:
· This example deletes user solution 5678 from error number
1234:
· This example deletes user solutions 123, 456, and 789 from
error number 4321:
See the explanations for the and options also.
Enables you to search for a specific type of error specified by
etype. The values of etype are as follows:
Displays all types of errors
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 name
of the monitor name and the event ID are specified, the
search would include both of the search parameters.
Displays HP-UX errno errors only.
Displays errors generated by the Event Manager (EVM).
Specify eventname as the search parameter. The values
for eventname are as listed below:
Displays generic errors.
Displays box infrastructure problems.
Displays forward progress errors.
Displays errors generated by the Common Network Tracing and Log‐
ging (NetTL) systems.
subsysid is the subsystem ID of a specific subsystem.
eventid is the event ID of a a single event. Both of
the subsystem ID and the event ID are integers. If you
specify both subsystem ID and event ID, the search
results would match both the search parameters
Displays errors that do not belong to any specific category.
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 enter‐
priseID, the search results that would match both of
those search parameters.
Displays errors generated by Web-Based Event Management (WBEM)
providers.
providername is a specific WBEM provider. eventid is a
single event. eventid is an integer. If both WBEM
provider ID and event ID are specified, the search
results would match both the search parameters.
Examples of using the option are as follows:
· Display matching NetTL errors:
· Display matching NetTL errors from subsystem 1234:
· Display matching NetTL errors from event ID 5678:
· Display matching NetTL errors from subsystem 1234 and event
ID 5678:
Displays help information for the
command. This option displays the syntax for the command. If you
invoke the command without any options, the is the default option.
Enables a severity operator
(sevop) and a severity level (sevval) for an error. Following
lists the various severity operators:
less than the specified severity level
less than or equal to the specified severity level
equal to the specified severity level
greater than or equal to the specified severity level
greater than the specified severity level
Following lists the various severity levels of errors in the
descending order of severity:
Indicates an irreparable error condition.
Indicates that immediate action is needed or else an imminent sus‐
pension of operation or critical resources will occur.
Indicates that quick action is needed.
Indicates that action is needed but not immediately.
Indicates that action can be taken when appropriate.
Indicates that the error is informative.
Indicates that the severity level is unknown.
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, includes major, critical, fatal/non‐
recoverable; and will include degraded/warning, information,
unknown, and others.
For an example to display matching errors with a severity greater
than use the option as follows:
Modifies a custom solution. Users must have administrative
privileges to use the option.
For example, to modify user solution 9876 of error number 1234 to
be use the option as follows:
Restricts the search of errors to the platform specified
by option. Examples of using the option are as follows:
· To search errors with query string specific to the platform
· To search errors with query string specific to the platform
on which the command is run
Provides a query string to query the CER for information about
errors, cause, and the recommended action. Obtain specific search
results by using the and options or the option along with the
option. The option is optional.
· An example command to display matching errors with a sever‐
ity greater than and which contain the word is as follows:
· An example command to display matching NetTL errors from
subsystem 1234 and event ID 5678 and which contain the word
is as follows:
Defines the scope of the search. HP enables external, registered
non-HP partners, Independent Software Vendors (ISVs) and Inde‐
pendent Hardware Vendors (IHV) to add their error metadata
(detailed information about an error) to the CER. Use the
option to view the error metadata of your choice.
Select scope to be one of the following values:
Displays both HP and non-HP error messages. This is the default.
Displays HP errors only
Displays non-HP ISV/IHV errors only
· An example to display HP errors that contain the word is as
follows:
· An example to display errors from vendors that contain the
word is as follows:
Provides detailed information about an error.
An example of the option is as follows:
Specifies how to parse the query string in the
option. The query string is used to query the CER for information
about errors, cause, and recommended actions.
matchtype is one of the following values:
Searches the CER for all the words of the query string in any
order.
Searches the CER for one or more words of the query string in any
order. This is the default
Searches the CER for the exact phrase of the query string.
Examples of using the option are as follows:
· Display matching errors that contain any of the words or
· Display matching errors that contain the exact phrase
EXAMPLES
Examples of using the different options of are as follows:
AUTHOR
was developed by HP.
SEE ALSOcerupdate(1).
emtui(1)