Create Spelling Aid Dictionary (CRTSPADCT)

The Create Spelling Aid Dictionary (CRTSPADCT) command allows the user to create a user-defined spelling aid dictionary. This dictionary is used with the Create Document (CRTDOC), Check Document (CHKDOC), Edit Document (EDTDOC), or Work with Documents (WRKDOC) commands when doing spell check functions, such as spelling aid and spelling verification.

Spelling aid dictionaries are classified into IBM language dictionaries and user dictionaries. Language dictionaries are IBM-created; user dictionaries are created with this command.

The following are IBM language dictionary names that are in library QDCT. They should not be used for user-created dictionaries.

AFRIKAAN
AKTUEEL
BRASIL
CATALA
DANSK
DEUTSCH
DSCHWEIZ
ESPANA
FRANCAIS
FRA2
GREEK
ISLENSK
ITALIANO
LEGAL
MEDICAL
NEDERLND
NORBOK
NORNYN
PORTUGAL
RUSSIAN
SUOMI
SVENSK
UK
US

This command requires a source file to contain all the words being put into the spelling aid dictionary. The source member can be created by using the Start Source Entry Utility (STRSEU) command. The dictionary source type is SPADCT.

Parameters

Keyword	Description	Choices	Notes
SPADCT	Spelling aid dictionary	Single values: USRSWL Other values: Qualified object name*	Required, Positional 1
	Qualifier 1: Spelling aid dictionary	Name
	Qualifier 2: Library	Name, *CURLIB
SRCFILE	Source file	Qualified object name	Required, Positional 2
	Qualifier 1: Source file	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
SRCMBR	Source member	Name, *DCT	Optional, Positional 3
TEXT	Text 'description'	Character value, SRCMBRTXT, BLANK	Optional
BASEDCT	Base dictionary	Qualified object name	Optional
	Qualifier 1: Base dictionary	Name, *NONE
	Qualifier 2: Library	Name, LIBL, CURLIB
VFYDCT	Verify dictionary	Qualified object name	Optional
	Qualifier 1: Verify dictionary	Name, *NONE
	Qualifier 2: Library	Name, LIBL, CURLIB
LNGATR	Language attribute	VFYDCT, NONE, ENGLISH, ESPANA, FRANCAIS, FRA2, ITALIANO, DANSK, DEUTSCH, ISLENSK, NEDERLND, NORSK, SVENSK, PORTUGAL, DSCHWEIZ, SUOMI, CATALA, AFRIKAAN, GREEK, BRASIL, TURKISH, RUSSIAN	Optional
SWLLANGID	Stop word list language ID	Character value	Optional
BASESWL	Base stop word list	IBM, NONE	Optional
OPTION	Source listing option	SOURCE, NOSOURCE, SRC, NOSRC	Optional, Positional 4
AUT	Authority	Name, LIBCRTAUT, CHANGE, ALL, USE, *EXCLUDE	Optional
REPLACE	Replace dictionary	YES, NO	Optional

Top

Spelling aid dictionary (SPADCT)

Specifies the name and library for the spelling aid dictionary being created.

This is a required parameter.

*USRSWL

A user-defined stop word list is created using an IBM-supplied name.

The possible library values are:

*CURLIB: The current library for the job is used to store the dictionary. If no library is specified as the current library for the job, QGPL is used.

library-name

Specify the name of the library where the dictionary is stored.

Source file (SRCFILE)

Specifies the name and library of the source file used when the spelling aid dictionary is created. The source file contains the source member that is used for creating the dictionary.

This is a required parameter.

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 source file. If no library is specified as the current library for the job, QGPL is used.
library-name: Specify the name of the library in which the source file is located.

Source member (SRCMBR)

Specifies the name of the source file member that contains the words for the dictionary being created. The member is located in the source file specified on the Source file prompt (SRCFILE parameter).

*DCT: The source file member name is the same as that of the dictionary being created.
source-file-member-name: Specify the name of the member in the source file that is used to create the spelling aid dictionary. A member name must be specified when the source file member being processed does not have the same name as the spelling aid dictionary being created.

Base dictionary (BASEDCT)

Specifies the name and library of the dictionary that contains words that are added to the dictionary being created. An IBM language dictionary (one created by IBM) cannot be used here.

*NONE: No words from another dictionary are added to the dictionary being created.
dictionary-name: Specify the name and library of the dictionary that contains words to be added to the dictionary being created.

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 name of the library where the dictionary is located.

Verify dictionary (VFYDCT)

