CL Command Reference - ADDFNTTBLE
CL Command List > ADDFNTTBLE Reference
Description:
The Add Font Table Entry (ADDFNTTBLE) command adds an entry in the specified font mapping table. This command adds an entry in the user font mapping tables used by Print Services Facility (PSF) that controls:
. Host-resident to printer-resident font character set mapping
. Printer-resident to host-resident font character set mapping
. Host-resident to printer-resident code page mapping
. Printer-resident to host-resident code page mapping
. Printer-resident to printer-resident font substitution mapping
To override a mapping entry in the system font or code page mapping tables, add the new mapping entry to a user table. Mapping entries added to a user table override any corresponding entries in the system tables.
When performing the printer to host and host to printer font mapping (first four tables above), PSF first searches the user tables for a match. If no match is found in the user mapping tables, PSF searches the appropriate system tables.
Restrictions:
. The PSF feature is required to use this command.
Examples:
Example 1: Override Existing Font Entry in system table
This command adds an entry to the QPHFCS table (printer-resident to host-resident font character set table). To override the mapping of an existing entry in the system printer-resident to host resident font character set table, you need to add a corresponding entry in the QPHFCS table. Following are the recommended steps to change the mapping of an entry in the system tables.
. Use the DSPFNTTBL command (DSPFNTTBL FNTTBL(*SYSPHFCS) OUTPUT(*PRINT)) to print the entries in the system font mapping table.
. Find the entry you want to change, and add an entry to the corresponding user font mapping table. In the above example, font identifier 254, width of 84, and point size 7.0 is to be added to the user font table (QPHFCS). The width of 84 and point size of 7.0 is were chosen based on an entry in the system table. The entry has no special attributes (*NONE) and graphic character set identifier 2039 will be used.
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: Override Existing Font Symbol Entry in system table
ADDFNTTBLE FNTTBL(*PHFCS)
PHFCS((254 84 *NONE 1275 7.0) (C0SYMBOL *RASTER))
This command adds an entry to 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, to override an existing entry in the system printer-resident to host-resident font character set table, you need to add a corresponding entry in the QPHFCS table.
Use the DSPFNTTBL command to display the system font mapping table and find the entry you want to change. In this example, you want to add an entry that maps a printer-resident to host resident font character set for the special symbol code page (259). As in the previous example, font identifier 254, width of 84, and point size 7.0 is to be added to 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 (500) and graphic set (697) is used by the application. The second entry will be used when a print application specifies special symbols (340 259).
Example 3: Add Font Entry that does not exist in system table
ADDFNTTBLE FNTTBL(*PHFCS)
PHFCS((65500 *PTSIZE *NONE *SYSVAL 7.0)
(C0NEWFNT *RASTER))
This command adds an entry to the QPHFCS table (printer-resident to host-resident font character set table) that does not exist in the system printer-resident to host-resident font character set table.
When adding entries that do not exist in the system printer resident to host-resident font character set table, it is recommended that you specify a specific value for font width or point size, but not both. For fixed pitch fonts, you should specify a font width and *WIDTH for point size. For typographic fonts, you should specify a point size and *PTSIZE for font width. In this example, a typographic font of 65500 with point size 7.0 is added to the printer-resident to host-resident font character set table (QPHFCS).
Example 4: Override Existing Code Page Entry in system table
ADDFNTTBLE FNTTBL(*PHCP) PHCP((*SYSVAL 38) (T1V00038))
This command adds an entry to the QPHCP table (printer-resident to host-resident code page table). To override an existing entry in the system printer-resident to host-resident code page table, you need to add a corresponding entry in the QPHCP table. Following are the recommended steps to change the mapping of an entry in the system tables.
. Use the DSPFNTTBL command (For example, DSPFNTTBL FNTTBL(*SYSPHCP) OUTPUT(*PRINT)) to print the entries in the system code page table.
. Find the entry you want to change, and add an entry into the corresponding user code page table. In the above example, code page 38 is to be added to the user code page table (QPHCP).
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.