269 lines
11 KiB
HTML
269 lines
11 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 Database Monitor (ENDDBMON)</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="ENDDBMON.Top_Of_Page"></a>
|
|
<h2>End Database Monitor (ENDDBMON)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>Conditional
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#ENDDBMON.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ENDDBMON.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ENDDBMON.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ENDDBMON"></a>
|
|
<p>The End Database Monitor (ENDDBMON) command ends the collection of database performance statistics for a specified job, all jobs on the system or a selected set of jobs (i.e. a generic job name).
|
|
</p>
|
|
<p>To end a monitor, you can specify the job or the monitor ID or both. If just the JOB parameter is specified, we end the monitor that was started using the same exact JOB parameter - if there is only one monitor which matches the specified JOB. If more than one monitor is active which matches the specified JOB, then the user uniquely identifies which monitor is to be ended by use of the MONID parameter. When just the MONID parameter is specified, we compare the specified MONID to the monitor ID of the monitor for the current job and to the monitor ID of all active public monitors (monitors that are open across multiple jobs). The monitor matching the specified MONID is closed.
|
|
</p>
|
|
<p>The monitor ID is returned in the informational message CPI436A which is generated for each occurrence of the STRDBMON command. The monitor ID can also be found in column QQC101 of the QQQ3018 database monitor record.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>You cannot end database monitoring for a specific job by using JOB(*ALL) on the ENDDBMON command. To end a specific job you must specify that job on the JOB parameter or specify JOB(*).
|
|
</li>
|
|
<li>If JOB(*ALL) was specified on the Start Database Monitor (STRDBMON) command, you cannot end monitoring on a per-job basis. Specifying ENDBMON JOB(*ALL) will end the monitor that is active across all jobs. Only if a specific job was specified on the JOB parameter or JOB(*) can you end monitoring for a specific job.
|
|
</li>
|
|
<li>This command is conditionally threadsafe. It is not threadsafe (and may fail) when the OUTFILE parameter for the STRDBMON command specified a distributed file or a Distributed Data Management (DDM) file of type *SNA.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDBMON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ENDDBMON.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" rowspan="4"><a href="#ENDDBMON.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top">Single values: <b><u>*</u></b><br>Other values: <i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job name</td>
|
|
<td valign="top"><i>Generic name, name</i>, *ALL</td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Generic name, name</i>, *ALL</td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999, *ALL</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#ENDDBMON.MONID"><b>MONID</b></a></td>
|
|
<td valign="top">Monitor ID</td>
|
|
<td valign="top"><i>Character value</i>, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDDBMON.COMMENT"><b>COMMENT</b></a></td>
|
|
<td valign="top">Comment</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDBMON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ENDDBMON.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the job(s) for which the database monitor is to be ended.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The data monitor for the job running the ENDDBMON command is to be ended.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The data monitor open across all jobs (started with JOB(*ALL)) is to be ended.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Job name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the job whose database monitor is to be ended. If no job user name or job number qualifiers are specified, all of the jobs currently in the system are searched for the specified simple job name. If duplicates of the specified job name are found, you need to specify a job user name, job number or monitor ID that uniquely identifies the job to be changed.
|
|
</dd>
|
|
<dt><b><i>generic-name</i></b></dt>
|
|
<dd>Specify the generic job name of the monitor to be ended. The monitor started with the same generic job name (e.g. JOB(QZDA*)) will be ended.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: User</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the user of the job whose database monitor is to be ended.
|
|
</dd>
|
|
<dt><b><i>generic-name</i></b></dt>
|
|
<dd>Specify the generic job user of the monitor to be ended. The monitor started with the same generic job user (e.g. JOB(*ALL/DEVLPR*)) will be ended.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 3: Number</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>000000-999999</i></b></dt>
|
|
<dd>Specify the number of the job whose database monitor is to be ended.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDBMON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDDBMON.MONID"></a>
|
|
<h3>Monitor ID (MONID)</h3>
|
|
<p>Specifies the unique monitor ID of the database monitor to be ended. If mulitple monitors using the same JOB parameter were started, the MONID parameter must be specified to uniquely identify which individual monitor is to be ended. A monitor ID value is generated by the system for each invocation of the STRDBMON command. Informational message CPI436A contains the system generated monitor ID value. The system generated monitor ID value is also stored in column QQC101 of the QQQ3018 database monitor record.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>When used with JOB(*ALL), all public monitors (monitors over multiple jobs) will be ended. When used with a generic job name (e.g. JOB(QZDA*)), all public monitors (monitors over multiple jobs) started with JOB(QZDA*) will be ended.
|
|
</dd>
|
|
<dt><b><i>simple-name</i></b></dt>
|
|
<dd>Specify the 10-byte monitor ID of the monitor that is to be ended.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDBMON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDDBMON.COMMENT"></a>
|
|
<h3>Comment (COMMENT)</h3>
|
|
<p>User-specified description that is associated with the database monitor. The description is stored in the monitor record that has a record ID of 3018.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BLANK</u></b></dt>
|
|
<dd>Text is not specified.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify up to 100 characters of text.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDBMON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDDBMON.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: End Monitoring for a Specific Job</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDDBMON JOB(*)
|
|
</pre>
|
|
</p>
|
|
<p>This command ends database monitoring for the current job.
|
|
</p>
|
|
<p><b>Example 2: End Monitoring for All Jobs</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDDBMON JOB(*ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command ends the monitor open across all jobs on the system. If more than one monitor with JOB(*ALL) is active, then the MONID parameter must also be specified to uniquely identify which individual monitor to end.
|
|
</p>
|
|
<p><b>Example 3: End Monitoring for an Individual Public Monitor with MONID Parameter</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDDBMON JOB(*ALL) MONID(061601001)
|
|
</pre>
|
|
</p>
|
|
<p>This command ends the monitor that was started with JOB(*ALL) and that has a monitor ID of 061601001. Because there were mulitple monitors started with JOB(*ALL), the monitor ID must be specified to uniquely identify which monitor started with JOB(*ALL) is to be ended.
|
|
</p>
|
|
<p><b>Example 4: End Monitoring for an Individual Public Monitor with MONID Parameter</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDDBMON MONID(061601001)
|
|
</pre>
|
|
</p>
|
|
<p>The commands performs the same function as the previous example. It ends the monitor that was started with JOB(*ALL) or JOB(*) and that has a monitor ID of 061601001.
|
|
</p>
|
|
<p><b>Example 5: End Monitoring for All JOB(*ALL) Monitors</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDDBMON JOB(*ALL/*ALL/*ALL) MONID(*ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command ends all monitors that are active across multiple jobs. It will not end any monitors open for a specific job or the current job.
|
|
</p>
|
|
<p><b>Example 6: End Monitoring for a Generic Job</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDDBMON JOB(QZDA*)
|
|
</pre>
|
|
</p>
|
|
<p>This command ends the monitor that was started with JOB(QZDA*). If more than one monitor with JOB(QZDA*) is active, then the MONID parameter must also be specified to uniquely identify which individual monitor to end.
|
|
</p>
|
|
<p><b>Example 7: End Monitoring for an Individual Monitor with a Generic Job</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDDBMON JOB(QZDA*) MONID(061601001)
|
|
</pre>
|
|
</p>
|
|
<p>This command ends the monitor that was started with JOB(QZDA*) and has a monitor ID of 061601001. Because there were mulitple monitors started with JOB(QZDA*), the monitor ID must be specified to uniquely identify which JOB(QZDA*) monitor is to be ended.
|
|
</p>
|
|
<p><b>Example 8: End Monitoring for a Group of Generic Jobs</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDDBMON JOB(QZDA*) MONID(*ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command ends all monitors that were started with JOB(QZDA*).
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDBMON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDDBMON.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1321</b></dt>
|
|
<dd>Job &1 user &2 job number &3 not found.
|
|
</dd>
|
|
<dt><b>CPF436D</b></dt>
|
|
<dd>Job &1 is not being monitored.
|
|
</dd>
|
|
<dt><b>CPF436E</b></dt>
|
|
<dd>Job &1 user &2 job number &3 is not active.
|
|
</dd>
|
|
<dt><b>CPF43A1</b></dt>
|
|
<dd>Job &1 specified on ENDDBMON command is not unique.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDBMON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|