CRTIGCDCT (Create DBCS Conversion Dictionary)

CRTIGCDCT Command syntax diagram

 

Purpose

The Create DBCS Conversion Dictionary (CRTIGCDCT) command creates the specified double-byte character set (DBCS) conversion dictionary and stores it in the specified library. The dictionary contains alphameric entries and their related words. The system refers to DBCS conversion dictionaries when doing DBCS conversion.

 

Required Parameters

IGCDCT

Specifies the qualified name of the DBCS conversion dictionary being created and the library in which it is stored.

The name of the DBCS conversion dictionary can be qualified by one of the following library values:

*CURLIB: The DBCS conversion dictionary is created in the current library for the job. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library where the DBCS conversion dictionary is created.

dictionary-name: Specify the name of the dictionary being created.

Note:

A DBCS conversion dictionary created by the user can have any name, but is used for doing DBCS conversion only if it is named QUSRIGCDCT.

 

Optional Parameters

AUT

Specifies the authority given to users who do not have specific authority to the DBCS conversion dictionary, who are not on an authorization list, and whose user group has no specific authority to the DBCS conversion dictionary. More information on this parameter is in Commonly used parameters.

*LIBCRTAUT: The public authority for the DBCS conversion dictionary is taken from the value on the CRTAUT parameter of the target library (the library that is to contain the DBCS conversion dictionary). The public authority is determined when the DBCS conversion dictionary is created. If the CRTAUT value for the library changes after the DBCS conversion dictionary is created, the new value does not affect any existing objects.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the DBCS conversion dictionary.

*USE: The user can perform basic operations on the DBCS conversion dictionary, such as running a program or reading a file. The user cannot change the DBCS conversion dictionary. *USE authority provides object operational authority, read authority, and execute authority.

*EXCLUDE: The user cannot access the DBCS conversion dictionary.

authorization-list-name: Specify the name of the authorization list used.

TEXT

Specifies the text that briefly describes the dictionary. More information on this parameter is in Commonly used parameters.

*BLANK: No text is specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CRTIGCDCT

CRTIGCDCT   IGCDCT(DBCSLIB/QUSRIGCDCT)

This command creates a DBCS conversion dictionary named QUSRIGCDCT, which is stored in the library DBCSLIB.

Error messages for CRTIGCDCT

*ESCAPE Messages

CPF8431

DBCS conversion dictionary &2 not created in library &3.