Change Coded Font (CHGCDEFNT)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Change Coded Font (CHGCDEFNT) command allows the user to mark font character set and code page pairs referenced in the coded font as resident in the printer. Refer to Printer Device Programming, SC41-5713 for information on marking font character set and code pages as resident in the 3130 printer.

Restrictions:

Top

Parameters

Keyword Description Choices Notes
CDEFNT Coded font Qualified object name Required, Positional 1
Qualifier 1: Coded font Name
Qualifier 2: Library Name, *LIBL, *CURLIB
FNTCHRSET Font character set Generic name, name, *ALL Required, Positional 2
RESFNT Resident font *YES, *NO Optional
Top

Coded font (CDEFNT)

Specifies the coded font to be marked.

Qualifier 1: Coded font

name
Specify the name of the coded font to be marked.

Qualifier 2: Library

*LIBL
Search all libraries in the job's library list until the first match is found.
*CURLIB
Search only the current library for the job. If no library is specified as the current library for the job, QGPL is used.
name
Search the specified library.
Top

Font character set (FNTCHRSET)

Specifies which font character set or sets within the specified coded font are to be marked as resident or not resident.

*ALL
Specifies that all font character sets referenced in the coded font are to be marked.
generic-name
Specify the generic name of the font character sets to be marked. A generic name is a character string of one or more characters followed by an asterisk (*); for example, C0S0*. The asterisk substitutes for any valid characters. A generic name specifies all font character sets with names that begin with the generic prefix. If an asterisk is not included in the name, the system assumes it to be the complete font character set name. To change all the font character sets in a certain range, for example C0G16F70 - C0G16F7F, you should specify C0G16F7* for the font character set name. Specifying C0G16F* would be the same as *ALL and change all the font character sets in the coded font (assuming all font character set names started with C0G16F0).
name
Specify the name of the font character set to be marked.
Top

Resident font (RESFNT)

Specifies whether the font character set is resident in the printer or if it is not resident in the printer and needs to be downloaded by the system.

*NO
The font character set is not resident in the printer and needs to be downloaded by the system to the printer. Also, the font character set may be resident in the printer, but has been modified by the user. In that case, *NO should be specified.
*YES
The font character set is resident in the printer and does not need to be downloaded by the system to the printer.
Top

Examples

Example 1: Mark All as Being Resident

CHGCDEFNT   QFNT61/X0G16F FNTCHRSET(*ALL)  RESFNT(*YES)

This command marks all the font character set/code page pairs as resident in the printer for coded font X0G16F in library QFNT61. No user defined sections will be downloaded.

Example 2: Mark Sections as Resident

CHGCDEFNT   QFNT61/X0G16B  FNTCHRSET(C0G16F4*)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16B  FNTCHRSET(C0G16F50)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16B  FNTCHRSET(C0G16F51)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16B  FNTCHRSET(C0G16F52)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16B  FNTCHRSET(C0G16F53)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16B  FNTCHRSET(C0G16F54)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16B  FNTCHRSET(C0G16F55)  RESFNT(*YES)

This set of CHGCDEFNT commands marks all the font character set/code page pairs in sections 41 - 4F as resident and then marks sections 50 - 55 as resident.

Example 3: Mark Generic and Specific Font Character Set and Code Page Pairs

CHGCDEFNT   QFNT61/X0G16F  FNTCHRSET(C0G16F4*)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16F  FNTCHRSET(C0G16F48)  RESFNT(*NO)
CHGCDEFNT   QFNT61/X0G16F  FNTCHRSET(C0G16F5*)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16F  FNTCHRSET(C0G16F60)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16F  FNTCHRSET(C0G16F61)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16F  FNTCHRSET(C0G16F62)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16F  FNTCHRSET(C0G16F63)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16F  FNTCHRSET(C0G16F64)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16F  FNTCHRSET(C0G16F65)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16F  FNTCHRSET(C0G16F66)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16F  FNTCHRSET(C0G16F67)  RESFNT(*YES)
CHGCDEFNT   QFNT61/X0G16F  FNTCHRSET(C0G16F68)  RESFNT(*YES)

This set of CHGCDEFNT commands marks all the font character set and code page pairs in sections 41 - 4F as resident; then marks section 48 to be downloaded. Sections 50 - 5F are marked as resident and sections 60 - 68 are marked as resident.

Top

Error messages

*ESCAPE Messages

PQT0100
Coded font &1 in library &2 not changed.
PQT0101
Font character set or code page &1 not found in coded font &2.
PQT0102
Invalid value &1 specified for resident font parameter.
Top