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

1128 lines
34 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>Display Problems (DSPPRB)</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="DSPPRB.Top_Of_Page"></a>
<h2>Display Problems (DSPPRB)</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="#DSPPRB.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPPRB.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPPRB.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPPRB"></a>
<p>The Display Problem (DSPPRB) command allows you to display or print service information related to performing hardware or software maintenance. The service information, contained in the problem log entries, are shown on the DSPPRB display, printed with the job's output, or stored in a database file.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPPRB.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="#DSPPRB.PRBID"><b>PRBID</b></a></td>
<td valign="top">Problem identifier</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#DSPPRB.STATUS"><b>STATUS</b></a></td>
<td valign="top">Status type</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 6 repetitions): *OPENED, *READY, *PREPARED, *SENT, *ANSWERED, *VERIFIED, *CLOSED</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPPRB.SEV"><b>SEV</b></a></td>
<td valign="top">Severity</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 3 repetitions): 1, 2, 3, 4</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="7"><a href="#DSPPRB.PERIOD"><b>PERIOD</b></a></td>
<td valign="top">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>, <b><u>*AVAIL</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Start date</td>
<td valign="top">
<i>Date</i>, <b><u>*BEGIN</u></b>, *CURRENT</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>, <b><u>*AVAIL</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: End date</td>
<td valign="top">
<i>Date</i>, <b><u>*END</u></b>, *CURRENT</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#DSPPRB.HARDWARE"><b>HARDWARE</b></a></td>
<td valign="top">Hardware</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Device type</td>
<td valign="top">
<i>Character value</i>, <b><u>*ALL</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Model number</td>
<td valign="top">
<i>Character value</i>, <b><u>*ALL</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Serial number</td>
<td valign="top">
<i>Character value</i>, <b><u>*ALL</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#DSPPRB.RESOURCE"><b>RESOURCE</b></a></td>
<td valign="top">Resource name</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#DSPPRB.LICPGM"><b>LICPGM</b></a></td>
<td valign="top">Product</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Program identifier</td>
<td valign="top">
<i>Character value</i>, <b><u>*ALL</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Release</td>
<td valign="top">
<i>Character value</i>, <b><u>*ALL</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Modification level</td>
<td valign="top">
<i>Character value</i>, <b><u>*ALL</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#DSPPRB.FUNCTION"><b>FUNCTION</b></a></td>
<td valign="top">Function</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPPRB.PGM"><b>PGM</b></a></td>
<td valign="top">Program</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPPRB.MSGID"><b>MSGID</b></a></td>
<td valign="top">Message identifier</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#DSPPRB.ORIGIN"><b>ORIGIN</b></a></td>
<td valign="top">Origin</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Network identifier</td>
<td valign="top">
<i>Communications name</i>, <b><u>*ALL</u></b>, *NETATR</td>
</tr>
<tr>
<td valign="top">Element 2: Control point name</td>
<td valign="top">
<i>Communications name</i>, <b><u>*ALL</u></b>, *NETATR</td>
</tr>
<tr>
<td valign="top"><a href="#DSPPRB.SRVID"><b>SRVID</b></a></td>
<td valign="top">Service number</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPPRB.ASNUSER"><b>ASNUSER</b></a></td>
<td valign="top">User assigned</td>
<td valign="top"><i>Simple name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPPRB.GROUP"><b>GROUP</b></a></td>
<td valign="top">Group assigned</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPPRB.PRBTYPE"><b>PRBTYPE</b></a></td>
<td valign="top">Problem type</td>
<td valign="top"><b><u>*ALL</u></b>, 1, 2, 3, 4, 5, 6</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPPRB.PRBCGY"><b>PRBCGY</b></a></td>
<td valign="top">Problem category</td>
<td valign="top"><b><u>*ALL</u></b>, *REPORT, *CRITICAL, *LOGONLY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPPRB.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT, *OUTFILE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#DSPPRB.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="#DSPPRB.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="#DSPPRB.TYPE"><b>TYPE</b></a></td>
<td valign="top">Type of information</td>
<td valign="top"><b><u>*BASIC</u></b>, *CAUSE, *FIX, *USRTXT, *SPTDTA</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPPRB.PRBID"></a>
<h3>Problem identifier (PRBID)</h3>
<p>Specifies the ID of the problems to be selected. Problems with different origin systems may have the same identifier. Specifying the <b>Origin (ORIGIN)</b> parameter along with this parameter will assure that only one problem is selected.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All problems that match the other selection criteria are selected.
</dd>
<dt><b><i>problem-ID</i></b></dt>
<dd>Specify the 10-character problem ID of the problem to be selected.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.STATUS"></a>
<h3>Status type (STATUS)</h3>
<p>Specifies the status of problem log entries. There are seven types of status:
</p>
<dl>
<dt><b>*OPENED</b></dt>
<dd>The problem is in Opened status. The problem has been identified and a problem record was created.
</dd>
<dt><b>*READY</b></dt>
<dd>The problem is in Ready status. Problem analysis information has been added to the problem record.
</dd>
<dt><b>*PREPARED</b></dt>
<dd>The problem is in Prepared status. The problem has been prepared for reporting.
</dd>
<dt><b>*SENT</b></dt>
<dd>The problem is in Sent status. The problem has been sent to a service provider, but no answer has been returned.
</dd>
<dt><b>*ANSWERED</b></dt>
<dd>The problem is in Answered status. An answer has been returned by the service provider or added by an operator on this system.
</dd>
<dt><b>*VERIFIED</b></dt>
<dd>The problem is in Verified status. The problem was resolved and the system operator has verified that the problem is corrected.
</dd>
<dt><b>*CLOSED</b></dt>
<dd>The problem was closed.
</dd>
</dl>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All types of status of problem log entries are shown.
</dd>
<dt><b><i>status-type</i></b></dt>
<dd>Specify the type of status to be shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.SEV"></a>
<h3>Severity (SEV)</h3>
<p>Specifies the severity level of the problem. Severity levels are assigned by the user when the problem is prepared for reporting. The four severity levels are:
</p>
<dl>
<dt><b>1</b></dt>
<dd>High
</dd>
<dt><b>2</b></dt>
<dd>Medium
</dd>
<dt><b>3</b></dt>
<dd>Low
</dd>
<dt><b>4</b></dt>
<dd>None
</dd>
</dl>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All problem log entries are shown.
</dd>
<dt><b><i>severity</i></b></dt>
<dd>Specify the level of severity of problem log entries to be shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.PERIOD"></a>
<h3>Period (PERIOD)</h3>
<p>Specifies the period of time for which the problem data is selected. The dates and times indicate when the problem log entry was created.
</p>
<p>The possible <b>starting time</b> values are:
</p>
<dl>
<dt><b><u>*AVAIL</u></b></dt>
<dd>Problem entries created on the specified starting date are shown.
</dd>
<dt><b><i>start-time</i></b></dt>
<dd>Specify the creation time (for the specified date) of the first data record to include.
<p>The time is specified in 24-hour format and can be specified with or without a time separator:
</p>
<ul>
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Hours, minutes, and seconds must each be exactly 2 digits (use leading zeros if necessary).
</li>
<li>With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter 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 will fail.
</li>
</ul>
</dd>
</dl>
<p>The possible <b>starting date</b> values are:
</p>
<dl>
<dt><b><u>*BEGIN</u></b></dt>
<dd>Problems available at the beginning of the log are shown. If *BEGIN is specified, time values other than *AVAIL for start-time are ignored.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The problem log entries created for the current day between the specified start-time and end-time (if specified) are displayed.
</dd>
<dt><b><i>start-date</i></b></dt>
<dd>Specify the date after which the problem log entries can be shown. The date must be specified in the job date format.
</dd>
</dl>
<p>The possible <b>ending time</b> values are:
</p>
<dl>
<dt><b><u>*AVAIL</u></b></dt>
<dd>Problem log entries created on the specified ending date are shown.
</dd>
<dt><b><i>end-time</i></b></dt>
<dd>Specify the time after which problem log entries created are not shown. See the start-time description in this parameter description for details on how the time must be specified.
</dd>
</dl>
<p>The possible <b>ending date</b> values are:
</p>
<dl>
<dt><b><u>*END</u></b></dt>
<dd>The last day on which a problem log entry was created is the last day for which problems are shown. If *END is specified, then any time value other than *AVAIL for end-time is ignored.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The current date is used for the date of the last problem opened to show.
</dd>
<dt><b><i>end-date</i></b></dt>
<dd>Specify the date after which problem log entries cannot be shown. See the start-date description in this parameter for details on how the date must be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.HARDWARE"></a>
<h3>Hardware (HARDWARE)</h3>
<p>Specifies that only problem log entries that identify the specified failing hardware are shown.
</p>
<p>The possible <b>machine type</b> values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries are shown, regardless of what hardware is identified as failing.
<p>
<b>Note: </b>If *ALL is specified, any value other than *ALL for model and serial number is ignored.
</p>
</dd>
<dt><b><i>type</i></b></dt>
<dd>Specify the 4-character type code for the hardware.
</dd>
</dl>
<p>The possible <b>model number</b> values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries that identify failing hardware of the specified type are shown.
<p>
<b>Note: </b>If *ALL is specified, any value other than *ALL for serial number is ignored.
</p>
</dd>
<dt><b><i>model</i></b></dt>
<dd>Specify the 3-character model number for the hardware.
</dd>
</dl>
<p>The possible <b>serial number</b> values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries that identify failing hardware of the specified type and model are shown.
</dd>
<dt><b><i>serial</i></b></dt>
<dd>Specify the serial number of the hardware in one of the following formats, where n is a decimal character ranging from 0 through 9.
<ul>
<li>nnnnn
</li>
<li>nnnnnnn
</li>
<li>nn-nnnnn
</li>
<li>nn-nnnnnnn
</li>
</ul>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.RESOURCE"></a>
<h3>Resource name (RESOURCE)</h3>
<p>Specifies that only problem log entries that identify the specified failing resource name are shown.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries are shown, regardless of which resource name, if any, is identified by the problem.
</dd>
<dt><b><i>resource-name</i></b></dt>
<dd>Specify the resource name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.LICPGM"></a>
<h3>Product (LICPGM)</h3>
<p>Specifies that problem log entries that identify the specified failing software are shown.
</p>
<p>The possible <b>program ID</b> values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries are shown regardless of what software is identified as failing.
<p>
<b>Note: </b>If *ALL is specified, any value other than *ALL for release and modification is ignored.
</p>
</dd>
<dt><b><i>program-ID</i></b></dt>
<dd>Specify the identification number of the licensed program.
</dd>
</dl>
<p>The possible <b>release</b> values are:
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All entries that identify failing software from the specified licensed program are shown.
<p>
<b>Note: </b>If *ALL is specified, any value other than *ALL for modification is ignored.
</p>
</dd>
<dt><b><i>release-level</i></b></dt>
<dd>Specify the release level of the licensed program.
</dd>
</dl>
<p>The possible <b>modification</b> values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries that identify failing software from the specified licensed program and release are shown.
</dd>
<dt><b><i>modification</i></b></dt>
<dd>Specify the modification number of the release.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.FUNCTION"></a>
<h3>Function (FUNCTION)</h3>
<p>Specifies that only problem log entries that identify the specified function are to be shown. The function is present only in user-detected problem log entries and represents a major functional area or product.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries are shown regardless of what function ID, if any, is identified.
</dd>
<dt><b><i>generic*-function-identifier</i></b></dt>
<dd>Specify a generic function ID. A generic ID is a character string containing one or more of the initial characters of the function ID followed by an asterisk (*). If blank characters are included, the character string must be enclosed in apostrophes (').
</dd>
<dt><b><i>function-id</i></b></dt>
<dd>Specify the complete function ID. If blank characters are included, the character string must be enclosed in apostrophes (').
<p>The possible values for function ID are:
</p>
<dl>
<dt><b>ID</b></dt>
<dd><b> Description
</b></dd>
<dt><b>ALRT</b></dt>
<dd>Alerts
</dd>
<dt><b>APF</b></dt>
<dd>Advanced printer function
</dd>
<dt><b>APPC</b></dt>
<dd>Advanced program-to-program communications
</dd>
<dt><b>APPN</b></dt>
<dd>Advanced Peer-to-Peer Networking function
</dd>
<dt><b>APS</b></dt>
<dd>Advanced DBCS Printer Support program
</dd>
<dt><b>ASYNC</b></dt>
<dd>Asynchronous communications
</dd>
<dt><b>BAS</b></dt>
<dd>AS/400 BASIC
</dd>
<dt><b>BGU</b></dt>
<dd>AS/400 Business Graphics Utility
</dd>
<dt><b>BSC</b></dt>
<dd>Binary synchronous communications
</dd>
<dt><b>CBL</b></dt>
<dd>AS/400 COBOL and COBOL for iSeries
</dd>
<dt><b>CGU</b></dt>
<dd>Character generator utility
</dd>
<dt><b>CL</b></dt>
<dd>Control language
</dd>
<dt><b>CRYPT</b></dt>
<dd>Cryptographic Support/400
</dd>
<dt><b>CSM</b></dt>
<dd>Communications and Systems Management
</dd>
<dt><b>C400</b></dt>
<dd>C/400
</dd>
<dt><b>DDM</b></dt>
<dd>Distributed data management
</dd>
<dt><b>DFU</b></dt>
<dd>Data file utility
</dd>
<dt><b>DHCF</b></dt>
<dd>Distributed host command facility
</dd>
<dt><b>DICT</b></dt>
<dd>Language Dictionaries/400
</dd>
<dt><b>DSNX</b></dt>
<dd>Distributed system node executive
</dd>
<dt><b>ECS</b></dt>
<dd>Electronic customer support
</dd>
<dt><b>FINANCE</b></dt>
<dd>Finance Communications
</dd>
<dt><b>FTN</b></dt>
<dd>FORTRAN/400
</dd>
<dt><b>FTS</b></dt>
<dd>File transfer support
</dd>
<dt><b>GDDM</b></dt>
<dd>Graphical Data Display Manager
</dd>
<dt><b>ICF</b></dt>
<dd>Intersystem Communication Facility
</dd>
<dt><b>IDU</b></dt>
<dd>Interactive data definition utility (IDDU)
</dd>
<dt><b>INTRA</b></dt>
<dd>Intrasystem Communication
</dd>
<dt><b>IPDS</b></dt>
<dd>Intelligent Printer Data Stream
</dd>
<dt><b>ITF</b></dt>
<dd>Interactive terminal facility
</dd>
<dt><b>LPDA</b></dt>
<dd>Link Problem Determination and Analysis
</dd>
<dt><b>MIA</b></dt>
<dd>MI Assembler
</dd>
<dt><b>MIGR</b></dt>
<dd>Migration
</dd>
<dt><b>OBJD</b></dt>
<dd>Object distribution
</dd>
<dt><b>OCL</b></dt>
<dd>S/36 operator control language
</dd>
<dt><b>OFC</b></dt>
<dd>OfficeVision
</dd>
<dt><b>OSP</b></dt>
<dd>i5/OS
</dd>
<dt><b>PAS</b></dt>
<dd>AS/400 Pascal
</dd>
<dt><b>PASSTHRU</b></dt>
<dd>Pass-through
</dd>
<dt><b>PC400</b></dt>
<dd>Client Access/400
</dd>
<dt><b>PDM</b></dt>
<dd>Programming development manager
</dd>
<dt><b>PL1</b></dt>
<dd>AS/400 PL/I
</dd>
<dt><b>POSCOM</b></dt>
<dd>Point-of-Sale Communications Utility/400
</dd>
<dt><b>QRY</b></dt>
<dd>Query/400
</dd>
<dt><b>RETAIL</b></dt>
<dd>Retail Communications
</dd>
<dt><b>REXX</b></dt>
<dd>REXX/400
</dd>
<dt><b>RJE</b></dt>
<dd>Remote job entry
</dd>
<dt><b>RLU</b></dt>
<dd>Report layout utility
</dd>
<dt><b>RPFT</b></dt>
<dd>Performance Tools/400
</dd>
<dt><b>RPG</b></dt>
<dd>RPG for iSeries
</dd>
<dt><b>RSCS</b></dt>
<dd>Remote spooling communications subsystem
</dd>
<dt><b>RWS</b></dt>
<dd>Remote work station
</dd>
<dt><b>SDA</b></dt>
<dd>Screen design aid
</dd>
<dt><b>SDLC</b></dt>
<dd>Synchronous Data Link Control
</dd>
<dt><b>SEU</b></dt>
<dd>Source entry utility
</dd>
<dt><b>SMU</b></dt>
<dd>IBM System Manager for i5/OS
</dd>
<dt><b>SNADS</b></dt>
<dd>SNA distribution services
</dd>
<dt><b>SNUF</b></dt>
<dd>SNA upline facility
</dd>
<dt><b>SORT</b></dt>
<dd>AS/400 sort
</dd>
<dt><b>SQL</b></dt>
<dd>SQL/400
</dd>
<dt><b>SUU</b></dt>
<dd>System upgrade utility
</dd>
<dt><b>TCPIP</b></dt>
<dd>TCP/IP Connectivity Utilities/400
</dd>
<dt><b>TRLAN</b></dt>
<dd>Token ring network
</dd>
<dt><b>TXT38</b></dt>
<dd>System/38 compatible Text Management
</dd>
<dt><b>VMC</b></dt>
<dd>Vertical Licensed Internal Code
</dd>
<dt><b>VNET</b></dt>
<dd>RSCS/PROFS
</dd>
<dt><b>WRD</b></dt>
<dd>Word processing
</dd>
<dt><b>X21</b></dt>
<dd>X.21 public data network
</dd>
<dt><b>X25</b></dt>
<dd>X.25 packet-switching data network
</dd>
<dt><b>3270EM</b></dt>
<dd>3270 device emulation
</dd>
<dt><b>802.3</b></dt>
<dd>Ethernet
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.PGM"></a>
<h3>Program (PGM)</h3>
<p>Specifies whether only problem log entries that identify a specified failing program are shown. For machine detected problems, the failing program, if any, is identified by the most likely possible cause.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries are shown regardless of whether a program is identified.
</dd>
<dt><b><i>generic*-program-name</i></b></dt>
<dd>Specify a generic program name. A generic name is a character string containing one or more characters followed by an asterisk (*).
</dd>
<dt><b><i>program-name</i></b></dt>
<dd>Specify the program name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.MSGID"></a>
<h3>Message identifier (MSGID)</h3>
<p>Specifies whether only problem log entries that identify a specified message are shown.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries are shown regardless of which message ID is associated with the problem.
</dd>
<dt><b><i>generic*-msg-id</i></b></dt>
<dd>Specify a generic message identifier (ID). A generic ID is a character string containing one or more characters followed by an asterisk (*).
</dd>
<dt><b><i>message-identifier</i></b></dt>
<dd>Specify the message identifier.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.ORIGIN"></a>
<h3>Origin (ORIGIN)</h3>
<p>Specifies that only problem log entries that originated at the specified systems are shown.
</p>
<p>The possible <b>network ID</b> values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries are shown regardless of the network ID of the origin system.
</dd>
<dt><b>*NETATR</b></dt>
<dd>Only entries that originated on systems with the same local network ID as the one defined in the network attributes for this system are shown.
</dd>
<dt><b><i>network-ID</i></b></dt>
<dd>Specify a network ID. Only entries that originated on systems with this local network ID are shown.
</dd>
</dl>
<p>The possible <b>control point name</b> values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries originating at systems with the specified network ID are shown.
</dd>
<dt><b>*NETATR</b></dt>
<dd>Only entries that originated on systems with the same local control point name as the one defined in the network attributes for this system are shown.
</dd>
<dt><b><i>control-point-name</i></b></dt>
<dd>Specify a control point name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.SRVID"></a>
<h3>Service number (SRVID)</h3>
<p>Specifies whether only problem log entries that have the specified service assigned number are shown. This number was assigned when the problem was reported to IBM service support.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All entries are shown regardless of the service assigned number, if any.
</dd>
<dt><b><i>service-assigned-number</i></b></dt>
<dd>Specify the service assigned number.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.ASNUSER"></a>
<h3>User assigned (ASNUSER)</h3>
<p>Specifies whether only problem log entries assigned to this user are shown.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All problem log entries are shown.
</dd>
<dt><b><i>user-name</i></b></dt>
<dd>Specify the user ID assigned to the problems to be shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.GROUP"></a>
<h3>Group assigned (GROUP)</h3>
<p>Specifies the group in the filter to which the problem is assigned.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All problem log entries are shown, regardless of the group assigned to them.
</dd>
<dt><b><i>group-name</i></b></dt>
<dd>Specify the 10-character problem filter group assigned to the entry.
<p>
<b>Note: </b>The values are blank if problem log filtering is not used.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.PRBTYPE"></a>
<h3>Problem type (PRBTYPE)</h3>
<p>Specifies which type of problems to display.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All problem log entries are shown, regardless of the problem type.
</dd>
<dt><b><i>1</i></b></dt>
<dd>Only machine-detected problems are shown.
</dd>
<dt><b><i>2</i></b></dt>
<dd>Only user-detected problems are shown.
</dd>
<dt><b><i>3</i></b></dt>
<dd>Only PTF order problems are shown.
</dd>
<dt><b><i>4</i></b></dt>
<dd>Only application-detected problems are shown.
</dd>
<dt><b><i>5</i></b></dt>
<dd>Only Client machine-detected problems are shown.
</dd>
<dt><b><i>6</i></b></dt>
<dd>Only Client user-detected problems are shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.PRBCGY"></a>
<h3>Problem category (PRBCGY)</h3>
<p>Specifies which category of problems to display.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All problems are shown.
</dd>
<dt><b>*REPORT</b></dt>
<dd>Problems that are logged and reported to the service provider are shown.
</dd>
<dt><b>*CRITICAL</b></dt>
<dd>Problems that are critical are shown.
</dd>
<dt><b>*LOGONLY</b></dt>
<dd>Problems that are logged, but not reported to the service provider, are shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
</dd>
</dl>
<dl>
<dt><b>*PRINT</b></dt>
<dd>The output is printed with the job's spooled output.
</dd>
</dl>
<dl>
</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>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.OUTFILE"></a>
<h3>File to receive output (OUTFILE)</h3>
<p>Specifies the name and library of the database file where the output of the command is directed. If the output file does not exist, this command creates a database file in the specified library. If a file is created, the text says <b>OUTFILE for DSPPRB</b>, and the authority for users other than those who have specific authority, group authority, or authority from an authorization list 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>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the library list for the current thread are searched until the first match is found.
</dd>
</dl>
<dl>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the file. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library where the file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.OUTMBR"></a>
<h3>Output member options (OUTMBR)</h3>
<p>Specifies the name of the database file member to which the output of the command is directed and whether the output to that member replaces or is added to existing records.
</p>
<p>The possible methods for adding new records are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the file receives the output. If <b>OUTMBR(*FIRST)</b> is specified and the member does not exist, the system creates a member with the name of the file specified on the <b>File to receive output (OUTFILE)</b> parameter.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the name of the file member that receives the output. If a member name is specified and the member does not exist, the system creates it.
</dd>
</dl>
<p>The optional values are:
</p>
<dl>
</dl>
<dl>
<dt><b><u>*REPLACE</u></b></dt>
<dd>The system clears the existing member and adds the new records.
</dd>
</dl>
<dl>
</dl>
<dl>
<dt><b>*ADD</b></dt>
<dd>The system adds the new records to the end of the existing records.
</dd>
</dl>
<p>
<b>Note: </b>The <b>OUTFILE</b> and <b>OUTMBR</b> keywords are conditioned on <b>OUTPUT(*OUTFILE)</b>.
</p>
<p>If <b>OUTPUT(*OUTFILE)</b> is specified, a database file name is required.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPPRB.TYPE"></a>
<h3>Type of information (TYPE)</h3>
<p>Specifies the type of problem information that is placed in the output file. Only one type of data can be placed in each file. This parameter is valid only when a value is also specified on the <b>File to receive output (OUTFILE)</b> parameter.
</p>
<dl>
<dt><b><u>*BASIC</u></b></dt>
<dd>Basic problem data including problem type, and status; device type, model, and serial number; product ID; contact information; and tracking data is placed in the output file.
</dd>
<dt><b>*CAUSE</b></dt>
<dd>Possible problem causes are placed in the output file.
</dd>
<dt><b>*FIX</b></dt>
<dd>Program temporary fixes (PTFs) are placed in the output file.
</dd>
<dt><b>*USRTXT</b></dt>
<dd>User-supplied text (note records) is placed in the output files.
</dd>
<dt><b>*SPTDTA</b></dt>
<dd>Supporting data identifiers are placed in the output file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPPRB.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Displaying Today's Problem Log Entries</b>
</p>
<p>
<pre>
DSPPRB PERIOD((*AVAIL *CURRENT) (*AVAIL *CURRENT))
</pre>
</p>
<p>This command shows all problem log entries that were created today.
</p>
<p><b>Example 2: Creating an Output File</b>
</p>
<p>
<pre>
DSPPRB OUTPUT(*OUTFILE) OUTFILE(*CURLIB/NEWFILE)
</pre>
</p>
<p>This command creates a member in the physical file NEWFILE in the current library which contains a record for each problem log entry in the problem log.
</p>
<p><b>Example 3: Displaying a List of Hardware Problems</b>
</p>
<p>
<pre>
DSPPRB SEV(1 2) HARDWARE(9347 001 10-7523489)
</pre>
</p>
<p>This command shows a list containing problems with the hardware specified by the user. The user has specified that the command track medium-to-high levels of severity.
</p>
<p><b>Example 4: Displaying a List of Problems That Have Been Opened</b>
</p>
<p>
<pre>
DSPPRB STATUS(*OPENED)
PERIOD((*AVAIL *CURRENT) (120000 *CURRENT))
LICPGM(5716SS1 03 00) PGM(QNOPGM)
</pre>
</p>
<p>This command shows a list containing problems that have been opened during the period starting at midnight and ending at noon on the current day, and have not yet been analyzed. This command also identifies the specified licensed program identifier and program name as the probable cause of the failure.
</p>
<p><b>Example 5: Displaying a List of Machine-Detected Problems</b>
</p>
<p>
<pre>
DSPPRB RESOURCE(TAP01) MSGID(CPF6788)
</pre>
</p>
<p>This command shows a list containing machine-detected problems that were opened due to the message, CPF6788, having been sent to the system operator message queue. The list of problems includes user-detected problems. To get the user-detected problems, the user specified the resource name and message identifier by using the Analyze Problem (ANZPRB) command.
</p>
<p><b>Example 6: Displaying a List of Reported Problems</b>
</p>
<p>
<pre>
DSPPRB SRVID(12345)
</pre>
</p>
<p>This command shows a list containing problems that have been reported to an IBM service support center and have 12345 as the service identifier.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPPRB.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF7A9C</b></dt>
<dd>Cannot work with the problem log at this time.
</dd>
<dt><b>CPF9845</b></dt>
<dd>Error occurred while opening file &amp;1.
</dd>
<dt><b>CPF9847</b></dt>
<dd>Error occurred while closing file &amp;1 in library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPPRB.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>