143 lines
5.3 KiB
HTML
143 lines
5.3 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 Directory Shadowing (ENDDIRSHD)</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="ENDDIRSHD.Top_Of_Page"></a>
|
|
<h2>End Directory Shadowing (ENDDIRSHD)</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="#ENDDIRSHD.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ENDDIRSHD.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ENDDIRSHD.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ENDDIRSHD"></a>
|
|
<p>The End Directory Shadowing (ENDDIRSHD) command ends the directory shadow controlling job in the system work subsystem (QSYSWRK).
|
|
</p>
|
|
<p>Any active collector or supplier jobs running are allowed to complete. No new collector jobs are started. Supplier jobs are prevented from starting if a collector system requests data through directory shadowing. The Start Directory Shadowing (STRDIRSHD) command can be used to re-start directory shadowing.
|
|
</p>
|
|
<p><b>Restriction:</b> You must have job control (*JOBCTL) authority to use this command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ENDDIRSHD.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="#ENDDIRSHD.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">How to end</td>
|
|
<td valign="top"><b><u>*CNTRLD</u></b>, *IMMED</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ENDDIRSHD.DELAY"><b>DELAY</b></a></td>
|
|
<td valign="top">Controlled end delay time</td>
|
|
<td valign="top">1-999999, <b><u>30</u></b></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ENDDIRSHD.OPTION"></a>
|
|
<h3>How to end (OPTION)</h3>
|
|
<p>Specifies whether the directory shadow controlling job is ended in a controlled manner or immediately.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CNTRLD</u></b></dt>
|
|
<dd>The directory shadow controlling job is ended in a controlled manner. This allows the directory shadow controlling job to perform cleanup (end-of-job processing).
|
|
</dd>
|
|
<dt><b>*IMMED</b></dt>
|
|
<dd>The directory shadow controlling job is ended immediately. The directory shadow controlling job is not allowed to perform any cleanup.
|
|
<p>
|
|
<b>Note: </b>Using the *IMMED option can cause unexpected results if data has been only partially updated.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ENDDIRSHD.DELAY"></a>
|
|
<h3>Controlled end delay time (DELAY)</h3>
|
|
<p>Specifies the amount of time (in seconds) allowed for the directory shadow controlling job to complete its cleanup processing during a controlled end. This parameter is not valid if OPTION(*IMMED) is specified. If the cleanup is not complete before the end of the delay time, the directory shadow controlling job is immediately ended.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>30</u></b></dt>
|
|
<dd>A maximum delay time of 30 seconds is allowed for cleanup before the directory shadow controlling job is ended.
|
|
</dd>
|
|
<dt><b><i>delay-time</i></b></dt>
|
|
<dd>Specify the maximum amount of delay time in seconds before the directory shadow controlling job is ended. Valid values range from 1 through 999999.
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDDIRSHD.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Ending Directory Shadowing in a Controlled Manner</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDDIRSHD OPTION(*CNTRLD) DELAY(60)
|
|
</pre>
|
|
</p>
|
|
<p>The directory shadow controlling job is ended in the system work subsystem in a controlled manner and will have 60 seconds to complete its end-of-job processing.
|
|
</p>
|
|
<p><b>Example 2: Ending Directory Shadowing Immediately</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ENDDIRSHD OPTION(*IMMED)
|
|
</pre>
|
|
</p>
|
|
<p>The directory shadow controlling job is ended in the system work subsystem immediately. The directory shadow controlling job does not perform end-of-job processing.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ENDDIRSHD.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF89A9</b></dt>
|
|
<dd>Unable to end job that controls directory shadowing.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ENDDIRSHD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|