Remove Font Table Entry (RMVFNTTBLE)

The Remove Font Table Entry (RMVFNTTBLE) command removes an entry in the specified font table. This command removes 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

The entry must have previously been added to the user tables by running the Add Font Table Entry (ADDFNTTBLE) command.

In performing the printer to host and host to printer font mapping (first four tables listed 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.
- 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 or if the entry is not supported by the printer, then the system will use its internal font substitution tables to perform font substitution.

Refer to Printer Device Programming, SC41-5713 for more information on font mapping tables.

Restrictions:

The PSF feature is required to use this command.

Parameters

Keyword	Description	Choices	Notes
FNTTBL	Font table	Single values: PHFCS, HPFCS, PHCP, HPCP Other values: Qualified object name	Required, Positional 1
	Qualifier 1: Font table	Name
	Qualifier 2:	Name, CURLIB, LIBL
PHFCS	Printer font entry	Element list	Optional
	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
PHCP	Printer code page entry	Element list	Optional
	Element 1: Graphic character set	Integer, *SYSVAL
	Element 2: Code page	Integer
HPFCS	Host font entry	Element list	Optional
	Element 1: Font character set	Name
	Element 2: Type	RASTER, OUTLINE
HPCP	Host code page entry	Element list	Optional
HPCP	Element 1: Code page	Name	Optional
PPFCS	Printer to printer font	Element list	Optional
	Element 1: Identifier	1-65535
	Element 2: Point size	1.0-999.9, ALL, NONE

Top

Font table (FNTTBL)

Specifies the font table to be removed.

Single values

*PHFCS: The printer-resident to host-resident font character set table is to be removed.
*PHCP: The printer-resident to host-resident code page mapping table is to be removed.
*HPFCS: The host-resident to printer-resident font character set table is to be removed.
*HPCP: The host-resident to printer-resident code page mapping table is to be removed.

Qualifier 1: Font table

name: Specify the name of the font table to be removed.

Qualifier 2: Library

*LIBL: Search all libraries in the job's library list until the first match is found.
*CURLIB: The current library is used to locate the font table. If no library is specified as the current library for the job, the QGPL library is used.
name: Specify the name of the library where the font table is located.

Printer to host font (PHFCS)

Specifies the printer-resident font entry to be removed.

Element 1: Printer font

Element 1: Identifier

1-65535: Specify the printer-resident font identifier to be mapped to a host-resident font.

Element 2: Width

*NONE: No width is specified for this font identifier. *NONE should be specified when mapping to an outline font.
*PTSIZE: The width for this font identifier will be calculated from the point size specified. When *PTSIZE is specified for width, the point size parameter cannot be *NONE or *WIDTH. When mapping a typographic raster font (2304 - 3839, 4096 - 53247, 61440 - 65534), a point size value should be specified. The width value can be *PTSIZE or a value can be given.
1-32767: Specify a width for the font identifier. When mapping a fixed pitch raster font (1 - 750, 3840 - 4095), a width should be specified. The point size value can be *WIDTH or a value can be given. Refer to Printer Device Programming, SC41-5713 for more information on font widths for printer-resident fonts.

Element 3: Attributes

*NONE: No special font attributes are specified on this font.
*BOLD: The printer-resident font is a bold font.
*ITALIC: The printer-resident font is an italic font.
*BOLDITC: The printer-resident font is a bold italic font.
*DBLWIDE: The printer-resident font is a double wide font.
*ITCDBLWIDE: The printer-resident font is an italic double wide font.

Element 4: Graphic character set

*SYSVAL: The graphic character set specified in the system value QCHRID is used.
graphic-character-identifier: Specify the graphic character set for the font. The graphic character set is the first part of the graphic character identifier which consists of the graphic character set and code page.

Element 5: Point size

*WIDTH: The font point size is computed from the font width value specified. When mapping a fixed pitch raster font (1 - 750, 3840 - 4095), it is recommended that a width value should be specified and the point size value should be *WIDTH.
*NONE: No point size is specified for this font identifier. *NONE should be specified when mapping to an outline font.
1.0-999.9: Specify a point size ranging from 1.0 through 999.9. When mapping a typographic raster font (2304 - 3839, 4096 - 53247, 61440 - 65534), a point size value should be specified.

Printer to host code page (PHCP)

Specifies the printer-resident code page entry to be removed.

Element 1: Printer code page

Element 1: Graphic character set

*SYSVAL: The graphic character set specified in the system value QCHRID is used. A change to this system value will only take effect for the font mapping tables when the print writer is started. If QCHRID is changed and a printer is currently active, you must end the print writer and start it again.
integer-number: Specify the graphic character set for the printer-resident code page. The graphic character set is the first part of the graphic character identifier which consists of the graphic character set and code page. For example, for the graphic character identifier 697 500, 697 is the graphic character set and 500 is the code page. In this example, specify 697 for the graphic character set.

Element 2: Code page

integer-number: Specify the printer-resident code page value.

Printer to printer font (PPFCS)

Specifies the printer-resident font substitution mapping to be removed.

Element 1: From printer font

Element 1: Identifier

1-65535: Specify the printer-resident font identifier for which the substitution printer-resident font is to be changed. Refer to Printer Device Programming, SC41-5713 for more information on printer-resident fonts that are supported, and which ones are scalable (require point size) and which ones are not scalable (specify point size *NONE).

Element 2: Point size

*NONE: No font point size is specified. This should be specified for all non-scalable fonts.
*ALL: Specifies that all point sizes for an outline (scalable) font will be mapped. If the font is not scalable, then this will treated the same as *NONE.
1.0-999.9: Specify a point size ranging from 1.0 through 999.9. When mapping a typographic raster font (2304 - 3839, 4096 - 53247, 61440 - 65534), a point size value should be specified.

Examples

Example 1: Remove Font Entry

RMVFNTTBLE   FNTTBL(*PHFCS)  PHFCS(254 84 *NONE 2039 7.0)

This command removes an entry from the QPHFCS table (printer resident to host-resident font character set table).

Example 2: Remove Code Page Entry

RMVFNTTBLE   FNTTBL(*PHCP)  PHCP(*SYSVAL 38)

This command removes an entry from the QPHCP table (printer resident to host-resident code page table).