CPYIGCTBL (Copy DBCS Font Table)

CPYIGCTBL Command syntax diagram

 

Purpose

The Copy DBCS Font Table (CPYIGCTBL) command copies part or all of a double-byte character set (DBCS) font table to tape, diskette, or physical file; or from tape, diskette, or physical file into the font table. Copying a DBCS font table from tape, diskette, or physical file into a font table also puts its definition in the system. DBCS font tables are objects and can be saved and restored.

DBCS font tables contain the images in a given dot matrix of the DBCS extension characters used on the system. The system refers to the tables when printing and displaying these characters. There are separate tables for each character image matrix used by devices attached to the system.

Restriction: A physical file used to save and restore table information must have a minimum record length of 74 bytes.

 

Required Parameters

IGCTBL
Specifies the name of the DBCS font table being 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 image.

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

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

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

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

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

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.

OPTION
Specifies how to copy the DBCS font tables: either from the system to diskette, tape, or physical file; or from diskette, tape, or physical file into the system.

*OUT: The specified DBCS font table is copied to diskette, tape, or physical file.

*IN: The specified DBCS font table is copied from diskette, tape, or physical file to the system.

DEV
Specifies whether a device (tape or diskette) or a physical file is used to save or restore tables.

*FILE: Specifies that the DBCS font table is saved to, or restored from, a physical file.

device-name: Specifies the name of the tape or diskette device that the table is saved to, or restored from. The device name must already be known on the system by a device description.

LABEL
Specifies the object that identifies the data file on diskette or tape that contains the DBCS font table. When copying the table into the system, the label identifies the file that exists on diskette or tape. When copying the table to diskette or tape, the label identifies the file that is created on diskette or tape.

*IGCTBL: Identifies the data file on diskette or tape that contains the DBCS font table. It is the same as the name specified on the IGCTBL parameter without the first character.

data-file-identifier: Specify the identifier (8 characters maximum for diskette and 17 maximum for tape, starting with an alphabetic character) of the data file that is used with this DBCS font table.

 

Optional Parameters

SELECT
Specifies which portion of the DBCS font table is to be copied.

*ALL: All IBM-supplied and user-defined DBCS characters are copied.

*SYS: Only IBM-supplied DBCS characters are copied.

*USER: Only user-defined DBCS characters are copied.

*RANGE: Only user-defined DBCS characters that fall in the range specified on the RANGE parameter are copied.

RANGE
Specifies the range of user-defined characters to be copied. Specify this value only when choosing SELECT(*RANGE).

The DBCS codes and numbers that can be specified for range values are listed in tables at the end of this parameter description. Tables are provided for the Japanese, Korean, traditional Chinese, and simplified Chinese languages.

Element 1: Starting Character to be Copied

The first of two values specified with the RANGE parameter specifies the first character to be copied. Specify one of the following values:

*FIRST: The system starts copying with the first user-defined DBCS character in the table.

from-user-character: The system starts copying with the specified DBCS code or number. Specify the 4-character DBCS code, or the 5-character DBCS number.

Element 2: Ending Character to be Copied

The last of two values specified with the RANGE parameter specifies the last character to be copied. Specify one of the following values:

*LAST: The system stops copying with the last user-defined character found.

to-user-character: The system stops copying with the specified DBCS code or number. Specify the 4-character DBCS code, or the 5-character DBCS number.

Following are tables that list the valid codes and numbers to specify for starting and ending values of user-defined character ranges.

Table 1. Japanese DBCS Codes for User-Defined Characters (RANGE parameter)

6941 - 69FE 6A41 - 6AFE 6B41 - 6BFE
6C41 - 6CFE 6D41 - 6DFE 6E41 - 6EFE
6F41 - 6FFE 7041 - 70FE 7141 - 71FE
7241 - 72FE 7341 - 73FE 7441 - 74FE
7541 - 75FE 7641 - 76FE 7741 - 77FE
7841 - 78FE 7941 - 79FE 7A41 - 7AFE
7B41 - 7BFE 7C41 - 7CFE 7D41 - 7DFE
7E41 - 7EFE 7F41 - 7FFE  

Table 2. Japanese DBCS Numbers for User-Defined Characters (RANGE Parameter)

10561 through 10750 10817 through 11006
11073 through 11262 11329 through 11518
11585 through 11774 11841 through 12030
12097 through 12286 12353 through 12542
12609 through 12798 12865 through 13054
13121 through 13310 13377 through 13566
13633 through 13822 13889 through 14078
14145 through 14334 14401 through 14590
14657 through 14846 14913 through 15102
15169 through 15358 15425 through 15614
15681 through 15870 15937 through 16126
16193 through 16382  

Table 3. Korean DBCS Codes for User-Defined Characters (RANGE Parameter)

D441 - D4FE D541 - D5FE D641 - D6FE
D741 - D7FE D841 - D8FE D941 - D9FE
DA41 - DAFE DB41 - DBFE DC41 - DCFE
DD41 - DDFE    

Table 4. Korean DBCS Numbers for User-Defined Characters (RANGE Parameter)

37953 through 38142 38209 through 38393
38465 through 38654 38721 through 38910
38977 through 39166 39233 through 39422
39489 through 39678 39745 through 39934
40001 through 40190 40257 through 40446

