Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (a - d) catclose(3)
NAME
catclose - Closes a specified message catalog
LIBRARY
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS
#include <nl_types.h>
int catclose (
nl_catd cat_descriptor);
PARAMETERS
cat_descriptor Specifies an index into the message catalog that is returned from a call to the
catopen( ) function.
DESCRIPTION
The catclose() function closes a message catalog specified by the cat_descriptor parameter.
If a program accesses several message catalogs, the NL_MAXOPEN number of open catalogs
can be reached. In this event, some message catalogs must be closed before more can be opened.
NOTES
The returned cat_descriptor pointer is not valid once the catclose( ) function has been called for
that cat_descriptor.
RETURN VALUES
Upon successful completion, a value of 0 (zero) is returned. If the cat_descriptor parameter
value is not valid, the catclose( ) function returns a value of -1.
RELATED INFORMATION
Functions: catopen(3), catgets(3).
Commands: gencat(1), mkcatdefs(1).
527187-017 Hewlett-Packard Company 1−87