301 lines
10 KiB
HTML
301 lines
10 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 Message Description (DSPMSGD)</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="DSPMSGD.Top_Of_Page"></a>
|
|
<h2>Display Message Description (DSPMSGD)</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="#DSPMSGD.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPMSGD.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPMSGD.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPMSGD"></a>
|
|
<p>The Display Message Description (DSPMSGD) command shows detailed information about the messages in a message file. The descriptions of specific messages, or a range of messages in one message file, can be specified by their identifiers, or all messages in one message file can be specified.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPMSGD.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" rowspan="3"><a href="#DSPMSGD.RANGE"><b>RANGE</b></a></td>
|
|
<td valign="top">Range of message identifiers</td>
|
|
<td valign="top">Single values: *ALL<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Lower value</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Upper value</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*ONLY</u></b>, *LAST</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPMSGD.MSGF"><b>MSGF</b></a></td>
|
|
<td valign="top">Message file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Message file</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QCPFMSG</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB, *USRLIBL</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#DSPMSGD.DETAIL"><b>DETAIL</b></a></td>
|
|
<td valign="top">Detail</td>
|
|
<td valign="top">*BASIC, <b><u>*FULL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPMSGD.FMTTXT"><b>FMTTXT</b></a></td>
|
|
<td valign="top">Format message text</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPMSGD.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>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPMSGD.RANGE"></a>
|
|
<h3>Range of message identifiers (RANGE)</h3>
|
|
<p>Specifies the range of message identifiers in the specified message file for which message descriptions are displayed or printed. All message descriptions in the message file specified for the <b>Message file (MSGF)</b> parameter can be displayed or printed by specifying *ALL on this parameter.
|
|
</p>
|
|
<p>If the starting message identifier is not specified, the message descriptions begin with the first message in the specified message file.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The ending message identifier is ignored when DETAIL(*BASIC) is specified with OUTPUT(*) and the list of message identifiers is displayed interactively.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All message descriptions in the message file specified are displayed or printed. This value can only be specified in the first element of this parameter.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Lower value</b>
|
|
</p>
|
|
<p>The first element of this parameter, called the starting message identifier, specifies the message identifier of the first message description to display or print.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first message in the file specified for the <b>Message file (MSGF)</b> parameter is the first message whose description is displayed or printed.
|
|
</dd>
|
|
<dt><b><i>lower-value</i></b></dt>
|
|
<dd>Specify the 7-character identifier of the first message description to be displayed or printed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Upper value</b>
|
|
</p>
|
|
<p>The second element of this parameter, called the ending message identifier, specifies the message identifier for the last message description to be printed. This value is ignored if OUTPUT(*) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>Only the message identifier specified as a starting message identifier has its description printed.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The last message in the file is the last message whose description is printed.
|
|
</dd>
|
|
<dt><b><i>upper-value</i></b></dt>
|
|
<dd>Specify the 7-character identifier of the last message description to be printed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPMSGD.MSGF"></a>
|
|
<h3>Message file (MSGF)</h3>
|
|
<p>Specifies the message file from which the message descriptions are to be shown.
|
|
</p>
|
|
<p><b>Qualifier 1: Message file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QCPFMSG</u></b></dt>
|
|
<dd>Message descriptions are shown from message file QCPFMSG.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the message file from which the message descriptions are shown.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</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 message file. If no current library entry exists in the library list, QGPL is used.
|
|
</dd>
|
|
<dt><b>*USRLIBL</b></dt>
|
|
<dd>Only the libraries in the user portion of the job's library list are searched.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the library where the message file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPMSGD.DETAIL"></a>
|
|
<h3>Detail (DETAIL)</h3>
|
|
<p>Specifies the amount of detail about the message that is displayed or printed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FULL</u></b></dt>
|
|
<dd>Detailed message descriptions are displayed or printed. If *PRINT is specified for the <b>Output (OUTPUT)</b> parameter, the detailed descriptions are printed. If an asterisk (*) is specified for the <b>Output (OUTPUT)</b> parameter, a menu is shown from which the user can select which details to view.
|
|
</dd>
|
|
<dt><b>*BASIC</b></dt>
|
|
<dd>A list of the specified message identifiers, their severity, and messages are displayed or printed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPMSGD.FMTTXT"></a>
|
|
<h3>Format message text (FMTTXT)</h3>
|
|
<p>Specifies whether messages and help information are displayed or printed in a formatted style.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>The messages and help information are displayed or printed in a formatted style.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The messages and help information are displayed or printed in an unformatted style.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPMSGD.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 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="#DSPMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPMSGD.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Displaying or Printing Descriptions</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPMSGD RANGE(CPF1100 CPF3600) MSGF(QSYS/QCPFMSG)
|
|
</pre>
|
|
</p>
|
|
<p>If this command is entered from a display station, the descriptions of the specified messages are shown on the display. If this command is entered from a batch job, the descriptions of the messages are sent to the job's spooled output queue.
|
|
</p>
|
|
<p><b>Example 2: Printing Message Descriptions</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPMSGD RANGE(*FIRST IDU0571) MSGF(QIDU/QIDUMSG)
|
|
FMTTXT(*NO) OUTPUT(*PRINT)
|
|
</pre>
|
|
</p>
|
|
<p>This command prints the message descriptions for message identifiers in the file that are in the following range: from the first message in the QIDUMSG message file through the message whose identifier is IDU0571. The message descriptions are not formatted.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPMSGD.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2401</b></dt>
|
|
<dd>Not authorized to library &1.
|
|
</dd>
|
|
<dt><b>CPF2407</b></dt>
|
|
<dd>Message file &1 in &2 not found.
|
|
</dd>
|
|
<dt><b>CPF2411</b></dt>
|
|
<dd>Not authorized to message file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF2483</b></dt>
|
|
<dd>Message file currently in use.
|
|
</dd>
|
|
<dt><b>CPF2510</b></dt>
|
|
<dd>Message file &1 in &2 logically damaged.
|
|
</dd>
|
|
<dt><b>CPF2515</b></dt>
|
|
<dd>Invalid message ID range.
|
|
</dd>
|
|
<dt><b>CPF2516</b></dt>
|
|
<dd>Unable to open display or printer file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF2519</b></dt>
|
|
<dd>Error occurred while processing message ID list.
|
|
</dd>
|
|
<dt><b>CPF2537</b></dt>
|
|
<dd>Too many records written to file &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF9807</b></dt>
|
|
<dd>One or more libraries in library list deleted.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|