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

134 lines
8.4 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="concept" />
<meta name="DC.Title" content="CDEFNT (Coded Font Name) keyword in printer files" />
<meta name="abstract" content="Use this field- or record-level keyword to specify the coded font for printing a named or constant field or fields within a record." />
<meta name="description" content="Use this field- or record-level keyword to specify the coded font for printing a named or constant field or fields within a record." />
<meta name="DC.subject" content="CDEFNT (Coded Font Name) keyword, Coded Font Name (CDEFNT) keyword" />
<meta name="keywords" content="CDEFNT (Coded Font Name) keyword, Coded Font Name (CDEFNT) 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="rzakdmstptcdefn" />
<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>CDEFNT (Coded Font Name) keyword in printer files</title>
</head>
<body id="rzakdmstptcdefn"><a name="rzakdmstptcdefn"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">CDEFNT (Coded Font Name) keyword in printer files</h1>
<div><p>Use this field- or record-level keyword to specify the coded font
for printing a named or constant field or fields within a record.</p>
<div class="p">The format of the keyword is: <pre> CDEFNT([library-name/ | &amp;library-name-field/]
coded-font-name | &amp;coded-font-name-field
[(*POINTSIZE height-value | &amp;height-value-field
width-value | &amp;width-value-field)])</pre>
</div>
<p>The coded-font-name parameter is required and can be up to 8 characters
in length.</p>
<p>Use the optional library-name parameter to further qualify the coded font
name. If you do not specify a library name, *LIBL is used to search for the
coded font name at print time. 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 coded font names, you can use the Work with Font
Resources (WRKFNTRSC) command and specify coded fonts. The IBM-supplied coded
font names all start with the characters X0.</p>
<p>Using the library-name parameter allows the coded font name to be located
more rapidly. However, the library list is still used to locate the character
set and code page defined by the coded font name.</p>
<div class="p">You can specify the library-name and coded-font-name as
constants, as program-to-system fields, or as a combination of both, as shown
in the following examples: <ul><li><samp class="codeph">[library-name/]coded-font-name...</samp></li>
<li><samp class="codeph">[library-name/]&amp;field1...</samp></li>
<li><samp class="codeph">[&amp;field2/]coded-font-name...</samp></li>
</ul>
</div>
<p>When you specify the library-name as a program-to-system field, the field
must exist in the same record format as the CDEFNT 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 coded-font-name as a program-to-system field, the
field must exist in the same record format as the CDEFNT 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>
<div class="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
in the following form: <pre>(*POINTSIZE height-value width-value)</pre>
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.</div>
<div class="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: <ul><li><samp class="codeph">[(*POINTSIZE height-value &amp;field1)]</samp></li>
<li><samp class="codeph">[(*POINTSIZE &amp;field2 width-value)]</samp></li>
</ul>
</div>
<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 CDEFNT 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>You must specify a point size for outline coded fonts. However, some outline
coded fonts have a default point size specified with them. If you do not specify
a point size for these coded fonts, then the default point size specified
with the coded font is used. <p>If you do not specify a point size for an
outline coded font that does not contain a default point size, 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.</p>
</li>
</ol>
</div>
<p>The coded font value is validated at print time. An error message is issued
if it is not valid or when the resource cannot be located.</p>
<p>Specify DEVTYPE(*AFPDS) on the CRTPRTF command when CDEFNT 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>CDEFNT cannot be specified at the same level as the FONT or FNTCHRSET keywords.</p>
<p>Option indicators are valid for this keyword.</p>
<div class="section"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the CDEFNT keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A*
A R REC1
A FLD1 8A 10 13CDEFNT(QFNTCPL/X0BRTR)
A*
A FLD2 10A 11 13CDEFNT(QFNTCPL/X0BRTP +
A (*POINTSIZE 10.1))
A FLD3 10A 20 13CDEFNT(QFNTCPL/X0BRTP +
A (*POINTSIZE 5.0 3.0))</pre>
<p>FLD1
specifies coded font X0BRTR, which is found in library QFNTCPL. FLD2 specifies
font X0BRTP from library QFNTCPL and a point size of 10.1 for that field.
FLD3 specifies font X0BRTP 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>