gtpc2m1d | C/C++ Language Support User's Guide |
This function is used to detach the TPFAR Structured Query Language
Transaction Profile (STP) and associated blocks from the ECB for later
reattachment to this or another ECB.
Format
#include <tpfarapi.h>
enum DBSDC_RETURN_CODE dbsdc(char *id);
- id
- A pointer to an 8-byte area where the function places the TPF Application
Requester (TPFAR) database support structure identifier.
Normal Return
- DBSDC_SUCCESSFUL
- Completed successfully.
Error Return
- DBSDC_NONE
- The TPFAR database support structure is not attached to the ECB.
Programming Considerations
- Structured query language (SQL) requests must have been previously issued
by this ECB.
- If the TPFAR database support structures are not reattached using the
dbsac function, conversations with the remote database are lost
until the next IPL.
- The TPFAR database support structure identifier returned is needed to
reattach the TPFAR database support structure later.
- The dbsdc.h function uses short-term pool files to save
the database support structure. The dbsac function must be
issued before the short-term pool directories are recycled.
Examples
The following example detaches the TPFAR database support structure from
the ECB.
#include <tpfarapi.h>
char id[8]
·
·
·
dbsdc(id);
Related Information