Usage Notes
The Token field is used to specify a user-defined identifier for the request.
| Language | Variable Name |
|---|---|
| COBOL: | DBCAREA-TOKEN |
| C: DBCAREA.H: | token |
| Routine | Action Taken |
|---|---|
| DBCHINI: | writes |
| DBCHCL: | reads (CON; RSUP; IRQ) |
| DBCHWAT: | uses |
| Used by | Action Taken |
|---|---|
| application program | writes |
Token is maintained for each request and is returned by DBCHWAT when a pending request has completed its transfer.
At the application programmer’s discretion, it may be used in whatever way is useful. It is primarily used by application programs running concurrent requests or sessions. It is most often used to index into or point to some application-program-maintained request context, so that an actual request id and session id can be retrieved for later calls to fetch, rewind, abort, or end request.