Display DBCS Conversion Dict (DSPIGCDCT)

Where allowed to run: All environments (*ALL)
Threadsafe: No

The Display DBCS Conversion Dictionary (DSPIGCDCT) command displays or prints the alphanumeric entries in the specified double-byte character set (DBCS) conversion dictionary and their related DBCS words. The system refers to the DBCS conversion dictionary when performing DBCS conversion.

Note: Use of the DBCS conversion function is not recommended for Chinese and Korean double-byte character sets.

Top

Parameters

Keyword	Description	Choices	Notes
IGCDCT	DBCS conversion dictionary	Qualified object name	Required, Positional 1
	Qualifier 1: DBCS conversion dictionary	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
ENTRY	Dictionary entry	X'40'-X'FE', *ALL	Optional
OUTPUT	Output	, PRINT	Optional

Top

DBCS conversion dictionary (IGCDCT)

Specifies the double-byte character set (DBCS) conversion dictionary displayed or printed and the library in which it is stored. If you do not specify a library name, the first dictionary found when searching your library list is shown.

The possible library values are:

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library for the job is used to locate the dictionary. If no library is specified as the current library for the job, QGPL is used.
library-name: Specify the library where the dictionary is located.

Top

Dictionary entry (ENTRY)

Specifies the alphanumeric entries displayed or printed with their related double-byte character set (DBCS) words.

*ALL: The system displays or prints all of the dictionary entries and their related DBCS words.
generic*-string: Specify a character string of one or more characters followed by an asterisk (*). The system displays or prints all of the dictionary entries that start with the specified string and their related DBCS words. If you do not include the asterisk, the system displays or prints a specific entry.
The string cannot be longer than 12 characters.
specific-string: Specify a character string. The system displays or prints the specified alphanumeric entry and its related DBCS words. The string cannot be longer than 12 characters.

Top

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*: The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).

*PRINT: The output is printed with the job's spooled output.

Top

Examples

Example 1: Displaying Entries

DSPIGCDCT   IGCDCT(DBCSLIB/QUSRIGCDCT)  OUTPUT(*)

This command displays at a work station all entries in the DBCS conversion dictionary named QUSRIGCDCT, that is stored in the library DBCSLIB.

Example 2: Printing Entries

DSPIGCDCT   IGCDCT(DBCSLIB/QUSRIGCDCT)  ENTRY('?')
            OUTPUT(*PRINT)

This command prints the entry ? and its related words from the DBCS conversion dictionary named QUSRIGCDCT, which is stored in the library DBCSLIB.

Top

Error messages

*ESCAPE Messages

CPF8138: &8 damage on DBCS conversion dictionary &4 in &9.
CPF8433: Form length of file &1 in &2 less than five lines.
CPF8451: Entry value &1 not correct.
CPF8455: Work station is not a DBCS device.
CPF9801: Object &2 in library &3 not found.
CPF9802: Not authorized to object &2 in &3.
CPF9803: Cannot allocate object &2 in library &3.
CPF9810: Library &1 not found.
CPF9820: Not authorized to use library &1.
CPF9845: Error occurred while opening file &1.
CPF9846: Error while processing file &1 in library &2.
CPF9847: Error occurred while closing file &1 in library &2.
CPF9850: Override of printer file &1 not allowed.

Top