monsrv.script

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

the machine nicknames for which monitor messages have been logged.
:p.
:li.If the :xph.MACHINE:exph. option is specified (and the :xph.NAMES:exph.
option is not specified), the result buffer will contain a marshalled
:xph.<List> of <Map&colon.STAF/Service/Monitor/HandleInfo>:exph., which
represents the handles for the specified machine that have logged monitor
messages.  The map is defined as follows:  
:table cols='* * * *'.
:tcap.Definition of map class STAF/Service/Monitor/HandleInfo
:tnote text='Description'.This map class represents the handle that generated
the monitor message on the specified machine.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Format / Value
:ethd.
:row.
:c.handle
:c.Handle
:c.&stringObj.
:c.
:row.
:c.timestamp
:c.Date-Time
:c.&stringObj.
:c.&timestampFormat.
:row.
:c.size
:c.Size
:c.&stringObj.
:c.
:tnote text='Notes'.
The "Date-Time" is the date/time at which the last monitor
message was logged.
The "Size" is the size of the last monitor message logged.
:etnote.
:etable.
:p.
:li.If the :xph.MACHINE:exph. option is specified with the :xph.NAMES:exph.
option, the result buffer will contain a marshalled :xph.<List> of
<Map&colon.STAF/Service/Monitor/NameInfo>:exph., which
represents the named monitors for the specified machine.  The map is defined
as follows:
:table cols='* * * *'.
:tcap.Definition of map class STAF/Service/Monitor/NameInfo
:tnote text='Description'.This map class represents the named monitors
on the specified machine.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Format / Value
:ethd.
:row.
:c.name
:c.Name
:c.&stringObj.
:c.
:row.
:c.timestamp
:c.Date-Time
:c.&stringObj.
:c.&timestampFormat.
:row.
:c.size
:c.Size
:c.&stringObj.
:c.
:tnote text='Notes'.
The "Date-Time" is the date/time at which the last monitor
message was logged.
The "Size" is the size of the last monitor message logged.
:etnote.
:etable.
:p.
:li.If the :xph.SETTINGS:exph. option is specified, the result buffer will
contain a marshalled :xph.<Map&colon.STAF/Service/Monitor/Settings>:exph. defined
as follows:
:table cols='* * * *'.
:tcap.Definition of map class STAF/Service/Monitor/Settings
:tnote text='Description'.This map class represents the settings for
the Monitor service.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Value
:ethd.
:row.
:c.maxRecordSize
:c.Max Record Size
: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.
:eul.

:h4.Examples
:ul.
:li.:hp2.Goal::ehp2. Show me all the machines that have written monitor data.
: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 monitor information (Handle) 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.
Handle Date-Time         Size
------ ----------------- ----
34     20040910-16:29:03 30
36     20040910-16:29:13 148
37     20040910-16:29:19 97
68     20040911-16:00:32 43
:exmp.
:p.
:li.:hp2.Goal::ehp2. Show me all the monitor information (Handle) for machine testmachine1.
:p.:hp2.Syntax::ehp2.&nbsp; :xph.LIST MACHINE testmachine1:exph.
:p.:hp2.Results::ehp2.  If the request is submitted from the
command line, the result, in table format, could look like:
:xmp.
Handle Date-Time         Size
------ ----------------- ----
20     20041022-17:43:05 25
:exmp.
:p.
:li.:hp2.Goal::ehp2. Show me all the named monitors for machine automate.austin.ibm.com.
:p.:hp2.Syntax::ehp2.&nbsp; :xph.LIST MACHINE automate.austin.ibm.com NAMES:exph.
:p.:hp2.Results::ehp2.  If the request is submitted from the
command line, the result, in table format, could look like:
:xmp.
Name              Date-Time         Size
----------------- ----------------- ----
ActiveXYZRequests 20061205-13:50:06 39
test1             20061205-13:54:14 25
:exmp.
:p.
:li.:hp2.Goal::ehp2. Show me all the Monitor settings.
:p.:hp2.Syntax::ehp2.&nbsp; :xph.LIST SETTINGS:exph.
:p.:hp2.Results::ehp2.  If the request is submitted from the
command line, the result, in default format, could look like:
:xmp.
Max Record Size    : 512
Resolve Message    : Enabled
Resolve Message Var: Disabled
:exmp.
:eul.
.*
.*---------------------------------------------------------------------
.*
:ih1.service commands
:ih2.DELETE
:i3.monitor service
:h3.DELETE
The DELETE command will delete monitor files and directories.
:h4.Syntax
:xmp.
DELETE &lbrk.BEFORE <Timestamp>&rbrk. CONFIRM
:exmp.
:p.:xph.BEFORE:exph. specifies that you only want to delete monitor data
recorded prior to the specified timestamp.  If :xph.BEFORE:exph. is not
specified, all monitor data will be removed. The keyword :hp3.TODAY:ehp3.
can be used for :xph.<Timestamp>:exph. to delete all data prior to the
current system date.
:p.:xph.CONFIRM:exph. confirms you really want to delete the monitor
data.
:h4.Security
:p.&seclvl. 4.
:h4.Return Codes
:p.All return codes from DELETE are documented in :hdref refid=retcode..
:h4.Results
:p.The result buffer will contain no data on return from a DELETE command.
.*
.*---------------------------------------------------------------------
.*
:ih1.service commands
:ih2.SET
:i3.monitor service
:h3.SET
Sets monitor service options.
:h4.Syntax
:xmp.
SET  &lbrk.RESOLVEMESSAGE | NORESOLVEMESSAGE&rbrk.
     &lbrk.MAXRECORDSIZE <Size>&rbrk.
     &lbrk.ENABLERESOLVEMESSAGEVAR | DISABLERESOLVEMESSAGEVAR&rbrk.
