'\" t
.\"     Title: ipmctl-show-events
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 1.5.8
.\"      Date: 2019-10-28
.\"    Manual: ipmctl
.\"    Source: ipmctl
.\"  Language: English
.\"
.TH "IPMCTL\-SHOW\-EVENTS" "1" "2019-10-28" "ipmctl" "ipmctl"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
ipmctl\-show\-events \- Shows DCPMM related events
.SH "SYNOPSIS"
.sp
.nf
ipmctl show [OPTIONS] \-event [TARGETS] [PROPERTIES]
.fi
.br
.SH "DESCRIPTION"
.sp
Shows DCPMM related events. The options, targets, and properties can be used to
filter the events. If no filters are provided, the default is to display up to
50 events. Refer to the Event Log Specification for detailed information about
events.
.SH "OPTIONS"
.sp
\-h, \-help
.RS 4
Displays help for the command.
.RE
.sp
\-o (text|nvmxml), \-output (text|nvmxml)
.RS 4
Changes the output format. One of: "text" (default) or "nvmxml".
.RE
.SH "TARGETS"
.sp
\-dimm [(DimmID)]
.RS 4
Filter output to events on a specific DCPMM by optionally supplying the dimm target and
one DCPMM identifier.
.RE
.SH "PROPERTIES"
.sp
Category
.RS 4
Filters output to events of a specific category. One of:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Diag": Filters output to diagnostic events.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"FW": Filters output to FW consistency diagnostic test events.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Config": Filters output to platform config diagnostic test events.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"PM": Filters output to PM meta data diagnostic test events.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Quick": Filters output to quick diagnostic test events.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Security": Filters output to security diagnostic test events.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Health": Filters output to device health events.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Mgmt": Filters output to management software generated events.
.RE
.RE
.sp
Severity
.RS 4
Filters output of events based on the severity of the event. One of:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Info": (Default) Shows informational, warning, and error severity events.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Warning": Shows warning and error events.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"Error": Shows error events.
.RE
.RE
.sp
ActionRequired
.RS 4
Filters output to events that require corrective action or acknowledgment.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"0": Filters output to only show non\-ActionRequired events.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"1": Filters output to only show ActionRequired events.
.RE
.RE
.sp
Count
.RS 4
Filters output of events limited to the specified count, starting with the
most recent. Count may be a value from 1 to 2,147,483,647.
Default = 50.
.RE
.SH "EXAMPLES"
.sp
Displays the 50 most recent events.
.sp
.nf
ipmctl show \-event
.fi
.br
.sp
Shows the 10 most recent error events.
.sp
.nf
ipmctl show \-event count=10 severity=error
.fi
.br
.SH "RETURN DATA"
.sp
This command displays a table with a row for each event matching the provided
filters, showing most recent first.
.sp
Time
.RS 4
Time of the event in the format MM:dd:yyyy:hh:mm:ss.
.RE
.sp
EventID
.RS 4
The event identifier
.RE
.sp
Severity
.RS 4
The severity of the event
.RE
.sp
ActionRequired
.RS 4
A flag indicating that the event requires corrective action or acknowledgment. One of:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
0: A action is not required.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
1: An action is required.
.RE
.RE
.sp
Code
.RS 4
The event code defined by the SW Event Log specification
.RE
.sp
Message
.RS 4
The event message
.RE