137 lines
5.2 KiB
HTML
137 lines
5.2 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>End Watch (ENDWCH)</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="ENDWCH.Top_Of_Page"></a>
|
|
<h2>End Watch (ENDWCH)</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="#ENDWCH.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ENDWCH.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ENDWCH.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ENDWCH"></a>
|
|
<p>The End Watch (ENDWCH) command ends a watch session that was started by a STRWCH (Start Watch) command or by Start Watch (QSCSWCH) API.
|
|
</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 watch function of Operating System through iSeries Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_WATCH, can also be used to change the list of users that are allowed to start and end watch operations.
|
|
</li>
|
|
<li>If ending a watch session that is watching for a message within a job log, the issuer of the command must be running under a user profile which is the same as the job user identity of the job being watched, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority. Job control (*JOBCTL) special authority is also required when ending a session where jobs with a generic user name are being watched.
|
|
</li>
|
|
<li>If ending a watch session that was started specifying *ALL for the watch job name, or a generic user name, you must have *ALLOBJ special authority, or be authorized to the Watch Any Job function of Operating System through iSeries Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_WATCH_ANY_JOB, can also be used to change the list of users that are allowed to start and end watch operations.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDWCH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ENDWCH.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="#ENDWCH.SSNID"><b>SSNID</b></a></td>
|
|
<td valign="top">Session ID</td>
|
|
<td valign="top"><i>Name</i>, *PRV</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDWCH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ENDWCH.SSNID"></a>
|
|
<h3>Session ID (SSNID)</h3>
|
|
<p>Specifies a session identifier for the watch to be ended. This name must match the session identifier of a watch session that had been previously started and is still active.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*PRV</b></dt>
|
|
<dd>The watch session most recently started by the same user who is running this ENDWCH command will be ended. For example, if the job running the ENDWCH command is running under user profile BOB, the last watch session started under user profile BOB is ended.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the session identifier of the watch to be ended.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDWCH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDWCH.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: End Most Recently Started Watch</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDWCH SSNID(*PRV)
|
|
</pre>
|
|
</p>
|
|
<p>This command ends the watch session started most recently by the same user who is running the ENDWCH command.
|
|
</p>
|
|
<p><b>Example 2: End a Specific Watch Session</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDWCH SSNID(MYSESSION)
|
|
</pre>
|
|
</p>
|
|
<p>This command ends the watch session MYSESSION.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDWCH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDWCH.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF39EC</b></dt>
|
|
<dd>Cannot end watch session &1 started by &2 command.
|
|
</dd>
|
|
<dt><b>CPF39E1</b></dt>
|
|
<dd>Watch session &1 not found.
|
|
</dd>
|
|
<dt><b>CPF39E2</b></dt>
|
|
<dd>There is no active watch session for current user profile.
|
|
</dd>
|
|
<dt><b>CPF39E6</b></dt>
|
|
<dd>The user does not have the required authority.
|
|
</dd>
|
|
<dt><b>CPF39E8</b></dt>
|
|
<dd>Not enough authority to watch operations.
|
|
</dd>
|
|
<dt><b>CPF39E9</b></dt>
|
|
<dd>*JOBCTL special authority required.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDWCH.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|