Reset (28)

The Reset operation (B_RESET) releases all resources held by a client. This operation aborts any transactions the client has pending, releases all locks, and closes all open files for the client.

Parameters


	Op Code	Pos Block	Data Buf	Data Buf Len	Key Buffer	Key Number
Sent
Returned

Prerequisites

Your application can issue a Reset operation at any time after the MicroKernel or Requester is loaded, as long as the client issuing the Reset call has established a connection with the MicroKernel-for example, by opening a file or by requesting the status of a file using a Btrieve utility.

Procedure

Set the Operation Code to 28.

Set the Key Number and Key Buffer to 0.

Result

If the Reset operation is successful, the MicroKernel performs the following actions for the specified client, window, or session:

Aborts any active transactions.

Releases all locks held.

Closes all open files.

If the Reset operation is unsuccessful, the MicroKernel returns a nonzero status code.

Positioning

The Reset operation destroys all currencies because it closes any open files.