IBM Support

Resolving error ERZ057001E

Technote (troubleshooting)


CICS commands cannot locate the message catalog file. The following message appears:

ERZ057001E/0020 08/30/12 12:03:53.767300037 ansdev 6225994/0001 : Cannot access message catalog for message ERZ010190I.


NLSPATH and LANG is not set properly or the configured locale has not been installed.

Resolving the problem

You can resolve this problem by verifying the following:

  • Ensure that LANG is set to a locale supported by TXSeries.

Ensure that the locale is set in LANG variable is installed on the operating system. On AIX, you can use the locale -a command to list the available public locales installed on the server. Run the locale command to retrieve names and values of all current locale environment variables. Ensure that the LC_MESSAGES and LANG are in sync.
  • Ensure that the CICS user has read permission on all the catalog files provided by TXSeries from the corresponding locale message directory .
  • Check if the NLSPATH contains TXSeries_install_directory/msg/%L/%N path or not.
    NLSPATH should only contain path related to the message catalogs or language information. You can use two special variables, %N and %L in the NLSPATH environment variable. The %N variable is replaced by the catalog name referred to by the call that opens the message catalog. The %L variable is replaced by the value, LC_MESSAGES category. If you omit the %N variable in a directory specification within the NLSPATH environment variable, the application assumes that it defines a catalog name and opens it as such and will not traverse the rest of the search path. If NLSPATH contains other extraneous items, remove it from the NLSPATH settings.
      Note: Do not provide absolute file names such as or languages such as en_US in the NLSPATH definition.

      Example for a correct NLSPATH definition:
        # echo $NLSPATH

      Example for an incorrect NLSPATH definition:
        # echo $NLSPATH

      NLSPATH search will ignore the elements beyond /usr/lib/nls/en_US

      Document information

      More support for: TXSeries for Multiplatforms

      Software version: 6.2, 7.1

      Operating system(s): AIX, HP-UX, Solaris

      Reference #: 1610187

      Modified date: 21 August 2014

      Translate this page: