logsrv.script

Software Testing Automation Framework (STAF)的开发代码

20070211-04:34:07 Debug   Step 3: debug: files=78 threads=98
:exmp.
:p.
:li.:hp2.Goal::ehp2. Show me everything that happened after I left until I came in that
has "threads" or "buffer" in the message (in the long format)
:p.:hp2.Syntax::ehp2.  :xph.QUERY LONG GLOBAL LOGNAME stresstst FROM 20070210@19:00:00 TO today@08:00:00 CONTAINS threads CONTAINS buffer:exph.
:p.:hp2.Results::ehp2.  If the request was issued from the
command line, the result, in table format, could look like:
:xmp.
R# Date-Time         Machine                 H# Name   User             Endpoint                          Level Message
-- ----------------- ----------------------- -- ------ ---------------- --------------------------------- ----- ----------------------------------
3  20070210-19:39:09 automate.austin.ibm.com 37 Test1A none://anonymous local://local                     Debug Step 1: debug: files=23 threads=37
7  20070211-01:21:58 automate.austin.ibm.com 37 Test1A none://anonymous local://local                     Debug Step 2: debug: files=31 threads=54
9  20070211-01:43:46 crazy8s.austin.ibm.com  41 Test2  none://anonymous tcp://crazy8s.austin.ibm.com@6500 Debug Step 1: debug: files=43 threads=67
10 20070211-02:53:20 automate.austin.ibm.com 37 Test1A none://anonymous local://local                     Error Step 3: Sharing buffer exceeded
14 20070211-04:34:07 automate.austin.ibm.com 37 Test1A none://anonymous local://local                     Debug Step 3: debug: files=78 threads=98
:exmp.
:p.
:li.:hp2.Goal::ehp2. Show me all the debug entries for global log stresstst
that starts with "Step 1:" or "Step 2:" in the message (in the long format)
:p.:hp2.Syntax::ehp2.  :xph.QUERY LONG GLOBAL LOGNAME stresstst CSCONTAINS "Step 1:" CSCONTAINS "Step 2:" LEVELMASK Debug:exph.
:p.:hp2.Results::ehp2.  If the request was issued from the
command line, the result, in verbose format, could look like:
:xmp.
[
  {
    Record #   : 3
    Date-Time  : 20070210-19:39:09
    Machine    : automate.austin.ibm.com
    Handle     : 37
    Handle Name: Test1A
    User       : none://anonymous
    Endpoint   : local://local
    Level      : Debug
    Message    : Step 1: debug: files=23 threads=37
  }
  {
    Record #   : 7
    Date-Time  : 20070211-01:21:58
    Machine    : automate.austin.ibm.com
    Handle     : 37
    Handle Name: Test1A
    User       : none://anonymous
    Endpoint   : local://local
    Level      : Debug
    Message    : Step 2: debug: files=31 threads=54
  }
  {
    Record #   : 9
    Date-Time  : 20070211-01:43:46
    Machine    : crazy8s.austin.ibm.com
    Handle     : 41
    Handle Name: Test2
    User       : none://anonymous
    Endpoint   : tcp://crazy8s.austin.ibm.com@6500
    Level      : Debug
    Message    : Step 1: debug: files=43 threads=67
  }
]
:exmp.
:p.
:li.:hp2.Goal::ehp2. Show the statistics for the file.
:p.:hp2.Syntax::ehp2.  :xph.QUERY GLOBAL LOGNAME stresstst STATS:exph.
:p.:hp2.Results::ehp2.  If the request was issued from the
command line, the result, in default format, could look like:
:xmp.
Fatal  : 0
Error  : 1
Warning: 1
Info   : 1
Trace  : 4
Trace2 : 0
Trace3 : 0
Debug  : 4
Debug2 : 0
Debug3 : 0
Start  : 1
Stop   : 1
Pass   : 1
Fail   : 0
Status : 1
User1  : 1
User2  : 1
User3  : 0
User4  : 0
User5  : 0
User6  : 0
User7  : 0
User8  : 0
:exmp.
:p.
:li.:hp2.Goal::ehp2. Show me log record numbers 5 to 10 in global log stresstst in the long format.
:p.:hp2.Syntax::ehp2.  :xph.QUERY GLOBAL LOGNAME stresstst FROMRECORD 5 TORECORD 10 LONG:exph.
:p.:hp2.Results::ehp2.  If the request was issued from the
command line, the result, in table format, could look like:
:xmp.
R# Date-Time         Machine                 H# Name   User             Endpoint                          Level Message
-- ----------------- ----------------------- -- ------ ---------------- --------------------------------- ----- ----------------------------------
5  20070210-22:21:01 automate.austin.ibm.com 37 Test1A none://anonymous local://local                     Info  Step 2: File ready on retry 3
6  20070211-01:21:39 automate.austin.ibm.com 37 Test1A none://anonymous local://local                     Trace Step 2: processing time: 03:02:41
7  20070211-01:21:58 automate.austin.ibm.com 37 Test1A none://anonymous local://local                     Debug Step 2: debug: files=31 threads=54
8  20070211-01:37:25 crazy8s.austin.ibm.com  41 Test2  none://anonymous tcp://crazy8s.austin.ibm.com@6500 Trace Step 1: processing time: 03:11:53
9  20070211-01:43:46 crazy8s.austin.ibm.com  41 Test2  none://anonymous tcp://crazy8s.austin.ibm.com@6500 Debug Step 1: debug: files=43 threads=67
10 20070211-02:53:20 automate.austin.ibm.com 37 Test1A none://anonymous local://local                     Error Step 3: Sharing buffer exceeded
:exmp.
:p.
:li.:hp2.Goal::ehp2. Show me which log records numbered 5 to 10 in global log stresstst have log level "Trace".
Use the long format.
:p.:hp2.Syntax::ehp2.  :xph.QUERY GLOBAL LOGNAME stresstst FROMRECORD 5 TORECORD 10 LEVELMASK Trace LONG:exph.
:p.:hp2.Results::ehp2.  If the request was issued from the
command line, the result, in table format, could look like:
:xmp.
R# Date-Time         Machine                 H# Name   User             Endpoint                          Level Message
-- ----------------- ----------------------- -- ------ ---------------- --------------------------------- ----- ----------------------------------
6  20070211-01:21:39 automate.austin.ibm.com 37 Test1A none://anonymous local://local                     Trace Step 2: processing time: 03:02:41
8  20070211-01:37:25 crazy8s.austin.ibm.com  41 Test2  none://anonymous tcp://crazy8s.austin.ibm.com@6500 Trace Step 1: processing time: 03:11:53
:exmp.
:eul.
.*
.*---------------------------------------------------------------------
.*
:ih1.service commands
:ih2.LIST
:i3.log service
:h3.LIST
Allows you to list the names of the log files based on a global, machine,
or handle location.   Also allows you to list current operational settings
:h4.Syntax
:xmp.
LIST GLOBAL | MACHINES | MACHINE <Machine> &lbrk.HANDLES | HANDLE <Handle>&rbrk.
:exmp.
or
:xmp.
LIST SETTINGS
:exmp.
:p.:xph.GLOBAL:exph. indicates you want to list all global logs.
:p.:xph.MACHINES:exph. indicates you want to list all the machines which have
created machine logs.
:p.:xph.MACHINE:exph. indicates you want to list all the machine logs for the
specified machine nickname.  &varres.
:p.:xph.HANDLES:exph. indicates you want to list all the handles that have
created handle logs for the given machine.
:p.:xph.HANDLE:exph. indicates you want to list all the handle logs for the
specified handle of the specified machine. &varres.
:p.:xph.SETTINGS:exph. indicates you want to list the current operational
settings.
:h4.Security
:p.&seclvl. 2.
:h4.Return Codes
:p.In addition to the return codes documented in :hdref refid=retcode.,
LIST also returns codes documented in :hdref refid=logerr..
:h4.Results
:p.If successful, the result buffer will contain data based on the LIST command:
:p.
:ul.
:li.If the :xph.MACHINES:exph. option is specified, the result buffer
will contain a marshalled :xph.<List>:exph. of &stringObj., which
represents the machines for which machine logs have been generated.
:p.
:li.If the :xph.HANDLES:exph. option is specified, the result buffer
will contain a marshalled :xph.<List>:exph. of &stringObj., which
represents the handles for which handle logs have been generated.
:p.
:li.If the :xph.GLOBAL:exph. option is specified, the result buffer
will contain a marshalled
:xph.<List> of <Map&colon.STAF/Service/Log/ListLogs>:exph.,
which represents the global logs.
:p.If option :xph.MACHINE:exph. is specified without the
:xph.HANDLES:exph. option, the result buffer will contain a marshalled
:xph.<List> of <Map&colon.STAF/Service/Log/ListLogs>:exph.,
which represents the machine logs for the specified machine nickname.
:p.If both options :xph.MACHINE:exph. and :xph.HANDLE:exph. are specified,
the result buffer will contain a marshalled
:xph.<List> of <Map&colon.STAF/Service/Log/ListLogs>:exph.,
which represents the handle logs for the specified machine nickname and handle.
:p.The map is defined as follows:
:table cols='* * * 2*'.
:tcap.Definition of map class STAF/Service/Log/ListLogs
:tnote text='Description'.This map class represents a log file.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Value / Format
:ethd.
:row.
:c.logName
:c.Log Name
:c.&stringObj.
:c.
:row.
:c.timestamp
:c.Date-Time
:c.&stringObj.
:c.&timestampFormat.
:row.
:c.upperSize
:c.U-Size
:c.&stringObj.
:c.
:row.
:c.size
:c.L-Size
:c.&stringObj.
:c.
:tnote text='Notes'. 
The "U-Size" value is the upper 32-bits of the size and the "L-Size" value is
the lower 32-bits of the size.  The sizes are shown in bytes.
:etnote.
:etable.
:p.
:li.If the :xph.SETTINGS:exph. option is specified, the result buffer will
contain a marshalled map of the settings for the log service in one of
two formats:
:p.
:ul.
:li.If the logging mode is local, the default mode, the
:xph.LIST SETTINGS:exph. request will contain a marshalled
:xph.<Map&colon.STAF/Service/Log/ListLocalSettings>:exph. defined as follows:
:table cols='* * * 2*'.
:tcap.Definition of map class STAF/Service/Log/ListLocalSettings
:tnote text='Description'.This map class represents the settings for a Log service
whose logging mode is local.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Value / Format
:ethd.
:row.
:c.loggingMode
:c.Logging Mode
:c.&stringObj.
:c.:xph.'Local':exph.
:row.
:c.directory
:c.Directory
:c.&stringObj.
:c.
:row.
:c.maxRecordSize
:c.Max Record Size
:c.&stringObj.
:c.
:row.
:c.defaultMaxQueryRecords
:c.Default Max Query Records
:c.&stringObj.
:c.
:row.
:c.resolveMessage
:c.Resolve Message
:c.&stringObj.
:c.:xph.'Enabled' | 'Disabled':exph.
:row.
:c.resolveMessageVar
:c.Resolve Message Var
:c.&stringObj.
:c.:xph.'Enabled' | 'Disabled':exph.
:etable.
:p.
:li.If the logging mode is remote, the :xph.LIST SETTINGS:exph. request
will contain a marshalled
:xph.<Map&colon.STAF/Service/Log/ListRemoteSettings>:exph. defined as follows:
:table cols='* * * *'.
:tcap.Definition of map class STAF/Service/Log/ListRemoteSettings
:tnote text='Description'.This map class represents the settings for a Log service
whose logging mode is remote.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Format / Value
:ethd.
:row.
:c.loggingMode
:c.Logging Mode
:c.&stringObj.
:c.:xph.'Remote':exph.
:row.
:c.remoteLogServer
:c.Remote Log Server
:c.&stringObj.
:c.
:row.
:c.remoteLogService
:c.Remote Log Service
:c.&stringObj.
:c.
:etable.
:eul.
:eul.

