Work with conversion dictionaries

Create a DBCS conversion dictionary

To create a DBCS conversion dictionary, follow these steps:

1. Use the Create DBCS Conversion Dictionary (CRTIGCDCT) command.
2. Name the dictionary, QUSRIGCDCT, so it can be used during DBCS conversion. The system uses the dictionary if it is the first user-created dictionary found when searching a user's library list.

   You might call the dictionary by another name while it is being created to prevent application programs from using it for conversion. Later, change the dictionary name using the Rename Object (RNMOBJ) command.

3. Use the EDTIGCDCT command to put entries and related words into the dictionary after creating it.

Edit a DBCS conversion dictionary

Use the Edit DBCS conversion dictionary (EDTIGCDCT) command to edit the DBCS conversion dictionary. Use editing to add user-defined characters to the dictionary, so that users can enter characters using DBCS conversion, and rearrange terms in a DBCS conversion dictionary to suit individual needs.

The display needed for use while editing the DBCS conversion dictionary depends on the value that you entered for the ENTRY parameter on the EDTIGCDCT command:

• If you specified a specific string with the ENTRY parameter or if you want to display double-byte characters, you must use a DBCS display.
• If you did not specify a specific string with the ENTRY parameter, or if you do not want to display double-byte characters, use either a DBCS display, or a 24-row by 80-column alphanumeric display.

You can perform the following editing operations on a user-created DBCS conversion dictionary:

• Add entries to the dictionary (including adding the first entries to the dictionary after it is created). The dictionary can contain as many as 99 999 entries.
• Delete entries from the dictionary.
• Change entries in the dictionary, such as replacing the DBCS words related to an alphanumeric entry.
• Move the DBCS words related to an alphanumeric entry to rearrange the order in which they appear during DBCS conversion.

The only editing function that you can perform with QSYSIGCDCT, the system-supplied dictionary, is to move DBCS words related to an alphanumeric entry. Move words in order to rearrange the order in which they appear during DBCS conversion.

Display and print the DBCS conversion dictionary

Use the Display DBCS Conversion Dictionary (DSPIGCDCT) command to display and print the DBCS conversion dictionary. You can display or print the entire dictionary or just a certain part of it, depending on the value you specify for the ENTRY parameter.

For example, to print the entry ABC from the dictionary QUSRIGCDCT and its related words, enter:

DSPIGCDCT IGCDCT(DBCSLIB/QUSRIGCDCT)  +
ENTRY(ABC) OUTPUT(*PRINT)

To display all of the entries from the system-supplied dictionary QSYSIGCDCT and their related words, enter:

DSPIGCDCT IGCDCT(QSYS/QSYSIGCDCT)

Delete a DBCS conversion dictionary

Use the Delete DBCS Conversion Dictionary (DLTIGCDCT) command to delete a DBCS conversion dictionary from the system. In order to delete the dictionary, you must have object existence authority to the dictionary and object operational authorities to the library in which the dictionary is stored.

When you delete a dictionary, make sure that you specify the correct library name. It is possible that many users have their own dictionaries, each named QUSRIGCDCT, stored in their libraries. If you do not specify any library name, the system deletes the first DBCS conversion dictionary in your library list.