124 lines
4.7 KiB
HTML
124 lines
4.7 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Work with Watches (WRKWCH)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="WRKWCH.Top_Of_Page"></a>
|
|
<h2>Work with Watches (WRKWCH)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#WRKWCH.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#WRKWCH.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#WRKWCH.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="WRKWCH"></a>
|
|
<p>The Work with Watches (WRKWCH) command can be used to show a panel with the list of active watches around the system. An active watch can be a watch started issuing Trace Internal (TRCINT), Start Trace (STRTRC), Trace Connection (TRCCNN), Trace TCP/IP Application (TRCTCPAPP), and Start Communications Trace (STRCMNTRC) commands specifying watches parameters, or a session started using Start Watch (STRWCH) command, or using Start Watch (QSCSWCH) API.
|
|
</p>
|
|
<p>When you run this command, the Work with Watches panel is shown. From this display you can end an active watch or start a new one. Also the watches being ended are shown.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service Trace function and Service Watch function of the operating system through iSeries Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE and QIBM_SERVICE_WATCH, can also be used to change the list of users that are allowed to perform trace operations.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKWCH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="WRKWCH.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKWCH.WCH"><b>WCH</b></a></td>
|
|
<td valign="top">Watch</td>
|
|
<td valign="top">Single values: *ALL<br>Other values (up to 3 repetitions): *SRVMON, *STRWCH, *TRCCMD</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKWCH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="WRKWCH.WCH"></a>
|
|
<h3>Watch (WCH)</h3>
|
|
<p>Specifies the watches to be shown on the Work with Watches panel.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All active watches are shown in the Work with Watches panel.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SRVMON</b></dt>
|
|
<dd>Active watches started using the Service Monitor function of the operating system are shown.
|
|
</dd>
|
|
<dt><b>*STRWCH</b></dt>
|
|
<dd>Active watches started using the Start Watch (STRWCH) command or the Start Watch (QSCSWCH) API are shown.
|
|
</dd>
|
|
<dt><b>*TRCCMD</b></dt>
|
|
<dd>Active watches started using Start Communications Trace (STRCMNTRC), Start Trace (STRTRC), Trace Internal (TRCINT), Trace Connection (TRCCNN) and Trace TCP/IP Application (TRTCPAPP) commands are shown.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKWCH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKWCH.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
WRKWCH WCH(*TRCCMD)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays the Work with Watches panel, showing all watch sessions started via watches parameters specified in Trace Internal (TRCINT), Trace Connection (TRCCNN), Start Communications Trace (STRCMNTRC), Trace TCP/IP Application (TRCTCPAPP) and Start Trace (STRTRC) commands.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKWCH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKWCH.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF39E6</b></dt>
|
|
<dd>The user does not have the required authority.
|
|
</dd>
|
|
<dt><b>CPF98A2</b></dt>
|
|
<dd>Not authorized to &1 command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKWCH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|