Usage Notes
using-data-count is a four byte field that indicates that using-data-ptr-array addresses a list of pointers to areas containing data that is referred to by the USING clause in the request string. The number of pointers in the list is the value of using-data-count.
Similarly, if Variable-length-request is not specified, using-data-length-vector either contains the length of the using-data or addresses a list of four byte values containing the length of each area of using-data. If Variable-length-request is specified, using-data-length-vector is unused.
using-data-pointer (along with the associated length) is functionally equivalent to using-data-count of one (along with the associated data and lengths).
A using-data-count of one (along with the associated data and lengths) is functionally equivalent to the existing using-data-pointer (along with the associated length). A using-data-count greater than one will be rejected if the server does not support Array Operations. The DBCHQE Array-operations may be used to ascertain whether the server supports this feature.
Language | Variable Name |
---|---|
COBOL: | DBCAREA-USING-DATA-COUNT |
C: DBCAREA.H: | using_data_count |
Routine | Action Taken |
---|---|
DBCHINI | writes |
DBCHCL | reads (RSUP; IWPF; IRQ) |
Used by | Action Taken |
---|---|
application program | writes |