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