IGCCDEFNT (DBCS Coded Font) keyword

Use this record- or field-level keyword to specify the DBCS-coded font for printing a named or constant field or fields.

The format of this keyword is:

IGCCDEFNT([library-name/ | &library-name-field/]
      coded-font-name | &coded-font-name-field
      [(*POINTSIZE height-value | &height-value-field
      width-value | &width-value-field)])

The coded-font parameter is required and must be the name of an i5/OS™ DBCS-coded font. It can be up to 8 characters long.

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.

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:

[library-name/]coded-font-name...
[library-name/]&field1...
[&field2/]coded-font-name...

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).

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).

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.

Note: 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.

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:

(*POINTSIZE height-value width-value)

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.

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:

[(*POINTSIZE height-value &field1)]
[(*POINTSIZE &field2 width-value)]

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).

Notes:

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.
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.

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.

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.

Note: 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).

Option indicators are valid for this keyword.

Example

The following example shows how to specify the IGCCDEFNT keyword.

|...+....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))

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.