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:
- *USE authority to the CPYIGCTBL, CRTPF, CHKIN and CHKOUT commands.
- *USE authority to the DBCS font table.
- *X authority to directories in the PCF file path name prefix.
- *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 |
| Top |