Information Catalog Manager Programming Guide and Reference

FLGTerm

Ends the Information Catalog Manager API DLL environment, disconnects from the database manager, and frees all associated system resources.

Authorization

Administrator or user

Syntax

APIRET APIENTRY FLGTerm (PFLGEXTCODE pExtCode )

Parameters

pExtCode (PFLGEXTCODE) -- output

Points to an extended code associated with the reason code. See Appendix D, Information Catalog Manager reason codes to see if a meaningful extended code is associated with the returned reason code.

Reason code (APIRET)

Represents the execution result of this API call.

See Appendix D, Information Catalog Manager reason codes for an explanation of the returned reason codes.

Usage

When your program calls FLGTerm, the Information Catalog Manager automatically commits any uncommitted changes to the information catalog database. If any changes need to be rolled back, your program should call FLGRollback before calling FLGTerm to exit the Information Catalog Manager.

If the Information Catalog Manager encountered a severe error while trying to roll back the database, FLGTerm will encounter an error while shutting down the Information Catalog Manager and trying to release resources. If the person using your program is logged on as an administrator when the FLGTerm call fails, that person might need to use the Information Catalog Manager CLEARKA utility to log off the administrator user ID.

Examples

Figure 152 shows the C language code required to invoke the FLGTerm API call. This sample code stops the Information Catalog Manager API DLL.

Figure 152. Sample C language call to FLGTerm

. APIRET rc; // Reason code FLGEXTCODE ExtCode = 0; // Extended code . . // FLGInit() . // calls to the FLG API rc = FLGTerm ( &ExtCode );