::nsmcp::Tool ::nsmcp::Tool describe execute init jsonArguments name permission validate ::nsmcp::Object ::nsmcp::Object dict getdef ::nsmcp::Tool->::nsmcp::Object ::nsmcp::RequestRoutingTool ::nsmcp::RequestRoutingTool contextSupported encodeSnapshot execute mapped snapshot ::nsmcp::RequestRoutingTool->::nsmcp::Tool

Class ::nsmcp::RequestRoutingTool

::nsmcp::RequestRoutingTool[i] create ... \
           [ -adminExample (default "") ] \
           [ -adminSummary (default "") ] \
           [ -description (default "Inspect effective connection-pool mappings and registered filters for the authenticated server. Runtime ns_server data, not configuration guesses. Filter registrations include authentication, request processing and other purposes; names do not establish behavior. Does not execute filters or read implementation files.") ] \
           [ -inputSchema (default "
        {
            "type": "object",
            "properties": {},
            "additionalProperties": false
        }
    ") ] \
           [ -name (default "server_request_routing") ] \
           [ -outputSchema (default "") ] \
           [ -permission (default "diagnostics.runtime.read") ] \
           [ -redactor:required redactor:required ]
Defined in /usr/local/ns/tcl/nsmcp/traffic-tools.tcl

Class Relations

  • class: ::nx::Class[i]
  • superclass: ::nsmcp::Tool[i]

Methods (to be applied on instances)

  • contextSupported (scripted, public)

     <instance of nsmcp::RequestRoutingTool[i]> contextSupported server

    Probe whether native routing supports a request-context ns_set. Use a temporary context and release it even when the capability probe fails.

    Parameters:
    server (required)
    Selected NaviServer virtual-server name.
    Returns:
    True when contextual routing lookup is supported, otherwise false.

    Testcases:
    No testcase defined.

  • encodeSnapshot (scripted, public)

     <instance of nsmcp::RequestRoutingTool[i]> encodeSnapshot snapshot

    Encode a routing snapshot as typed JSON fields. Retain route order and availability metadata while converting Tcl containers to arrays and objects.

    Parameters:
    snapshot (required)
    Routing snapshot with availability metadata.
    Returns:
    The field triples for the encoded routing snapshot.

    Testcases:
    No testcase defined.

  • execute (scripted, public)

     <instance of nsmcp::RequestRoutingTool[i]> execute context \
    arguments

    Describe the selected server's request-routing configuration. Capture pool/filter maps and whether native contextual lookup is supported.

    Parameters:
    context (required)
    Authenticated request context carrying the principal, grants and selected server.
    arguments (required)
    Rooted ns_json typed triples for the tool's JSON argument object.
    Returns:
    A rooted JSON tool-result object, including availability or job metadata as appropriate.

    Testcases:
    No testcase defined.

  • mapped (scripted, public)

     <instance of nsmcp::RequestRoutingTool[i]> mapped server record

    Resolve one request against native pool mapping. Populate a temporary request context from available record fields, perform the lookup and release the ns_set.

    Parameters:
    server (required)
    Selected NaviServer virtual-server name.
    record (required)
    Recorded request fields or routing-evidence dictionary.
    Returns:
    The native mapping result for the request.

    Testcases:
    No testcase defined.

  • snapshot (scripted, public)

     <instance of nsmcp::RequestRoutingTool[i]> snapshot server

    Capture configured request-pool and filter routing information. Record unavailable runtime observations explicitly instead of inferring missing routes.

    Parameters:
    server (required)
    Selected NaviServer virtual-server name.
    Returns:
    The routing snapshot dictionary with pools, filters and availability metadata.

    Testcases:
    No testcase defined.