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

216 lines
7.3 KiB
HTML
Raw 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 DBCS Conversion Dict (DSPIGCDCT)</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="DSPIGCDCT.Top_Of_Page"></a>
<h2>Display DBCS Conversion Dict (DSPIGCDCT)</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="#DSPIGCDCT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPIGCDCT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPIGCDCT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPIGCDCT"></a>
<p>The Display DBCS Conversion Dictionary (DSPIGCDCT) command displays or prints the alphanumeric entries in the specified double-byte character set (DBCS) conversion dictionary and their related DBCS words. The system refers to the DBCS conversion dictionary when performing DBCS conversion.
</p>
<p>
<b>Note: </b>Use of the DBCS conversion function is not recommended for Chinese and Korean double-byte character sets.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPIGCDCT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPIGCDCT.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="#DSPIGCDCT.IGCDCT"><b>IGCDCT</b></a></td>
<td valign="top">DBCS conversion dictionary</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: DBCS conversion dictionary</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"><a href="#DSPIGCDCT.ENTRY"><b>ENTRY</b></a></td>
<td valign="top">Dictionary entry</td>
<td valign="top">X'40'-X'FE', <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPIGCDCT.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="#DSPIGCDCT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPIGCDCT.IGCDCT"></a>
<h3>DBCS conversion dictionary (IGCDCT)</h3>
<p>Specifies the double-byte character set (DBCS) conversion dictionary displayed or printed and the library in which it is stored. If you do not specify a library name, the first dictionary found when searching your library list is shown.
</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 dictionary. 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 library where the dictionary is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPIGCDCT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPIGCDCT.ENTRY"></a>
<h3>Dictionary entry (ENTRY)</h3>
<p>Specifies the alphanumeric entries displayed or printed with their related double-byte character set (DBCS) words.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>The system displays or prints all of the dictionary entries and their related DBCS words.
</dd>
<dt><b><i>generic*-string</i></b></dt>
<dd>Specify a character string of one or more characters followed by an asterisk (*). The system displays or prints all of the dictionary entries that start with the specified string and their related DBCS words. If you do not include the asterisk, the system displays or prints a specific entry.
<p>The string cannot be longer than 12 characters.
</p>
</dd>
<dt><b><i>specific-string</i></b></dt>
<dd>Specify a character string. The system displays or prints the specified alphanumeric entry and its related DBCS words. The string cannot be longer than 12 characters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPIGCDCT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPIGCDCT.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>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPIGCDCT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPIGCDCT.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Displaying Entries</b>
</p>
<p>
<pre>
DSPIGCDCT IGCDCT(DBCSLIB/QUSRIGCDCT) OUTPUT(*)
</pre>
</p>
<p>This command displays at a work station all entries in the DBCS conversion dictionary named QUSRIGCDCT, that is stored in the library DBCSLIB.
</p>
<p><b>Example 2: Printing Entries</b>
</p>
<p>
<pre>
DSPIGCDCT IGCDCT(DBCSLIB/QUSRIGCDCT) ENTRY('?')
OUTPUT(*PRINT)
</pre>
</p>
<p>This command prints the entry ? and its related words from the DBCS conversion dictionary named QUSRIGCDCT, which is stored in the library DBCSLIB.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPIGCDCT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPIGCDCT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF8138</b></dt>
<dd>&amp;8 damage on DBCS conversion dictionary &amp;4 in &amp;9.
</dd>
<dt><b>CPF8433</b></dt>
<dd>Form length of file &amp;1 in &amp;2 less than five lines.
</dd>
<dt><b>CPF8451</b></dt>
<dd>Entry value &amp;1 not correct.
</dd>
<dt><b>CPF8455</b></dt>
<dd>Work station is not a DBCS device.
</dd>
<dt><b>CPF9801</b></dt>
<dd>Object &amp;2 in library &amp;3 not found.
</dd>
<dt><b>CPF9802</b></dt>
<dd>Not authorized to object &amp;2 in &amp;3.
</dd>
<dt><b>CPF9803</b></dt>
<dd>Cannot allocate object &amp;2 in library &amp;3.
</dd>
<dt><b>CPF9810</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF9820</b></dt>
<dd>Not authorized to use library &amp;1.
</dd>
<dt><b>CPF9845</b></dt>
<dd>Error occurred while opening file &amp;1.
</dd>
<dt><b>CPF9846</b></dt>
<dd>Error while processing file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9847</b></dt>
<dd>Error occurred while closing file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9850</b></dt>
<dd>Override of printer file &amp;1 not allowed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPIGCDCT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>