admnls(1M)                     DG/UX R4.11MU05                    admnls(1M)


NAME
       admnls - manipulate national language variables

SYNOPSIS
       admnls -o set parameter=value ...

       admnls -o get [ -qv ] [ parameter ...  ]

DESCRIPTION
       The admnls command manages national language support (NLS)
       environment variables.

       The following environment variables are managed:

       LANG      The user's chosen locale.  The default is C.

       NLSPATH   The path on which to look for message catalogs.  The
                 default is /usr/lib/nls/msg/%L/%N:/etc/nls/msg/%L/%N.

       The NLSPATH variable is used by catopen(1) to locate X/Open message
       catalogs.  NLSPATH can consist of a series of pathnames, separated by
       colons.  This is useful for programs which install message catalogs
       somewhere other than the default location For example, if the
       hypothetical ipslng product installs message catalogs under
       /usr/opt/ipslng/locale, NLSPATH could be set to
       /usr/lib/nls/msg/%L/%N:/usr/opt/ipslng/%L/%N.  In NLSPATH, the
       sequence "%L" is replaced with the value of the environment variable
       LANG.

       The LANG variable is also used by setlocale(3C) to determine which
       subdirectory of /usr/lib/locale to use for other locale-dependent
       information.

   Operations
       The following operations are provided:

       set       Assign new values to one or more parameters.

       get       Retrieve the values for one or more parameters.  If
                 parameter is not given, all parameters are displayed.
                 Otherwise, parameter must be one of LANG or NLSPATH.

   Options
       The following options are provided:

       -q        Use quiet mode.  For the get operation, there are no
                 headers and only the values of the requested parameters are
                 displayed.

       -v        Use verbose mode.  For the get operation, headers are
                 displayed.  This option is enabled by default.

EXAMPLES
       For example, to set the LANG variable to C and the NLSPATH variable
       to /usr/lib/nls/msg/%L/%N, use a command line like

           admnls -o set LANG=C NLSPATH="/usr/lib/nls/msg/%L/%N"


FILES
       /etc/TIMEZONE
                 Contains the values of the variables for sh(1) users.

       /etc/TIMEZONE.csh
                 Contains the values of the variables for csh(1) users.

DIAGNOSTICS
   Warnings
        -  Either database file (/etc/TIMEZONE or /etc/TIMEZONE.csh) is
           missing.  The file will be created from the prototype.

        -  Either of LANG or NLSPATH is missing from the database file.  It
           will be added.

   Errors
        -  There is an error modifying one of the database files.

   Exit Codes
        0     The operation was successful.

        1     The operation was unsuccessful.

        2     The operation failed due to access restrictions.

        3     There was an error in the command line.

NOTES
       Any logins and processes running when environment variables are
       changed, and all their child processes, will continue to see the old
       values of the variables.  In order to ensure that all processes run
       with the new values for LANG and NLSPATH, you must reboot the system.

       You must have appropriate privilege to write to the /etc/TIMEZONE
       file in order to use the set operation.  On a traditional DG/UX
       system, appropriate privilege means that you have superuser
       privilege, or an effective UID of root.  See the
       appropriateprivilege(5) man page for more information.

       On a system that supports the DG/UX Capability option, appropriate
       privilege is defined as having one one or more specific capabilities
       enabled in the effective capability set of the user.  See
       capdefaults(5) for the default capabilities for this command.

REFERENCES
       X/Open Portability Guide, Volume 3.

SEE ALSO
       catgets(1), csh(1), gettxt(1), sh(1), catgets(3C), catopen(3C),
       gettxt(3C), localeconv(3C), setlocale(3C), timezone(4),
       appropriateprivilege(5), capdefaults(5), environ(5).


Licensed material--property of copyright holder(s)