80 lines
4.9 KiB
HTML
80 lines
4.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="task" />
|
||
|
|
<meta name="DC.Title" content="Watch for messages" />
|
||
|
|
<meta name="abstract" content="The system provides a watch for event function which allows you to watch for messages." />
|
||
|
|
<meta name="description" content="The system provides a watch for event function which allows you to watch for messages." />
|
||
|
|
<meta name="DC.subject" content="watch for event, watch for message, watching, messages" />
|
||
|
|
<meta name="keywords" content="watch for event, watch for message, watching, messages" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="monmg.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../rzahb/rzahb_eventfunction.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../apis/pm1c.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="wchmsg" />
|
||
|
|
<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>Watch for messages</title>
|
||
|
|
</head>
|
||
|
|
<body id="wchmsg"><a name="wchmsg"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Watch for messages</h1>
|
||
|
|
<div><p>The system provides a watch for event function which allows you
|
||
|
|
to watch for messages.</p>
|
||
|
|
<div class="section"> <p>The watch for event function allows you to specify messages for
|
||
|
|
which you want the system to watch. Once these messages occur, a user exit
|
||
|
|
program will be called to take any necessary action. You must specify the
|
||
|
|
message queue or job log where you expect the message to be sent. You can
|
||
|
|
specify some text string to be compared against the message data in order
|
||
|
|
to be informed of only certain messages.</p>
|
||
|
|
<p>Use the <span class="cmdname">Start
|
||
|
|
Watch (STRWCH)</span> command to start a watch session and be notified
|
||
|
|
when a specified message occurs. When the watched for message is added to
|
||
|
|
the specified message queue or log, the watch exit program is called. Every
|
||
|
|
time a watch session is started a job is submitted into QUSRWRK subsystem
|
||
|
|
with the same name as the session id. This is where the watch exit program
|
||
|
|
runs.</p>
|
||
|
|
<p>The <span class="cmdname">Work with Watches (WRKWCH)</span> command can
|
||
|
|
be used to show a panel with the list of active watches on the system, while <span class="cmdname">End
|
||
|
|
Watch (ENDWCH)</span> command can be used to end a watch session. </p>
|
||
|
|
<p>The <span class="apiname">Start
|
||
|
|
Watch (QSCSWCH)</span> and <span class="apiname">End Watch (QSCEWCH)</span> APIs
|
||
|
|
have a very similar usage to the STRWCH and ENDWCH commands. </p>
|
||
|
|
<p>The watch
|
||
|
|
for event function is also incorporated into some trace commands: </p>
|
||
|
|
<ul><li><span class="cmdname">Start Trace (STRTRC)</span></li>
|
||
|
|
<li><span class="cmdname">Start Communications Trace (STRCMNTRC)</span></li>
|
||
|
|
<li><span class="cmdname">Trace Internal (TRCINT)</span></li>
|
||
|
|
<li><span class="cmdname">Trace Connection (TRCCNN)</span></li>
|
||
|
|
<li><span class="cmdname">Trace TCP Application (TRCTCPAPP)</span></li>
|
||
|
|
</ul>
|
||
|
|
<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 you need to
|
||
|
|
spend monitoring traces. </p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="monmg.htm" title="You can monitor for exception messages. Exception messages include escape, notify, and status messages that are sent to your CL procedure's or program's call message queue by the commands in your procedure or program or by commands in another procedure or program. Diagnostic messages cannot be monitored.">Monitor for messages in a CL program or procedure</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
||
|
|
<div><a href="../rzahb/rzahb_eventfunction.htm">Watch for event function</a></div>
|
||
|
|
<div><a href="../apis/pm1c.htm">Monitoring APIs</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|