nsmcp::LogService method accessProgress (public)

 <instance of nsmcp::LogService> accessProgress handle fields

Defined in /usr/local/ns/tcl/nsmcp/log-tools.tcl

Update retained progress for an access scan. Merge progress fields only while the job handle still exists, under the service mutex.

Parameters:

handle (required)

Retained job or conversation handle; ownership and expiry checks still apply.

fields (required)

Dictionary of fields supplied by the callback or progress producer.

Returns:

An update result, or an empty result for an expired job.

Testcases:

No testcase defined.

Source code:

ns_mutex lock ${:mutex}
try {
    if {![nsv_exists ${:store} $handle]} {
        return
    }
    set record [nsv_get ${:store} $handle]
    if {[dict get $record status] ne "running"} {
        return
    }
    dict set record progress $fields
    nsv_set ${:store} $handle $record
} finally {
    ns_mutex unlock ${:mutex}
}

XQL Not present:

Generic, PostgreSQL, Oracle