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

117 lines
4.6 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 Job Log Server (ENDLOGSVR)</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="ENDLOGSVR.Top_Of_Page"></a>
<h2>End Job Log Server (ENDLOGSVR)</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="#ENDLOGSVR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ENDLOGSVR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ENDLOGSVR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ENDLOGSVR"></a>
<p>The End Job Log Server (ENDLOGSVR) command is used to end the job log server. The job log server writes job logs for jobs that are in a job log pending state. If more than one job log server job is active at the time this command is issued, all of the job log server jobs will be ended.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You must have job control (*JOBCTL) special authority to use this command.
</li>
</ul>
<p><b>Usage notes:</b>
</p>
<ul>
<li>If you only want to stop the production of a particular job log because, for example, it is very long or consuming too many resources, use the Change Job (CHGJOB) or End Job (ENDJOB) command instead of this command.
<p>To determine which job a server is currently working on, display the server job's job log using the Display Job Log (DSPJOBLOG) command. Informational message, CPI1307, "Writing job log for &amp;3/&amp;2/&amp;1" will be logged in the server job's job log while it is writing the job log for the job named in the message.
</p>
<p>If you want to be able to write the complete job log for the job named in CPI1307 at a later time, change the job using the CHGJOB command specifying *PND on the LOGOUTPUT parameter.
</p>
<p>If you do not need the job log and do not want to save it so it could be rewritten later, use the ENDJOB command on the job named in the CPI1307 message, specifying LOGLMT(0).
</p>
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDLOGSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ENDLOGSVR.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="#ENDLOGSVR.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#ENDLOGSVR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ENDLOGSVR.OPTION"></a>
<h3>How to end (OPTION)</h3>
<p>Specifies whether the job log server is ended in a controlled manner or immediately.
</p>
<dl>
<dt><b><u>*CNTRLD</u></b></dt>
<dd>The server is ended in a controlled manner. Job logs which are in the process of being written are allowed to continue until they have completed.
</dd>
<dt><b>*IMMED</b></dt>
<dd>The server is ended immediately. Jobs which are currently being processed by the job log server will not be removed from the system and the job logs currently being written will not be completed. The incomplete job logs will be rewritten from the beginning when a new job log server is started.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDLOGSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDLOGSVR.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
ENDLOGSVR
</pre>
</p>
<p>This command ends the job log server in a controlled manner. Any job logs which are currently being written to spooled files by the job log server are allowed to complete.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDLOGSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDLOGSVR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF134B</b></dt>
<dd>Job log server not ended.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDLOGSVR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>