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

160 lines
5.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>Change Manager Services Atr (CHGMGRSRVA)</title>
</head>
<body bgcolor="white">
<a name="CHGMGRSRVA.Top_Of_Page"></a>
<h2>Change Manager Services Atr (CHGMGRSRVA)</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="#CHGMGRSRVA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGMGRSRVA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGMGRSRVA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGMGRSRVA"></a>
<p>The Change Manager Services Attributes (CHGMGRSRVA) command enables you to control the cleanup time interval, the maximum time that command requests remain active, and the maximum time that command requests are kept in the remote command history file.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGRSRVA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGMGRSRVA.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="#CHGMGRSRVA.CLNUP"><b>CLNUP</b></a></td>
<td valign="top">Remote command cleanup</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top">Element 1: Cleanup interval</td>
<td valign="top">
0-999, <b><u>*SAME</u></b>, *STARTUP</td>
</tr>
<tr>
<td valign="top">Element 2: Maximum active time</td>
<td valign="top">
1-999, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Maximum history days</td>
<td valign="top">
0-999, <b><u>*SAME</u></b>, *NOMAX</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGMGRSRVA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGMGRSRVA.CLNUP"></a>
<h3>Remote command cleanup (CLNUP)</h3>
<p>Specifies how often active remote commands are cleaned up, how long remote commands are allowed to remain active, and how long completed commands are kept in the history database file. Cleanup will always take place whenever the remote command manager service is started. Cleanup is done to remove the following from the system:
</p>
<ul>
<li>Outstanding active command request correlation information.
</li>
<li>Command request information in the history log.
</li>
</ul>
<p>Outstanding active command requests that are cleaned up will be placed in the history log.
</p>
<p><b>Cleanup interval</b>
</p>
<p>The possible cleanup interval values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The current value is not changed.
</dd>
<dt><b>*STARTUP</b></dt>
<dd>Cleanup is done only when the remote command manager service is started.
</dd>
<dt><b><i>cleanup-interval</i></b></dt>
<dd>Specifies the interval of time in hours that cleanup should take place. For example, if 24 is specified, cleanup will be started every 24 hours. Valid values range from 0 to 999.
</dd>
</dl>
<p><b>Maximum active time</b>
</p>
<p>The possible active time values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The current value is not changed.
</dd>
<dt><b><i>max-active-time</i></b></dt>
<dd>Specifies the number of hours that an active remote command request is allowed to remain active on the remote system before it is cleaned up. When cleanup is started, all active requests that have been active longer than the specified time are cleaned up. Valid values range from 1 to 999.
</dd>
</dl>
<p><b>Maximum history days</b>
</p>
<p>The possible history values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The current value is not changed.
</dd>
<dt><b>*NOMAX</b></dt>
<dd>Specifies the history log is not cleaned up by the remote command manager. The user is responsible for deleting the entries within the history log.
</dd>
<dt><b><i>max-history-days</i></b></dt>
<dd>Specify the number of days that a completed remote command request is allowed to remain in the history log database file before it is cleaned up. When cleanup is started, all completed requests stored in the history database file for longer than the specified time are cleaned up. Valid values range from 0 to 999.
<p>
<b>Note: </b>If the database file runs out of space, completed requests will no longer be logged.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGRSRVA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGMGRSRVA.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGMGRSRVA CLNUP(*STARTUP 48 7)
</pre>
</p>
<p>This command configures the remote command service to do cleanup processing when the service is started. Commands should remain active for 48 hours and logged in the history file for 7 days.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGRSRVA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGMGRSRVA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>MSS0415</b></dt>
<dd>Managed system attributes not found or damaged.
</dd>
<dt><b>MSS041A</b></dt>
<dd>*ALLOBJ special authority required.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGRSRVA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>