352 lines
12 KiB
HTML
352 lines
12 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>Display Service Agent (DSPSRVAGT)</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="DSPSRVAGT.Top_Of_Page"></a>
|
||
|
|
<h2>Display Service Agent (DSPSRVAGT)</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="#DSPSRVAGT.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#DSPSRVAGT.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#DSPSRVAGT.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="DSPSRVAGT"></a>
|
||
|
|
<p>The Display Service Agent (DSPSRVAGT) command allows a user to display several aspects of Service Agent. The area to be displayed is specified by the <b>Type (TYPE)</b> parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="DSPSRVAGT.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="#DSPSRVAGT.TYPE"><b>TYPE</b></a></td>
|
||
|
|
<td valign="top">Type</td>
|
||
|
|
<td valign="top">*DEVICE, *SRVINF, *MAINT, *PRDACTLOG, *SRVREGINF, *PRBRPT</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#DSPSRVAGT.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="#DSPSRVAGT.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="#DSPSRVAGT.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"><a href="#DSPSRVAGT.SYSNAME"><b>SYSNAME</b></a></td>
|
||
|
|
<td valign="top">System or logical partition</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*LOCAL</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#DSPSRVAGT.OUTPUT"><b>OUTPUT</b></a></td>
|
||
|
|
<td valign="top">Output</td>
|
||
|
|
<td valign="top"><b><u>*</u></b>, *PRINT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#DSPSRVAGT.SRVREP"><b>SRVREP</b></a></td>
|
||
|
|
<td valign="top">IBM Service representative</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="#DSPSRVAGT.SRVTELNBR"><b>SRVTELNBR</b></a></td>
|
||
|
|
<td valign="top">IBM Service telephone number</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="#DSPSRVAGT.RECOMMEND"><b>RECOMMEND</b></a></td>
|
||
|
|
<td valign="top">Recommendations</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="#DSPSRVAGT.ERRLOGID"><b>ERRLOGID</b></a></td>
|
||
|
|
<td valign="top">Error log identifier</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="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="DSPSRVAGT.TYPE"></a>
|
||
|
|
<h3>Type (TYPE)</h3>
|
||
|
|
<p>Specifies the aspect of Service Agent to be displayed.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEVICE</b></dt>
|
||
|
|
<dd>Information from the Service Agent threshold table for a device is to be displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SRVINF</b></dt>
|
||
|
|
<dd>Information about Service Agent service information collection and transmission is displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MAINT</b></dt>
|
||
|
|
<dd>The IBM Service preventive maintenance checklist is to be displayed or printed. This is a list of actions suggested during a preventive maintenance call on the system or logical partition. This list should be printed and given to the customer after each preventive maintenance service call.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRDACTLOG</b></dt>
|
||
|
|
<dd>A record from the Product Activity Log is to be displayed or printed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SRVREGINF</b></dt>
|
||
|
|
<dd>Information needed to register a system or logical partition as a Service Agent is to be displayed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPSRVAGT.DEVICE"></a>
|
||
|
|
<h3>Device (DEVICE)</h3>
|
||
|
|
<p>Specifies the device for which the threshold table information is to be displayed.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This is a required parameter when TYPE(*DEVICE) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the four-character device type for which the threshold table information is to be displayed. For example, DEVICE(2420) might be specified for a 2420 tape device.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPSRVAGT.CATEGORY"></a>
|
||
|
|
<h3>Category (CATEGORY)</h3>
|
||
|
|
<p>Specifies the type of device for which the threshold table information is to be displayed.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This is a required parameter when TYPE(*DEVICE) 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="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPSRVAGT.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="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPSRVAGT.SYSNAME"></a>
|
||
|
|
<h3>System or logical partition (SYSNAME)</h3>
|
||
|
|
<p>Specifies the name of the system or logical partition for which information is to be displayed.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only when TYPE(*SRVINF) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LOCAL</u></b></dt>
|
||
|
|
<dd>Information for the local system or logical partition is to be displayed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the name of the system or logical partition for which information is to be displayed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPSRVAGT.OUTPUT"></a>
|
||
|
|
<h3>Output (OUTPUT)</h3>
|
||
|
|
<p>Specifies where the output from the command is to be directed.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only when TYPE(*MAINT) or TYPE(*PRDACT) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The output is displayed for interactive jobs or printed with the job's spooled output for non-interactive jobs.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PRINT</b></dt>
|
||
|
|
<dd>The output is printed with the job's spooled output.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPSRVAGT.SRVREP"></a>
|
||
|
|
<h3>IBM Service representative (SRVREP)</h3>
|
||
|
|
<p>Specifies the name of the IBM service representative making this service call or the name of the IBM service representative the customer should contact when they have questions concerning the service performed.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only when TYPE(*MAINT) and OUTPUT(*PRINT) are specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BLANK</u></b></dt>
|
||
|
|
<dd>No value is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the name of the IBM Service contact. This value will be included in the output when OUTPUT(*PRINT) is specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPSRVAGT.SRVTELNBR"></a>
|
||
|
|
<h3>IBM Service telephone number (SRVTELNBR)</h3>
|
||
|
|
<p>Specifies the telephone number the customer should call to contact IBM Service.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only when TYPE(*MAINT) and OUTPUT(*PRINT) are specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BLANK</u></b></dt>
|
||
|
|
<dd>No value is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the complete telephone number sequence to contact IBM Service. This value will be included in the output when OUTPUT(*PRINT) is specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPSRVAGT.RECOMMEND"></a>
|
||
|
|
<h3>Recommendations (RECOMMEND)</h3>
|
||
|
|
<p>Specifies any recommendations the IBM Service representative has for the customer.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only when TYPE(*MAINT) and OUTPUT(*PRINT) are specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BLANK</u></b></dt>
|
||
|
|
<dd>No value is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify any recommendations IBM Service wishes to make to the customer. This value will be formatted and included in the output when OUTPUT(*PRINT) is specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPSRVAGT.ERRLOGID"></a>
|
||
|
|
<h3>Error log identifier (ERRLOGID)</h3>
|
||
|
|
<p>Specifies the record identifier for the Product Activity Log record that is to be displayed.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is required when TYPE(*PRDACTLOG) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the identifier of the Product Activity Log record to be displayed. Identifiers may be found using the Work with Service Agent (WRKSRVAGT) command with TYPE(*EVENT) specified, or by using the Start Service Tools (STRSST) command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="DSPSRVAGT.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
DSPSRVAGT TYPE(*DEVICE) DEVICE(2420) CATEGORY(*TAPE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command will display the information in the Service Agent threshold table for device 2420, a tape device.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="DSPSRVAGT.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="#DSPSRVAGT.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|