Specifies the name and library of an existing dictionary that is searched for each word specified in the source member. Only those words that are not found in the existing dictionary are placed in the new dictionary to avoid duplication.

*NONE: Every word specified in the source member is placed in the new spelling aid dictionary without verifying against another dictionary.
dictionary-name: Specify the name of the dictionary that contains words that are not to be duplicated in the dictionary being created.

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 name of the library where the dictionary is located.

Language attribute (LNGATR)

Specifies the language attribute associated with the dictionary being created. The language attribute determines the processing rules that apply when the dictionary is used.

*VFYDCT: The language attribute of the dictionary is the same as the language attribute of the dictionary that is specified on the Verify dictionary prompt (VFYDCT parameter).
*NONE: The dictionary being created does not have a specific language attribute.
*AFRIKAAN: The language attribute used by the spelling aid dictionary is Afrikaans.
*BRASIL: The language attribute used by the spelling aid dictionary is Brazilian Portuguese.
*CATALA: The language attribute used by the spelling aid dictionary is Catalan.
*DANSK: The language attribute used by the spelling aid dictionary is Danish.
*DEUTSCH: The language attribute used by the spelling aid dictionary is German.
*DSCHWEIZ: The language attribute used by the spelling aid dictionary is Swiss-German.
*ENGLISH: The language attribute used by the spelling aid dictionary is English.
*ESPANA: The language attribute used by the spelling aid dictionary is Spanish.
*FRANCAIS: The language attribute used by the spelling aid dictionary is French.
*FRA2: The language attribute used by the spelling aid dictionary is French, where accents are required on uppercase characters.
*GREEK: The language attribute used by the spelling aid dictionary is Greek.
*ISLENSK: The language attribute used by the spelling aid dictionary is Icelandic.
*ITALIANO: The language attribute used by the spelling aid dictionary is Italian.
*NEDERLND: The language attribute used by the spelling aid dictionary is Dutch.
*NORSK: The language attribute used by the spelling aid dictionary is Norwegian.
*PORTUGAL: The language attribute used by the spelling aid dictionary is Portuguese.
*RUSSIAN: The language attribute used by the spelling aid dictionary is Russian.
*SUOMI: The language attribute used by the spelling aid dictionary is Finnish.
*SVENSK: The language attribute used by the spelling aid dictionary is Swedish.
*TURKISH: The language attribute used by the spelling aid dictionary is Turkish.

Base stop word list (BASESWL)

Specifies whether the IBM-supplied stop word list words are included in the user-created stop word list.

*IBM: The words from the IBM-supplied stop word list are added to the user-created stop word list.
*NONE: No words from the IBM-supplied stop word list are added to the user-created stop word list.
Note: Word entries in the IBM-supplied stop word list source file preceded by a dash, (&ndash.), are not added to the user-created stop word list even when BASESWL(*IBM) is specified.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*LIBCRTAUT: The authority for the object is the same as the value specified on the Create authority prompt (CRTAUT parameter) of the library in which the object is being created. If the value specified on the Create authority prompt (CRTAUT parameter) is changed, the new value will not affect any existing objects.
*CHANGE: The user can change the dictionary and use it to check the spelling of the content of a text document.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) 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 object.

*USE: The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.

*EXCLUDE: The user cannot access the object.

authorization-list-name: Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Examples

CRTSPADCT   SPADCT(MYLIB/MYDCT)  SRCFILE(MYLIB/SRC)
            SRCMBR(WORDS)  OPTION(*NOSRC)
            BASEDCT(QGPL/BASDCT)  VFYDCT(QDCT/US)
            LNGATR(*ENGLISH)  REPLACE(*YES)

This command creates a spelling aid dictionary named MYDCT in the library MYLIB. The words used in the spelling aid dictionary are from source member WORDS of the SRC source file in MYLIB. The dictionary includes words from a dictionary named BASDCT, but does not contain any words that are found in the dictionary named US. The dictionary being created has the *ENGLISH attribute. If an existing dictionary is named MYDCT, it is replaced.

Error messages

*ESCAPE Messages

CPF2283: Authorization list &1 does not exist.
CPF4102: File &2 in library &3 with member &4 not found.
CPF4104: User not authorized to operation on file &2 in &3, member, device, or program device &4.
CPF411B: Shared open of member &4 not successful.
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.
CPF9832: Function not supported for DDM file &2.
CPF9845: Error occurred while opening file &1.
CPF9848: Cannot open file &1 in library &2 member &3.
CPF9899: Error occurred during processing of command.