Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

catclose(3) OSS Library Calls Reference Manual
NAME
catclose - Closes a specified message catalog
LIBRARY
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series OSS processes: /G/system/zdllnnn/zcrtldll
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).
1−38 Hewlett-Packard Company 527187-007