| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Font Table Entry (CHGFNTTBLE) command changes an entry in the specified font table. This command changes an exiting entry in the user font or code page tables used by Print Services Facility (PSF) that controls:
The entry must have first been added to the user tables with the ADDFNTTBLE (Add Font Table Entry) command.
In performing the printer to host and host to printer font mapping (first four tables above), the user tables are searched first for a match. If no match is found, then the system font or code page tables are searched.
For the printer-resident to printer-resident font substitution table, the following processing is done by the system:
Refer to Printer Device Programming, SC41-5713 for more information on font mapping tables.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FNTTBL | Font table | Single values: *PHFCS, *HPFCS, *PHCP, *HPCP Other values: Qualified object name |
Optional, Positional 1 |
| Qualifier 1: Font table | Name | ||
| Qualifier 2: Library | Name, *CURLIB, *LIBL | ||
| PHFCS | Printer to host font | Element list | Optional |
| Element 1: Printer font | Element list | ||
| Element 1: Identifier | 1-65535 | ||
| Element 2: Width | 1-32767, *NONE, *PTSIZE | ||
| Element 3: Attributes | *NONE, *BOLD, *ITALIC, *BOLDITC, *DBLWIDE, *ITCDBLWIDE | ||
| Element 4: Graphic character set | Integer, *SYSVAL | ||
| Element 5: Point size | 1.0-999.9, *WIDTH, *NONE | ||
| Element 2: Host font | Element list | ||
| Element 1: Font character set | Name, *SAME | ||
| Element 2: Type | *SAME, *RASTER, *OUTLINE | ||
| PHCP | Printer to host code page | Element list | Optional |
| Element 1: Printer code page | Element list | ||
| Element 1: Graphic character set | Integer, *SYSVAL | ||
| Element 2: Code page | Integer | ||
| Element 2: Host code page | Element list | ||
| Element 1: Code page | Name, *SAME | ||
| HPFCS | Host to printer font | Element list | Optional |
| Element 1: Host font | Element list | ||
| Element 1: Font character set | Name | ||
| Element 2: Type | *RASTER, *OUTLINE | ||
| Element 2: Printer font | Element list | ||
| Element 1: Identifier | 1-65535, *SAME, *NONE | ||
| Element 2: Width | 1-32767, *SAME, *NONE, *PTSIZE | ||
| Element 3: Attributes | *SAME, *NONE, *BOLD, *ITALIC, *BOLDITC, *DBLWIDE, *ITCDBLWIDE | ||
| Element 4: Graphic character set | Integer, *SAME, *SYSVAL | ||
| Element 5: Point size | 1.0-999.9, *SAME, *WIDTH, *NONE | ||
| HPCP | Host to printer code page | Element list | Optional |
| Element 1: Host code page | Element list | ||
| Element 1: Code page | Name | ||
| Element 2: Printer code page | Element list | ||
| Element 1: Graphic character set | Integer, *SYSVAL, *SAME | ||
| Element 2: Code page | Integer, *SAME | ||
| PPFCS | Printer to printer font | Element list | Optional |
| Element 1: From printer font | Element list | ||
| Element 1: Identifier | 1-65535 | ||
| Element 2: Point size | 1.0-999.9, *ALL, *NONE | ||
| Element 2: To printer font | Element list | ||
| Element 1: Identifier | 1-65535, *SAME | ||
| Element 2: Point size | 1.0-999.9, *ALL, *NONE, *SAME |
| Top |
Specifies the name of the font table to be changed.
This is a required parameter.
Single values
This table would be used when your application, such as DDS, references printer-resident fonts and the printer does not support resident fonts. Examples of printers which do not support resident fonts are 3827, 3825, 3820, and the 3900 Model 1. Print Services Facility (PSF) must map the references from printer-resident fonts to host-resident fonts and download them.
This table is like the QPHFCS table, in that it is used when the application references printer-resident code pages and the printer being used does not support printer-resident code pages. The printer resident code page must be mapped to a host-resident code page and downloaded to the printer by PSF.
This table is used when your application references host-resident fonts (font character sets and code pages) and the printer, such as the 4224, 4234, 4230, and 64XX, does not support downloading of host-resident fonts. PSF must map the references from host-resident fonts to printer-resident fonts.
This table is like the QHPFCS table, in that it is used when the application references host-resident code pages and the printer being used does not support host-resident code pages. The host resident code page must be mapped to a printer-resident code page and downloaded to the printer by PSF.
Qualifier 1: Font table
To use a printer-resident to printer-resident font substitution table with a particular PSF printer, you need to specify the name of the font table on the FNTTBL parameter of the Create PSF Configuration (CRTPSFCFG) or Change PSF Configuration (CHGPSFCFG) command.
Qualifier 2: Library
| Top |
Specifies the printer-resident to host-resident font character set mapping. The printer-resident font, along with its specified attributes will be mapped to a host-resident font character set.
Element 1: Printer font
Element 1: Identifier
Element 2: Width
Element 3: Attributes
Element 4: Graphic character set
Element 5: Point size
Element 2: Host font
Element 1: Font character set
Element 2: Type
| Top |
Specifies the printer-resident to host-resident code page mapping. The printer-resident host code page will be mapped to a host-resident code page.
Element 1: Printer code page
Element 1: Graphic character set
Element 2: Code page
Element 2: Host code page
Element 1: Code page
| Top |
Specifies the host-resident to printer-resident font character set mapping. The host-resident font, along with its specified attributes will be mapped to a printer-resident font.
Element 1: Host font
Element 1: Font character set
Element 2: Type
Element 2: Printer font
Element 1: Identifier
Element 2: Width
Element 3: Attributes
Element 4: Graphic character set
Element 5: Point size
| Top |
Maps a host-resident code page to a printer-resident code page. The host-resident code page will be mapped to a printer-resident code page.
Element 1: Host code page
Element 1: Code page
Element 2: Printer code page
Element 1: Graphic character set
Element 2: Code page
| Top |
Specifies the printer-resident font substitution mapping. When a printer-resident font is not supported by a printer, you can specify the substitute printer-resident font to be used instead of the substitute printer-resident font selected by the system. Caution should be used when doing the following types of mapping as undesirable results may occur.
Element 1: From printer font
Element 1: Identifier
Element 2: Point size
Element 2: To printer font
Element 1: Identifier
Element 2: Point size
| Top |
Example 1: Changing Font Entry
CHGFNTTBLE FNTTBL(*PHFCS)
PHFCS((254 84 *NONE 2039 7.0) (C0D0GT18 *RASTER))
This command changes an entry in the QPHFCS table (printer resident to host-resident font character set table). The entry must have been already added to the table using the ADDFNTTBLE (Add Font Table Entry) command. In this example, font identifier 254, width of 84, and point size 7.0 is to be changed in the user font table (QPHFCS). The entry has no special attributes (*NONE) and graphic character set 2039 is used.
In performing the font mapping, the attributes of the resident font specified in the print application are compared to those in the font table QPHFCS. If a match is found, then the specified host resident font (C0D0GT18) is downloaded to the printer. If no match is found, then the system printer-resident to host-resident font character set table is searched.
Note that the print application may specify the normal graphic character set (for example, 697 in 697 500 specified in QCHRID system value). The 697 is mapped to 2039 and will result in a match for this entry.
Example 2: Changing Font Symbol Entry
CHGFNTTBLE FNTTBL(*PHFCS)
PHFCS((254 84 *NONE 1275 7.0) (C0SYMBOL *RASTER))
This command changes an entry in the QPHFCS table (printer resident to host-resident font character set table) for use when using the special symbols code page (code page 259). As specified in Example 1, the entry must have already been added using the ADDFNTTBLE (Add Font Table Entry) command. As in the previous example, font identifier 254, width of 84, and point size 7.0 is to be changed in the user font table (QPHFCS). The width of 84 and point size of 7.0 is gotten from the system table. The entry has no special attributes (*NONE) and graphic character set 1275 is used.
We now have two entries in the printer-resident to host-resident font character set table. Both entries have the same font identifier, width, and point size. The first entry will be used when the standard code page and graphic set is used by the application (697 500 in this example). The second entry will be used when a print application specifies special symbols (340 259).
Example 3: Change Code Page Entry
CHGFNTTBLE FNTTBL(*PHCP) PHCP((*SYSVAL 38) (T1V00038))
This command changes an entry in the QPHCP table (printer resident to host-resident code page table). In the above example, the mapping for code page 38 is changed.
In performing the font mapping, the attributes of the resident code page specified in the print application are compared to those in the code page table (QPHCP). If a match is found, then the specified host-resident code page (T1V00038) is downloaded to the printer. If no match is found, then the system printer-resident to host-resident code page table is searched.
| Top |
*ESCAPE Messages
| Top |