81 lines
5.9 KiB
HTML
81 lines
5.9 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="Use the watch for event function" />
|
||
|
|
<meta name="abstract" content="Use the corresponding commands to set up and use the watch for event function." />
|
||
|
|
<meta name="description" content="Use the corresponding commands to set up and use the watch for event function." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahb_eventfunction.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../apis/xwchevnt.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/strwch.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="rzahb_useeventfunction" />
|
||
|
|
<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>Use the watch for event function</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzahb_useeventfunction"><a name="rzahb_useeventfunction"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Use the watch for event function</h1>
|
||
|
|
<div><p><span><img src="./delta.gif" alt="Start of change" />Use the corresponding commands to set up and
|
||
|
|
use the watch for event function.<img src="./deltaend.gif" alt="End of change" /></span></p>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Start Watch (STRWCH) command</h4><p>The Start Watch (STRWCH)
|
||
|
|
command starts a watch session and notifies you when the specified message
|
||
|
|
or Licensed Internal Code log entry occurs. When the watched for message is
|
||
|
|
added to the specified message queue or log, or the watched for log entry
|
||
|
|
is added, the exit program specified in the Watch program (WCHPGM) parameter
|
||
|
|
is called.</p>
|
||
|
|
<p><img src="./delta.gif" alt="Start of change" />When watching for messages, you must specify
|
||
|
|
the message queue or job log where you expect the message to be sent. You
|
||
|
|
can narrow the search by specifying a text string to be compared against the
|
||
|
|
message data, the From program or the To program of the watched for message.<img src="./deltaend.gif" alt="End of change" /></p>
|
||
|
|
<p><img src="./delta.gif" alt="Start of change" />When watching for Licensed Internal Code log entries, you
|
||
|
|
must specify the Licensed Internal Code log major and minor codes. *ALL and
|
||
|
|
wildcards (?) are accepted. You can narrow the search by specifying a text
|
||
|
|
string to be compared against several of the Licensed Internal Code log fields
|
||
|
|
of the watched for log entry. Use the Watch for Licensed Internal Code log
|
||
|
|
entry (WCHLICLOG) parameter on the STRWCH command.<img src="./deltaend.gif" alt="End of change" /></p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><img src="./delta.gif" alt="Start of change" /><h4 class="sectiontitle">Work with Watches (WRKWCH) command</h4><p>The <a href="../cl/wrkwch.htm">Work with Watches (WRKWCH)</a> command
|
||
|
|
is used to show a panel with a list of active watches on the system.</p>
|
||
|
|
<img src="./deltaend.gif" alt="End of change" /></div>
|
||
|
|
<div class="section"><img src="./delta.gif" alt="Start of change" /><h4 class="sectiontitle">End Watch (ENDWCH) command</h4><p>The <a href="../cl/endwch.htm">End Watch (ENDWCH)</a> command
|
||
|
|
is used to end a watch session.</p>
|
||
|
|
<img src="./deltaend.gif" alt="End of change" /></div>
|
||
|
|
<div class="section"><img src="./delta.gif" alt="Start of change" /><h4 class="sectiontitle">Start Watch (QSCSWCH) and End Watch (QSCEWCH)
|
||
|
|
APIs</h4><p>The <a href="../apis/qscswch.htm">Start
|
||
|
|
Watch (QSCSWCH)</a> and <a href="../apis/qscewch.htm">End Watch (QSCEWCH)</a> application programming interfaces
|
||
|
|
(APIs) have a very similar usage to the STRWCH and ENDWCH commands.</p>
|
||
|
|
<img src="./deltaend.gif" alt="End of change" /></div>
|
||
|
|
<div class="section"><img src="./delta.gif" alt="Start of change" /><h4 class="sectiontitle">Use the watch for event function with trace
|
||
|
|
commands</h4><p>Watch support enhances the trace functions by automatically
|
||
|
|
monitoring and ending traces when certain predetermined criteria are met.
|
||
|
|
This prevents the loss of valuable trace data and reduces the amount of time
|
||
|
|
that you need to spend monitoring traces. For more information, see <a href="../rzaku/rzakuadvtrc.htm">Advanced
|
||
|
|
trace function: Watch support</a>.</p>
|
||
|
|
<img src="./deltaend.gif" alt="End of change" /></div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzahb_eventfunction.htm" title="The watch for event function enhances your ability to detect and react to problems represented by specific messages or Licensed Internal Code log entries. The watch for event function notifies you when the specified event (message or Licensed Internal Code log entry) occurs, and then calls the specified exit program to take the desired action.">Watch for event function</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
||
|
|
<div><a href="../apis/xwchevnt.htm">Exit Program for Watch for Event</a></div>
|
||
|
|
<div><a href="../cl/strwch.htm">Start Watch (STRWCH)</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|