dsmReleaseBuffer
The dsmReleaseBuffer function returns a buffer to IBM® Storage Protect. The application calls dsmReleaseBuffer after a dsmGetDataEx was called and the application has moved all the data out of the buffer and is ready to release it. dsmReleaseBuffer requires that dsmInitEx was called with the UseTsmBuffers set to btrue and a non-zero value was provided for numTsmBuffers. dsmReleaseBuffer should also be called if the application is about to call dsmTerminate and it still holds data buffers.
dsmReleaseBufferSyntax
dsInt16_t dsmReleaseBuffer (releaseBufferIn_t *dsmReleaseBufferInP,
releaseBufferOut_t *dsmReleaseBufferOutP) ;
Parameters
- releaseBufferIn_t * dsmReleaseBufferInP (I)
- This structure contains the following input parameters.
- dsUint32_t dsmHandle (I)
- The handle that associates this call with a previous dsmInitEx call.
- dsUint8_t tsmBufferHandle(I)
- The handle that identifies this buffer.
- char *dataPtr(I)
- The address to which the application is written.
Return codes
The return code numbers are provided in parentheses ( ).
| Return code | Explanation |
|---|---|
| DSM_RC_BAD_CALL_SEQUENCE | The call was not issued in the proper state. |
| DSM_RC_INVALID_TSMBUFFER | The handle or the value of dataPtr are invalid. |
| DSM_RC_BUFF_ARRAY_ERROR | A buffer array error occurred. |