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

217 lines
8.8 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>Change Coded Font (CHGCDEFNT)</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="CHGCDEFNT.Top_Of_Page"></a>
<h2>Change Coded Font (CHGCDEFNT)</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="#CHGCDEFNT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGCDEFNT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGCDEFNT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGCDEFNT"></a>
<p>The Change Coded Font (CHGCDEFNT) command allows the user to mark font character set and code page pairs referenced in the coded font as resident in the printer. Refer to Printer Device Programming, SC41-5713 for information on marking font character set and code pages as resident in the 3130 printer.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>The Print Services Facility (PSF) feature is required to use this command.
</li>
<li>Font character set and code page pairs that are marked as resident will be downloaded to printers that do not support resident DBCS raster fonts.
</li>
<li>When marking fonts, the print writer must be stopped and re-started If fonts are marked while the writer is active, the changes may not take effect until the next time the writer is started. To be guaranteed that PSF uses the changed coded font, you must first end the print writer.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCDEFNT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCDEFNT.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="#CHGCDEFNT.CDEFNT"><b>CDEFNT</b></a></td>
<td valign="top">Coded font</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: Coded font</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="#CHGCDEFNT.FNTCHRSET"><b>FNTCHRSET</b></a></td>
<td valign="top">Font character set</td>
<td valign="top"><i>Generic name, name</i>, *ALL</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCDEFNT.RESFNT"><b>RESFNT</b></a></td>
<td valign="top">Resident font</td>
<td valign="top">*YES, <b><u>*NO</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGCDEFNT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGCDEFNT.CDEFNT"></a>
<h3>Coded font (CDEFNT)</h3>
<p>Specifies the coded font to be marked.
</p>
<p><b>Qualifier 1: Coded font</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the coded font to be marked.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>Search all libraries in the job's library list until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>Search only the current library for the job. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Search the specified library.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCDEFNT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCDEFNT.FNTCHRSET"></a>
<h3>Font character set (FNTCHRSET)</h3>
<p>Specifies which font character set or sets within the specified coded font are to be marked as resident or not resident.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Specifies that all font character sets referenced in the coded font are to be marked.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the font character sets to be marked. A generic name is a character string of one or more characters followed by an asterisk (*); for example, C0S0*. The asterisk substitutes for any valid characters. A generic name specifies all font character sets with names that begin with the generic prefix. If an asterisk is not included in the name, the system assumes it to be the complete font character set name. To change all the font character sets in a certain range, for example C0G16F70 - C0G16F7F, you should specify C0G16F7* for the font character set name. Specifying C0G16F* would be the same as *ALL and change all the font character sets in the coded font (assuming all font character set names started with C0G16F0).
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the font character set to be marked.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCDEFNT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCDEFNT.RESFNT"></a>
<h3>Resident font (RESFNT)</h3>
<p>Specifies whether the font character set is resident in the printer or if it is not resident in the printer and needs to be downloaded by the system.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The font character set is not resident in the printer and needs to be downloaded by the system to the printer. Also, the font character set may be resident in the printer, but has been modified by the user. In that case, *NO should be specified.
</dd>
<dt><b>*YES</b></dt>
<dd>The font character set is resident in the printer and does not need to be downloaded by the system to the printer.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCDEFNT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCDEFNT.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Mark All as Being Resident</b>
</p>
<p>
<pre>
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(*ALL) RESFNT(*YES)
</pre>
</p>
<p>This command marks all the font character set/code page pairs as resident in the printer for coded font X0G16F in library QFNT61. No user defined sections will be downloaded.
</p>
<p><b>Example 2: Mark Sections as Resident</b>
</p>
<p>
<pre>
CHGCDEFNT QFNT61/X0G16B FNTCHRSET(C0G16F4*) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16B FNTCHRSET(C0G16F50) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16B FNTCHRSET(C0G16F51) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16B FNTCHRSET(C0G16F52) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16B FNTCHRSET(C0G16F53) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16B FNTCHRSET(C0G16F54) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16B FNTCHRSET(C0G16F55) RESFNT(*YES)
</pre>
</p>
<p>This set of CHGCDEFNT commands marks all the font character set/code page pairs in sections 41 - 4F as resident and then marks sections 50 - 55 as resident.
</p>
<p><b>Example 3: Mark Generic and Specific Font Character Set and Code Page Pairs</b>
</p>
<p>
<pre>
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(C0G16F4*) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(C0G16F48) RESFNT(*NO)
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(C0G16F5*) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(C0G16F60) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(C0G16F61) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(C0G16F62) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(C0G16F63) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(C0G16F64) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(C0G16F65) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(C0G16F66) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(C0G16F67) RESFNT(*YES)
CHGCDEFNT QFNT61/X0G16F FNTCHRSET(C0G16F68) RESFNT(*YES)
</pre>
</p>
<p>This set of CHGCDEFNT commands marks all the font character set and code page pairs in sections 41 - 4F as resident; then marks section 48 to be downloaded. Sections 50 - 5F are marked as resident and sections 60 - 68 are marked as resident.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCDEFNT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCDEFNT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>PQT0100</b></dt>
<dd>Coded font &amp;1 in library &amp;2 not changed.
</dd>
<dt><b>PQT0101</b></dt>
<dd>Font character set or code page &amp;1 not found in coded font &amp;2.
</dd>
<dt><b>PQT0102</b></dt>
<dd>Invalid value &amp;1 specified for resident font parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCDEFNT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>