ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaih_5.4.0.1/rzaihjobmonthreshold.htm

177 lines
13 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Specify the threshold values" />
<meta name="abstract" content="Setting a threshold for a metric that is being collected by a monitor allows you to be notified and, optionally, to specify actions to be taken when a certain value (called the trigger value) is reached. You can also specify actions to be taken when a second value (called the reset value) is reached." />
<meta name="description" content="Setting a threshold for a metric that is being collected by a monitor allows you to be notified and, optionally, to specify actions to be taken when a certain value (called the trigger value) is reached. You can also specify actions to be taken when a second value (called the reset value) is reached." />
<meta name="DC.Relation" scheme="URI" content="rzaihjobmoncreate.htm" />
<meta name="DC.Relation" scheme="URI" content="rzaihjobmonmetrics.htm" />
<meta name="DC.Relation" scheme="URI" content="rzaihjobmoncollectitv.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzaihjobmonthreshold" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Specify the threshold values</title>
</head>
<body id="rzaihjobmonthreshold"><a name="rzaihjobmonthreshold"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Specify the threshold values</h1>
<div><p>Setting a threshold for a metric that is being collected by a monitor
allows you to be notified and, optionally, to specify actions to be taken
when a certain value (called the <dfn class="term">trigger value</dfn>) is reached. You
can also specify actions to be taken when a second value (called the <dfn class="term">reset
value</dfn>) is reached.</p>
<p> For example, when you create a system monitor, you can specify an i5/OS™ command
that stops any new jobs from starting when CPU utilization reaches 90% and
another i5/OS command
that allows new jobs to start when CPU utilization falls to less than 70%.</p>
<p>For some metrics, it is appropriate to specify a reset value, which resets
the threshold and allows it to be triggered again when the trigger value is
reached. For those thresholds, you can specify a command to be run when the
reset value is reached. For other metrics (such as the File Status metric
and the Text metric on file monitors, and any message set on a message monitor),
you can specify to automatically reset the threshold when the trigger command
is run.</p>
<p>You can set up to two thresholds for each metric that the monitor is collecting.
Thresholds are triggered and reset based on the value at the time the metric
collection is made. Specifying a higher number of collection intervals in
the Duration field helps to avoid unnecessary threshold activity due to frequent
spiking of values.</p>
<p>You can also choose to add an event to the Event Log whenever the trigger
value or the reset value is reached.</p>
<p>On the New Monitor - Metrics page, the threshold tabs provide a place for
you to specify a threshold value for each metric that you have selected to
monitor. For example, if you are creating a job monitor, you can set your
threshold values in the following ways depending on the type of metric you
have selected:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><th valign="top" width="14.285714285714285%" class="firstcol" id="d0e40">Job Count</th>
<td valign="top" width="85.71428571428571%" headers="d0e40 ">When you define a threshold, you can specify a command to run on the
endpoint system when the threshold is triggered. For example, selecting <span class="menucascade"><span class="uicontrol"></span> &gt; <span class="uicontrol">25 jobs</span></span> will trigger
the threshold whenever the monitor detects more than 25 jobs running during
the number of collection intervals you specify for <span class="uicontrol">Duration</span>. <p>You
can then specify a command to be run on the endpoint system when the monitor
detects more than 25 jobs. Enter the command name and click <span class="uicontrol">Prompt</span> for
assistance in specifying the parameters for the command. For more detailed
information and examples of specifying commands to be run when thresholds
are triggered, see the performance scenarios topic.</p>
<p><span class="uicontrol">Enable
reset</span> is optional, and cannot be selected until a trigger is defined.
You can also specify a command to be run on the endpoint system when the threshold
is reset.</p>
</td>
</tr>
<tr><th valign="top" width="14.285714285714285%" class="firstcol" id="d0e63"> </th>
<td valign="top" width="85.71428571428571%" headers="d0e63 "> </td>
</tr>
<tr><th valign="top" width="14.285714285714285%" class="firstcol" id="d0e68">Job Log Message</th>
<td valign="top" width="85.71428571428571%" headers="d0e68 ">You must select <span class="uicontrol">Trigger when any of the following messages
are sent to the job log</span> before you can specify the conditions
to trigger a threshold. You can specify messages to monitor for based on any
combination of Message ID, Type, and Minimum severity. Each row in the Job
Log Message table shows a combination of criteria that must be met for a message
to trigger a threshold. A threshold will be triggered if it meets the criteria
in at least one row. Use the online help to specify the conditions to trigger
a threshold. <p>Be careful to monitor the smallest number of jobs that will
give you the information you need. Monitoring a large number of jobs for job
log messages may have a performance impact on your system.</p>
<p>You can specify
a command to be run on the endpoint system when the threshold is triggered.
Enter the command name and click <span class="uicontrol">Prompt</span> for assistance
in specifying the parameters for the command.</p>
<p>Be sure to click the Collection
Interval tab to specify how often you want the monitor to check for job log
messages.</p>
<p>A message trigger can only be manually reset. You can specify
a command to be run on the endpoint system when the threshold is reset. When
you reset the monitor, you always have the option to reset without running
the specified command.</p>
</td>
</tr>
<tr><th valign="top" width="14.285714285714285%" class="firstcol" id="d0e87"> </th>
<td valign="top" width="85.71428571428571%" headers="d0e87 "> </td>
</tr>
<tr><th valign="top" width="14.285714285714285%" class="firstcol" id="d0e92">Job Status</th>
<td valign="top" width="85.71428571428571%" headers="d0e92 ">On the <span class="uicontrol">Metrics - General</span> tab, select the statuses
that you want to monitor for. Click the <span class="uicontrol">Metrics - Status Threshold</span> tab
to specify the conditions to trigger a threshold. You must select <span class="uicontrol">Trigger
when job is in any selected status</span> before you can specify the
conditions to trigger a threshold. The threshold is triggered whenever the
monitor detects that the job is in any selected status for the number of collection
intervals you specify for <span class="uicontrol">Duration</span>. <p>You can then
specify a command to be run on the endpoint system when the threshold is triggered.
Enter the command name and click <span class="uicontrol">Prompt</span> for assistance
in specifying the parameters for the command.</p>
<p><span class="uicontrol">Reset when
job is not in selected statuses</span> is optional, and cannot be selected
until a trigger is defined. You can specify a command to be run on the endpoint
system when the threshold is reset.</p>
</td>
</tr>
<tr><th valign="top" width="14.285714285714285%" class="firstcol" id="d0e119"> </th>
<td valign="top" width="85.71428571428571%" headers="d0e119 "> </td>
</tr>
<tr><th valign="top" width="14.285714285714285%" class="firstcol" id="d0e124">Job Numeric Values</th>
<td valign="top" width="85.71428571428571%" headers="d0e124 ">When you define the threshold, you can specify a command to run on
the endpoint system when the threshold is triggered. For example, selecting <span class="menucascade"><span class="uicontrol"></span> &gt; <span class="uicontrol">101 transactions per second</span></span> for the Transaction Rate metric will trigger the threshold
whenever the monitor detects more than 101 transactions per second on any
of the selected jobs during the number of collection intervals you specify
for <span class="uicontrol">Duration</span>. <p>You can then specify a command to
be run on the endpoint system when the monitor detects more than 101 transactions
per second. Enter the command name and click <span class="uicontrol">Prompt</span> for
assistance in specifying the parameters for the command.</p>
<p><span class="uicontrol">Enable
reset</span> is optional, and cannot be selected until a trigger is defined.
You can also specify a command to be run on the endpoint system when the threshold
is reset.</p>
</td>
</tr>
<tr><th valign="top" width="14.285714285714285%" class="firstcol" id="d0e147"> </th>
<td valign="top" width="85.71428571428571%" headers="d0e147 "> </td>
</tr>
<tr><th valign="top" width="14.285714285714285%" class="firstcol" id="d0e152">Summary Numeric Values (total for all jobs)</th>
<td valign="top" width="85.71428571428571%" headers="d0e152 ">When you define a threshold, you can specify a command to run on the
endpoint system when the threshold is triggered. For example, selecting <span class="menucascade"><span class="uicontrol"></span> &gt; <span class="uicontrol">1001 transactions per second</span></span> for the Transaction Rate metric will trigger the threshold
whenever the monitor detects more than 1001 transactions per second on all
of the selected jobs during the number of collection intervals you specify
for <span class="uicontrol">Duration</span>. <p>You can then specify a command to
be run on the endpoint system when the monitor detects more than 1001 transactions
per second. Enter the command name and click <span class="uicontrol">Prompt</span> for
assistance in specifying the parameters for the command.</p>
<p><span class="uicontrol">Enable
reset</span> is optional, and cannot be selected until a trigger is defined.
You can also specify a command to be run on the endpoint system when the threshold
is reset.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p>For more information about these
and other Management Central tasks and topics, refer to the detailed task
help that is available from the iSeries™ Navigator window. Click <span class="uicontrol">Help</span> from
the menu bar and select <span class="menucascade"><span class="uicontrol">iSeries Navigator overview</span> &gt; <span class="uicontrol">Management Central</span></span>.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaihjobmoncreate.htm" title="Creating a new monitor is a quick and easy process that begins at the New Monitor window. In iSeries Navigator, expand Management Central, expand Monitors, right-click the type of monitor you want to create (for example, Job), and then click New Monitor.">Create a new monitor</a></div>
<div class="previouslink"><strong>Previous topic:</strong> <a href="rzaihjobmonmetrics.htm" title="For each type of monitor, Management Central offers several measurements, known as metrics, to help you pinpoint different aspects of system activity. A metric is a measurement of a particular characteristic of a system resource or the performance of a program or a system.">Select the metrics</a></div>
<div class="nextlink"><strong>Next topic:</strong> <a href="rzaihjobmoncollectitv.htm" title="When you are setting thresholds for the metrics you have selected to monitor, you should consider how often you want the data to be collected.">Specify the collection interval</a></div>
</div>
</div>
</body>
</html>