oracledb 3.0.0 → 3.1.2

package/odpi/src/dpiSubscr.c

@@ -1,674 +0,0 @@
-//-----------------------------------------------------------------------------
-// Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
-// This program is free software: you can modify it and/or redistribute it
-// under the terms of:
-//
-// (i)  the Universal Permissive License v 1.0 or at your option, any
-//      later version (http://oss.oracle.com/licenses/upl); and/or
-//
-// (ii) the Apache License v 2.0. (http://www.apache.org/licenses/LICENSE-2.0)
-//-----------------------------------------------------------------------------
-
-//-----------------------------------------------------------------------------
-// dpiSubscr.c
-//   Implementation of subscriptions (CQN).
-//-----------------------------------------------------------------------------
-
-#include "dpiImpl.h"
-
-// forward declarations of internal functions only used in this file
-static void dpiSubscr__freeMessage(dpiSubscrMessage *message);
-static int dpiSubscr__populateMessage(dpiSubscr *subscr,
-        dpiSubscrMessage *message, void *descriptor, dpiError *error);
-static int dpiSubscr__populateMessageTable(dpiSubscr *subscr,
-        dpiSubscrMessageTable *table, void *descriptor, dpiError *error);
-static int dpiSubscr__populateQueryChangeMessage(dpiSubscr *subscr,
-        dpiSubscrMessage *message, void *descriptor, dpiError *error);
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__callback() [INTERNAL]
-//   Callback that is used to execute the callback registered when the
-// subscription was created.
-//-----------------------------------------------------------------------------
-static void dpiSubscr__callback(dpiSubscr *subscr, UNUSED void *handle,
-        UNUSED void *payload, UNUSED uint32_t payloadLength, void *descriptor,
-        UNUSED uint32_t mode)
-{
-    dpiSubscrMessage message;
-    dpiErrorInfo errorInfo;
-    dpiError error;
-
-    // ensure that the subscription handle is still valid
-    if (dpiGen__startPublicFn(subscr, DPI_HTYPE_SUBSCR, __func__, 1,
-            &error) < 0)
-        dpiGen__endPublicFn(subscr, DPI_FAILURE, &error);
-
-    // populate message
-    memset(&message, 0, sizeof(message));
-    if (dpiSubscr__populateMessage(subscr, &message, descriptor, &error) < 0) {
-        dpiError__getInfo(&error, &errorInfo);
-        message.errorInfo = &errorInfo;
-    }
-    message.registered = subscr->registered;
-
-    // invoke user callback
-    (*subscr->callback)(subscr->callbackContext, &message);
-
-    // clean up message
-    dpiSubscr__freeMessage(&message);
-    dpiGen__endPublicFn(subscr, DPI_SUCCESS, &error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__check() [INTERNAL]
-//   Determine if the subscription is open and available for use.
-//-----------------------------------------------------------------------------
-static int dpiSubscr__check(dpiSubscr *subscr, const char *fnName,
-        dpiError *error)
-{
-    if (dpiGen__startPublicFn(subscr, DPI_HTYPE_SUBSCR, fnName, 1, error) < 0)
-        return DPI_FAILURE;
-    if (!subscr->handle)
-        return dpiError__set(error, "check closed", DPI_ERR_SUBSCR_CLOSED);
-    return dpiConn__checkConnected(subscr->conn, error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__create() [INTERNAL]
-//   Create a new subscription structure and return it. In case of error NULL
-// is returned.
-//-----------------------------------------------------------------------------
-int dpiSubscr__create(dpiSubscr *subscr, dpiConn *conn,
-        dpiSubscrCreateParams *params, dpiError *error)
-{
-    uint32_t qosFlags;
-    int32_t int32Val;
-    int rowids;
-
-    // retain a reference to the connection
-    dpiGen__setRefCount(conn, error, 1);
-    subscr->conn = conn;
-    subscr->callback = params->callback;
-    subscr->callbackContext = params->callbackContext;
-    subscr->subscrNamespace = params->subscrNamespace;
-    subscr->qos = params->qos;
-
-    // create the subscription handle
-    if (dpiOci__handleAlloc(conn->env->handle, &subscr->handle,
-            DPI_OCI_HTYPE_SUBSCRIPTION, "create subscr handle", error) < 0)
-        return DPI_FAILURE;
-
-    // set the namespace
-    if (dpiOci__attrSet(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION,
-            (void*) &params->subscrNamespace, sizeof(uint32_t),
-            DPI_OCI_ATTR_SUBSCR_NAMESPACE, "set namespace", error) < 0)
-        return DPI_FAILURE;
-
-    // set the protocol
-    if (dpiOci__attrSet(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION,
-            (void*) &params->protocol, sizeof(uint32_t),
-            DPI_OCI_ATTR_SUBSCR_RECPTPROTO, "set protocol", error) < 0)
-        return DPI_FAILURE;
-
-    // set the timeout
-    if (dpiOci__attrSet(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION,
-            (void*) &params->timeout, sizeof(uint32_t),
-            DPI_OCI_ATTR_SUBSCR_TIMEOUT, "set timeout", error) < 0)
-        return DPI_FAILURE;
-
-    // set the IP address used on the client to listen for events
-    if (params->ipAddress && params->ipAddressLength > 0 &&
-            dpiOci__attrSet(subscr->env->handle, DPI_OCI_HTYPE_ENV,
-                    (void*) params->ipAddress, params->ipAddressLength,
-                    DPI_OCI_ATTR_SUBSCR_IPADDR, "set IP address", error) < 0)
-        return DPI_FAILURE;
-
-    // set the port number used on the client to listen for events
-    if (params->portNumber > 0 && dpiOci__attrSet(subscr->env->handle,
-            DPI_OCI_HTYPE_ENV, (void*) &params->portNumber, 0,
-            DPI_OCI_ATTR_SUBSCR_PORTNO, "set port number", error) < 0)
-        return DPI_FAILURE;
-
-    // set the context for the callback
-    if (dpiOci__attrSet(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION,
-            (void*) subscr, 0, DPI_OCI_ATTR_SUBSCR_CTX, "set callback context",
-            error) < 0)
-        return DPI_FAILURE;
-
-    // set the callback, if applicable
-    if (params->callback && dpiOci__attrSet(subscr->handle,
-            DPI_OCI_HTYPE_SUBSCRIPTION, (void*) dpiSubscr__callback, 0,
-            DPI_OCI_ATTR_SUBSCR_CALLBACK, "set callback", error) < 0)
-        return DPI_FAILURE;
-
-    // set the subscription name, if applicable
-    if (params->name && params->nameLength > 0 &&
-            dpiOci__attrSet(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION,
-                    (void*) params->name, params->nameLength,
-                    DPI_OCI_ATTR_SUBSCR_NAME, "set name", error) < 0)
-        return DPI_FAILURE;
-
-    // set QOS flags
-    qosFlags = 0;
-    if (params->qos & DPI_SUBSCR_QOS_RELIABLE)
-        qosFlags |= DPI_OCI_SUBSCR_QOS_RELIABLE;
-    if (params->qos & DPI_SUBSCR_QOS_DEREG_NFY)
-        qosFlags |= DPI_OCI_SUBSCR_QOS_PURGE_ON_NTFN;
-    if (qosFlags && dpiOci__attrSet(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION,
-            (void*) &qosFlags, sizeof(uint32_t), DPI_OCI_ATTR_SUBSCR_QOSFLAGS,
-            "set QOS", error) < 0)
-        return DPI_FAILURE;
-
-    // set CQ specific QOS flags
-    qosFlags = 0;
-    if (params->qos & DPI_SUBSCR_QOS_QUERY)
-        qosFlags |= DPI_OCI_SUBSCR_CQ_QOS_QUERY;
-    if (params->qos & DPI_SUBSCR_QOS_BEST_EFFORT)
-        qosFlags |= DPI_OCI_SUBSCR_CQ_QOS_BEST_EFFORT;
-    if (qosFlags && dpiOci__attrSet(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION,
-            (void*) &qosFlags, sizeof(uint32_t),
-            DPI_OCI_ATTR_SUBSCR_CQ_QOSFLAGS, "set CQ QOS", error) < 0)
-        return DPI_FAILURE;
-
-    // set rowids flag, if applicable
-    if (params->qos & DPI_SUBSCR_QOS_ROWIDS) {
-        rowids = 1;
-        if (dpiOci__attrSet(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION,
-                (void*) &rowids, 0, DPI_OCI_ATTR_CHNF_ROWIDS,
-                "set rowids flag", error) < 0)
-            return DPI_FAILURE;
-    }
-
-    // set which operations are desired, if applicable
-    if (params->operations && dpiOci__attrSet(subscr->handle,
-            DPI_OCI_HTYPE_SUBSCRIPTION, (void*) &params->operations, 0,
-            DPI_OCI_ATTR_CHNF_OPERATIONS, "set operations", error) < 0)
-        return DPI_FAILURE;
-
-    // set grouping information, if applicable
-    if (params->groupingClass) {
-
-        // set grouping class
-        if (dpiOci__attrSet(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION,
-                (void*) &params->groupingClass, 0,
-                DPI_OCI_ATTR_SUBSCR_NTFN_GROUPING_CLASS, "set grouping class",
-                error) < 0)
-            return DPI_FAILURE;
-
-        // set grouping value
-        if (dpiOci__attrSet(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION,
-                (void*) &params->groupingValue, 0,
-                DPI_OCI_ATTR_SUBSCR_NTFN_GROUPING_VALUE, "set grouping value",
-                error) < 0)
-            return DPI_FAILURE;
-
-        // set grouping type
-        if (dpiOci__attrSet(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION,
-                (void*) &params->groupingType, 0,
-                DPI_OCI_ATTR_SUBSCR_NTFN_GROUPING_TYPE, "set grouping type",
-                error) < 0)
-            return DPI_FAILURE;
-
-        // set grouping repeat count
-        int32Val = DPI_SUBSCR_GROUPING_FOREVER;
-        if (dpiOci__attrSet(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION,
-                (void*) &int32Val, 0,
-                DPI_OCI_ATTR_SUBSCR_NTFN_GROUPING_REPEAT_COUNT,
-                "set grouping repeat count", error) < 0)
-            return DPI_FAILURE;
-
-    }
-
-    // register the subscription
-    if (dpiOci__subscriptionRegister(conn, &subscr->handle, error) < 0)
-        return DPI_FAILURE;
-    subscr->registered = 1;
-
-    return DPI_SUCCESS;
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__free() [INTERNAL]
-//   Free the memory and any resources associated with the subscription.
-//-----------------------------------------------------------------------------
-void dpiSubscr__free(dpiSubscr *subscr, dpiError *error)
-{
-    if (subscr->handle) {
-        if (subscr->registered)
-            dpiOci__subscriptionUnRegister(subscr->conn, subscr, error);
-        dpiOci__handleFree(subscr->handle, DPI_OCI_HTYPE_SUBSCRIPTION);
-        subscr->handle = NULL;
-    }
-    if (subscr->conn) {
-        dpiGen__setRefCount(subscr->conn, error, -1);
-        subscr->conn = NULL;
-    }
-    dpiUtils__freeMemory(subscr);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__freeMessage() [INTERNAL]
-//   Free memory associated with the message.
-//-----------------------------------------------------------------------------
-static void dpiSubscr__freeMessage(dpiSubscrMessage *message)
-{
-    dpiSubscrMessageQuery *query;
-    uint32_t i, j;
-
-    // free the tables for the message
-    if (message->numTables > 0) {
-        for (i = 0; i < message->numTables; i++) {
-            if (message->tables[i].numRows > 0)
-                dpiUtils__freeMemory(message->tables[i].rows);
-        }
-        dpiUtils__freeMemory(message->tables);
-    }
-
-    // free the queries for the message
-    if (message->numQueries > 0) {
-        for (i = 0; i < message->numQueries; i++) {
-            query = &message->queries[i];
-            if (query->numTables > 0) {
-                for (j = 0; j < query->numTables; j++) {
-                    if (query->tables[i].numRows > 0)
-                        dpiUtils__freeMemory(query->tables[i].rows);
-                }
-                dpiUtils__freeMemory(query->tables);
-            }
-        }
-        dpiUtils__freeMemory(message->queries);
-    }
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__populateAQMessage() [INTERNAL]
-//   Populate message with details.
-//-----------------------------------------------------------------------------
-static int dpiSubscr__populateAQMessage(dpiSubscr *subscr,
-        dpiSubscrMessage *message, void *descriptor, dpiError *error)
-{
-    uint32_t flags = 0;
-
-    // determine if message is a deregistration message
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_AQNFY_DESCRIPTOR, &flags,
-            NULL, DPI_OCI_ATTR_NFY_FLAGS, "get flags", error) < 0)
-        return DPI_FAILURE;
-    message->eventType = (flags == 1) ? DPI_EVENT_DEREG : DPI_EVENT_AQ;
-    if (message->eventType == DPI_EVENT_DEREG) {
-        subscr->registered = 0;
-        return DPI_SUCCESS;
-    }
-
-    // determine the name of the queue which spawned the event
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_AQNFY_DESCRIPTOR,
-            (void*) &message->queueName, &message->queueNameLength,
-            DPI_OCI_ATTR_QUEUE_NAME, "get queue name", error) < 0)
-        return DPI_FAILURE;
-
-    // determine the consumer name for the queue that spawned the event
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_AQNFY_DESCRIPTOR,
-            (void*) &message->consumerName, &message->consumerNameLength,
-            DPI_OCI_ATTR_CONSUMER_NAME, "get consumer name", error) < 0)
-        return DPI_FAILURE;
-
-    return DPI_SUCCESS;
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__populateObjectChangeMessage() [INTERNAL]
-//   Populate object change message with details.
-//-----------------------------------------------------------------------------
-static int dpiSubscr__populateObjectChangeMessage(dpiSubscr *subscr,
-        dpiSubscrMessage *message, void *descriptor, dpiError *error)
-{
-    void **tableDescriptor, *indicator;
-    int32_t numTables;
-    void *tables;
-    uint32_t i;
-    int exists;
-
-    // determine table collection
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_CHDES, &tables, 0,
-            DPI_OCI_ATTR_CHDES_TABLE_CHANGES, "get tables", error) < 0)
-        return DPI_FAILURE;
-    if (!tables)
-        return DPI_SUCCESS;
-
-    // determine number of tables
-    if (dpiOci__collSize(subscr->conn, tables, &numTables, error) < 0)
-        return DPI_FAILURE;
-
-    // allocate memory for table entries
-    if (dpiUtils__allocateMemory((size_t) numTables,
-            sizeof(dpiSubscrMessageTable), 1, "allocate msg tables",
-            (void**) &message->tables, error) < 0)
-        return DPI_FAILURE;
-    message->numTables = (uint32_t) numTables;
-
-    // populate message table entries
-    for (i = 0; i < message->numTables; i++) {
-        if (dpiOci__collGetElem(subscr->conn, tables, (int32_t) i, &exists,
-                (void**) &tableDescriptor, &indicator, error) < 0)
-            return DPI_FAILURE;
-        if (dpiSubscr__populateMessageTable(subscr, &message->tables[i],
-                *tableDescriptor, error) < 0)
-            return DPI_FAILURE;
-    }
-
-    return DPI_SUCCESS;
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__populateMessage() [INTERNAL]
-//   Populate message with details.
-//-----------------------------------------------------------------------------
-static int dpiSubscr__populateMessage(dpiSubscr *subscr,
-        dpiSubscrMessage *message, void *descriptor, dpiError *error)
-{
-    void *rawValue;
-
-    // if quality of service flag indicates that deregistration should take
-    // place when the first notification is received, mark the subscription
-    // as no longer registered
-    if (subscr->qos & DPI_SUBSCR_QOS_DEREG_NFY)
-        subscr->registered = 0;
-
-    // handle AQ messages, if applicable
-    if (subscr->subscrNamespace == DPI_SUBSCR_NAMESPACE_AQ)
-        return dpiSubscr__populateAQMessage(subscr, message, descriptor,
-                error);
-
-    // determine the type of event that was spawned
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_CHDES, &message->eventType,
-            NULL, DPI_OCI_ATTR_CHDES_NFYTYPE, "get event type", error) < 0)
-        return DPI_FAILURE;
-
-    // determine the name of the database which spawned the event
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_CHDES,
-            (void*) &message->dbName, &message->dbNameLength,
-            DPI_OCI_ATTR_CHDES_DBNAME, "get DB name", error) < 0)
-        return DPI_FAILURE;
-
-    // determine the id of the transaction which spawned the event
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_CHDES, &rawValue, NULL,
-            DPI_OCI_ATTR_CHDES_XID, "get transaction id", error) < 0)
-        return DPI_FAILURE;
-    dpiOci__rawPtr(subscr->env->handle, rawValue, (void**) &message->txId);
-    dpiOci__rawSize(subscr->env->handle, rawValue, &message->txIdLength);
-
-    // populate event specific attributes
-    switch (message->eventType) {
-        case DPI_EVENT_OBJCHANGE:
-            return dpiSubscr__populateObjectChangeMessage(subscr, message,
-                    descriptor, error);
-        case DPI_EVENT_QUERYCHANGE:
-            return dpiSubscr__populateQueryChangeMessage(subscr, message,
-                    descriptor, error);
-        case DPI_EVENT_DEREG:
-            subscr->registered = 0;
-            break;
-        default:
-            return dpiError__set(error, "event type", DPI_ERR_NOT_SUPPORTED);
-    }
-
-    return DPI_SUCCESS;
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__populateMessageQuery() [INTERNAL]
-//   Populate a message query structure from the OCI descriptor.
-//-----------------------------------------------------------------------------
-static int dpiSubscr__populateMessageQuery(dpiSubscr *subscr,
-        dpiSubscrMessageQuery *query, void *descriptor, dpiError *error)
-{
-    void **tableDescriptor, *indicator, *tables;
-    int32_t numTables;
-    uint32_t i;
-    int exists;
-
-    // determine query id
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_CQDES, &query->id, 0,
-            DPI_OCI_ATTR_CQDES_QUERYID, "get id", error) < 0)
-        return DPI_FAILURE;
-
-    // determine operation
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_CQDES, &query->operation, 0,
-            DPI_OCI_ATTR_CQDES_OPERATION, "get operation", error) < 0)
-        return DPI_FAILURE;
-
-    // determine table collection
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_CQDES, &tables, 0,
-            DPI_OCI_ATTR_CQDES_TABLE_CHANGES, "get table descriptor",
-            error) < 0)
-        return DPI_FAILURE;
-    if (!tables)
-        return DPI_SUCCESS;
-
-    // determine number of tables
-    if (dpiOci__collSize(subscr->conn, tables, &numTables, error) < 0)
-        return DPI_FAILURE;
-
-    // allocate memory for table entries
-    if (dpiUtils__allocateMemory((size_t) numTables,
-            sizeof(dpiSubscrMessageTable), 1, "allocate query tables",
-            (void**) &query->tables, error) < 0)
-        return DPI_FAILURE;
-    query->numTables = (uint32_t) numTables;
-
-    // populate message table entries
-    for (i = 0; i < query->numTables; i++) {
-        if (dpiOci__collGetElem(subscr->conn, tables, (int32_t) i, &exists,
-                (void**) &tableDescriptor, &indicator, error) < 0)
-            return DPI_FAILURE;
-        if (dpiSubscr__populateMessageTable(subscr, &query->tables[i],
-                *tableDescriptor, error) < 0)
-            return DPI_FAILURE;
-    }
-
-    return DPI_SUCCESS;
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__populateMessageRow() [INTERNAL]
-//   Populate a message row structure from the OCI descriptor.
-//-----------------------------------------------------------------------------
-static int dpiSubscr__populateMessageRow(dpiSubscrMessageRow *row,
-        void *descriptor, dpiError *error)
-{
-    // determine operation
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_ROW_CHDES, &row->operation,
-            0, DPI_OCI_ATTR_CHDES_ROW_OPFLAGS, "get operation", error) < 0)
-        return DPI_FAILURE;
-
-    // determine rowid
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_ROW_CHDES,
-            (void*) &row->rowid, &row->rowidLength,
-            DPI_OCI_ATTR_CHDES_ROW_ROWID, "get rowid", error) < 0)
-        return DPI_FAILURE;
-
-    return DPI_SUCCESS;
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__populateMessageTable() [INTERNAL]
-//   Populate a message table structure from the OCI descriptor.
-//-----------------------------------------------------------------------------
-static int dpiSubscr__populateMessageTable(dpiSubscr *subscr,
-        dpiSubscrMessageTable *table, void *descriptor, dpiError *error)
-{
-    void **rowDescriptor, *indicator, *rows;
-    int32_t numRows;
-    int exists;
-    uint32_t i;
-
-    // determine operation
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_TABLE_CHDES,
-            &table->operation, 0, DPI_OCI_ATTR_CHDES_TABLE_OPFLAGS,
-            "get operation", error) < 0)
-        return DPI_FAILURE;
-
-    // determine table name
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_TABLE_CHDES,
-            (void*) &table->name, &table->nameLength,
-            DPI_OCI_ATTR_CHDES_TABLE_NAME, "get table name", error) < 0)
-        return DPI_FAILURE;
-
-    // if change invalidated all rows, nothing to do
-    if (table->operation & DPI_OPCODE_ALL_ROWS)
-        return DPI_SUCCESS;
-
-    // determine rows collection
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_TABLE_CHDES, &rows, 0,
-            DPI_OCI_ATTR_CHDES_TABLE_ROW_CHANGES, "get rows descriptor",
-            error) < 0)
-        return DPI_FAILURE;
-
-    // determine number of rows in collection
-    if (dpiOci__collSize(subscr->conn, rows, &numRows, error) < 0)
-        return DPI_FAILURE;
-
-    // allocate memory for row entries
-    if (dpiUtils__allocateMemory((size_t) numRows, sizeof(dpiSubscrMessageRow),
-            1, "allocate rows", (void**) &table->rows, error) < 0)
-        return DPI_FAILURE;
-    table->numRows = (uint32_t) numRows;
-
-    // populate the rows attribute
-    for (i = 0; i < table->numRows; i++) {
-        if (dpiOci__collGetElem(subscr->conn, rows, (int32_t) i, &exists,
-                (void**) &rowDescriptor, &indicator, error) < 0)
-            return DPI_FAILURE;
-        if (dpiSubscr__populateMessageRow(&table->rows[i], *rowDescriptor,
-                error) < 0)
-            return DPI_FAILURE;
-    }
-
-    return DPI_SUCCESS;
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__populateQueryChangeMessage() [INTERNAL]
-//   Populate query change message with details.
-//-----------------------------------------------------------------------------
-static int dpiSubscr__populateQueryChangeMessage(dpiSubscr *subscr,
-        dpiSubscrMessage *message, void *descriptor, dpiError *error)
-{
-    void **queryDescriptor, *indicator, *queries;
-    int32_t numQueries;
-    int exists;
-    uint32_t i;
-
-    // determine query collection
-    if (dpiOci__attrGet(descriptor, DPI_OCI_DTYPE_CHDES, &queries, 0,
-            DPI_OCI_ATTR_CHDES_QUERIES, "get queries", error) < 0)
-        return DPI_FAILURE;
-    if (!queries)
-        return DPI_SUCCESS;
-
-    // determine number of queries
-    if (dpiOci__collSize(subscr->conn, queries, &numQueries, error) < 0)
-        return DPI_FAILURE;
-
-    // allocate memory for query entries
-    if (dpiUtils__allocateMemory((size_t) numQueries,
-            sizeof(dpiSubscrMessageQuery), 1, "allocate queries",
-            (void**) &message->queries, error) < 0)
-        return DPI_FAILURE;
-    message->numQueries = (uint32_t) numQueries;
-
-    // populate each entry with a message query instance
-    for (i = 0; i < message->numQueries; i++) {
-        if (dpiOci__collGetElem(subscr->conn, queries, (int32_t) i, &exists,
-                (void**) &queryDescriptor, &indicator, error) < 0)
-            return DPI_FAILURE;
-        if (dpiSubscr__populateMessageQuery(subscr, &message->queries[i],
-                *queryDescriptor, error) < 0)
-            return DPI_FAILURE;
-    }
-
-    return DPI_SUCCESS;
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr__prepareStmt() [INTERNAL]
-//   Internal method for preparing statement against a subscription. This
-// allows for normal error processing without having to worry about freeing the
-// statement for every error that might take place.
-//-----------------------------------------------------------------------------
-static int dpiSubscr__prepareStmt(dpiSubscr *subscr, dpiStmt *stmt,
-        const char *sql, uint32_t sqlLength, dpiError *error)
-{
-    // prepare statement for execution
-    if (dpiStmt__prepare(stmt, sql, sqlLength, NULL, 0, error) < 0)
-        return DPI_FAILURE;
-
-    // fetch array size is set to 1 in order to avoid over allocation since
-    // the query is not really going to be used for fetching rows, just for
-    // registration
-    stmt->fetchArraySize = 1;
-
-    // set subscription handle
-    return dpiOci__attrSet(stmt->handle, DPI_OCI_HTYPE_STMT, subscr->handle, 0,
-            DPI_OCI_ATTR_CHNF_REGHANDLE, "set subscription handle", error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr_addRef() [PUBLIC]
-//   Add a reference to the subscription.
-//-----------------------------------------------------------------------------
-int dpiSubscr_addRef(dpiSubscr *subscr)
-{
-    return dpiGen__addRef(subscr, DPI_HTYPE_SUBSCR, __func__);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr_prepareStmt() [PUBLIC]
-//   Prepare statement for registration with subscription.
-//-----------------------------------------------------------------------------
-int dpiSubscr_prepareStmt(dpiSubscr *subscr, const char *sql,
-        uint32_t sqlLength, dpiStmt **stmt)
-{
-    dpiStmt *tempStmt;
-    dpiError error;
-
-    if (dpiSubscr__check(subscr, __func__, &error) < 0)
-        return dpiGen__endPublicFn(subscr, DPI_FAILURE, &error);
-    DPI_CHECK_PTR_NOT_NULL(subscr, sql)
-    DPI_CHECK_PTR_NOT_NULL(subscr, stmt)
-    if (dpiStmt__allocate(subscr->conn, 0, &tempStmt, &error) < 0)
-        return dpiGen__endPublicFn(subscr, DPI_FAILURE, &error);
-    if (dpiSubscr__prepareStmt(subscr, tempStmt, sql, sqlLength,
-            &error) < 0) {
-        dpiStmt__free(tempStmt, &error);
-        return dpiGen__endPublicFn(subscr, DPI_FAILURE, &error);
-    }
-
-    *stmt = tempStmt;
-    return dpiGen__endPublicFn(subscr, DPI_SUCCESS, &error);
-}
-
-
-//-----------------------------------------------------------------------------
-// dpiSubscr_release() [PUBLIC]
-//   Release a reference to the subscription.
-//-----------------------------------------------------------------------------
-int dpiSubscr_release(dpiSubscr *subscr)
-{
-    return dpiGen__release(subscr, DPI_HTYPE_SUBSCR, __func__);
-}
-