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:
1
Aborts any active transactions.
2
Releases all locks held by the client.
3
Closes all files open for the client.
4
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.