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

259 lines
12 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>Create Font Table (CRTFNTTBL)</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="CRTFNTTBL.Top_Of_Page"></a>
<h2>Create Font Table (CRTFNTTBL)</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="#CRTFNTTBL.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTFNTTBL.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTFNTTBL.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTFNTTBL"></a>
<p>The Create Font Table (CRTFNTTBL) command allows the user to create a font mapping table to be used by Print Services Facility (PSF). These tables allow the user to change, add, and remove entries in a font table 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>In performing the printer to host and host to printer font mapping (first four tables 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 table or if the specified substitute font is not supported by the printer, then the system will use its internal font substitution tables to perform the 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="#CRTFNTTBL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTFNTTBL.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="#CRTFNTTBL.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: Library</td>
<td valign="top"><i>Name</i>, <b><u>*CURLIB</u></b></td>
</tr><tr>
<td valign="top"><a href="#CRTFNTTBL.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTFNTTBL.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *CHANGE, *ALL, *USE, *EXCLUDE</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTFNTTBL.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTFNTTBL.FNTTBL"></a>
<h3>Font table (FNTTBL)</h3>
<p>Specifies the name of the font table to be created. Only one font mapping table can be created on the system for each of the single values allowed for this parameter. When one of these values is specified, a font mapping table is created in library QUSRSYS with one of the following names:
</p>
<p>
<pre>
Single value Font table
------------ ----------
*PHFCS QPHFCS
*PHCP QPHCP
*HPFCS QHPFCS
*HPCP QHPCP
</pre>
</p>
<p>You can also create a printer-resident to printer-resident font substitution table. Multiple printer-resident to printer-resident font substitution tables can be created on the system.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*PHFCS</b></dt>
<dd>The printer-resident to host-resident font character set mapping table is created. When this table is created, it will be named QPHFCS and will be created in library QUSRSYS. This table would be used when your application references printer-resident fonts and the printer, such as the 3827, 3825, 3820, 3900 Model 1, does not support resident fonts. Print Services Facility (PSF) must map the references from printer-resident fonts to host-resident fonts and download them.
</dd>
<dt><b>*PHCP</b></dt>
<dd>The printer-resident to host-resident code page mapping table is created. When this table is created, it will be named QPHCP and will be created in library QUSRSYS. This table is like the QPHFCS table, in that it is used when the application references printer-resident code pages and the printer being used does not support printer-resident code pages. The printer-resident code page must be mapped to a host-resident code page and downloaded to the printer by PSF.
</dd>
<dt><b>*HPFCS</b></dt>
<dd>The host-resident to printer-resident font character set mapping table is created. When this table is created, it will be named QHPFCS and will be created in library QUSRSYS. This table is used when your application references host-resident fonts (font character sets and code pages) and the printer, such as the 4224, 4234, 4230, 64XX, does not support downloading of host-resident fonts. PSF must map the references from host-resident fonts to printer-resident fonts.
</dd>
<dt><b>*HPCP</b></dt>
<dd>The host-resident to printer-resident code page mapping table is created. When this table is created, it will be named QHPCP and will be created in library QUSRSYS. This table is like the QHPFCS table, in that it is used when the application references host-resident code pages and the printer being used does not support host-resident code pages. The host-resident code page must be mapped to a printer-resident code page and downloaded to the printer by PSF.
</dd>
</dl>
<p><b>Qualifier 1: Font table</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the printer-resident to printer-resident font substitution table to be created.
<p>The name of the font table must be specified when a printer-resident to printer-resident font substitution table is created. This printer-resident font substitution table should be used when all three of the following conditions exist:
</p>
<ul>
<li>You are printing to a PSF attached printer.
</li>
<li>Your application specifies a printer-resident font which is not supported by the printer you are using.
</li>
<li>You want to specify a different substitute printer-resident font than the one selected by the system.
</li>
</ul>
<p>To use a printer-resident to printer-resident font substitution table with a particular PSF printer, you need to specify the name of the font table on the FNTTBL parameter of the Create PSF Configuration (CRTPSFCFG) or Change PSF Configuration (CHGPSFCFG) command.
</p>
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*CURLIB</u></b></dt>
<dd>The current library is used to store 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 you want to store the font table.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTFNTTBL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTFNTTBL.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the font table.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>No text is specified.
</dd>
<dt><b><i>'character-value'</i></b></dt>
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTFNTTBL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTFNTTBL.AUT"></a>
<h3>Authority (AUT)</h3>
<p>Specifies the authority you are giving to users who do not have specific authority to the object, who are not on an authorization list, and whose group profile has no specific authority to the object.
</p>
<dl>
<dt><b><u>*LIBCRTAUT</u></b></dt>
<dd>The system determines the authority for the object by using the value specified for the CRTAUT parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified on the CRTAUT parameter is changed, the new value will not affect any existing objects.
</dd>
<dt><b>*CHANGE</b></dt>
<dd>Change authority allows the user to change and perform basic functions on the object. Change authority provides object operational authority and all data authorities.
</dd>
<dt><b>*ALL</b></dt>
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, perform basic functions on the object, and change ownership of the object.
</dd>
<dt><b>*USE</b></dt>
<dd>Use authority provides object operational authority, read authority, and execute authority.
</dd>
<dt><b>*EXCLUDE</b></dt>
<dd>The user cannot access the object.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTFNTTBL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTFNTTBL.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTFNTTBL FNTTBL(*PHFCS)
TEXT('Printer to Host Font Mapping Table')
</pre>
</p>
<p>This command creates a Printer to Host Font Mapping Table. The table will be named QPHFCS and created into library QUSRSYS. The table is created with no entries. Entries can be added or changed by running the Add Font Table Entry (ADDFNTTBLE) and Change Font Table Entry (CHGFNTTBLE) commands.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTFNTTBL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTFNTTBL.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2283</b></dt>
<dd>Authorization list &amp;1 does not exist.
</dd>
<dt><b>PQT0121</b></dt>
<dd>Font table &amp;1 not created in library &amp;2.
</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>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTFNTTBL.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>