friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgsrvagt.htm

1164 lines
39 KiB
HTML
Raw Blame History

<!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 (CHGSRVAGT)</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="CHGSRVAGT.Top_Of_Page"></a>
<h2>Change Service Agent (CHGSRVAGT)</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="#CHGSRVAGT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGSRVAGT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGSRVAGT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGSRVAGT"></a>
<p>The Change Service Agent (CHGSRVAGT) command allows a user to change the operation of Service Agent in several functional areas. The function to be changed is specified by the <b>Type (TYPE)</b> parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGSRVAGT.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="#CHGSRVAGT.TYPE"><b>TYPE</b></a></td>
<td valign="top">Type</td>
<td valign="top">*COVERAGE, *JOBLOG, *MASTERPWD, *PRBLOG, *PRBRPT, *PRDACTLOG, *SENDDATA, *THRESHOLD, *USERAUTH</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.BLKPRBRPT"><b>BLKPRBRPT</b></a></td>
<td valign="top">Block reporting</td>
<td valign="top">*YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="7"><a href="#CHGSRVAGT.PERIOD"><b>PERIOD</b></a></td>
<td valign="top">Block period</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="7">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Start time and date</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Start time</td>
<td valign="top">
<i>Time</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Start date</td>
<td valign="top">
<i>Date</i></td>
</tr>
<tr>
<td valign="top">Element 2: End time and date</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: End time</td>
<td valign="top">
<i>Time</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: End date</td>
<td valign="top">
<i>Date</i></td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.IGNPRB"><b>IGNPRB</b></a></td>
<td valign="top">Ignore</td>
<td valign="top">*YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.CRTJOBLOG"><b>CRTJOBLOG</b></a></td>
<td valign="top">Create job logs</td>
<td valign="top">*YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.ANZIMMED"><b>ANZIMMED</b></a></td>
<td valign="top">Analyze immediately</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.ANZSTRDATE"><b>ANZSTRDATE</b></a></td>
<td valign="top">Analysis start date</td>
<td valign="top"><i>Date</i>, <b><u>*NOCHG</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.ANZSTRTIME"><b>ANZSTRTIME</b></a></td>
<td valign="top">Analysis start time</td>
<td valign="top"><i>Time</i>, <b><u>*NOCHG</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.ENBCVG"><b>ENBCVG</b></a></td>
<td valign="top">Enable coverage</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.CVGSTRTIME"><b>CVGSTRTIME</b></a></td>
<td valign="top">Coverage start time</td>
<td valign="top"><i>Time</i>, <b><u>080000</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.CVGENDTIME"><b>CVGENDTIME</b></a></td>
<td valign="top">Coverage end time</td>
<td valign="top"><i>Time</i>, <b><u>200000</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.WEEKEND"><b>WEEKEND</b></a></td>
<td valign="top">Call over weekends</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.DATA"><b>DATA</b></a></td>
<td valign="top">Data</td>
<td valign="top"><b><u>*CHG</u></b>, *ALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.CURPWD"><b>CURPWD</b></a></td>
<td valign="top">Current password</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.NEWPWD"><b>NEWPWD</b></a></td>
<td valign="top">New password</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.VFYPWD"><b>VFYPWD</b></a></td>
<td valign="top">Verify password</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.SUBTYPE"><b>SUBTYPE</b></a></td>
<td valign="top">Subtype</td>
<td valign="top">*DEVICE, *SYSREFCDE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.ACTION"><b>ACTION</b></a></td>
<td valign="top">Action</td>
<td valign="top">*ADD, *CHG, *RMV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.DEVICE"><b>DEVICE</b></a></td>
<td valign="top">Device</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.CATEGORY"><b>CATEGORY</b></a></td>
<td valign="top">Category</td>
<td valign="top">*DASD, *TAPE, *PROCESSOR, *OPTICAL, *FSIOP, *OTHER</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.SENSEFMT"><b>SENSEFMT</b></a></td>
<td valign="top">Sense byte format</td>
<td valign="top"><b><u>0</u></b>, 4, 2, 8, C</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGSRVAGT.RPTERRCLS"><b>RPTERRCLS</b></a></td>
<td valign="top">Error classes</td>
<td valign="top">Values (up to 27 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Class</td>
<td valign="top">
*PERMANENT, *THRESHOLD, *TEMPORARY, *STATISTICAL, *INFORMATIONAL, *SOFTWARE, *RECOVERABLE, *BUFFERED, *MACHINECHECK, *VARYON, *VARYOFF, *RECOVERED, *IOPDUMP, *LICINTCODE, *RESET, *QUALIFIED, *PREDANALYSIS, *DATAPROTECTION, *HDWREDUNDANCY, *ADDITIONAL1, *ADDITIONAL2, *ADDITIONAL3, *ADDITIONAL4, *ADDITIONAL5, *ADDITIONAL6, *ADDITIONAL7, *ADDITIONAL8</td>
</tr>
<tr>
<td valign="top">Element 2: Report error</td>
<td valign="top">
<b><u>*YES</u></b>, *NO</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.SYSREFCDE"><b>SYSREFCDE</b></a></td>
<td valign="top">System reference code</td>
<td valign="top"><i>Character value</i>, *RANGE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.ADDACTIVE"><b>ADDACTIVE</b></a></td>
<td valign="top">Active</td>
<td valign="top">*YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.ADDTHRESH"><b>ADDTHRESH</b></a></td>
<td valign="top">Threshold</td>
<td valign="top">0-99, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.ADDGROUP"><b>ADDGROUP</b></a></td>
<td valign="top">Group</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.ADDTEXT"><b>ADDTEXT</b></a></td>
<td valign="top">Text</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.CHGACTIVE"><b>CHGACTIVE</b></a></td>
<td valign="top">Active</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.CHGTHRESH"><b>CHGTHRESH</b></a></td>
<td valign="top">Threshold</td>
<td valign="top">0-99, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.CHGGROUP"><b>CHGGROUP</b></a></td>
<td valign="top">Group</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.CHGTEXT"><b>CHGTEXT</b></a></td>
<td valign="top">Text</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGSRVAGT.RANGE"><b>RANGE</b></a></td>
<td valign="top">System reference code range</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Starting code</td>
<td valign="top">
<i>Character value</i>, *FIRST</td>
</tr>
<tr>
<td valign="top">Element 2: Ending code</td>
<td valign="top">
<i>Character value</i>, *LAST</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSRVAGT.IBMID"><b>IBMID</b></a></td>
<td valign="top">Authorize users</td>
<td valign="top">Values (up to 2 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGSRVAGT.TYPE"></a>
<h3>Type (TYPE)</h3>
<p>Specifies the type of change to be made.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*PRBRPT</b></dt>
<dd>Problem reporting is to be changed by specifying the window of time during which product activity log entries should be ignored when Service Agent analyzes the product activity log.
<p>This option is for use before a DASD pump or before other system maintenance which may generate product activity log entries. For example, during a DASD pump operation, errors may be put into the product activity log. When Service Agent analyzes the product activity log after the DASD pump operation, Service Agent reports the errors generated by the pump process.
</p>
<p>To prevent the analysis and reporting of these errors, use this feature before starting the Service Agent monitoring jobs before powering down the system to perform maintenance.
</p>
<p>
<b>Note: </b>Using this feature can prevent unnecessary problem reporting.
</p>
</dd>
<dt><b>*MASTERPWD</b></dt>
<dd>The Service Agent master password is to be changed. Passwords for Service Agent are to be kept in confidence. The new password may be 6 - 8 characters in length and may contain any combination of alphanumeric characters. To change the password you must do the following:
<ol>
<li>Enter the current password.
</li>
<li>Enter the new password.
</li>
<li>Enter the new password again to verify it.
</li>
<li>Press Enter to save the new password.
</li>
</ol>
<p>
<b>Note: </b>The first time that a new password is created, it actually is an additional master password. This additional password may subsequently be changed by this procedure, but the original master password remains valid.
</p>
</dd>
<dt><b>*PRBLOG</b></dt>
<dd>Problem log analysis is to be changed either to prevent any existing problems from being analyzed and reported, or to allow existing problems to be analyzed and reported. If Service Agent monitoring jobs have been ended for an extended period of time and are to be started again, this feature may be used to prevent reporting of problem log entries that occurred during the inactive period.
<p>
<b>Note: </b>This command should be issued while no Service Agent monitoring jobs are running. If this command is issued while Service Agent monitoring jobs are running, you must end and restart these jobs either by using the end jobs and start jobs options on the GO SERVICE main menu, or by using ENDSRVAGT TYPE(*SBSJOB) and STRSRVAGT TYPE(*SBSJOB).
</p>
</dd>
<dt><b>*JOBLOG</b></dt>
<dd>Service Agent job logging is to be changed (set on or off).
</dd>
<dt><b>*PRDACTLOG</b></dt>
<dd>Parameters to the next product activity log (PAL) analysis cycle are to be changed. These are the date and time from which PAL records are analyzed, and the time at which the next analysis cycle will be initiated.
<p>
<b>Note: </b>PAL routines must be active for this function. Use the Change Service Agent attributes (CHGSRVAGTA) command and specify PAL analysis parameters (PALANZ) to activate the PAL analysis routines.
</p>
</dd>
<dt><b>*SENDDATA</b></dt>
<dd>The amount of service information to be sent is to be changed.
</dd>
<dt><b>*COVERAGE</b></dt>
<dd>Offhours coverage is to be changed. This feature will cause Service Agent to stop reporting problems at the time specified for the <b>Coverage end time (CVGENDTIME)</b> parameter and resume reporting problems at the time specified for the <b>Coverage start time (CVGSTRTIME)</b> parameter. If <b>Call over weekends (WEEKEND)</b> parameter is set to *NO, Service Agent will stop reporting problems at the coverage end time on Friday and resume reporting problems at the coverage start time on Monday.
</dd>
<dt><b>*THRESHOLD</b></dt>
<dd>Specifies that a change action is to be performed on a device or system reference code in the threshold table.
</dd>
<dt><b>*USERAUTH</b></dt>
<dd>Specifies that user IDs will be authorized to access system information using the IBM Electronic Services web site. One or more values must be specified for the Authorize users (IBMID) parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.BLKPRBRPT"></a>
<h3>Block reporting (BLKPRBRPT)</h3>
<p>Specifies whether Service Agent should ignore product activity log entries for a given period of time.
</p>
<p>
<b>Note: </b>This is a required parameter when TYPE(*PRBRPT) is specified.
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>Service Agent will ignore product activity log entries created during the given date and time range.
</dd>
<dt><b>*NO</b></dt>
<dd>Service Agent will not ignore product activity log entries created after the present time, even if that period of time falls within the date and time range given in a previous use of this command with BLKPRBRPT(*YES).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.PERIOD"></a>
<h3>Block period (PERIOD)</h3>
<p>Specifies the period during which Service Agent should ignore product activity log entries.
</p>
<p>
<b>Note: </b>This is a required parameter when BLKPRBRPT(*YES) is specified.
</p>
<p><b>Element 1: Start time and date</b>
</p>
<p>Specifies the time and date at which Service Agent should start ignoring product activity log entries.
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Start time</b>
</p>
<dl>
<dt><b><i>time</i></b></dt>
<dd>Specify the start time in the job time format.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Start date</b>
</p>
<dl>
<dt><b><i>date</i></b></dt>
<dd>Specify the start date in the job date format.
</dd>
</dl>
</dd>
</dl>
<p><b>Element 2: End time and date</b>
</p>
<p>Specifies the time and date at which Service Agent should stop ignoring product activity log entries.
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: End time</b>
</p>
<dl>
<dt><b><i>time</i></b></dt>
<dd>Specify the end time in the job time format.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: End date</b>
</p>
<dl>
<dt><b><i>date</i></b></dt>
<dd>Specify the end date in the job date format.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.IGNPRB"></a>
<h3>Ignore (IGNPRB)</h3>
<p>Specifies whether Service Agent will ignore existing problem log entries when Service Agent monitoring jobs are started.
</p>
<p>
<b>Note: </b>This is a required parameter when TYPE(*PRBLOG) is specified.
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>Service Agent will ignore existing problem log entries.
</dd>
<dt><b>*NO</b></dt>
<dd>Service Agent will not ignore existing problem log entries.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.CRTJOBLOG"></a>
<h3>Create job logs (CRTJOBLOG)</h3>
<p>Specifies whether joblogs are created for jobs ran by the QSRVAGT user profile.
</p>
<p>
<b>Note: </b>This is a required parameter when TYPE(*JOBLOG) is specified.
</p>
<dl>
<dt><b>*NO</b></dt>
<dd>No joblogs are created for Service Agent jobs unless a job ends abnormally.
</dd>
<dt><b>*YES</b></dt>
<dd>A joblog is created for each of the Service Agent jobs ran by the QSRVAGT user profile.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.ANZIMMED"></a>
<h3>Analyze immediately (ANZIMMED)</h3>
<p>Specifies whether the next analysis cycle should start immediately.
</p>
<p>
<b>Note: </b>This parameter is valid only when TYPE(*PRDACTLOG) is specified.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Service Agent product activity log analysis is started immediately.
</dd>
<dt><b>*NO</b></dt>
<dd>Service Agent product activity log analysis is started automatically at the next scheduled date and time. The scheduled date and time can be changed by using the <b>Analysis start date (ANZSTRDATE)</b> and <b>Analysis start time (ANZSTRTIME)</b> parameters provided, or by using the Change Service Agent settings option on the SERVICE menu.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.ANZSTRDATE"></a>
<h3>Analysis start date (ANZSTRDATE)</h3>
<p>Specifies the date at which analysis is to begin.
</p>
<p>
<b>Note: </b>This parameter is valid only when TYPE(*PRDACTLOG) is specified.
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>The ending date of the previous analysis cycle is used as the starting date for the next cycle.
</dd>
<dt><b><i>date</i></b></dt>
<dd>Specify the start date in the job date format. This will indicate that the date at which analysis is to begin is to change. An additional field is provided to specify a new time if desired. All product activity log records with time stamps from this date and time to the current date and time are included in the analysis.
<p>Specifying a new date and/or time causes all existing data on the Media Analysis Report and the Product Activity Log Monthly Summary to be removed. The data will be recreated from the records included in the next analysis cycle. This parameter can therefore be used to modify the starting date for these cumulative reports. These reports can be accessed by selecting the Customer Reports menu option on the SERVICE menu. This parameter has the same effect on the product activity log reports available on the SERVICECE menu.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.ANZSTRTIME"></a>
<h3>Analysis start time (ANZSTRTIME)</h3>
<p>Specifies the time at which analysis is to begin.
</p>
<p>
<b>Note: </b>This parameter is valid only when TYPE(*PRDACTLOG) is specified.
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>The ending time of the previous analysis cycle is used as the starting time for the next cycle.
</dd>
<dt><b><i>time</i></b></dt>
<dd>Specify the start time in the job date format. This will indicate that the time at which analysis is to begin is to change. An additional field is provided to specify a new date if desired. All product activity log records with time stamps from this date and time to the current date and time are included in the analysis.
<p>Specifying a new time and date causes all existing data on the Media Analysis Report and the Product Activity Log Monthly Summary to be removed. The data will be recreated from the records included in the next analysis cycle. This parameter can therefore be used to modify the starting time for these cumulative reports. These reports can be accessed by selecting the Customer Reports menu option on the SERVICE menu. This parameter has the same effect on the product activity log reports available on the SERVICECE menu.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.ENBCVG"></a>
<h3>Enable coverage (ENBCVG)</h3>
<p>Specifies whether the offhours coverage feature is to be used.
</p>
<p>
<b>Note: </b>This parameter is valid only when TYPE(*COVERAGE) is specified.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The offhours coverage feature is not used.
</dd>
<dt><b>*YES</b></dt>
<dd>The offhours coverage feature is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.CVGSTRTIME"></a>
<h3>Coverage start time (CVGSTRTIME)</h3>
<p>Specifies the time at which coverage is to begin.
</p>
<p>
<b>Note: </b>This is a required parameter when ENBCVG(*YES) is specified.
</p>
<dl>
<dt><b><i>time</i></b></dt>
<dd>Specify the start time in the job time format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.CVGENDTIME"></a>
<h3>Coverage end time (CVGENDTIME)</h3>
<p>Specifies the time at which coverage is to end.
</p>
<p>
<b>Note: </b>This is a required parameter when ENBCVG(*YES) is specified.
</p>
<dl>
<dt><b><i>time</i></b></dt>
<dd>Specify the end time in the job time format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.WEEKEND"></a>
<h3>Call over weekends (WEEKEND)</h3>
<p>Specifies whether service requests are to be placed during the weekend.
</p>
<p>
<b>Note: </b>This parameter is valid only when ENBCVG(*YES) is specified.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Service requests will be placed between the time specified for the <b>Coverage end time (CVGENDTIME)</b> on Friday and the time specified for the <b>Coverage start time (CVGSTRTIME)</b> parameter on Monday.
</dd>
</dl>
<dl>
<dt><b>*NO</b></dt>
<dd>Service requests will not be placed between the time specified for CVGENDTIME on Friday and the time specified for CVGSTRTIME on Monday.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.DATA"></a>
<h3>Data (DATA)</h3>
<p>Indicates the amount of service information to be sent.
</p>
<p>
<b>Note: </b>This is a required parameter when TYPE(*SENDDATA) is specified.
</p>
<dl>
<dt><b><u>*CHG</u></b></dt>
<dd>Only the service information types that have changed is sent.
</dd>
</dl>
<dl>
<dt><b>*ALL</b></dt>
<dd>All service information is sent whether it has changes or not. This value is in effect for the next time Service Agent sends service information, after which it will be returned to the default of *CHG.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.CURPWD"></a>
<h3>Current password (CURPWD)</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="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.NEWPWD"></a>
<h3>New password (NEWPWD)</h3>
<p>Specifies the new password you want to use to sign on to the CE menu. This password must be 6 - 8 characters in length and may contain any combination of alphanumeric characters. The first time that a new password is created, it actually is an additional master password. This additional password may subsequently be changed by this procedure, but the original master password remains in force.
</p>
<p>It is recommended that you not use the same password that you use for your user profile.
</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 new password.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.VFYPWD"></a>
<h3>Verify password (VFYPWD)</h3>
<p>Specifies the new password again to make sure that you have entered it correctly. If the password you enter here is different from the one you entered in the previous field, an error message is displayed and your password remains the same as it was before you attempted to change it.
</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 new password again, for verification.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.SUBTYPE"></a>
<h3>Subtype (SUBTYPE)</h3>
<p>Specifies the type of entry to be changed in the threshold table.
</p>
<p>
<b>Note: </b>This is a required parameter when TYPE(*THRESHOLD) is specified.
</p>
<dl>
<dt><b>*DEVICE</b></dt>
<dd>A device entry is to be changed.
</dd>
<dt><b>*SYSREFCDE</b></dt>
<dd>A system reference code entry is to be changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.ACTION"></a>
<h3>Action (ACTION)</h3>
<p>Specifies the type of change action to be performed on the threshold table entry.
</p>
<p>
<b>Note: </b>This is a required parameter when a value is specified for the <b>Subtype (SUBTYPE)</b> parameter.
</p>
<dl>
<dt><b>*ADD</b></dt>
<dd>A threshold table entry is added.
</dd>
<dt><b>*CHG</b></dt>
<dd>A threshold table entry is changed.
</dd>
<dt><b>*RMV</b></dt>
<dd>A threshold table entry is removed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.DEVICE"></a>
<h3>Device (DEVICE)</h3>
<p>Specifies the device to be added to or changed in the Service Agent threshold table, or the device that is associated with the system reference code to be added to, changed in, or removed from the Service Agent threshold table.
</p>
<p>A list of the current devices may be displayed by using the Work with Threshold Table option from the SERVICE menu.
</p>
<p>
<b>Note: </b>This is a required parameter when TYPE(*THRESHOLD) is specified.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the four character device type associated with the threshold table or system reference code. For example, DEVICE(2420) might be specified for a 2420 tape device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.CATEGORY"></a>
<h3>Category (CATEGORY)</h3>
<p>Specifies the category of device added or changed in the Service Agent threshold table.
</p>
<p>
<b>Note: </b>This is a required parameter when SUBTYPE(*DEVICE) is specified and ACTION(*ADD) or ACTION(*CHG) is specified.
</p>
<dl>
<dt><b>*DASD</b></dt>
<dd>The device is a DASD device.
</dd>
<dt><b>*TAPE</b></dt>
<dd>The device is a tape device.
</dd>
<dt><b>*PROCESSOR</b></dt>
<dd>The device is a processor.
</dd>
<dt><b>*OPTICAL</b></dt>
<dd>The device is an optical device.
</dd>
<dt><b>*FSIOP</b></dt>
<dd>The device is an FSIOP device.
</dd>
<dt><b>*OTHER</b></dt>
<dd>The device is other than one of the above listed devices.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.SENSEFMT"></a>
<h3>Sense byte format (SENSEFMT)</h3>
<p>Specifies the format of the volume statistical data for tape devices.
</p>
<p>
<b>Note: </b>This parameter is valid only when CATEGORY(*TAPE) is specified.
</p>
<dl>
<dt><b><u>0</u></b></dt>
<dd>The device does not report removable media statistics.
</dd>
<dt><b>4</b></dt>
<dd>The format is for a 1/4" cartridge tape device.
</dd>
<dt><b>2</b></dt>
<dd>The format is for a 1/2" reel tape device.
</dd>
<dt><b>8</b></dt>
<dd>The format is for an 8 mm tape device.
</dd>
<dt><b>C</b></dt>
<dd>The format is for a 1/2" cartridge tape device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.RPTERRCLS"></a>
<h3>Error classes (RPTERRCLS)</h3>
<p>Specifies whether or not Service Agent processes an error of the specified class for this device.
</p>
<p>
<b>Note: </b>This parameter is valid only when SUBTYPE(*DEVICE) is specified and ACTION(*ADD) or ACTION(*CHG) is specified.
</p>
<p><b>Element 1: Class</b>
</p>
<p>Specifies the class of error.
</p>
<dl>
<dt><b>*PERMANENT</b></dt>
<dd>A permanent error.
</dd>
<dt><b>*THRESHOLD</b></dt>
<dd>A threshold error.
</dd>
<dt><b>*TEMPORARY</b></dt>
<dd>A temporary error.
</dd>
<dt><b>*STATISTICAL</b></dt>
<dd>A statistical error.
</dd>
<dt><b>*INFORMATIONAL</b></dt>
<dd>An informational error.
</dd>
<dt><b>*SOFTWARE</b></dt>
<dd>A software error.
</dd>
<dt><b>*RECOVERABLE</b></dt>
<dd>A recoverable error.
</dd>
<dt><b>*BUFFERED</b></dt>
<dd>A buffered error.
</dd>
<dt><b>*MACHINECHECK</b></dt>
<dd>A machine check error.
</dd>
<dt><b>*VARYON</b></dt>
<dd>A vary on error.
</dd>
<dt><b>*VARYOFF</b></dt>
<dd>A vary off error.
</dd>
<dt><b>*RECOVERED</b></dt>
<dd>A recovered error.
</dd>
<dt><b>*IOPDUMP</b></dt>
<dd>An IOP dump error.
</dd>
<dt><b>*LICINTCODE</b></dt>
<dd>A licensed internal code error.
</dd>
<dt><b>*RESET</b></dt>
<dd>A reset error.
</dd>
<dt><b>*QUALIFIED</b></dt>
<dd>A qualified error.
</dd>
<dt><b>*PREDANALYSIS</b></dt>
<dd>A predictive analysis error.
</dd>
<dt><b>*DATAPROTECTION</b></dt>
<dd>A data protection error.
</dd>
<dt><b>*HDWREDUNDANCY</b></dt>
<dd>A hardware redundancy error.
</dd>
<dt><b>*ADDITIONAL1</b></dt>
<dd>First additional error.
</dd>
<dt><b>*ADDITIONAL2</b></dt>
<dd>Second additional error.
</dd>
<dt><b>*ADDITIONAL3</b></dt>
<dd>Third additional error.
</dd>
<dt><b>*ADDITIONAL4</b></dt>
<dd>Fourth additional error.
</dd>
<dt><b>*ADDITIONAL5</b></dt>
<dd>Fifth additional error.
</dd>
<dt><b>*ADDITIONAL6</b></dt>
<dd>Sixth additional error.
</dd>
<dt><b>*ADDITIONAL7</b></dt>
<dd>Seventh additional error.
</dd>
<dt><b>*ADDITIONAL8</b></dt>
<dd>Eighth additional error.
</dd>
</dl>
<p><b>Element 2: Report error</b>
</p>
<p>Specifies whether an error of this class is to be reported for this device.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>An error of this class is reported.
</dd>
<dt><b>*NO</b></dt>
<dd>An error of this class is not reported.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.SYSREFCDE"></a>
<h3>System reference code (SYSREFCDE)</h3>
<p>Specifies the system reference code added, changed, or removed from the threshold table.
</p>
<p>
<b>Note: </b>This parameter is required when SUBTYPE(*SYSREFCDE) is specified.
</p>
<dl>
<dt><b>*RANGE</b></dt>
<dd>Specify a range of system reference codes to be changed.
<p>
<b>Note: </b>*RANGE is valid only when ACTION(*CHG) is specified. When *RANGE is specified, values must be specified for the <b>System reference code range (RANGE)</b> parameter.
</p>
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the system reference code added, changed, or removed from the threshold table.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.ADDACTIVE"></a>
<h3>Active (ADDACTIVE)</h3>
<p>Specifies whether or not Service Agent reports errors for a system reference code for this device.
</p>
<p>
<b>Note: </b>This parameter is required when SUBTYPE(*SYSREFCDE) and ACTION(*ADD) are specified.
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>Service Agent reports the errors for this system reference code for this device.
</dd>
<dt><b>*NO</b></dt>
<dd>Service Agent does not report errors for this system reference code for this device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.ADDTHRESH"></a>
<h3>Threshold (ADDTHRESH)</h3>
<p>Specifies the number of times this system reference code must occur within a seven day period for Service Agent to report this error from the product activity log.
</p>
<p>
<b>Note: </b>This parameter is required when SUBTYPE(*SYSREFCDE) and ACTION(*ADD) are specified.
</p>
<dl>
<dt><b>*NONE or 0</b></dt>
<dd>This error is not reported from the product activity log.
</dd>
<dt><b><i>1-99</i></b></dt>
<dd>Specify a threshold value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.ADDGROUP"></a>
<h3>Group (ADDGROUP)</h3>
<p>Specifies the group to which this system reference code belongs.
</p>
<p>
<b>Note: </b>This parameter is required when SUBTYPE(*SYSREFCDE) and ACTION(*ADD) are specified.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the one-character group identifier.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.ADDTEXT"></a>
<h3>Text (ADDTEXT)</h3>
<p>Specifies the text that briefly describes the system reference code.
</p>
<p>
<b>Note: </b>This parameter is valid only when SUBTYPE(*SYSREFCDE) and ACTION(*ADD) are specified.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>No text is specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Text to describe the system reference code.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.CHGACTIVE"></a>
<h3>Active (CHGACTIVE)</h3>
<p>Specifies whether or not Service Agent reports errors for this system reference code for this device.
</p>
<p>
<b>Note: </b>This parameter is valid only when SUBTYPE(*SYSREFCDE) and ACTION(*CHG) are specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</b></dt>
<dd>Service Agent reports the errors for this system reference code for this device.
</dd>
<dt><b>*NO</b></dt>
<dd>Service Agent does not report the errors for this system reference code for this device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.CHGTHRESH"></a>
<h3>Threshold (CHGTHRESH)</h3>
<p>Specifies the number of times this system reference code must occur in a seven day period for Service Agent to report this error from the product activity log.
</p>
<p>
<b>Note: </b>This parameter is valid only when SUBTYPE(*SYSREFCDE) and ACTION(*CHG) are specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE or 0</b></dt>
<dd>This error is not reported from the product activity log.
</dd>
<dt><b><i>1-99</i></b></dt>
<dd>Specify a threshold value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.CHGGROUP"></a>
<h3>Group (CHGGROUP)</h3>
<p>Specifies the group to which this system reference code belongs.
</p>
<p>
<b>Note: </b>This parameter is valid only when SUBTYPE(*SYSREFCDE) and ACTION(*CHG) are 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 a one character group identifier.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.CHGTEXT"></a>
<h3>Text (CHGTEXT)</h3>
<p>Specifies the text that briefly describes the system reference code.
</p>
<p>
<b>Note: </b>This parameter is valid only when SUBTYPE(*SYSREFCDE) and ACTION(*CHG) are specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*BLANK</b></dt>
<dd>No text is specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Text to describe the system reference code.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.RANGE"></a>
<h3>System reference code range (RANGE)</h3>
<p>Specifies the starting and ending system reference codes to be changed.
</p>
<p>
<b>Note: </b>This parameter is required when SYSREFCDE(*RANGE) is specified.
</p>
<p><b>Element 1: Starting code</b>
</p>
<dl>
<dt><b>*FIRST</b></dt>
<dd>System reference codes are to be changed starting with the first system reference code for the device.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the first system reference code to be changed.
</dd>
</dl>
<p><b>Element 2: Ending code</b>
</p>
<dl>
<dt><b>*LAST</b></dt>
<dd>System reference codes are to be changed ending with the last system reference code for the device.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the last system reference code to be changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSRVAGT.IBMID"></a>
<h3>Authorize users (IBMID)</h3>
<p>Specifies the IBM IDs that will be authorized to access service information using the IBM Electronic Services web site. IBM provides personalized web functions that use information collected by IBM Electronic Service Agent. To use these functions, users sign in using their IBM ID (user ID) that they obtain from IBM. To register for an IBM ID, go to the My IBM Profile (https://www.ibm.com/account/profile) web site.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGSRVAGT.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGSRVAGT TYPE(*THRESHOLD) SUBTYPE(*SYSREFCDE) ACTION(*ADD)
DEVICE(9337) SYSREFCDE(3050)
ADDACTIVE(*YES) ADDTHRESH(0)
ADDTEXT('DISK DVC RET WRN RSP TO IOP')
</pre>
</p>
<p>This command adds system reference code 3050 to the 9337 device in the threshold table with a threshold limit of 0.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGSRVAGT.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="#CHGSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink