Copy To PCF File (CPYTOPCFF)

Where allowed to run: All environments (*ALL)
Threadsafe: No 		Parameters
Examples
Error messages

The Copy to Portable Compiled Format font file (CPYTOPCFF) command copies all of user-defined DBCS character fonts contained in a double-byte character set (DBCS) font table to an existing PCF font file. During the copy operation, a dot matrix conversion is automatically performed. See the description for the Copy From PCF File (CPYFRMPCFF) command for a table that lists the supported dot matrix conversions. There is also a table that lists the maximum number of user-defined DBCS character fonts that can be copied for each type of DBCS font table.

Restrictions: You must have the following authority:

  1. *USE authority to the CPYIGCTBL, CRTPF, CHKIN and CHKOUT commands.
  2. *USE authority to the DBCS font table.
  3. *X authority to directories in the PCF file path name prefix.
  4. *RW authority to the PCF font file.
Top

Parameters

Keyword Description Choices Notes
FROMIGCTBL From DBCS font table QIGC2424, QIGC2424K, QIGC2424C, QIGC2424S, QIGC3232, QIGC3232S Required, Positional 1
TOPCFF To PCF file Path name Required, Positional 2
RPLFNT Replace font *NO, *YES Optional
Top

From DBCS font table (FROMIGCTBL)

Specifies the name of the DBCS font table from which all user-defined DBCS character fonts are copied.

This is a required parameter.

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.
Top

To PCF file (TOPCFF)

Specifies the path name of the PCF file to which user-defined character fonts are copied. The PCF file and all directories in the path name must exist. The PCF file is a stream file object, and it must be a user-defined character set with UCS-2 encoding.

This is a required parameter.

Top

Replace font (RPLFNT)

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

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

Examples

Example 1: Copying Without Replacing Existing Fonts 

CPYTOPCFF  QIGC2424
         '/QIBM/ProdData/NetworkStation/fonts/pcf/IBM_JPN12.pcf'
           RPLFNT(*NO)

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

Example 2: Copying Replacing Existing Fonts 

CPYTOPCFF  QIGC2424C
           '/QIBM/ProdData/NetworkStation/fonts/pcf/Chtpc23.pcf'
           RPLFNT(*YES)

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

Top

Error messages

*ESCAPE Messages

CPFB7A7
&1 command ended due to error.
Top