CATOPEN(3,L)                AIX Technical Reference                CATOPEN(3,L)



-------------------------------------------------------------------------------
catopen



PURPOSE

Open a message catalog.

LIBRARY

Standard C Library (libc.a)

SYNTAX

#include <nl_types.h>

nl_catd catopen (filename, parm)
char *filename;
int parm

DESCRIPTION

The catopen subroutine opens a message catalog, which must be done before a
message can be extracted using catgets or catgetmsg.

The catalog descriptor nl_catd is defined in nl_types.h..  The filename
parameter is the name of the catalog to open and the parm parameter is reserved
for future use and should be set to zero.  The results of setting this field to
any other value is undefined.  If no / (slash) is in the filename, then NLSPATH
is used to resolve the path.  If there is one or more / (slash) in the
filename, an absolute path is assumed.

RETURN VALUE

A valid catalog descriptor (nl_catd) is returned if the catalog is successfully
opened; a -1 if an error occurred.  The catopen routine may fail due to an
invalid pathname for the catalog, or if more than NL_MAXOPEN catalogs are
currently open.

ERROR CONDITIONS

The catopen subroutine will fail if the following is true:

ENOMEM    Insufficient storage space is available.

RELATED INFORMATION

In this book:  "environment."

The gencat and mkcatdefs commands in AIX Operating System Commands Reference.




Processed November 7, 1990       CATOPEN(3,L)                                 1

CATOPEN(3,L)                AIX Technical Reference                CATOPEN(3,L)



The message catalog description in Managing the AIX Operating System.

In this book:  "catclose," "catgets" and "catgetmsg."




















































Processed November 7, 1990       CATOPEN(3,L)                                 2