:exmp.
:p.:xph.RESOLVEMESSAGE:exph. causes the MONITOR service to call the STAF
variable service to resolve any variables in Monitor Log messages before being 
written.
:p.:xph.NORESOLVEMESSAGE:exph. causes the MONITOR service to not call the STAF
variable service to resolve any variables in Monitor Log messages before being
written.  This is the default.
:p.:xph.MAXRECORDSIZE <Size>:exph. sets the Maximum record size for Monitor
data.  The default is 1024 bytes.
:p.:xph.ENABLERESOLVEMESSAGEVAR:exph. causes STAF/Service/<Name>/ResolveMessage
variable to be queried for every Monitor Log command, to determine if variables
in the Monitor Log command should be resolved.
:p.:xph.DISABLERESOLVEMESSAGEVAR:exph. causes STAF/Service/<Name>/ResolveMessage
variable to not be queried for every Monitor Log command.  This is the default.
:p.The highest priority in defining whether variables in a Monitor Log command
are to be resolved will be the
:xph.RESOLVEMESSAGE/NORESOLVEMESSAGE:exph. specified directly in the
Log command.  If the Monitor Log command contains neither option, then if 
:xph.ENABLERESOLVEMESSAGEVAR:exph. is set, the variable
STAF/Service/<Name>/ResolveMessage will be examined to determine whether to
resolve the message.  If :xph.DISABLERESOLVEMESSAGEVAR:exph. is set, then the
:xph.RESOLVEMESSAGE/NORESOLVEMESSAGE:exph. option (set via the PARMS options or
by use of the :xph.SET RESOLVEMESSAGE/NORESOLVEMESSAGE:exph. Monitor command)
will be honored.
:h4.Security
:p.&seclvl. 5.
:h4.Return Codes
:p.All return codes from SET are documented in :hdref refid=retcode..
:h4.Results
:p.The result buffer will contain no data on return from a successul :xph.SET:exph.
command.
:h4.Examples
:ul.
:li.:hp2.Goal::ehp2.&nbsp; Enable the resolve message setting for the Monitor service.
:p.:hp2.Syntax::ehp2.&nbsp; :xph.SET RESOLVEMESSAGE:exph.
:p.
:li.:hp2.Goal::ehp2.&nbsp; Set two operational settings for the Monitor service.
:p.:hp2.Syntax::ehp2.&nbsp; :xph.SET MAXRECORDSIZE 512 ENABLERESOLVEMESSAGEVAR:exph.
:eul.
.*
.*---------------------------------------------------------------------
.*
:ih1.error codes
:i2.monitor service
:h3 id=monerr.Monitor Error Code Reference
:p.No additional return codes are defined for the Monitor service.
The Monitor service uses only the STAF return codes (see :hdref refid=retcode. for
additional information).