Create C Locale Description (CRTCLD)

The Create C/400* Locale Description (CRTCLD) command creates a locale description object (*CLD) using the source information provided on the SRCFILE and SRCMBR parameters. The locale description source file must exist.

To change an existing locale, use the Retrieve C Locale Description (RTVCLDSRC) command.

Error messages for CRTCLD

*ESCAPE Messages

PSE1707: The listing option on the CRTCLD command failed.
PSE1708: Member &3 is not found in the specified file and library.
PSE1709: File &1 is not found in library &2.
PSE1739: The necessary storage could not be allocated.
PSE1749: Compilation failed. Locale object &1 is not created.

Parameters

Keyword	Description	Choices	Notes
CLD	Locale name	Qualified object name	Required, Positional 1
	Qualifier 1: Locale name	Name
	Qualifier 2: Library	Name, *CURLIB
SRCFILE	Source file	Qualified object name	Optional, Positional 2
	Qualifier 1: Source file	Name, QCLDSRC
	Qualifier 2: Library	Name, LIBL, CURLIB
SRCMBR	Source member	Name, *CLD	Optional, Positional 3
TEXT	Text description	Character value, SRCMBRTXT, BLANK	Optional, Positional 4
OPTION	Source listing option	NOSOURCE, SOURCE, NOSRC, SRC	Optional, Positional 5
LISTING	Error listing level	NOSECLVL, SECLVL	Optional, Positional 6
PRTFILE	Print file	Qualified object name	Optional, Positional 7
	Qualifier 1: Print file	Name, QSYSPRT
	Qualifier 2: Library	Name, LIBL, CURLIB
REPLACE	Replace	YES, NO	Optional, Positional 8
AUT	Authority	Name, LIBCRTAUT, ALL, CHANGE, USE, *EXCLUDE	Optional, Positional 9
TGTRLS	Target Release	CURRENT, PRV, V3R0M5, V3R1M0, V3R6M0	Optional, Positional 10

Top

Locale name (CLD)

Specifies the name and the library of the new C/400 locale description.

locale-name: Enter a name for the C/400 locale description.

The possible library values are:

*CURLIB: The current library is used to store the locale when CRTCLD is processed. If you have not specified a current library, QGPL is used.
library-name: Enter the name of the library where the C/400 locale description is to be created. The library must already exist.

Source file (SRCFILE)

Specifies the source physical file name and library of the C/400 locale description source. Both the source physical file and the library must exist.

QCLDSRC: The default name for the source physical file containing the C/400 locale description source to be processed.
source-file-name: Enter the name of the file containing the C/400 locale description source.

The possible library values are:

*LIBL: The library list is searched to find the library containing the source file when CRTCLD is processed.
*CURLIB: The current library is searched for the source file when CRTCLD is processed. If you have not indicated a specific library as your current library, QGPL is used.
library-name: Enter the name of the library containing the C/400 locale description source file.

Source member (SRCMBR)

Specifies the member containing the C/400 locale description source. The member is in the file and library specified on the SRCFILE parameter. This member must exist.

*CLD: The locale name identified by the CLD parameter is also the name of the member.
source-file-member-name: Enter the name of the file member that contains the locale description source to be processed.

Text description (TEXT)

Enter text that describes the C/400 locale description.

*SRCMBRTXT: The text description associated with the locale description source is used.
*BLANK: No text appears.
'description': Enter descriptive text no longer than 50 characters, and enclose it in single quotation marks. The quotation marks are not part of the 50 character string.

Error listing level (LISTING)

Specifies the level of detail of error messages to include in the created source listing.

*NOSECLVL: Only the first-level error message text is included in the created source listing.
*SECLVL: Both levels of message text are included in the created source listing. The second level text describes the cause of the error, the possible steps to take to recover, and a technical description of the processing steps taken because of the error.

Print file (PRTFILE)

Specifies the name and library of the printer file that will be used to print the source listing.

QSYSPRT: The listing is directed to the default printer file QSYSPRT.
print-file-name: Enter the name of the printer file where you want to direct your source listing. It must be defined to have a minimum record length of 132 characters.

The possible library values are:

*LIBL: The system searches the library list for the printer file.
*CURLIB: The current library is searched for the printer file. If you have not indicated a specific library as your current library, QGPL is used.
library-name: Enter the name of the library where the printer file will be found.

Replace (REPLACE)

Specifies whether the existing version of the locale description object is to be replaced by the current version.

YES: The existing locale description is replaced with the new version. The old version is moved to the library, QRPLOBJ, and renamed based on the system date and time. The text description of the replaced locale description is changed to the name of the original locale description. The old locale description is deleted at the next IPL if you do not explicitly delete it.
*NO: The existing locale description is not replaced. If a locale description with the same name exists in the specified library, a message is displayed and the locale description is not created.

Authority (AUT)

Specifies the object authority you are granting the users who do not have specific authority to the object, who are not on the authorization list, or whose group has no specific authority to the object.

*LIBCRTAUT: The public authority for the object will be taken from the CRTAUT keyword of the target library (the library that will contain the created object). This value will be determined when the object is created. If the CRTAUT value for the library changes after the object is created, the new value will NOT affect any existing objects.
*CHANGE: Provides all data authority and the authority to perform all operations on the object except those limited to the owner or controlled by object authority and object management authority. You can change the object and perform basic functions on it.
*USE: Provides object operational authority and read authority; authority for basic operations on the object such as running a program or reading a file. You are prevented from changing the object.
*ALL: Authority for all operations on the object except those limited to the owner or controlled by authorization list management authority. You can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object, but you cannot transfer its ownership.
*EXCLUDE: You are prevented from accessing the object.

Target Release (TGTRLS)

Specifies the release of the operating system on which you intend to use the object being created.

Note: This parameter has no function in the CRTCLD command but is included for consistency with other CL commands for creating objects. A *CLD object created with any of the allowed TGTRLS values can be restored and used with the previous version of the operating system.

*CURRENT

The object is to be used on the release of the operating system currently running on your system. For example, if V3R6M0 is running on the system, *CURRENT means you intend to use the object on a system with V3R6M0 installed. You can also use the object on a system with any later release of the operating system installed.

*PRV

The object is to be used on the previous release of the operating system. For example, if V3R6M0 is running on your system, *PRV means you intend to use the object on a system with V2R3M0 installed. You can also use the object on a system with any later release of the operating system installed.

release-level

Specify the release in the format VxRxMx, where Vx is the version, Rx is the release, and Mx is the modification level.

The object can be used on a system with the specified release or any later release of the operating system installed.

Valid values depend on the current version, release, and modification level, and these change with each new release. Press the F4 (Prompt) key from the TGTRLS parameter to see the list of valid values for this release.

Error messages

*ESCAPE Messages

PSE1707: The listing option on the CRTCLD command failed.
PSE1708: Member &3 is not found in the specified file and library.
PSE1709: File &1 is not found in library &2.
PSE1739: The necessary storage could not be allocated.
PSE1749: Compilation failed. Locale object &1 is not created.