ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/endmsf.htm

142 lines
5.0 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 Mail Server Framework (ENDMSF)</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="ENDMSF.Top_Of_Page"></a>
<h2>End Mail Server Framework (ENDMSF)</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="#ENDMSF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ENDMSF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ENDMSF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ENDMSF"></a>
<p>The End Mail Server Framework (ENDMSF) command ends the mail server framework jobs in the system work subsystem (QSYSWRK).
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMSF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ENDMSF.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="#ENDMSF.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="#ENDMSF.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="#ENDMSF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ENDMSF.OPTION"></a>
<h3>How to end (OPTION)</h3>
<p>Specifies whether the mail server framework jobs that are in the system work subsystem (QSYSWRK) end immediately or in a controlled manner.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*CNTRLD</u></b></dt>
<dd>All mail server framework jobs are ended in a controlled manner. This allows each framework job a chance to complete processing the current mail server framework messages before it ends.
</dd>
<dt><b>*IMMED</b></dt>
<dd>All mail server framework jobs are ended immediately. Any mail server framework messages being processed at the time the job ended are processed when the mail server framework is restarted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMSF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDMSF.DELAY"></a>
<h3>Controlled end delay time (DELAY)</h3>
<p>Specifies the amount of time (in seconds) allowed for the mail server framework jobs to complete their processing during a controlled end. This parameter is ignored if OPTION(*IMMED) is specified. If the jobs do not end before the end of the delay time, they are then immediately ended.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>30</u></b></dt>
<dd>A maximum delay time of 30 seconds is allowed before the mail server framework jobs are ended.
</dd>
<dt><b><i>delay-time</i></b></dt>
<dd>Specify the maximum amount of delay time in seconds before the jobs are ended. Valid values range from 1 through 999999.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMSF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDMSF.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Ending Mail Server Framework in a Controlled Manner</b>
</p>
<p>
<pre>
ENDMSF OPTION(*CNTRLD) DELAY(60)
</pre>
</p>
<p>This command ends the mail server framework jobs in the system work subsystem in a controlled manner and has 60 seconds to complete processing any mail server framework messages currently being handled.
</p>
<p><b>Example 2: Ending Mail Server Framework Immediately</b>
</p>
<p>
<pre>
ENDMSF OPTION(*IMMED)
</pre>
</p>
<p>This command ends the mail server framework jobs in the system work subsystem immediately. The mail server framework jobs do not complete processing any mail server framework messages currently being handled.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMSF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDMSF.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFAFAB</b></dt>
<dd>ENDMSF did not complete successfully.
</dd>
<dt><b>CPFAFAC</b></dt>
<dd>ENDMSF completed successfully; however errors occurred.
</dd>
<dt><b>CPFAFFF</b></dt>
<dd>Internal system error in program &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDMSF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>