:h4.Examples
:ul.
:li.:hp2.Goal::ehp2. Show me all the global logs.
:p.:hp2.Syntax::ehp2.&nbsp; :xph.LIST GLOBAL:exph.
:p.:hp2.Results::ehp2.  If the request is submitted from the
command line, the result, in table format, could look like:
:xmp.
Log Name  Date-Time         U-Size L-Size
--------- ----------------- ------ ------
StressTST 20070210-14:17:00 0      120823
Suite100  20070211-15:45:00 0      2622
:exmp.
:p.
:li.:hp2.Goal::ehp2. Show me all the machines that have created machine logs.
:p.:hp2.Syntax::ehp2.&nbsp; :xph.LIST MACHINES:exph.
:p.:hp2.Results::ehp2.  If the request is submitted from the
command line, the result, in default format, could look like:
:xmp.
automate.austin.ibm.com
testmachine1
:exmp.
:p.
:li.:hp2.Goal::ehp2. Show me all the machine logs for machine automate.austin.ibm.com.
:p.:hp2.Syntax::ehp2.&nbsp; :xph.LIST MACHINE automate.austin.ibm.com:exph.
:p.:hp2.Results::ehp2.  If the request is submitted from the
command line, the result, in table format, could look like:
:xmp.
Log Name Date-Time         U-Size L-Size
-------- ----------------- ------ ------
AutoGlob 20070210-10:54:00 0      1168
:exmp.
:p.
:li.:hp2.Goal::ehp2. Show me all the handles for machine automate.austin.ibm.com that have created logs.
:p.:hp2.Syntax::ehp2. LIST MACHINE automate.austin.ibm.com HANDLES
:p.:hp2.Results::ehp2.  If the request is submitted from the
command line, the result could look like:
:xmp.
42
43
44
45
:exmp.
:p.
:li.:hp2.Goal::ehp2. Show me all the handle logs for machine automate.austin.ibm.com and handle 43.
:p.:hp2.Syntax::ehp2.&nbsp; :xph.LIST MACHINE automate.austin.ibm.com HANDLE 43:exph.
:p.:hp2.Results::ehp2.  If the request is submitted from the
command line, the result, in table format, could look like: