CRTSPADCT (Create Spelling Aid Dictionary)

CRTSPADCT Command syntax diagram

 

Purpose

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 names are the IBM-supplied system dictionary names, in alphabetical order, that are in library QDCT. It is recommended that they are not used for user-created dictionaries:

AFRIKAAN

AKTUEEL

BRASIL

CATALA

DANSK

DEUTSCH

DSCHWEIZ

ESPANA

FRANCAIS

FRA2

GREEK

ISLENSK

ITALIANO

LEGAL

MEDICAL

NEDERLND

NORBOK

NORNYN

PORTUGAL

SUOMI

SVENSK

UK

US

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

More information on user-defined spelling aid dictionaries is in the Use OfficeVision/400 Word Processing book.

 

Required Parameters

SPADCT

Specifies the qualified name of the spelling aid dictionary being created.

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

The possible library values are:

*CURLIB: The current library is used to locate the dictionary. 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 dictionary is located.

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

SRCFILE

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

The name of the source file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

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

 

Optional Parameters

SRCMBR

Specifies the name of the source file member that contains the words for the dictionary being created; the member is in the source file specified in the SRCFILE parameter. If SRCMBR is not specified, the member name is the same as that of the dictionary being created; the default value *DCT implies that the name of the dictionary being created is used. A member name must be specified when the source file member to be processed does not have the same name as the spelling aid dictionary being created.

*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 (specified by SRCFILE) used to create the spelling aid dictionary.

OPTION

Specifies the type of output created when the dictionary is created.

Source Listing Options

*SRC or *SOURCE: A list of the source statements used to create the dictionary, as well as any errors that occur, is created.

*NOSRC or *NOSOURCE: No list of the source statements is created unless errors occur.

BASEDCT

Specifies the qualified name of the dictionary that contains words added to the dictionary being created. A system dictionary (one created by IBM) cannot be used here.

*NONE: No words from another dictionary are added into the dictionary being created.

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

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

dictionary-name: Specify the name of the dictionary that contains words added to the dictionary being created.

VFYDCT

Specifies the qualified name of the dictionary that is searched for each word specified in the source member. Only words not found in the verify dictionary are placed in the new dictionary.

*NONE: Use every word specified in the source member to create the spelling aid dictionary.

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

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

dictionary-name: Specify the name of the dictionary that contains words not included in the dictionary being created.

LNGATR

Specifies the language attribute associated with the dictionary being created. Because each language has its own structure, knowing the language for which the new dictionary is intended makes creation and storage of the new dictionary easier and more effective for the system.

*VFYDCT: The language attribute of the dictionary is the same as the language attribute of the dictionary specified on the VFYDCT parameter.

*NONE: The dictionary created has no specific language attribute.

*ENGLISH: The language attribute of the spelling aid dictionary is English.

*ESPANA: The language attribute of the spelling aid dictionary is Spanish.

*FRANCAIS: The language attribute of the spelling aid dictionary is French.

*FRA2: The language attribute of the spelling aid dictionary is French, in which accents are required on uppercase characters.

*ITALIANO: The language attribute of the spelling aid dictionary is Italian.

*DANSK: The language attribute of the spelling aid dictionary is Danish.

*DEUTSCH: The language attribute of the spelling aid dictionary is German.

*ISLENSK: The language attribute of the spelling aid dictionary is Icelandic.

*NEDERLND: The language attribute of the spelling aid dictionary is Dutch.

*NORSK: The language attribute of the spelling aid dictionary is Norwegian.

*SVENSK: The language attribute of the spelling aid dictionary is Swedish.

*PORTUGAL: The language attribute of the spelling aid dictionary is Portuguese.

*DSCHWEIZ: The language attribute of the spelling aid dictionary is Swiss German.

*SUOMI: The language attribute of the spelling aid dictionary is Finnish.

*CATALA: The language attribute of the spelling aid dictionary is Catalan.

*AFRIKAAN: The language attribute of the spelling aid dictionary is Afrikaans.

*GREEK: The language attribute of the spelling aid dictionary is Greek.

*BRASIL: The language attribute of the spelling aid dictionary is Brazilian Portuguese.

*TURKISH: The language attribute of the spelling aid dictionary is Turkish.

*RUSSIAN: The language attribute of the spelling aid dictionary is Russian.

SWLLANGID

Specifies the language identifier (ID) for the 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.

: 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, (-), are not added to the user-created stop word list even when BASESWL(*IBM) is specified.

AUT

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

*LIBCRTAUT: The public authority for the spelling aid dictionary is taken from the value on the CRTAUT parameter of the target library (the library that is to contain the spelling aid dictionary). The public authority is determined when the spelling aid dictionary is created. If the CRTAUT value for the library changes after the spelling aid 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.

*USE: The user can perform basic operations on the spelling aid dictionary, such as running a program or reading a file. The user cannot change the spelling aid dictionary. *USE authority provides object operational authority, read authority, and execute 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 spelling aid dictionary.

*EXCLUDE: The user cannot access the spelling aid dictionary.

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

REPLACE

Specifies whether a dictionary being created has the same name as an existing dictionary. More information on this parameter is in Commonly used parameters.

*YES: The dictionary being created replaces an existing dictionary that has the same name.

*NO: No replacement occurs.

TEXT

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

*SRCMBRTXT: The text is taken from the source file member being used to create the spelling aid dictionary. If the source file is a database file, the text is taken from the source member. You can add or change text for a database source member by using the Start SEU (STRSEU), Add Physical File Member (ADDPFM), or Change Physical File Member (CHGPFM) commands. If the source file is an inline or device file, the text is blank.

*BLANK: Text is not specified.

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

Example for CRTSPADCT

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 for CRTSPADCT

*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.