Stop (25)

The Stop operation (B_STOP) performs a number of termination routines for the client, such as releasing all locks and closing all open files associated with that client.

Parameters


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

Procedure

Set the Operation Code to 25.

Result

If the Stop operation is successful, the transactional interface performs the following actions:

Aborts any active transactions.

Releases all locks held by the client.

Closes all files open for the client.

If no other clients (other applications registered with the transactional interface) exist and depending on the transactional interface configuration, the transactional interface may terminate itself and free a number of resources.

If the Stop operation is unsuccessful, the transactional interface returns a nonzero status code. The most common nonzero Status Code is 20 (Record Manager Inactive). This status occurs because the transactional interface or the Requester is not loaded.

Positioning

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