ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakd_5.4.0.1/rzakdmsttpptfntch.htm

164 lines
9.7 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="FNTCHRSET (Font Character Set) keyword in printer files" />
<meta name="abstract" content="Use this file-level, record-level, or field-level keyword to specify the font for printing a named or constant field within a record." />
<meta name="description" content="Use this file-level, record-level, or field-level keyword to specify the font for printing a named or constant field within a record." />
<meta name="DC.subject" content="FNTCHRSET (Font Character Set) keyword, Font Character Set (FNTCHRSET) keyword" />
<meta name="keywords" content="FNTCHRSET (Font Character Set) keyword, Font Character Set (FNTCHRSET) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakdmstprkey.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzakdmsttpptfntch" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>FNTCHRSET (Font Character Set) keyword in printer files</title>
</head>
<body id="rzakdmsttpptfntch"><a name="rzakdmsttpptfntch"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">FNTCHRSET (Font Character Set) keyword in printer files</h1>
<div><p>Use this file-level, record-level, or field-level keyword to specify
the font for printing a named or constant field within a record.</p>
<div class="section"><p>The format of the keyword is:</p>
<pre> FNTCHRSET([library-name/ | &amp;library-name-field/]
font-character-set | &amp;font-character-set-field
[library-name/ | &amp;library-name-field/]
code-page | &amp;code-page-field
[(*POINTSIZE height-value | &amp;height-value-field
width-value | &amp;width-value-field)])</pre>
<p>When a program-to-system field is described below for a FNTCHRSET
parameter, the program-to-system field is allowed only when the keyword is
used at the record or field level.</p>
<p>The font-character-set
and code-page parameters are required. Both can be up to eight characters
long.</p>
<p>Use the optional library-name parameter to further qualify the
font character set or code page. If library-name is not specified, *LIBL is
used to search for the font character set and code page. If *LIBL is used,
the system-supplied font libraries are added to the library list when searching
for the requested font. To view the IBM-supplied font character set names
or code page names, you can use the Work with Font Resources (WRKFNTRSC) command
and specify font character sets or code pages. The IBM-supplied font character
set names all start with the characters C0 and the IBM-supplied code page
names all start with T1.</p>
<p>You can specify the library-name and font-character-set
as constants, as program-to-system fields, or as a combination of both, as
shown in the following examples:</p>
<ul><li><samp class="codeph">[library-name/]font-character-set...</samp></li>
<li><samp class="codeph">[library-name/]&amp;field1</samp></li>
<li><samp class="codeph">[&amp;field2/]font-character-set...</samp></li>
</ul>
<p>When you specify the library-name as a program-to-system field, the
field must exist in the same record format as the FNTCHRSET keyword. It must
be defined as length of 10, data type A (character), and usage P (program-to-system).</p>
<p>When
you specify the font-character-set as a program-to-system field, the field
must exist in the same record format as the FNTCHRSET keyword. It must be
defined as length of 8, data type A (character), and usage P (program-to-system).</p>
<p>You
can specify the library-name and code-page as constants, as program-to-system
fields, or as a combination of both, as shown in the following examples:</p>
<ul><li><samp class="codeph">[library-name/]code-page...</samp></li>
<li><samp class="codeph">[library-name/]&amp;field1</samp></li>
<li><samp class="codeph">[&amp;field2/]code-page...</samp></li>
</ul>
<p>When you specify the library-name as a program-to-system field, the
field must exist in the same record format as the FNTCHRSET keyword. It must
be defined as length of 10, data type A (character), and usage P (program-to-system).</p>
<p>When
you specify the code-page as a program-to-system field, the field must exist
in the same record format as the FNTCHRSET keyword. It must be defined as
length of 8, data type A (character), and usage P (program-to-system).</p>
<div class="note"><span class="notetitle">Note:</span> If an application uses private resources (for example, fonts,
page segments, overlays, or GDF files not distributed with the system), be
aware of the following information. When referencing these resources, if you
specify *LIBL or you do not specify a library name, the resources must be
available through the library list used by the application creating the spooled
file.</div>
<p>Use the optional point-size parameter to further define a numeric
font that specifies a point size. Specify the point-size parameter as an expression
of the following form:</p>
<pre>(*POINTSIZE height-value width-value)</pre>
<p>The
height-value specifies the point size for the height of the font. The width-value
specifies the point size for the width of the font. If the font is to be uniformly
scaled (where the height and width are the same), then you can specify only
the height-value. You cannot specify the width-value without the height-value.
The valid values for this parameter are 0.1 through 999.9.</p>
<p>You can specify
the point-size height and point-size width as constants, as program-to-system
fields, or as a combination of both, as shown in the following examples:</p>
<ul><li>[(*POINTSIZE height-value &amp;field1)]</li>
<li>[(*POINTSIZE &amp;field2 width-value)]</li>
</ul>
<p>When you specify the point-size height-value or width-value as a program-to-system
field, the fields must exist in the same record format as the FNTCHRSET keyword.
They must be defined as length 4 with 1 decimal position, data type S, and
usage P (program-to-system).</p>
<div class="note"><span class="notetitle">Notes:</span> <ol><li>For raster fonts, Print Services Facility™ (PSF) ignores
the point size. PSF does not do any validation at spool intercept time, and
it does not issue any error messages.</li>
<li>If you do not specify a point size for an outline font, then PSF cannot
print the spooled file. The spooled file is held at print writer time. PSF
does not do any validation at spool intercept time.</li>
</ol>
</div>
<p>The font character set and code page values are validated
at print time. An error message is issued if they are not valid.</p>
<div class="note"><span class="notetitle">Note:</span> When
a printer file is created and a character set and code page are specified
for the font character set (FNTCHRSET) parameter, column spacing is done using
this printer file-level parameter. Any fonts or code pages specified in the
FNTCHRSET keyword are ignored and the font and code page specified in the
printer file parameter FNTCHRSET is used.</div>
<p>Specify DEVTYPE(*AFPDS)
on the CRTPRTF command when FNTCHRSET is specified in the file. If DEVTYPE
is changed to anything other than *AFPDS, the keyword is ignored and a warning
message is issued at print time.</p>
<p>FNTCHRSET cannot be specified at the
same level as the FONT and CDEFNT keywords.</p>
<p>Option indicators are valid
for this keyword.</p>
</div>
<div class="section"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the FNTCHRSET keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A*
A R REC1
A FLD1A 14A 3 8FNTCHRSET(C0S0CE12 T1L0PCHN)
A*
A FLD2A 10A 5 8FNTCHRSET(USERLIB/FNTCHR +
A USERLIB/CODEPG1 +
A (*POINTSIZE 99.9))
A*
A FLD3A 10A 5 8FNTCHRSET(FNTCHR CODEPG1 +
A (*POINTSIZE 5.0 3.0))</pre>
<p>FLD1A
specifies font character set C0S0CE12 and code page T1L0PCHN. *LIBL is used
to search for the font character set and code page. FLD2A specifies the font
character set FNTCHR, which exists in library USERLIB, and code page CODEPG1,
which exists in library USERLIB. FLD2A prints with a point size of 99.9. FLD3A
specifies font character set FNTCHR and code page CODEPG1, with a vertical
point size of 5.0 and a horizontal point size of 3.0.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakdmstprkey.htm" title="See the valid keyword entries for defining printer files in this topic.">Keyword entries for printer files (positions 45 through 80)</a></div>
</div>
</div>
</body>
</html>