The CURSOR-STATUS field of the CURSOR-DESC structure is a bit mask that can take any combination of the values described in Table 2-6.
Value |
Meaning |
|---|---|
TDS-CURSTAT-DECLARED |
The cursor is declared. This status is reset after the next cursor command is processed. |
TDS-CURSTAT-OPEN |
The cursor is open. |
TDS-CURSTAT-ROWCNT |
The cursor specified the number of rows that should be returned for the TDS-CURSOR-FETCH command. |
TDS-CURSTAT-RDONLY |
The cursor is read only; it cannot be updated. The Open ServerConnect application should return an error to the client if TDS-CURSOR-UPDATE or TDS-CURSOR-DELETE is received for this cursor. |
TDS-CURSTAT-UPDATABLE |
The cursor can be updated. |
TDS-CURSTAT-CLOSED |
The cursor is closed, but not deallocated. It can be opened again later. This status is also set upon declaration of a cursor. Open ServerConnect clears it when a TDS-CURSOR-OPEN is received and resets it when a TDS-CURSOR-CLOSE is received. |
TDS-CURSTAT-DEALLOC |
The cursor is closed and deallocated. No other status flags should be set at this time. |
