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

163 lines
5.7 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Start Service Agent (STRSRVAGT)</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="STRSRVAGT.Top_Of_Page"></a>
<h2>Start Service Agent (STRSRVAGT)</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="#STRSRVAGT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRSRVAGT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRSRVAGT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRSRVAGT"></a>
<p>The Start Service Agent (STRSRVAGT) command allows a user to start an aspect of Service Agent. The aspect to be started is specified by the <b>Type (TYPE)</b> parameter.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You must have input/output system configuration (*IOSYSCFG) special authority and also have use (*USE) authority to the Create Line Description PPP (CRTLINPPP) command to create service configurations.
</li>
<li>You must have job control (*JOBCTL) special authority to run the TYPE(*SBSJOB) of this command.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRSRVAGT.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="#STRSRVAGT.TYPE"><b>TYPE</b></a></td>
<td valign="top">Type</td>
<td valign="top">*ACTIVATE, *ACTPWD, *MASTERPWD, *SBSJOB</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#STRSRVAGT.ACTPWD"><b>ACTPWD</b></a></td>
<td valign="top">Activation password</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRSRVAGT.MSTPWD"><b>MSTPWD</b></a></td>
<td valign="top">Master password</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#STRSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRSRVAGT.TYPE"></a>
<h3>Type (TYPE)</h3>
<p>Specifies the aspect of Service Agent to be started.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*SBSJOB</b></dt>
<dd>All Service Agent monitoring jobs which normally run in the QSYSWRK subsystem are to be started in that subsystem. This option will have no effect if the QSYSWRK subsystem does not exist or is not started.
</dd>
<dt><b>*ACTPWD</b></dt>
<dd>The activation password may be entered as part of Service Agent activation.
</dd>
<dt><b>*ACTIVATE</b></dt>
<dd>Service Agent is to be activated. This option may be used only in a batch program. It is useful for those users who have many systems or logical partitions on which to activate Service Agent and would like to distribute a program to do so.
<p>Before this option will run successfully, either the ECS or the Service Agent service configuration must be created. This can be done using the Create Service Configuration (CRTSRVCFG) command.
</p>
</dd>
<dt><b>*MASTERPWD</b></dt>
<dd>The master password may be entered.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRSRVAGT.ACTPWD"></a>
<h3>Activation password (ACTPWD)</h3>
<p>Specifies the current value of the activation password. Entering this password is required for activation of hardware problem reporting for a network of systems or logical partitions. An activation password is not required to activate service information collection and transmission capabilities or to activate hardware problem reporting for only the local system or logical partition.
</p>
<p>The password will not display when you type it.
</p>
<p>
<b>Note: </b>This is a required parameter when TYPE(*ACTPWD) is specified.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the activation password.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRSRVAGT.MSTPWD"></a>
<h3>Master password (MSTPWD)</h3>
<p>Specifies the current value of the master password. This may be either the original master password, or the additional value already created.
</p>
<p>
<b>Note: </b>This is a required parameter when TYPE(*MASTERPWD) is specified.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the master password.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRSRVAGT.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
STRSRVAGT TYPE(*SBSJOB)
</pre>
</p>
<p>This command starts the Service Agent monitoring jobs that run in the QSYSWRK subsystem.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRSRVAGT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF9899</b></dt>
<dd>Error occurred during processing of command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>