Table 5. Traditional Chinese DBCS Codes for User-Defined Characters (RANGE Parameter)

D041 - D0FE D141 - D1FE D241 - D2FE
D341 - D3FE D441 - D4FE D541 - D5FE
D641 - D6FE D741 - D7FE D841 - D8FE
D941 - D9FE DA41 - DAFE DB41 - DBFE
DC41 - DCFE DD41 - DDFE  

Table 6. Traditional Chinese DBCS Numbers for User-Defined Characters (RANGE Parameter)

36929 through 37118 37185 through 37374
37441 through 37630 37697 through 37886
37953 through 38142 38209 through 38398
38465 through 38654 38721 through 38910
38977 through 39166 39233 through 39422
39489 through 39678 39745 through 39934
40001 through 40190 40257 through 40446

Table 7. Simplified Chinese DBCS Codes for User-Defined Characters (RANGE Parameter)

7641 - 76FE 7741 - 77FE
7841 - 78FE 7941 - 79FE
7A41 - 7AFE 7B41 - 7BFE
7C41 - 7CFE 7D41 - 7DFE
7E41 - 7EFE 7F41 - 7FFE

Table 8. Simplified Chinese DBCS Numbers for User-Defined Characters (RANGE Parameter)

13889 through 14078 14145 through 14334
14401 through 14590 14657 through 14846
14913 through 15102 15169 through 15358
15425 through 15614 15681 through 15870
15937 through 16126 16193 through 16382

RPLIMG
Specifies whether user-defined DBCS characters in the specified table are replaced with those found on tape or diskette. Specify this value only when choosing OPTION(*IN).

*NO: The system does not replace user-defined DBCS characters in the table stored in the system with those found on tape or diskette.

*YES: The system replaces user-defined DBCS characters in the table stored in the system with those found on tape or diskette.

VOL
Specifies one or more volume identifiers used by the file. More information on this parameter is in Commonly used parameters.

*MOUNTED: The volume currently placed in the device is used.

volume-identifier: Specify the identifiers of one or more diskettes or tapes in the order in which they are placed in a tape or diskette drive and used in the copy operation.

EXPDATE
Specifies, when OPTION(*OUT) is indicated, the end date of the file on diskette or tape that contains the DBCS font table. If a date is specified, the file is protected and cannot be written over until the day after the specified end date.

*PERM: The data file is permanently protected. An expiration date of 999999 is assigned.

expiration-date: Specify the expiration date after which the data file is no longer protected. The date must be specified in the format defined by the system values QDATFMT and, if separators are used, QDATSEP. However, the specified date is put in the diskette or tape label as yymmdd, where yy is the year, mm is the month, and dd is the day.

SEQNBR
Specifies (only when tape is used) which sequence number is used as the starting point for the copy process. This value is valid only if the parameter OPTION(*OUT) is specified.

Note: This value is valid only if *OUT is specified on the OPTION parameter.

*END: The system saves the table after the last sequence number on the tape.

*SEARCH: The volume that is in the tape or diskette unit is searched for a data file with an identifier that compares with the LABEL parameter value; when a match is found, the table is restored. If the last operation on the device specifies ENDOPT(*LEAVE) (the tape is positioned at the location at which the last operation ended), the file search starts with the first data file beyond the current tape position. If ENDOPT(*LEAVE) was not used for the last operation (or if the tape was manually rewound since an ENDOPT(*LEAVE) operation), the search starts with the first data file on the volume. This value is valid only if the parameter OPTION(*IN) is specified.

file-sequence-number: Specify the sequence number of the file that is used. Valid values range from 1 through 9999.

ENDOPT
Specifies the operation that is automatically performed on the tape volume after the operation ends. If more than one volume is included, this parameter applies only to the last tape volume used; all other tape volumes are rewound and unloaded when the end of the tape is reached.

*REWIND: The tape is automatically rewound, but not unloaded, after the operation has ended.

*LEAVE: The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.

*UNLOAD: The tape is automatically rewound and unloaded after the operation ends.

FILE
Specifies the name of the existing physical file that contains the DBCS font table.

The name of the physical file can be qualified by the following library value:

library-name: Specify the name of the library to be used.

physical-file-name: Specify the name of the physical file.

MBR
Specifies the name of the existing physical file member that the table is saved to, or restored from.

Example for CPYIGCTBL 

CPYIGCTBL  IGCTBL(QIGC2424)  OPTION(*OUT)  LABEL(*IGCTBL)
  DEV(QDKT)

This command causes the system to copy the complete Japanese DBCS font table QIGC2424 from the system to the diskette. The name of the label on the diskette is IGC2424.

Additional Considerations

Consider the following before entering this command:

Error messages for CPYIGCTBL

*ESCAPE Messages

CPF8181
DBCS font table &4 damaged.
CPF8416
DBCS font table &1 not updated and no images copied.
CPF8417
Error found in RANGE keyword.
CPF8418
Data file &2 cannot be used to copy DBCS font table &1.
CPF8419
DBCS font table &1 not created and no images copied.
CPF8420
CPYIGCTBL command ended due to error.
CPF8421
DBCS font table &1 not found.
CPF8422
Not able to use DBCS font table &1.
CPF8423
Error found in keyword IGCTBL.
CPF8426
Device &1 either not found, or not valid for command.
CPF8427
DBCS font table &1 not migrated.