119 lines
5.9 KiB
HTML
119 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="reference" />
|
||
|
|
<meta name="DC.Title" content="Extend the watch function using the watch exit program example" />
|
||
|
|
<meta name="abstract" content="Using the example exit program as a starting point, you can modify the code to allow the program to perform additional function." />
|
||
|
|
<meta name="description" content="Using the example exit program as a starting point, you can modify the code to allow the program to perform additional function." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakuwatchexitpgmandexample.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakuexitprogramexample.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1997, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1997, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="extendwatchexitpgm" />
|
||
|
|
<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>Extend the watch function using the watch exit program example</title>
|
||
|
|
</head>
|
||
|
|
<body id="extendwatchexitpgm"><a name="extendwatchexitpgm"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Extend the watch function using the watch exit program example</h1>
|
||
|
|
<div><p><span>Using the example exit program as a starting
|
||
|
|
point, you can modify the code to allow the program to perform additional
|
||
|
|
function.</span></p>
|
||
|
|
<div class="section"><p>The following table provides suggestions for ways
|
||
|
|
you can extend the capability of the watch function on your system by performing
|
||
|
|
different actions based on the Trace option setting parameter in the exit
|
||
|
|
program. Refer to each Trace option setting parameter value and the corresponding
|
||
|
|
sample functions that can be performed.</p>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" id="d0e25">Trace option setting parameter value</th>
|
||
|
|
<th valign="top" id="d0e27">Sample functions that can be performed</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" headers="d0e25 ">*ON</td>
|
||
|
|
<td valign="top" headers="d0e27 "> <ul><li>To set up the environment right before the trace starts. For example: <ul><li>Start a process</li>
|
||
|
|
<li>Run commands</li>
|
||
|
|
<li>Change some special values</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>To register the status of the system right before the trace starts. For
|
||
|
|
example: <ul><li>Retrieve system values</li>
|
||
|
|
<li>Dump a job</li>
|
||
|
|
<li>Dump key objects for problem analysis</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>To verify that everything is ready for the trace and the watch function
|
||
|
|
to start. For example: <ul><li>Check certain system values</li>
|
||
|
|
<li>Check for the existence of key objects. </li>
|
||
|
|
</ul>
|
||
|
|
If the exit program detects that something is not ready, the value *STOP
|
||
|
|
for the Output parameter could be specified to prevent the trace command and
|
||
|
|
the watch function from starting.</li>
|
||
|
|
</ul>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">*MSGID or *LICLOG</td>
|
||
|
|
<td valign="top" headers="d0e27 "> <ul><li>To register the final status of the system right after the event being
|
||
|
|
watched for occurs. For example: <ul><li>Retrieve system values</li>
|
||
|
|
<li>Dump a job</li>
|
||
|
|
<li>Dump key objects for problem analysis</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>To set the environment back to the initial status. For example: <ul><li>End a process</li>
|
||
|
|
<li>Run commands</li>
|
||
|
|
<li>Change special values</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">*COMPDATA</td>
|
||
|
|
<td valign="top" headers="d0e27 ">The exit program can determine whether the trace and
|
||
|
|
the watch function should stop or continue running. This is determined by
|
||
|
|
returning *STOP or *CONTINUE for the Output parameter.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">*INTVAL</td>
|
||
|
|
<td valign="top" headers="d0e27 "> <ul><li>To perform activities periodically. For example, dump key objects for
|
||
|
|
problem analysis.</li>
|
||
|
|
<li>To check conditions periodically. For example, check for the existence
|
||
|
|
of key objects. The exit program can determine whether the trace and the watch
|
||
|
|
function should stop or continue running. This is determined by returning
|
||
|
|
*STOP or *CONTINUE for the Output parameter.</li>
|
||
|
|
</ul>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">*WCHTIMO</td>
|
||
|
|
<td valign="top" headers="d0e27 ">To set the environment back to the initial status. For
|
||
|
|
example: <ul><li>End a process</li>
|
||
|
|
<li>Run commands</li>
|
||
|
|
<li>Change some special values</li>
|
||
|
|
</ul>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakuwatchexitpgmandexample.htm" title="You can specify exit programs in the trace program parameter to extend the capability of the watch function.">Example: Watch exit program</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relref"><strong>Related reference</strong><br />
|
||
|
|
<div><a href="rzakuexitprogramexample.htm" title="This is sample code for a watch trace exit program. It is written in control language (CL).">Example: Watch exit program</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|