1 LOCALE
  An OpenVMS XPG4 localization utility that:

   o  Compiles a binary locale file (LOCALE COMPILE).

   o  Loads a locale name into system memory as shared, read-only
      global data (LOCALE LOAD).

   o  Displays details of locales on your system (LOCALE SHOW).

   o  Unloads a locale name from system memory (LOCALE UNLOAD).


  For more information on the XPG4 utilities, including file
  formats, see the VSU C Run-Time Library Reference Manual.
  Also see help for the related commands GENCAT and ICONV.

  Format:

       LOCALE option

2 COMPILE
  Converts a locale source file into a binary locale file.  The
  binary locale file is used by utilities and C routines that are
  dependent on the setting of the international environment logical
  names.

  Format:

       LOCALE COMPILE sourcefile

3 Parameter

  sourcefile

    The file specification of the locale source file.  This file
    defines each category of the locale.  The default file type for
    the source file is .LSRC.

3 Qualifiers

4 /CHARACTER_DEFINITIONS                     
    /[NO]CHARACTER_DEFINITIONS[=filename]
    /NOCHARACTER_DEFINITIONS (D)

  Specifies a character-set description file (charmap) for the
  locale.  This file maps characters to their actual character
  encodings.  If a charmap is not specified, no symbolic names
  (other than collating symbols defined in a collating symbol
  keyword) are allowed in the locale source file.  The default file
  type for a charmap is .CMAP.

4 /DISPLAY                                   
    /DISPLAY[=[NO]HOLE]
    /DISPLAY=NOHOLE (D)

  Used with certain Chinese locales and terminals to
  specify that 4-byte characters occupy four printing 
  positions (columns) on the terminal display. The default 
  value (/DISPLAY=NOHOLE) specifies that 4-byte characters
  occupy two printing positions.

4 /IGNORE=WARNINGS                           
    /[NO]IGNORE=WARNINGS
    /NOIGNORE=WARNINGS (D)

  Generates an output file even if LOCALE COMPILE issues warning
  messages.  Use the /IGNORE qualifier with caution because warning
  messages can indicate user errors that you might want to fix
  before using the resulting locale file.

4 /LISTING                                
    /[NO]LISTING[=filename]
    /LISTING[=filename] (Batch Default)
    /NOLISTING (Interactive Default)

  Specifies the name of the listing file.  The /SHOW qualifier
  controls the information included in the listing file.  If the
  filename is omitted, the default is sourcefile.LIS.

4 /OUTPUT                                 
    /[NO]OUTPUT[=filename]
    /NOOUTPUT (D)

  Specifies the name of the output file.  If the /OUTPUT qualifier
  is omitted, the default output filename is sourcefile.LOCALE.
  Public locales are stored in the directory defined by the logical
  name SYS$I18N_LOCALE.  If the output file is in any other
  location, the locale is private.

  If /NOOUTPUT is specified, the compiler does not create an output
  file, even if the compilation is successful.

4 /SHOW                                   
    /SHOW[=(keyword[,...])])
    /SHOW=(SOURCE,TERMINAL) (D)

  Use /SHOW together with /LIST to control the information included
  in the listing file.  You can specify the following keywords:

  ALL                        Include all information.

  BRIEF                      Include a summary of the symbol table.

  [NO]CHARACTER_DEFINITIONS  Include/omit the charmap file.

  NONE                       Do not print any information.  If NONE
                             is specified, the listing file only
                             contains the error messages generated.

  [NO]SOURCE                 Include/omit a listing of the source
                             file.

  [NO]STATISTICS             Include/omit compiler performance
                             information.

  [NO]SYMBOLS                Include/omit a listing of the charmap
                             symbol table.

  [NO]TERMINAL               Display compiler messages at the
                             terminal.

2 LOAD
  Loads the specified locale name into the system memory as shared,
  read-only global data.

  LOCALE LOAD is a privileged OpenVMS command, typically issued by
  the system manager, and requiring the following privileges:

   o  SYSGBL

   o  PRMGBL


  Format:

       LOCALE LOAD name

3 Parameter

  name

    A character string that identifies the locale to be loaded.
    This can be one of the following:

     o  The name of the public locale

        The format of the name is:

             language_country.codeset[@modifier]

        LOCALE LOAD searches for the public locale binary file in
        the location defined by the logical name SYS$I18N_LOCALE.
        The file type defaults to .LOCALE.  The period (.) and
        at-sign (@) characters in the name specified are replaced by
        an underscore character (_).

     o  A file specification

        Specifies the binary locale file.  This can be any valid
        file specification.  If either the device or directory is
        not specified, LOCALE LOAD first applies the current
        caller's device and directory as defaults.  If the file is
        not found, the device and directory defined by the
        SYS$I18N_LOCALE logical name are used as defaults.  The file
        type defaults to .LOCALE.

        Wildcards are not allowed.  The binary locale file cannot
        reside on a remote node.


2 SHOW
  Displays information about the locales and charmaps on the system.

  Format:

       LOCALE SHOW option

3 CHARACTER_DEFINITIONS
  Lists all the character set description files (charmaps) in the
  public directory defined by the logical name SYS$I18N_LOCALE.  A
  charmap defines symbolic names and values of characters in a coded
  character set.  Charmaps are used by the LOCALE COMPILE command
  when compiling a locale.  A charmap file has the file type .CMAP.

  Format:

       LOCALE SHOW CHARACTER_DEFINITIONS

3 CURRENT
  Displays a summary of the current international environment, as
  defined by several international environment logical names.

  Format:

       LOCALE SHOW CURRENT

3 PUBLIC
  Lists all public locales on the system.  The set of public locales
  contains all locales that reside in the directory defined by the
  logical name SYS$I18N_LOCALE, as well as the system's built-in
  locales supplied with the VSI C run-time library.

  Format:

       LOCALE SHOW PUBLIC

3 VALUE
  Displays the value of one or more keywords from the current
  international environment.

  Format:

       LOCALE SHOW VALUE  name[,...]

4 Parameter

  name[,...]

    The name of a keyword or category.  If you specify a keyword,
    the value of that keyword in the current locale is displayed.
    If you specify a category, the values of the keywords in that
    category are displayed.  For integer keywords that have no value
    assigned, the value CHAR_MAX (127) is displayed.  When a keyword
    value includes semicolons, double-quotes, backslashes, or
    control characters, they are preceded by an escape character
    (usually a backslash).

3 Qualifiers

4 /CATEGORY                     
    /[NO]CATEGORY
    /NOCATEGORY (D)

  Displays the category name before each keyword.  If /CATEGORY is
  omitted, the category name is not displayed.

4 /KEYWORD                     
    /[NO]KEYWORD
    /NOKEYWORD (D)

  Displays the keyword name before the value of a keyword.  If
  /KEYWORD is omitted, the value of the keyword is displayed, but
  not its name.

2 UNLOAD
  Unloads the specified locale name from the system's memory.  If a
  process is accessing the locale when the UNLOAD command is
  entered, the global sections are deleted after the process
  deaccesses the locale.

  LOCALE UNLOAD is a privileged OpenVMS command, typically issued by
  the system manager, and requiring the following privileges:

   o  SYSGBL

   o  PRMGBL


  Only locale files loaded by the LOCALE LOAD command can be
  unloaded.

  Format:

       LOCALE UNLOAD name

3 Parameter

  name

    A character string that identifies the locale to be unloaded.
    See the LOCALE LOAD command for acceptable formats for this
    parameter.

