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

865 lines
29 KiB
HTML
Raw Permalink 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>Change Service Agent Attr (CHGSRVAGTA)</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="CHGSRVAGTA.Top_Of_Page"></a>
<h2>Change Service Agent Attr (CHGSRVAGTA)</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="#CHGSRVAGTA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGSRVAGTA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGSRVAGTA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGSRVAGTA"></a>
<p>The Change Service Agent Attr (CHGSRVAGTA) command allows a user to change the attributes of Service Agent.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGSRVAGTA.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="#CHGSRVAGTA.ENABLE"><b>ENABLE</b></a></td>
<td valign="top">Enable</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO, *SRVINF, *PRBRPT</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGTA.AUTORPT"><b>AUTORPT</b></a></td>
<td valign="top">Auto report</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#CHGSRVAGTA.AUTORPTRTY"><b>AUTORPTRTY</b></a></td>
<td valign="top">Auto report retry</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Retry</td>
<td valign="top">
<b><u>*SAME</u></b>, *YES, *NO</td>
</tr>
<tr>
<td valign="top">Element 2: Frequency</td>
<td valign="top">
5-720, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Number of times to retry</td>
<td valign="top">
1-999, <b><u>*SAME</u></b>, *NOMAX</td>
</tr>
<tr>
<td valign="top">Element 4: Notify users</td>
<td valign="top">
<b><u>*SAME</u></b>, *YES, *NO</td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#CHGSRVAGTA.PALANZ"><b>PALANZ</b></a></td>
<td valign="top">Product activity log analysis</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Enable</td>
<td valign="top">
<b><u>*SAME</u></b>, *YES, *NO</td>
</tr>
<tr>
<td valign="top">Element 2: Start hour</td>
<td valign="top">
0-23, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Interval</td>
<td valign="top">
<b><u>*SAME</u></b>, 1, 2, 3, 4, 6, 8, 12, 24</td>
</tr>
<tr>
<td valign="top">Element 4: Send message</td>
<td valign="top">
<b><u>*SAME</u></b>, *YES, *NO</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGTA.RUNPTY"><b>RUNPTY</b></a></td>
<td valign="top">Run priority</td>
<td valign="top">1-99, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGTA.NOTIFYUSR"><b>NOTIFYUSR</b></a></td>
<td valign="top">Notify user ID</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 5 repetitions): <i>Simple name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CHGSRVAGTA.AUTOPTF"><b>AUTOPTF</b></a></td>
<td valign="top">Auto PTF</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Enable</td>
<td valign="top">
<b><u>*SAME</u></b>, *YES, *NO</td>
</tr>
<tr>
<td valign="top">Element 2: Schedule day</td>
<td valign="top">
<b><u>*SAME</u></b>, *SUN, *MON, *TUE, *WED, *THU, *FRI, *SAT</td>
</tr>
<tr>
<td valign="top">Element 3: Download PTFs</td>
<td valign="top">
<b><u>*SAME</u></b>, *YES, *NO, *CVRLTR</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGSRVAGTA.AUTOTEST"><b>AUTOTEST</b></a></td>
<td valign="top">Auto test</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Schedule day</td>
<td valign="top">
<b><u>*SAME</u></b>, *SUN, *MON, *TUE, *WED, *THU, *FRI, *SAT</td>
</tr>
<tr>
<td valign="top">Element 2: Schedule time</td>
<td valign="top">
<i>Time</i>, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="6"><a href="#CHGSRVAGTA.SRVINF"><b>SRVINF</b></a></td>
<td valign="top">Service information</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="6">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Select information</td>
<td valign="top">
Values (up to 9 repetitions): <i>Character value</i>, <b><u>*SAME</u></b>, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Collect time</td>
<td valign="top">
<i>Time</i>, <b><u>*SAME</u></b>, *CURRENT</td>
</tr>
<tr>
<td valign="top">Element 3: Send time</td>
<td valign="top">
<i>Time</i>, <b><u>*SAME</u></b>, *COLLECT</td>
</tr>
<tr>
<td valign="top">Element 4: Connection verification timer</td>
<td valign="top">
1-21, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 5: Task hold interval</td>
<td valign="top">
1-30, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGSRVAGTA.SRVPVDID"><b>SRVPVDID</b></a></td>
<td valign="top">Report problem to</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Control point name</td>
<td valign="top">
<i>Communications name</i>, <b><u>*SAME</u></b>, *IBMSRV</td>
</tr>
<tr>
<td valign="top">Element 2: Network ID</td>
<td valign="top">
<i>Communications name</i>, <b><u>*SAME</u></b>, *NETATR</td>
</tr>
<tr>
<td valign="top" rowspan="6"><a href="#CHGSRVAGTA.LINECTL"><b>LINECTL</b></a></td>
<td valign="top">Line control</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="6">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Enable</td>
<td valign="top">
<b><u>*SAME</u></b>, *YES, *NO</td>
</tr>
<tr>
<td valign="top">Element 2: Configuration object</td>
<td valign="top">
Values (up to 12 repetitions): <i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Line description</td>
<td valign="top">
<i>Name</i>, *SAME</td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Controller description</td>
<td valign="top">
<i>Name</i>, *SAME, <b><u>*ANY</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Device description</td>
<td valign="top">
<i>Name</i>, *SAME, <b><u>*ANY</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGTA.RPTRMTPRB"><b>RPTRMTPRB</b></a></td>
<td valign="top">Report remote problem</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGTA.ACTPWD"><b>ACTPWD</b></a></td>
<td valign="top">Activation password</td>
<td valign="top"><i>Character value</i>, *SAME</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGSRVAGTA.ENABLE"></a>
<h3>Enable (ENABLE)</h3>
<p>Specifies whether Service Agent is enabled.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *YES.
</dd>
<dt><b>*YES</b></dt>
<dd>Service Agent is enabled.
</dd>
<dt><b>*NO</b></dt>
<dd>Service Agent is not enabled.
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGTA.AUTORPT"></a>
<h3>Auto report (AUTORPT)</h3>
<p>Specifies whether service requests are to be placed automatically by Service Agent.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *YES.
</dd>
<dt><b>*YES</b></dt>
<dd>Service Agent will automatically place service requests.
<p>This function requires the use of the problem log filter. System value QPRBFTR will be changed to QS9FILTER.
</p>
</dd>
<dt><b>*NO</b></dt>
<dd>Service Agent will not automatically place service requests. The users specified for the Notify user ID (NOTIFYUSR) parameter will receive messages about a problem that is discovered.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGTA.AUTORPTRTY"></a>
<h3>Auto report retry (AUTORPTRTY)</h3>
<p>Specifies whether service requests placed automatically by Service Agent are to be retried if an attempt fails, and if so, how they are to be retried.
</p>
<p><b>Element 1: Retry</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *YES.
</dd>
<dt><b>*YES</b></dt>
<dd>Service requests placed automatically by Service Agent are retried.
</dd>
<dt><b>*NO</b></dt>
<dd>Service requests placed automatically by Service Agent are not retried.
</dd>
</dl>
<p><b>Element 2: Frequency</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to 15.
</dd>
<dt><b><i>5-720</i></b></dt>
<dd>Specifies the frequency in minutes at which service requests placed automatically by Service Agent are retried.
</dd>
</dl>
<p><b>Element 3: Number of times to retry</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to 3.
</dd>
<dt><b>*NOMAX</b></dt>
<dd>Service requests placed automatically by Service Agent will be retried until successful.
</dd>
<dt><b><i>1-999</i></b></dt>
<dd>Specify the number of times to retry service requests placed automatically by Service Agent.
</dd>
</dl>
<p><b>Element 4: Notify users</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *YES.
</dd>
<dt><b>*YES</b></dt>
<dd>The users specified for the Notify user ID (NOTIFYUSR) parameter will receive a message when a service request placed automatically by Service Agent is retried.
</dd>
<dt><b>*NO</b></dt>
<dd>No message will be sent when a service request placed automatically by Service Agent is retried.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGTA.PALANZ"></a>
<h3>Product activity log analysis (PALANZ)</h3>
<p>Specifies whether product activity log (PAL) analysis routines are run and errors are reported.
</p>
<p>Before a problem found in the product activity log is reported, product activity log analysis routines are run. These analysis routines can be CPU intensive.
</p>
<p><b>Element 1: Enable</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *YES.
</dd>
<dt><b>*YES</b></dt>
<dd>Product activity log analysis routines are run. A problem from the product activity log is reported.
</dd>
<dt><b>*NO</b></dt>
<dd>Product activity log analysis routines are not run. A problem from the product activity log is not reported. There will be no media analysis data or product activity log data available for reports.
</dd>
</dl>
<p><b>Element 2: Start hour</b>
</p>
<p>Specifies the base hour of the day used to determine when product activity log (PAL) analysis runs. PAL analysis will run at the intervals specified using the Start hour parameter as the base hour. PAL analysis will run 10 minutes after the hour.
</p>
<p>For example, 00 means to base the start hour at midnight. With the PAL analysis interval is 4, it will run at 00:10, 04:10, 08:10 and 12:10.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to 00.
</dd>
<dt><b><i>0-23</i></b></dt>
<dd>Specify the base hour to determine when PAL analysis runs.
</dd>
</dl>
<p><b>Element 3: Interval</b>
</p>
<p>Specifies how often, in hours, to check the product activity log for problems to report.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to 4.
</dd>
<dt><b>1</b></dt>
<dd>Service Agent checks the product activity log every hour.
</dd>
<dt><b>2</b></dt>
<dd>Service Agent checks the product activity log every 2 hours.
</dd>
<dt><b>3</b></dt>
<dd>Service Agent checks the product activity log every 3 hours.
</dd>
<dt><b>4</b></dt>
<dd>Service Agent checks the product activity log every 4 hours.
</dd>
<dt><b>6</b></dt>
<dd>Service Agent checks the product activity log every 6 hours.
</dd>
<dt><b>8</b></dt>
<dd>Service Agent checks the product activity log every 8 hours.
</dd>
<dt><b>12</b></dt>
<dd>Service Agent checks the product activity log every 12 hours.
</dd>
<dt><b>24</b></dt>
<dd>Service Agent checks the product activity log every 24 hours.
</dd>
</dl>
<p><b>Element 4: Send message</b>
</p>
<p>Specifies whether a message should be sent to the list of users to receive Service Agent messages each time Service Agent begins analyzing the product activity log.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *YES.
</dd>
<dt><b>*YES</b></dt>
<dd>The users identified in the Notify user ID (NOTIFYUSR) parameter will receive messages each time Service Agent starts a product activity log analysis cycle. A record will also be created in the Service Agent audit log.
</dd>
<dt><b>*NO</b></dt>
<dd>Service Agent will not send messages to users each time it starts a product activity log analysis cycle. A record will still be created in the Service Agent audit log.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGTA.RUNPTY"></a>
<h3>Run priority (RUNPTY)</h3>
<p>Specifies the run priority for Service Agent. Run priority is a value ranging from 1 (highest priority) through 99 (lowest priority) that represents the importance of the job when it competes with other jobs for the machine resources.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to 51.
</dd>
<dt><b><i>1-99</i></b></dt>
<dd>Specify the run priority for Service Agent.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGTA.NOTIFYUSR"></a>
<h3>Notify user ID (NOTIFYUSR)</h3>
<p>Specifies the user profiles to receive messages about Service Agent activity.
</p>
<p>
<b>Note: </b>In addition to any user profiles you specify, the system operator (QSYSOPR) and QSRV user profiles will also receive messages. It is not possible to prevent messages from being sent to the QSYSOPR and QSRV user profiles.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<p><b>Other values (up to 5 repetitions)</b>
</p>
<dl>
<dt><b><i>simple-name</i></b></dt>
<dd>Specify the user profile names of the users to receive Service Agent messages.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGTA.AUTOPTF"></a>
<h3>Auto PTF (AUTOPTF)</h3>
<p>Specifies whether Service Agent will electronically (using ECS) check the system or logical partition to determine if PTFs deemed critical by IBM Service are on the system or logical partition. If PTFs are needed, fix request entries containing the PTF numbers to be ordered will be created into the problem log.
</p>
<p><b>Element 1: Enable</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *YES.
</dd>
<dt><b>*YES</b></dt>
<dd>The function is enabled.
</dd>
<dt><b>*NO</b></dt>
<dd>The function is not enabled.
</dd>
</dl>
<p><b>Element 2: Schedule day</b>
</p>
<p>Specifies the day of the week the automatic PTF processing is to take place and whether any PTFs identified as being needed by the system or logical partition are downloaded to the system or logical partition.
</p>
<p>This value may not be set correctly if your system or logical partition is not using the Gregorian calendar.
</p>
<p>
<b>Note: </b>The available days from which to choose are shown when F4 is pressed. This provides an even distribution of the IBM Service system resources, thereby maintaining high availability of the IBM Service system.
</p>
<p>The day of the week can be selected, however the time of day cannot, for the same reason stated above. This automatic PTF function may not run at the same time of day each time it runs.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to the first day of those described above.
</dd>
<dt><b>*SUN</b></dt>
<dd>The function will run on Sunday.
</dd>
<dt><b>*MON</b></dt>
<dd>The function will run on Monday.
</dd>
<dt><b>*TUE</b></dt>
<dd>The function will run on Tuesday.
</dd>
<dt><b>*WED</b></dt>
<dd>The function will run on Wednesday.
</dd>
<dt><b>*THU</b></dt>
<dd>The function will run on Thursday.
</dd>
<dt><b>*FRI</b></dt>
<dd>The function will run on Friday.
</dd>
<dt><b>*SAT</b></dt>
<dd>The function will run on Saturday.
</dd>
</dl>
<p><b>Element 3: Download PTFs</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *YES.
</dd>
<dt><b>*YES</b></dt>
<dd>The PTFs that are found to be needed during the automatic PTF processing will be downloaded to the system or logical partition.
<p>
<b>Note: </b>PTFs that are downloaded will NOT be loaded or applied.
</p>
</dd>
<dt><b>*NO</b></dt>
<dd>The PTFs that are found to be needed during the automatic PTF processing will not be downloaded to the system or logical partition. Fix request entries containing the PTF numbers to be ordered will exist in the problem log.
</dd>
<dt><b>*CVRLTR</b></dt>
<dd>The PTF cover letters for the PTFs that are found to be needed during the automatic PTF processing will be downloaded to the system or logical partition. Fix request entries containing the PTF numbers to be ordered will exist in the problem log, but only the associated cover letters will be ordered.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGTA.AUTOTEST"></a>
<h3>Auto test (AUTOTEST)</h3>
<p>Specifies the day of the week and the time of day that the automated operational test problem reporting is to take place.
</p>
<p><b>Element 1: Schedule day</b>
</p>
<p>Specifies the day of the week the automated operational test is to take place.
</p>
<p>This value may not be set correctly if your system or logical partition is not using the Gregorian calendar.
</p>
<p>
<b>Note: </b>The available days from which to choose are shown when F4 is pressed. This provides an even distribution of the IBM Service system resources, thereby maintaining high availability of the IBM Service system.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to the first day of those described above.
</dd>
<dt><b>*SUN</b></dt>
<dd>The function will run on Sunday.
</dd>
<dt><b>*MON</b></dt>
<dd>The function will run on Monday.
</dd>
<dt><b>*TUE</b></dt>
<dd>The function will run on Tuesday.
</dd>
<dt><b>*WED</b></dt>
<dd>The function will run on Wednesday.
</dd>
<dt><b>*THU</b></dt>
<dd>The function will run on Thursday.
</dd>
<dt><b>*FRI</b></dt>
<dd>The function will run on Friday.
</dd>
<dt><b>*SAT</b></dt>
<dd>The function will run on Saturday.
</dd>
</dl>
<p><b>Element 2: Schedule time</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to a time chosen at random.
</dd>
<dt><b><i>time</i></b></dt>
<dd>Specify the time at which the automated operational test problem is to take place. Specify the time in the job time format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGTA.SRVINF"></a>
<h3>Service information (SRVINF)</h3>
<p>Specifies service information is to be collected and sent to IBM, the time at which service information collection is to start, the time at which service information is to be sent, and how often the connection to IBM is automatically tested.
</p>
<p><b>Element 1: Select information</b>
</p>
<p>Specify that service information is to be sent to IBM.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *ALL.
</dd>
<dt><b>*ALL</b></dt>
<dd>All service information is sent to IBM.
</dd>
</dl>
<p><b>Element 2: Collect time</b>
</p>
<p>Specify the time at which the service information collection is to start.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *CURRENT.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The service information collection is to start at the current time.
</dd>
<dt><b><i>time</i></b></dt>
<dd>The time at which the service information collection is to start. Specify the time in the job time format.
</dd>
</dl>
<p><b>Element 3: Send time</b>
</p>
<p>Specify the time at which the service information is to be sent to IBM.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*COLLECT</b></dt>
<dd>The service information will be sent immediately after it is collected.
</dd>
<dt><b><i>time</i></b></dt>
<dd>The time at which the service information is to be sent. Specify the time in the job time format.
</dd>
</dl>
<p><b>Element 4: Connection verification timer</b>
</p>
<p>Specify how often, in days, the connection to IBM will automatically be tested.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to 7.
</dd>
<dt><b><i>1-21</i></b></dt>
<dd>How often, in days, the connection to IBM will automatically be tested.
</dd>
</dl>
<p><b>Element 5: Task hold interval</b>
</p>
<p>Specify the minimum number of days a Service Agent collection task or send task is kept after it has run. After this time interval, the task will be deleted. The time interval starts as soon as the task has run.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to 7.
</dd>
<dt><b><i>1-30</i></b></dt>
<dd>The number of days the tasks are kept.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGTA.SRVPVDID"></a>
<h3>Report problem to (SRVPVDID)</h3>
<p>Specifies the name of the service provider to receive automatic notification of a problem.
</p>
<p>Notification of a problem will automatically be sent to the system or logical partition specified by this parameter when AUTORPT(*YES) is specified. This system or logical partition must be in the list of service providers. Use the Work with Service Providers (WRKSRVPVD) command to see the service providers defined for your system or logical partition.
</p>
<p><b>Element 1: Control point name</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *IBMSRV.
</dd>
<dt><b>*IBMSRV</b></dt>
<dd>IBM Service is the service provider.
</dd>
<dt><b><i>communications-name</i></b></dt>
<dd>Specify the control point name of the service provider that will be notified of a local system problem.
</dd>
</dl>
<p><b>Element 2: Network ID</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *NETATR.
</dd>
<dt><b>*NETATR</b></dt>
<dd>The service provider is in the local network.
</dd>
<dt><b><i>communications-name</i></b></dt>
<dd>Specify the network ID of the service provider that is notified of a local system problem.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGTA.LINECTL"></a>
<h3>Line control (LINECTL)</h3>
<p>For ECS configurations that use a line description, Service Agent can vary off a line description that is in connect pending status which shares the same resource as the ECS line description. After the service request has completed, the specified configuration objects will be varied back on. This program will not take any action for any other line status.
</p>
<p><b>Element 1: Enable</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *NO.
</dd>
<dt><b>*YES</b></dt>
<dd>The line control feature is enabled.
</dd>
<dt><b>*NO</b></dt>
<dd>The line control feature is not enabled.
</dd>
</dl>
<p><b>Element 2: Configuration object</b>
</p>
<p>Each configuration object specified has three elements: line, controller, and device description name. Up to twelve sets of configuration objects can be specified.
</p>
<p>
<b>Note: </b>You must ensure the device is attached to the controller and the controller is attached to the line for all configuration object entries.
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Line description</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>The name of the line description that is to be varied off.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Controller description</b>
</p>
<dl>
<dt><b>*SAME</b></dt>
<dd>The value does not change.
</dd>
<dt><b><u>*ANY</u></b></dt>
<dd>Any controller description attached to the line description will be varied off.
</dd>
<dt><b><i>name</i></b></dt>
<dd>The name of the controller description that is to be varied off.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 3: Device description</b>
</p>
<dl>
<dt><b>*SAME</b></dt>
<dd>The value does not change.
</dd>
<dt><b><u>*ANY</u></b></dt>
<dd>Any device description attached to the controller description will be varied off.
</dd>
<dt><b><i>name</i></b></dt>
<dd>The name of the device description that is to be varied off.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGTA.RPTRMTPRB"></a>
<h3>Report remote problem (RPTRMTPRB)</h3>
<p>Specifies whether this system or logical partition reports problems on behalf of a network of systems or logical partitions.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it has been set. Otherwise, it is set to *NO.
</dd>
<dt><b>*NO</b></dt>
<dd>This system or logical partition does not report problems in the problem log that were sent from a remote system or logical partition in a network environment.
</dd>
<dt><b>*YES</b></dt>
<dd>This system or logical partition reports problems in the problem log that were sent from a remote system or logical partition in a network environment.
<p>
<b>Note: </b>This system or logical partition must be the host system or host logical partition. To enable this function, System Manager for iSeries must be installed and configured.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGTA.ACTPWD"></a>
<h3>Activation password (ACTPWD)</h3>
<p>Specifies the current value of the activation password.
</p>
<p>
<b>Note: </b>This is a required parameter when RPTRMTPRB(*YES) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the current value of the activation password. Your IBM Service Representative can provide you with the current activation password.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGSRVAGTA.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGSRVAGTA ENABLE(*YES) AUTORPT(*YES) NOTIFYUSR(SMITH)
</pre>
</p>
<p>This command changes enables problem reporting and service information collection and transmission and specifies the user profile SMITH to receive Service Agent messages.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGSRVAGTA.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="#CHGSRVAGTA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>