sam_closecat - Closes a catalog handle
cc [ flag ... ] file ... -L/opt/SUNWsamfs/lib -lsam [library ... ]
int sam_closecat(int cat_handle);
32-bit programs only
sam_closecat() deallocates the catalog handle indicated by
cat_handle. cat_handle is a catalog "handle" obtained from
a previous call to sam_opencat(). Deallocation of the cata-
log handle ends access to the automated library catalog that
it referred to, and makes the catalog handle available for
return by subsequent calls to sam_opencat().
Upon successful completion, a value of 0 is returned. Oth-
erwise, a value of -1 is returned and errno is set to indi-
cate the error.
sam_closecat() fails if one or more of the following error
conditions are true:
EBADFILE cat_handle is invalid.