cwbCO_DeleteSystem

Purpose

Deletes the system object that is specified by its handle, and frees all resources the system object has used.

Syntax

 
UINT CWB_ENTRY cwbCO_DeleteSystem(
                             cwbCO_SysHandle     system);

Parameters

cwbCO_SysHandle system - input

Handle that was returned by a previous call to either cwbCO_CreateSystem or cwbCO_CreateSystemLike. It identifies the iSeries™ system.

Return Codes

The following list shows common return values.

CWB_OK

Successful completion.

CWB_INVALID_API_HANDLE

Invalid system handle.

Usage

Before the system object resources are freed, if there are any connections that were made using the specified system object, they will be ended, forcefully if necessary. To determine if there are active connections, call cwbCO_IsConnected. If you want to know whether disconnecting any existing connections was successful, call cwbCO_Disconnect explicitly before calling this API.