Retrieve C Locale Description (RTVCLDSRC)

The Retrieve C/400* Locale Description Source (RTVCLDSRC) command retrieves the locale that you specified on the SRCFILE parameter. The *SYSVAL locale can be retrieved and used as a model to create a tailored locale description. The locale commands and formats that you use in your locale source are outlined in the C/400 User's Guide. Once your locale source is complete, use the CRTCLD command to process the description.

Error messages for RTVCLDSRC

*ESCAPE Messages

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.
PSE1751
Source &1 in file &3 was not retrieved.

Parameters

Keyword Description Choices Notes
CLD Locale name Qualified object name Required, Positional 1
Qualifier 1: Locale name Name, *SYSVAL
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

Locale name (CLD)

Specifies the C/400 locale description that is to be retrieved. You can retrieve the system values if you use *SYSVAL, instead of specifying a locale name and library.

locale name
Enter the name of the locale description.
*SYSVAL
The system default values are used as the basis for the retrieved locale description source. The default locale description values are used for any locale description information that does not have a corresponding system value.

The possible library values are:

*CURLIB
The current library will be searched for the source file specified. If you have not specified a current library, QGPL will be used.
library-name
Enter the name of the library containing the locale description.

Source file (SRCFILE)

Specifies the name and library of the file that receives the retrieved C/400 locale description source. If the specified library does not exist, the process ends. If the specified file does not exist, it is created.

QCLDSRC
The default source file name for the C locale description source. Use this default if you want to browse your source and its associated listing using SEU.
source-file-name
Enter the name of the file where you want to store the C locale description source.

The possible library values are:

*LIBL
The system searches the library list for the library that contains the locale description source file.
*CURLIB
The current library is used to store the retrieved locale. If you have not specified the current library, QGPL will be used.
library-name
Enter the name of the library to store the retrieved locale.

Source member (SRCMBR)

Specifies the source file member that will store the C/400 locale description source after processing. If the specified member does not exist, it is created.

*CLD
Specifies that the C locale description name specified by the CLD parameter is used as the source file member name. For example, if you retrieved the system values, the locale source is stored in a member called SYSVAL.
source-file-member-name
Enter a name for the source file member that will store the retrieved C locale description.

Text description (TEXT)

Specifies the text you want associated with the source file member you are processing.

*SRCMBRTXT
Specifies that the same text description you supplied for the C locale description is used.
*BLANK
No text appears.
'description'
Enter the descriptive text to accompany the retrieved C locale description. You can enter up to 50 characters of text.

Examples

None

Error messages

*ESCAPE Messages

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.
PSE1751
Source &1 in file &3 was not retrieved.