
Administration Commands                    display-log-records(1)

NAME
     display-log-records - displays all the error messages for  a
     given module at a given timestamp

SYNOPSIS
     display-log-records
     [--terse={true|false}][ --echo={true|false} ]
     [ --interactive={true|false} ] [ --host  host]
     [--port port] [--secure| -s ] [ --user  admin_user]
     [--passwordfile filename] [--help]
      --errorlevel {SEVERE|WARNING}   --timestamp  timestamp [--target instance] {module-id  [ module-id]*}

DESCRIPTION
     This command displays all the error  messages  for  a  given
     module at a given timestamp. This command can run remotely.

OPTIONS
     -t --terse                  Indicates that any  output  data
                                 must  be very concise, typically
                                 avoiding   human-friendly   sen-
                                 tences    and   favoring   well-
                                 formatted data  for  consumption
                                 by a script. Default is false.

     -e --echo                   Setting to true  will  echo  the
                                 command  line  statement  on the
                                 standard  output.   Default   is
                                 false.

     -I --interactive            If set to true  (default),  only
                                 the  required  password  options
                                 are prompted.

     -H --host                   The  machine  name   where   the
                                 domain  administration server is
                                 running. The  default  value  is
                                 localhost.

     -p --port                   The HTTP/S port for  administra-
                                 tion.  This is the port to which
                                 you should point your browser in
                                 order  to manage the domain. For
                                 example, http://localhost:4848.

                                 The default port number is 4848.

Java EE 5           Last change: 24 Jul 2007                    1

Administration Commands                    display-log-records(1)

     -s --secure                 If set to true, uses SSL/TLS  to
                                 communicate   with   the  domain
                                 administration server.

     -u --user                   The authorized  domain  adminis-
                                 tration   server  administrative
                                 username.

                                 If you have authenticated  to  a
                                 domain  using  the asadmin login
                                 command,  then  you   need   not
                                 specify  the  --user  option  on
                                 subsequent  operations  to  this
                                 particular domain.

     --passwordfile              The --passwordfile option speci-
                                 fies  the  name,  including  the
                                 full path, of a file  containing
                                 the   password   entries   in  a
                                 specific format. The  entry  for
                                 the   password   must  have  the
                                 AS_ADMIN_ prefix followed by the
                                 password   name   in   uppercase
                                 letters.

                                 For  example,  to  specify   the
                                 domain   administration   server
                                 password, use an entry with  the
                                 following                format:
                                 AS_ADMIN_PASSWORD=password,
                                 where  password  is  the  actual
                                 administrator  password.   Other
                                 passwords  that can be specified
                                 include AS_ADMIN_MAPPEDPASSWORD,
                                 AS_ADMIN_USERPASSWORD,       and
                                 AS_ADMIN_ALIASPASSWORD.

                                 All remote commands must specify
                                 the  admin password to authenti-
                                 cate to the  domain  administra-
                                 tion  server,  either through --
                                 passwordfile or  asadmin  login,
                                 or  interactively on the command
                                 prompt. The asadmin  login  com-
                                 mand can be used only to specify
                                 the admin  password.  For  other
                                 passwords,  that  must be speci-
                                 fied for  remote  commands,  use
                                 the --passwordfile or enter them
                                 at the command prompt.

Java EE 5           Last change: 24 Jul 2007                    2

Administration Commands                    display-log-records(1)

                                 If you have authenticated  to  a
                                 domain  using  the asadmin login
                                 command,  then  you   need   not
                                 specify   the   admin   password
                                 through    the    --passwordfile
                                 option  on subsequent operations
                                 to this particular domain.  How-
                                 ever, this is applicable only to
                                 AS_ADMIN_PASSWORD  option.   You
                                 will  still  need to provide the
                                 other  passwords,  for  example,
                                 AS_ADMIN_USERPASSWORD,   as  and
                                 when required by individual com-
                                 mands, such as update-file-user.

                                 For security reasons,  passwords
                                 specified   as   an  environment
                                 variable will  not  be  read  by
                                 asadmin.

                                 The    default     value     for
                                 AS_ADMIN_MASTERPASSWORD       is
                                 changeit.

     --help                      Displays the help text  for  the
                                 command.

     --target                    This is the name of  the  target
                                 upon   which   the   command  is
                                 operating.   The  valid  targets
                                 for  this  command  are instance
                                 and cluster.

     --errorlevel                Allowed values  are  SEVERE  and
                                 WARNING.

     --timestamp                 The time specified at which  the
                                 error logs are generated.

OPERANDS
     module-id                   Module for which the error  logs
                                 are to be displayed.

EXAMPLES
     Example 1 Using display-log-records

Java EE 5           Last change: 24 Jul 2007                    3

Administration Commands                    display-log-records(1)

     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.

       asadmin> display-error-statistics
       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.

       asadmin> display-error-distribution 1185340505312
       *****************************************************************
       Severity Warning   moduleID
       --------------------------
       1          2        javax.enterprise.system.container.web
       0         18     javax.enterprise.system.tools.admin.server.mbeans
       ...
       *****************************************************************
       Command display-error-distribution executed successfully.

       asadmin> display-log-records --passwordfile
       passwords --user admin --target server --host localhost --timestamp 1185340505312
       --port 4848 javax.enterprise.system.container.web

       ----------------------------------------------------------------------
       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;

Java EE 5           Last change: 24 Jul 2007                    4

Administration Commands                    display-log-records(1)

       message =  http-file-cache attribute hash-init-size not supported
       ----------------------------------------------------------------------
       Command display-log-records executed successfully.

EXIT STATUS
     0                           command executed successfully

     1                           error in executing the command

SEE ALSO
     display-error-distribution(1)

     , display-error-statistics(1)

Java EE 5           Last change: 24 Jul 2007                    5

