int KISAMAllocHandle(CHAND Chand, KHAND *pHandle)
Parameter | Type | Purpose |
Chand | CHAND | connection handle from previous KISAMConnect call |
pHandle | KHAND * | Address of location in which allocated table handle will be stored |
This should be called before a table is opened to allocate appropriate resources for the handle. It must be passed a connection handle Chand from a previously successful KISAMConnect call. If successful a call will return the next available handle number by copying it to the location whose address is passed in pHandle.
When no longer required the resources used by the handle must be released with a call to KISAMDropHandle.