CL Command Reference - CHGFNTTBLE
CL Command List > CHGFNTTBLE Reference
Description:
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:
1. Host-resident to printer-resident font character set mapping
2. Printer-resident to host-resident font character set mapping
3. Host-resident to printer-resident code page mapping
4. Printer-resident to host-resident code page mapping
5. Printer-resident to printer-resident font substitution mapping
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:
. If the printer-resident font specified in the print job is supported by the printer, then it is used. The printer-resident to printer-resident font substitution table is not searched.
. If the printer-resident font specified in the print job is not supported by the printer, then the printer-resident to printer-resident font substitution table is searched.
¨C If a matching entry is found in the printer-resident font substitution table and the entry is supported by the printer, then the specified substitute font in the printer-resident font substitution table is used.
- If a matching entry is not found in the printer-resident font substitution table or if the specified substitute font is not supported by the printer, then the system will use its internal font substitution tables to perform the font substitution.
Restrictions:
. The PSF feature is required to use this command.
Examples:
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.