nsmcp::LogCorrelation method results (public)

 <instance of nsmcp::LogCorrelation> results handle [ cursor ] \
    [ limit ]

Defined in /usr/local/ns/tcl/nsmcp/log-traffic-unified.tcl

Retrieve a page from a correlation service's cached searches. Try the configured system and access searches; propagate an unknown-handle error when none owns the result.

Parameters:

handle (required)

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

cursor (optional, defaults to "0")

Zero-based cursor into retained results. Defaults to '0'.

limit (optional, defaults to "20")

Maximum number of records or entries to return. Defaults to '20'.

Returns:

The matching cached result page.

Testcases:

No testcase defined.

Source code:

foreach source [list ${:systemSearch} {*}${:accessSearches}] {
    try {
        return [$source results $handle $cursor $limit]
    } trap {NSMCP RESULT UNKNOWN} {} {
        # Try the next configured source, never a caller-supplied path.
    }
}
return -code error -errorcode {NSMCP RESULT UNKNOWN} "unknown or expired result handle"

XQL Not present:

Generic, PostgreSQL, Oracle