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

509 lines
16 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>Remove Font Table Entry (RMVFNTTBLE)</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="RMVFNTTBLE.Top_Of_Page"></a>
<h2>Remove Font Table Entry (RMVFNTTBLE)</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="#RMVFNTTBLE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVFNTTBLE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVFNTTBLE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVFNTTBLE"></a>
<p>The Remove Font Table Entry (RMVFNTTBLE) command removes an entry in the specified font table. This command removes an entry in the user font mapping tables used by Print Services Facility (PSF) that controls:
</p>
<ol>
<li>Host-resident to printer-resident font character set mapping
</li>
<li>Printer-resident to host-resident font character set mapping
</li>
<li>Host-resident to printer-resident code page mapping
</li>
<li>Printer-resident to host-resident code page mapping
</li>
<li>Printer-resident to printer-resident font substitution mapping
</li>
</ol>
<p>The entry must have previously been added to the user tables by running the Add Font Table Entry (ADDFNTTBLE) command.
</p>
<p>In performing the printer to host and host to printer font mapping (first four tables listed above), the user tables are searched first for a match. If no match is found, then the system font or code page tables are searched.
</p>
<p>For the printer-resident to printer-resident font substitution table, the following processing is done by the system:
</p>
<ul>
<li>If the printer-resident font specified in the print job is supported by the printer, then it is used. The printer-resident to printer-resident font substitution table is not searched.
</li>
<li>If the printer-resident font specified in the print job is not supported by the printer, then the printer-resident to printer-resident font substitution table is searched.
<ul>
<li>If a matching entry is found in the printer-resident font substitution table and the entry is supported by the printer, then the specified substitute font in the printer-resident font substitution table is used.
</li>
<li>If a matching entry is not found in the printer-resident font substitution or if the entry is not supported by the printer, then the system will use its internal font substitution tables to perform font substitution.
</li>
</ul>
</li>
</ul>
<p>Refer to Printer Device Programming, SC41-5713 for more information on font mapping tables.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>The PSF feature is required to use this command.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVFNTTBLE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVFNTTBLE.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="#RMVFNTTBLE.FNTTBL"><b>FNTTBL</b></a></td>
<td valign="top">Font table</td>
<td valign="top">Single values: *PHFCS, *HPFCS, *PHCP, *HPCP<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Font table</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: </td>
<td valign="top"><i>Name</i>, *CURLIB, <b><u>*LIBL</u></b></td>
</tr><tr>
<td valign="top" rowspan="6"><a href="#RMVFNTTBLE.PHFCS"><b>PHFCS</b></a></td>
<td valign="top">Printer font entry</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="6">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Identifier</td>
<td valign="top">
1-65535</td>
</tr>
<tr>
<td valign="top">Element 2: Width</td>
<td valign="top">
1-32767, *NONE, *PTSIZE</td>
</tr>
<tr>
<td valign="top">Element 3: Attributes</td>
<td valign="top">
<b><u>*NONE</u></b>, *BOLD, *ITALIC, *BOLDITC, *DBLWIDE, *ITCDBLWIDE</td>
</tr>
<tr>
<td valign="top">Element 4: Graphic character set</td>
<td valign="top">
<i>Integer</i>, <b><u>*SYSVAL</u></b></td>
</tr>
<tr>
<td valign="top">Element 5: Point size</td>
<td valign="top">
1.0-999.9, <b><u>*WIDTH</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#RMVFNTTBLE.PHCP"><b>PHCP</b></a></td>
<td valign="top">Printer code page entry</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Graphic character set</td>
<td valign="top">
<i>Integer</i>, <b><u>*SYSVAL</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Code page</td>
<td valign="top">
<i>Integer</i></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#RMVFNTTBLE.HPFCS"><b>HPFCS</b></a></td>
<td valign="top">Host font entry</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Font character set</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top">Element 2: Type</td>
<td valign="top">
<b><u>*RASTER</u></b>, *OUTLINE</td>
</tr>
<tr>
<td valign="top" rowspan="2"><a href="#RMVFNTTBLE.HPCP"><b>HPCP</b></a></td>
<td valign="top">Host code page entry</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="2">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Code page</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#RMVFNTTBLE.PPFCS"><b>PPFCS</b></a></td>
<td valign="top">Printer to printer font</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Identifier</td>
<td valign="top">
1-65535</td>
</tr>
<tr>
<td valign="top">Element 2: Point size</td>
<td valign="top">
1.0-999.9, *ALL, <b><u>*NONE</u></b></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVFNTTBLE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVFNTTBLE.FNTTBL"></a>
<h3>Font table (FNTTBL)</h3>
<p>Specifies the font table to be removed.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*PHFCS</b></dt>
<dd>The printer-resident to host-resident font character set table is to be removed.
</dd>
<dt><b>*PHCP</b></dt>
<dd>The printer-resident to host-resident code page mapping table is to be removed.
</dd>
<dt><b>*HPFCS</b></dt>
<dd>The host-resident to printer-resident font character set table is to be removed.
</dd>
<dt><b>*HPCP</b></dt>
<dd>The host-resident to printer-resident code page mapping table is to be removed.
</dd>
</dl>
<p><b>Qualifier 1: Font table</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the font table to be removed.
</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>The current library is used to locate the font table. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the font table is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVFNTTBLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVFNTTBLE.PHFCS"></a>
<h3>Printer to host font (PHFCS)</h3>
<p>Specifies the printer-resident font entry to be removed.
</p>
<p><b>Element 1: Printer font</b>
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Identifier</b>
</p>
<dl>
<dt><b><i>1-65535</i></b></dt>
<dd>Specify the printer-resident font identifier to be mapped to a host-resident font.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Width</b>
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No width is specified for this font identifier. *NONE should be specified when mapping to an outline font.
</dd>
<dt><b>*PTSIZE</b></dt>
<dd>The width for this font identifier will be calculated from the point size specified. When *PTSIZE is specified for width, the point size parameter cannot be *NONE or *WIDTH. When mapping a typographic raster font (2304 - 3839, 4096 - 53247, 61440 - 65534), a point size value should be specified. The width value can be *PTSIZE or a value can be given.
</dd>
<dt><b><i>1-32767</i></b></dt>
<dd>Specify a width for the font identifier. When mapping a fixed pitch raster font (1 - 750, 3840 - 4095), a width should be specified. The point size value can be *WIDTH or a value can be given. Refer to Printer Device Programming, SC41-5713 for more information on font widths for printer-resident fonts.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 3: Attributes</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No special font attributes are specified on this font.
</dd>
<dt><b>*BOLD</b></dt>
<dd>The printer-resident font is a bold font.
</dd>
<dt><b>*ITALIC</b></dt>
<dd>The printer-resident font is an italic font.
</dd>
<dt><b>*BOLDITC</b></dt>
<dd>The printer-resident font is a bold italic font.
</dd>
<dt><b>*DBLWIDE</b></dt>
<dd>The printer-resident font is a double wide font.
</dd>
<dt><b>*ITCDBLWIDE</b></dt>
<dd>The printer-resident font is an italic double wide font.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 4: Graphic character set</b>
</p>
<dl>
<dt><b><u>*SYSVAL</u></b></dt>
<dd>The graphic character set specified in the system value QCHRID is used.
</dd>
<dt><b><i>graphic-character-identifier</i></b></dt>
<dd>Specify the graphic character set for the font. The graphic character set is the first part of the graphic character identifier which consists of the graphic character set and code page.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 5: Point size</b>
</p>
<dl>
<dt><b><u>*WIDTH</u></b></dt>
<dd>The font point size is computed from the font width value specified. When mapping a fixed pitch raster font (1 - 750, 3840 - 4095), it is recommended that a width value should be specified and the point size value should be *WIDTH.
</dd>
<dt><b>*NONE</b></dt>
<dd>No point size is specified for this font identifier. *NONE should be specified when mapping to an outline font.
</dd>
<dt><b><i>1.0-999.9</i></b></dt>
<dd>Specify a point size ranging from 1.0 through 999.9. When mapping a typographic raster font (2304 - 3839, 4096 - 53247, 61440 - 65534), a point size value should be specified.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVFNTTBLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVFNTTBLE.PHCP"></a>
<h3>Printer to host code page (PHCP)</h3>
<p>Specifies the printer-resident code page entry to be removed.
</p>
<p><b>Element 1: Printer code page</b>
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Graphic character set</b>
</p>
<dl>
<dt><b>*SYSVAL</b></dt>
<dd>The graphic character set specified in the system value QCHRID is used. A change to this system value will only take effect for the font mapping tables when the print writer is started. If QCHRID is changed and a printer is currently active, you must end the print writer and start it again.
</dd>
<dt><b><i>integer-number</i></b></dt>
<dd>Specify the graphic character set for the printer-resident code page. The graphic character set is the first part of the graphic character identifier which consists of the graphic character set and code page. For example, for the graphic character identifier 697 500, 697 is the graphic character set and 500 is the code page. In this example, specify 697 for the graphic character set.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Code page</b>
</p>
<dl>
<dt><b><i>integer-number</i></b></dt>
<dd>Specify the printer-resident code page value.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVFNTTBLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVFNTTBLE.HPFCS"></a>
<h3>Host to printer font (HPFCS)</h3>
<p>Specifies the host-resident font entry to be removed.
</p>
<p><b>Element 1: Host font</b>
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Font character set</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the font character set.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Type</b>
</p>
<dl>
<dt><b><u>*RASTER</u></b></dt>
<dd>The host-resident font is a raster font.
</dd>
<dt><b>*OUTLINE</b></dt>
<dd>The host-resident font is an outline font.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVFNTTBLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVFNTTBLE.HPCP"></a>
<h3>Host to printer code page (HPCP)</h3>
<p>Specifies the host-resident code page entry to be removed.
</p>
<p><b>Element 1: Host code page</b>
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Code page</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the host-resident code page.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVFNTTBLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVFNTTBLE.PPFCS"></a>
<h3>Printer to printer font (PPFCS)</h3>
<p>Specifies the printer-resident font substitution mapping to be removed.
</p>
<p><b>Element 1: From printer font</b>
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Identifier</b>
</p>
<dl>
<dt><b><i>1-65535</i></b></dt>
<dd>Specify the printer-resident font identifier for which the substitution printer-resident font is to be changed. Refer to Printer Device Programming, SC41-5713 for more information on printer-resident fonts that are supported, and which ones are scalable (require point size) and which ones are not scalable (specify point size *NONE).
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Point size</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No font point size is specified. This should be specified for all non-scalable fonts.
</dd>
<dt><b>*ALL</b></dt>
<dd>Specifies that all point sizes for an outline (scalable) font will be mapped. If the font is not scalable, then this will treated the same as *NONE.
</dd>
<dt><b><i>1.0-999.9</i></b></dt>
<dd>Specify a point size ranging from 1.0 through 999.9. When mapping a typographic raster font (2304 - 3839, 4096 - 53247, 61440 - 65534), a point size value should be specified.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVFNTTBLE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVFNTTBLE.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Remove Font Entry</b>
</p>
<p>
<pre>
RMVFNTTBLE FNTTBL(*PHFCS) PHFCS(254 84 *NONE 2039 7.0)
</pre>
</p>
<p>This command removes an entry from the QPHFCS table (printer resident to host-resident font character set table).
</p>
<p><b>Example 2: Remove Code Page Entry</b>
</p>
<p>
<pre>
RMVFNTTBLE FNTTBL(*PHCP) PHCP(*SYSVAL 38)
</pre>
</p>
<p>This command removes an entry from the QPHCP table (printer resident to host-resident code page table).
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVFNTTBLE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVFNTTBLE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2182</b></dt>
<dd>Not authorized to library &amp;1.
</dd>
<dt><b>CPF2283</b></dt>
<dd>Authorization list &amp;1 does not exist.
</dd>
<dt><b>CPF88D2</b></dt>
<dd>Font table &amp;1 in library &amp;2 not changed.
</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>CPF9822</b></dt>
<dd>Not authorized to file &amp;1 in library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVFNTTBLE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>