CPYFRMPCFF (Copy From PCF File)

CPYFRMPCFF Command syntax diagram

 

Purpose

The Copy From Portable Compiled Format File (CPYFRMPCFF) command copies all user-defined DBCS character fonts contained in a Portable Compiled Format (PCF) file to a double-byte character set (DBCS) font table. During the copy operation, a dot matrix conversion is automatically performed. The following table lists the supported dot matrix conversions.

Table 1. Supported dot matrix conversion

From DBCS font table To PCF file
24-by-24 16-by-16
24-by-24 24-by-24
24-by-24 32-by-32
24-by-24 48-by-48
32-by-32 16-by-16
32-by-32 24-by-24
32-by-32 32-by-32
32-by-32 48-by-48

There are differences in the number of supported user-defined DBCS characters between a DBCS font table and PCF file. The following table lists the maximum number of user-defined DBCS character fonts that can be copied for each type of DBCS font table.

Table 2. Maximum number of user-defined DBCS character fonts

DBCS font table Maximum number First DBCS code Last DBCS code
Japanese 1880 6941 72EA
Korean 1880 D441 DDEA
Traditional Chinese 2660 D041 DDFE
Simplified Chinese 1880 7641 7FEA

Restrictions: You must have the following authority:

  1. *USE authority to the CPYIGCTBL and CRTPF command.
  2. *CHANGE authority to the DBCS font table.
  3. *RX authority to directories in the PCF file path name prefixes.
  4. *RX authority to directories in the PCF file's parent path name prefix.
  5. *R authority to the PCF file.

 

Required Parameters

FROMPCFF
Specifies the path name of the PCF file from which user-defined DBCS character fonts are copied. The PCF file is a stream file object, and it must be an user-defined character set with UCS-2 encoding. See path names for more information on specifying path names.

path-name: Specify the path name of the PCF file.

TOIGCTBL
Specifies the name of the DBCS font table to which user-defined DBCS character fonts are copied. Choose one of the following table names:

QIGC2424: The Japanese DBCS font table used for displaying and printing extension characters in a 24-by-24 dot matrix font.

QIGC2424C: The Traditional Chinese DBCS font table used for printing extension characters in a 24-by-24 dot matrix font.

QIGC2424K: The Korean DBCS font table used for printing extension characters in a 24-by-24 dot matrix font.

QIGC2424S: The Simplified Chinese DBCS font table used for printing extension characters in a 24-by-24 dot matrix font.

QIGC3232: The Japanese DBCS font table used for displaying and printing extension characters in a 32-by-32 dot matrix font.

QIGC3232S: The Simplified Chinese DBCS font table used for printing extension characters in a 32-by-32 dot matrix font.

QIGCrrccl: The name of the DBCS font table to be copied must always be in the format QIGCrrccl, where rr is the table row matrix size, cc is the table column matrix size, and the letter l is an optional language identifier.

 

Optional Parameters

RPLFNT
Specifies whether user-defined DBCS character fonts in the specified DBCS font table are replaced with those from the specified PCF file.

*NO: The system does not replace user-defined DBCS character fonts in the DBCS font table with those from the specified PCF file.

*YES: The system replaces user-defined DBCS character fonts in the DBCS font table with those from the specified PCF file.

Examples for CPYFRMPCFF

Example 1: Copying Without Replacing Existing Fonts

CPYFRMPCFF
  '/QIBM/ProdData/NetworkStation/fonts/pcf/IBM_JPN17.pcf'
  TOIGCTBL(QIGC2424)
  RPLFNT(*NO)

This command copies all user-defined DBCS character fonts contained in the Japanese PCF file named IBM_JPN17.pcf (24-by-24 dot matrix font) in directory /QIBM/ProdData/NetworkStation/fonts/pcf to the Japanese DBCS font table QIGC2424 (24-by-24 dot matrix font). Only user-defined DBCS character fonts that are not found in the DBCS font table are copied.

Example 2: Copying User-Defined DBCS Character Fonts From DBCS Font Table to PCF File Replacing Existing Fonts

CPYFRMPCFF
  '/QIBM/ProdData/NetworkStation/fonts/pcf/Chtpc17.pcf'
  TOIGCTBL(QIGC2424C)
  RPLFNT(*YES)

This command copies all user-defined DBCS character fonts contained in the Traditional Chinese PCF file named Chtpc17.pcf (24-by-24 dot matrix font) in directory /QIBM/ProdData/NetworkStation/fonts/pcf to the Traditional Chinese DBCS font table QIGC2424C (24-by-24 dot matrix). User-defined DBCS character fonts in the DBCS font table are replaced with those found in the PCF file.

Error messages for CPYFRMPCFF

*ESCAPE Messages

None.