CEEQRYL,
analogous to the C language
function localename=setlocale(category,
NULL), queries the environment for which locale defines the
current setting for the locale category. CEEQRYL is sensitive to the
locales set by setlocale() or CEESETL, not to the Language Environment settings
from COUNTRY or CEE3CTY.
Syntax
>>-CEEQRYL--(--category--,--localename--,--fc--)---------------><
- category (input)
- A symbolic integer number that represents all or part of the locale
for a program. Depending on the value of the localename,
these categories can be initiated by the values of global categories
of corresponding names. The following values for the category parameter
are valid; Language Environment locale
callable services do not support the LC_TOD and LC_SYNTAX categories.
- LC_ALL
- A 4-byte integer (with a value of -1) that affects all locale
categories associated with a program's locale.
- LC_COLLATE
- A 4-byte integer (with a value of 0) that affects the behavior
of regular expression and collation subroutines.
- LC_CTYPE
- A 4-byte integer (with a value of 1) that affects the behavior
of regular expression, character classification, case conversion,
and wide character subroutines.
- LC_MESSAGES
- A 4-byte integer (with a value of 6) that affects the format and
values for positive and negative responses.
- LC_MONETARY
- A 4-byte integer (with a value of 3) that affects the behavior
of subroutines that format monetary values.
- LC_NUMERIC
- A 4-byte integer (with a value of 2) that affects the behavior
of subroutines that format non-monetary numeric values.
- LC_TIME
- A 4-byte integer (with a value of 4) that affects the behavior
of time conversion subroutines.
- localename (output)
- Returns the name of the locale that describes the current setting
of the category requested.
- fc (output)
- A 12-byte feedback code, optional in some languages,
that indicates the result of this service. If you choose to omit this
parameter, refer to Invoking callable services for the
appropriate syntax to indicate that the feedback code was omitted.
The
following symbolic conditions can result from this service:
Code |
Severity |
Message number |
Message text |
---|
CEE000 |
0 |
— |
The service completed successfully. |
CEE2KD |
3 |
2701 |
An invalid category parameter was passed to a locale function. |
CEE3T1 |
3 |
4001 |
General Failure: Service could not be completed. |