Function

catopen opens a message catalog that has been built by the gencat utility. (For more information about gencat, see the gencat command description in z/OS UNIX System Services Command Reference.) The catalog descriptor is returned in RETVAL.

Parameters

catalog name

The pathname for the message catalog. If the pathname contains a slash (/), the environment variables NLSPATH and LANG do not affect the resolution of the pathname.

Usage notes

1. The catalog descriptor returned in RETVAL can be used with the catgets and catclose commands. Do not use the catalog descriptor with any other commands.
2. If it is unsuccessful, catopen returns a -1 and sets ERRNO to indicate the error.