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

145 lines
9.1 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<?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="IGCCDEFNT (DBCS Coded Font) keyword" />
<meta name="abstract" content="Use this record- or field-level keyword to specify the DBCS-coded font for printing a named or constant field or fields." />
<meta name="description" content="Use this record- or field-level keyword to specify the DBCS-coded font for printing a named or constant field or fields." />
<meta name="DC.subject" content="IGCCDEFNT (DBCS Coded Font) keyword, DBCS Coded Font (IGCCDEFNT) keyword" />
<meta name="keywords" content="IGCCDEFNT (DBCS Coded Font) keyword, DBCS Coded Font (IGCCDEFNT) keyword" />
<meta name="DC.Relation" scheme="URI" content="prtkwd.htm" />
<meta name="DC.Relation" scheme="URI" content="prtkwd.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakdmstprkey.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakdmstptigcan.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="rzakdmstigcfont" />
<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>IGCCDEFNT (DBCS Coded Font) keyword</title>
</head>
<body id="rzakdmstigcfont"><a name="rzakdmstigcfont"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">IGCCDEFNT (DBCS Coded Font) keyword</h1>
<div><p>Use this record- or field-level keyword to specify the DBCS-coded
font for printing a named or constant field or fields.</p>
<div class="section"><p>The format of this keyword is:</p>
<pre>IGCCDEFNT([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>
<p>The
coded-font parameter is required and must be the name of an <span class="keyword"><font color="Purple">i5/OS™</font></span> DBCS-coded font. It can be up to 8 characters
long.</p>
<p>Use the optional library-name parameter to further qualify the
coded-font. If you do not specify the library name, *LIBL is used to search
for the coded font at print time. If *LIBL is used, the system-supplied font
libraries are added to the library list when searching for the requested font.
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>
<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 code:</p>
<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>
<p>When you specify the library-name as a program-to-system field, the
field must exist in the same record format as the IGCCDEFNT 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 IGCCDEFNT keyword. It must be defined
as length of 8, data type A (character), and usage P (program-to-system).</p>
<p>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>
<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 DBCS coded font that specifies a point size.
Specify the point-size parameter as an expression in 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 code:</p>
<ul><li><samp class="codeph">[(*POINTSIZE height-value &amp;field1)]</samp></li>
<li><samp class="codeph">[(*POINTSIZE &amp;field2 width-value)]</samp></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 IGCCDEFNT 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 DBCS 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 DBCS 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 coded font value is validated at print time. An error
message is issued if the value is not valid, or when the resource cannot be
located.</p>
<p>Specify DEVTYPE(*AFPDS) on the CRTPRTF command when you have
specified IGCCDEFNT in the file. If you change the DEVTYPE parameter to anything
other than the *AFPDS value, the keyword is ignored, and a warning message
is issued at print time.</p>
<div class="note"><span class="notetitle">Note:</span> Feature PSF is required to use this keyword.
If PSF is not installed, you will not be able to print files that use this
keyword or specify DEVTYPE(*AFPDS).</div>
<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 IGCCDEFNT keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A*
A R REC
A FLD1 24O 2 14IGCCDEFNT(XOG16B)
A FLD2 24O 3 14IGCCDEFNT(USERLIB/XOG16C +
A (*POINTSIZE 10.0))</pre>
<p>FLD1
in REC specifies coded font XOG16B. *LIBL is used to locate the DBCS resource.
FLD2 specifies DBCS font XOG16C from library USERLIB. FLD2 will be printed
with a point size of 10.0.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="prtkwd.htm" title="Do not use these keywords with DBCS (double-byte character set) data fields (the data type specified in position 35 is O or G).">Keyword considerations for printer files that use double-byte character set</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><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 class="relref"><strong>Related reference</strong><br />
<div><a href="prtkwd.htm" title="Do not use these keywords with DBCS (double-byte character set) data fields (the data type specified in position 35 is O or G).">Keyword considerations for printer files that use double-byte character set</a></div>
<div><a href="rzakdmstptigcan.htm" title="Use this field-level keyword to convert alphanumeric characters to equivalent DBCS characters (Japanese only).">IGCANKCNV (Alphanumeric-to-DBCS Conversion) keyword</a></div>
</div>
</div>
</body>
</html>