704 lines
26 KiB
HTML
704 lines
26 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>Print Error Log (PRTERRLOG)</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="PRTERRLOG.Top_Of_Page"></a>
|
|
<h2>Print Error Log (PRTERRLOG)</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="#PRTERRLOG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#PRTERRLOG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#PRTERRLOG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="PRTERRLOG"></a>
|
|
<p>The Print Error Log (PRTERRLOG) command is used primarily for problem analysis tasks. It places a formatted printer file of the data in the machine error log in a spooled printer device file named QPCSMPRT or in a specified output file.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>The following user profiles have private authorities to use the command:
|
|
<ul>
|
|
<li>QPGMR
|
|
</li>
|
|
<li>QSYSOPR
|
|
</li>
|
|
<li>QSRV
|
|
</li>
|
|
<li>QSRVBAS
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="PRTERRLOG.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="#PRTERRLOG.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Type of log data to list</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *ALLSUM, *ANZLOG, *MCH, *DEV, *ERRLOGID, *VOLSTAT</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTERRLOG.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Logical device</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 10 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTERRLOG.RSRCNAME"><b>RSRCNAME</b></a></td>
|
|
<td valign="top">Resource name</td>
|
|
<td valign="top">Values (up to 10 repetitions): <i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTERRLOG.ERRLOGID"><b>ERRLOGID</b></a></td>
|
|
<td valign="top">Error log identifier</td>
|
|
<td valign="top">Values (up to 10 repetitions): <i>Hexadecimal value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTERRLOG.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*PRINT</u></b>, *OUTFILE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="7"><a href="#PRTERRLOG.PERIOD"><b>PERIOD</b></a></td>
|
|
<td valign="top">Time period for log output</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="7">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: </td>
|
|
<td valign="top">
|
|
<i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Beginning time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*AVAIL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Beginning date</td>
|
|
<td valign="top">
|
|
<i>Date</i>, <b><u>*CURRENT</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: </td>
|
|
<td valign="top">
|
|
<i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Ending time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*AVAIL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Ending date</td>
|
|
<td valign="top">
|
|
<i>Date</i>, <b><u>*CURRENT</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTERRLOG.PRTFMT"><b>PRTFMT</b></a></td>
|
|
<td valign="top">Print format</td>
|
|
<td valign="top"><b><u>*CHAR</u></b>, *HEX</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#PRTERRLOG.OUTFILE"><b>OUTFILE</b></a></td>
|
|
<td valign="top">File to receive output</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File to receive output</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#PRTERRLOG.OUTMBR"><b>OUTMBR</b></a></td>
|
|
<td valign="top">Output member options</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Member to receive output</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Replace or add records</td>
|
|
<td valign="top">
|
|
<b><u>*REPLACE</u></b>, *ADD</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTERRLOG.VOLTYPE"><b>VOLTYPE</b></a></td>
|
|
<td valign="top">Volume type</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTERRLOG.MODEL"><b>MODEL</b></a></td>
|
|
<td valign="top">Model number</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTERRLOG.VOL"><b>VOL</b></a></td>
|
|
<td valign="top">Volume</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 10 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTERRLOG.VOLSTAT"><b>VOLSTAT</b></a></td>
|
|
<td valign="top">Volume statistical data</td>
|
|
<td valign="top"><b><u>*KEEP</u></b>, *DLT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTERRLOG.VOLSTATTYP"><b>VOLSTATTYP</b></a></td>
|
|
<td valign="top">Volume statistics type</td>
|
|
<td valign="top"><b><u>*LIFETIME</u></b>, *SESSION</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTERRLOG.SELECT"><b>SELECT</b></a></td>
|
|
<td valign="top">Error log entries to select</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *PRC, *MEDIA, *LWS, *CMN, *PWR, *LPP, *LIC</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTERRLOG.SORT"><b>SORT</b></a></td>
|
|
<td valign="top">Sort by</td>
|
|
<td valign="top"><b><u>*DATETIME</u></b>, *TIME, *DEVADR, *ERRTYPE, *RSRCNAME</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="PRTERRLOG.TYPE"></a>
|
|
<h3>Type of log data to list (TYPE)</h3>
|
|
<p>Specifies the type of error log data from the machine error log to print in the spooled printer file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All the error codes in the machine's error log are printed. In addition, the error codes for each subsystem (for example, diskette units, printers) are printed in summary form.
|
|
</dd>
|
|
<dt><b>*ALLSUM</b></dt>
|
|
<dd>All the data in the error log is printed in summary form.
|
|
</dd>
|
|
<dt><b>*ANZLOG</b></dt>
|
|
<dd>A one-line summary is created for each entry in the error log.
|
|
</dd>
|
|
<dt><b>*MCH</b></dt>
|
|
<dd>Only the error data produced by machine checks is printed.
|
|
</dd>
|
|
<dt><b>*DEV</b></dt>
|
|
<dd>Only the error data produced by the devices specified in the following parameters is printed:
|
|
<ul>
|
|
<li><b>Logical device (DEV)</b> parameter
|
|
</li>
|
|
<li><b>Resource name (RSRCNAME)</b> parameter
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
<dt><b>*ERRLOGID</b></dt>
|
|
<dd>Only the error data with the specified error log record is printed. *ERRLOGID can only be specified if the <b>Error log identifier (ERRLOGID)</b> parameter is also specified. It is ignored for other request types.
|
|
</dd>
|
|
<dt><b>*VOLSTAT</b></dt>
|
|
<dd>Only the tape or diskette volume statistical data records are printed.
|
|
<p>
|
|
<b>Note: </b>If you specify *PRINT on the <b>Output (OUTPUT)</b> parameter and *VOLSTAT on this parameter, lifetime statistics are printed. If you specify *OUTFILE on the OUTPUT parameter and *VOLSTAT on this parameter, session statistics are directed to the output file. If the name of the volume is reported as '******', it means that this volume is not displayable.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.DEV"></a>
|
|
<h3>Logical device (DEV)</h3>
|
|
<p>Specifies the device names for which you want the error log data to be printed. This parameter is valid only if *DEV is specified for the <b>Type of log data to list (TYPE)</b> parameter. This parameter cannot be specified if a value is specified for the <b>Resource name (RSRCNAME)</b> parameter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The error log data for all device names is printed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify one or more device names whose error log data you want to print. A maximum of ten device names can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.RSRCNAME"></a>
|
|
<h3>Resource name (RSRCNAME)</h3>
|
|
<p>Specifies the resource names for which error log entries are to be printed. This parameter is valid only if *DEV is specified for the <b>Type of log data to list (TYPE)</b> parameter. This parameter cannot be specified if a value is specified for the <b>Logical device (DEV)</b> parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify one or more resource names whose error log data you want to print. A maximum of ten resource names can be specified.
|
|
<p>
|
|
<b>Note: </b>If you specify a storage controller input/output processor (IOP) as the resource name, no error log entries are printed for the resource.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.ERRLOGID"></a>
|
|
<h3>Error log identifier (ERRLOGID)</h3>
|
|
<p>Specifies that error log entries with the specified error log identifier are printed. This parameter is valid only if *ERRLOGID is specified for the <b>Type of log data to list (TYPE)</b> parameter. A maximum of ten error log identifiers can be specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>hexadecimal-value</i></b></dt>
|
|
<dd>Specify the error log identifier of an error log entry to be printed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is printed with the job's spooled output or sent to a database file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRINT</u></b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*OUTFILE</b></dt>
|
|
<dd>The output is directed to the database file specified for the <b>File to receive output (OUTFILE)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.PERIOD"></a>
|
|
<h3>Time period for log output (PERIOD)</h3>
|
|
<p>Specifies the period of time for which the error log data is printed. The following values can be coded in this parameter, which contains two sets of two values each.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is not valid when TYPE(*VOLSTAT) and VOLSTATTYP(*LIFETIME) are specified.
|
|
</p>
|
|
<p><b>Element 1:</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 1: Beginning time</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
|
<dd>The error data that is available for the specified start or end date is printed.
|
|
</dd>
|
|
<dt><b><i>time</i></b></dt>
|
|
<dd>Specify the start time of the specified start date for which the error data is printed. The time is specified in 24-hour format with or without a time separator as follows:
|
|
<ul>
|
|
<li>With a time separator, specify a string of 5 or 8 digits, where the time separator for the job separates the hours, minutes, and seconds. If you issue this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command fails.
|
|
</li>
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where <b>hh</b> = hours, <b>mm</b> = minutes, and <b>ss</b> = seconds. Valid values for <b>hh</b> range from 00 through 23. Valid values for <b>mm</b> and <b>ss</b> range from 00 through 59.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 2: Beginning date</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The error data that is available for the current day and between the specified start and end times (if specified) is printed.
|
|
</dd>
|
|
<dt><b><i>date</i></b></dt>
|
|
<dd>Specify the start date for which error data is printed. The date must be specified in the job date format.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2:</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 1: Ending time</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
|
<dd>The error data that is available for the specified start or end date is printed.
|
|
</dd>
|
|
<dt><b><i>time</i></b></dt>
|
|
<dd>Specify the end time for the specified end date that specifies the error data to be printed. See the <b>Beginning time</b> description on this parameter for details about how time must be specified.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Element 2: Ending date</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The error data that is available for the current day and between the specified start and end times (if specified) is printed.
|
|
</dd>
|
|
<dt><b><i>date</i></b></dt>
|
|
<dd>Specify the end date for which error data is printed. The date must be specified in the job date format.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.PRTFMT"></a>
|
|
<h3>Print format (PRTFMT parameter)</h3>
|
|
<p>Specifies whether the indicated report prints any hexadecimal data in character format. This parameter cannot be specified if *VOLSTAT is specified for the <b>Type of log data to list (TYPE)</b> parameter, or if a value is specified for the <b>File to receive output (OUTFILE)</b> parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CHAR</u></b></dt>
|
|
<dd>The report is formatted so that hexadecimal data prints as character data.
|
|
</dd>
|
|
<dt><b>*HEX</b></dt>
|
|
<dd>No formatting is done for the report. Hexadecimal data prints as hexadecimal.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.OUTFILE"></a>
|
|
<h3>File to receive output (OUTFILE)</h3>
|
|
<p>Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.
|
|
</p>
|
|
<p><b>Qualifier 1: File to receive output</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the database file to which the command output is directed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.OUTMBR"></a>
|
|
<h3>Output member options (OUTMBR)</h3>
|
|
<p>Specifies the name of the database file member to which the output is directed when *OUTFILE is specified for the <b>Output (OUTPUT)</b> parameter.
|
|
</p>
|
|
<p><b>Element 1: Member to receive output</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the <b>File to receive output (OUTFILE)</b> parameter.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it.
|
|
<p>If the member exists, you can add records to the end of the existing member or clear the existing member and add the records.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Replace or add records</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REPLACE</u></b></dt>
|
|
<dd>The existing records in the specified database file member are replaced by the new records.
|
|
</dd>
|
|
<dt><b>*ADD</b></dt>
|
|
<dd>The new records are added to the existing information in the specified database file member.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.VOLTYPE"></a>
|
|
<h3>Volume type (VOLTYPE)</h3>
|
|
<p>Specifies the volume type of the specified volume identifier. Valid entries are 4-digit device type numbers for cartridge tape, reel tape, or diskette. This parameter returns information about all the volumes that use the same technology as the tape device type that was specified. For example, if 6380 is the specified value for this parameter, information about all 1/4 inch tape cartridges on the system is returned.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the volume type.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.MODEL"></a>
|
|
<h3>Model number (MODEL)</h3>
|
|
<p>Specifies the model number of the specified model type. This parameter is required if the device type is 9331 and TYPE(*VOLSTAT) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the model number.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.VOL"></a>
|
|
<h3>Volume (VOL)</h3>
|
|
<p>Specifies the name of the volume for which you want statistics processed.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Volume statistics are processed for all volumes.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of the volume for which statistics are processed. A maximum of ten volume names can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.VOLSTAT"></a>
|
|
<h3>Volume statistical data (VOLSTAT)</h3>
|
|
<p>Specifies whether the volume statistical data records are kept or deleted from the machine error log after they are printed. This parameter is valid only if *VOLSTAT is specified on the <b>Type of data (TYPE)</b> parameter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>ENDOPT(*UNLOAD) must be specified during the SAVE operation to generate volume statistics at the completion of the tape operation.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*KEEP</u></b></dt>
|
|
<dd>The volume statistical data records are kept in the error log after they are printed.
|
|
</dd>
|
|
<dt><b>*DLT</b></dt>
|
|
<dd>The volume statistical data records are deleted from the error log for volumes that are not active after they are printed.
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>You cannot specify *DLT on this parameter if *OUTFILE is specified on the <b>Output (OUTPUT)</b> parameter.
|
|
</li>
|
|
<li>The length of time it takes to run this command when VOLSTAT(*DLT) is specified is dependent on the number of volume IDs being deleted.
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.VOLSTATTYP"></a>
|
|
<h3>Volume statistics type (VOLSTATTYP)</h3>
|
|
<p>Specifies the type of volume statistics printed or directed to an output file. This parameter is valid only if *VOLSTAT is specified on the <b>Type of log data to list (TYPE)</b> parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIFETIME</u></b></dt>
|
|
<dd>Lifetime statistics are printed. Lifetime statistics cannot be placed in an output file.
|
|
</dd>
|
|
<dt><b>*SESSION</b></dt>
|
|
<dd>Session statistics are directed to the output file specified on the <b>File to receive output (OUTFILE)</b> parameter. Session statistics cannot be printed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.SELECT"></a>
|
|
<h3>Error log entries to select (SELECT)</h3>
|
|
<p>Specifies which type of error log entries are included on the report.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All error log entries are included on the report.
|
|
</dd>
|
|
<dt><b>*PRC</b></dt>
|
|
<dd>The processor error log entries are included on the report.
|
|
</dd>
|
|
<dt><b>*MEDIA</b></dt>
|
|
<dd>The error log entries for disk, tape, and diskette devices are included on the report.
|
|
</dd>
|
|
<dt><b>*LWS</b></dt>
|
|
<dd>The error log entries for local workstations are included on the report.
|
|
</dd>
|
|
<dt><b>*CMN</b></dt>
|
|
<dd>The error log entries for communications are included on the report. These include entries for communications I/O processors, I/O adapters, ports, lines, controllers, and devices connected with SDLC, ASYNC, BSC, X.25, IDLC, ISDN, and local area network line protocols.
|
|
</dd>
|
|
<dt><b>*PWR</b></dt>
|
|
<dd>The error log entries for system power control network (SPCN) are included on the report.
|
|
</dd>
|
|
<dt><b>*LPP</b></dt>
|
|
<dd>The error log entries for licensed programs are included on the report.
|
|
</dd>
|
|
<dt><b>*LIC</b></dt>
|
|
<dd>The error log entries for Licensed Internal Code are included on the report.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTERRLOG.SORT"></a>
|
|
<h3>Sort by (SORT)</h3>
|
|
<p>Specifies the order in which the entries appear on the report.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DATETIME</u></b></dt>
|
|
<dd>The entries are sorted by date and time. The summary entries are for each day.
|
|
</dd>
|
|
<dt><b>*TIME</b></dt>
|
|
<dd>The entries are sorted by the time of day only. The summary entries are for each hour.
|
|
</dd>
|
|
<dt><b>*DEVADR</b></dt>
|
|
<dd>The entries are sorted by the address of the device. The summary entries are divided into three levels: those for which the first two digits of the address are the same, those for which the first four digits of the address are the same, and those for which the first eight digits of the address are the same.
|
|
</dd>
|
|
<dt><b>*ERRTYPE</b></dt>
|
|
<dd>The entries are sorted by the severity of the type of error. The more severe types of errors report at the top of the list. The summary entries are divided into two levels: those that have a common error type, and those that have a common error type and system reference code.
|
|
</dd>
|
|
<dt><b>*RSRCNAME</b></dt>
|
|
<dd>The entries are sorted by the resource name of the device.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="PRTERRLOG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Printing Error Log Data</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
PRTERRLOG
|
|
</pre>
|
|
</p>
|
|
<p>This command gets the error data in the machine error log that occurred for all device types and puts it in a spooled file. The entire error log is printed and any hexadecimal data is in character format.
|
|
</p>
|
|
<p><b>Example 2: Using the System Resource Manager Database</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
PRTERRLOG TYPE(*DEV) RSRCNAME(TAPE000001) PRTFMT(*HEX)
|
|
</pre>
|
|
</p>
|
|
<p>This command uses the system resource manager database to determine the device type, model, and serial number for the resource TAPE000001. The print request is based on that information. The report is put in the spooled file and contains all records that pertain to that device type, model, and serial number. Any hexadecimal data in the file is converted to hexadecimal format.
|
|
</p>
|
|
<p><b>Example 3: Processing Error Log Entries</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
PRTERRLOG TYPE(*DEV) DEV(DISKLUD1) OUTPUT(*OUTFILE)
|
|
OUTFILE(MYLIB/MYDBD) OUTMBR(ELOG)
|
|
</pre>
|
|
</p>
|
|
<p>This command processes all the error log entries for the logical device named DISKLUD1. They are put in the file MYDBD, in the library MYLIB, and in the member ELOG. No spooled files are created.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="PRTERRLOG.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPD36CA</b></dt>
|
|
<dd>OUTPUT(*OUTFILE) cannot be specified with DEV(*ALL).
|
|
</dd>
|
|
<dt><b>CPD36C2</b></dt>
|
|
<dd>DEV and RSRCNAME cannot be used together.
|
|
</dd>
|
|
<dt><b>CPD36C3</b></dt>
|
|
<dd>PRTFMT parameter not valid with TYPE(*VOLSTAT).
|
|
</dd>
|
|
<dt><b>CPD36C4</b></dt>
|
|
<dd>OUTFILE not valid with PRTFMT parameter.
|
|
</dd>
|
|
<dt><b>CPD36C5</b></dt>
|
|
<dd>RSRCNAME parameter can only be used with TYPE(*DEV) parameter.
|
|
</dd>
|
|
<dt><b>CPD36C7</b></dt>
|
|
<dd>ERRLOGID valid only with TYPE(*ERRLOGID).
|
|
</dd>
|
|
<dt><b>CPD36C9</b></dt>
|
|
<dd>PERIOD not valid for specified TYPE and VOLSTATTYP.
|
|
</dd>
|
|
<dt><b>CPF3535</b></dt>
|
|
<dd>Error log not available for printing.
|
|
</dd>
|
|
<dt><b>CPF3541</b></dt>
|
|
<dd>No error log entries were found.
|
|
</dd>
|
|
<dt><b>CPF3593</b></dt>
|
|
<dd>PERIOD parameter start time exceeds end time.
|
|
</dd>
|
|
<dt><b>CPF3693</b></dt>
|
|
<dd>Service function ended because error occurred.
|
|
</dd>
|
|
<dt><b>CPI36CA</b></dt>
|
|
<dd>Resource name &1 not found.
|
|
</dd>
|
|
<dt><b>CPI36CC</b></dt>
|
|
<dd>No error log entries were found for &1 &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTERRLOG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|