<!--Arbortext, Inc., 1988-2007, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<!--Arbortext, Inc., 1988-2007, v.4002-->
<?Pub UDT _bookmark _target>
<?Pub EntList bull rArr sect>
<?Pub Inc>
<refentry id="display-log-records-1">
<!-- @(#)display-log-records.1 1.12 07/07/25 SMI; -->
<refmeta><refentrytitle>display-log-records</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">24 Jul 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>display-log</primary></indexterm>
<refname>display-log-records</refname><refpurpose>displays all the error messages
for a given module at a given timestamp</refpurpose></refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>display-log-records</command> &synopsis-common;<option
role="nodash">--errorlevel {SEVERE|WARNING}</option> <option role="nodash">--timestamp
</option> <replaceable>timestamp</replaceable> [<option role="nodash">--target</option> <replaceable>
instance</replaceable>] {<replaceable>module-id</replaceable>  [<replaceable> module-id
</replaceable>]*}</synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>This command displays all the error messages for a given module at a
given timestamp. This command can run remotely.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="nodash">--target</option></term>
<listitem><para>This is the name of the target upon which the command is operating.
The valid targets for this command are instance and cluster. </para>
</listitem>
</varlistentry>
<varlistentry><term><option role="nodash">--errorlevel</option></term>
<listitem><para>Allowed values are <literal>SEVERE</literal> and <literal>WARNING
</literal>. </para>
</listitem>
</varlistentry>
<varlistentry><term><option role="nodash">--timestamp</option></term>
<listitem><para>The time specified at which the error logs are generated. </para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>module-id</replaceable></term>
<listitem><para>Module for which the error logs are to be displayed.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></title>
<example><title>Using display-log-records</title>
<para>Before using the display-log-records command, use the display-error-statistics
and the display-error-distribution command to get the timestamp and module
id, which are required operands for the  display-log-records command.</para>
<screen>asadmin> <userinput>display-error-statistics</userinput>
Timestamp                               Severity  Warning
---------------------------------------------------------
1185340505312(Jul 25, 2007 10:45:05 AM)     1        20
1185336905312(Jul 25, 2007 9:45:05 AM)      0        0
1185333305312(Jul 25, 2007 8:45:05 AM)      0        0
1185329705312(Jul 25, 2007 7:45:05 AM)      0        0
1185326105312(Jul 25, 2007 6:45:05 AM)      0        0
---------------------------------------------------------
Command display-error-statistics executed successfully.

</screen>
<screen>asadmin> <userinput>display-error-distribution 1185340505312</userinput>
*****************************************************************
Severity Warning   moduleID 
--------------------------
 1          2&#9;&#9;javax.enterprise.system.container.web
 0         18     javax.enterprise.system.tools.admin.server.mbeans
...
*****************************************************************
Command display-error-distribution executed successfully.

</screen>
<screen>asadmin> <userinput>display-log-records --passwordfile 
passwords --user admin --target server --host localhost --timestamp 1185340505312 
--port 4848 javax.enterprise.system.container.web
   </userinput>
----------------------------------------------------------------------
RecNumber = 5849
dateTime = Wed Jul 25 10:45:05 AM PST 2007
msgId = WEB0335
level = WARNING
productName = sun-appserver-9.1
logger = javax.enterprise.system.container.web
nvp = _ThreadID=10;_ThreadName=main;_RequestID=a4a52e69-ed14-4d0c-ada7-4fe07382c158;
message =  http-listener attribute family not supported
----------------------------------------------------------------------
RecNumber = 5848
dateTime = Wed Jul 25 10:45:05 AM PST 2007
msgId = WEB0334
level = WARNING
productName = sun-appserver-9.1
logger = javax.enterprise.system.container.web
nvp = _ThreadID=10;_ThreadName=main;_RequestID=a4a52e69-ed14-4d0c-ada7-4fe07382c158;
message =  http-file-cache attribute hash-init-size not supported
----------------------------------------------------------------------
Command display-log-records executed successfully.</screen>
</example>
</refsect1>
<refsect1 role="exit-status"><title></title>
<variablelist termlength="medium">
<varlistentry><term>0</term>
<listitem><para>command executed successfully</para>
</listitem>
</varlistentry>
<varlistentry><term>1</term>
<listitem><para>error in executing the command</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="see-also"><title></title>
<para><olink targetptr="display-error-distribution-1">display-error-distribution(1)</olink></para>
<para>, <olink targetptr="display-error-statistics-1">display-error-statistics(1)</olink></para>
</refsect1>
</refentry>
<?Pub *0000005992 0>
