xdmp.requestCancel

xdmp.requestCancel(
   hostID as (Number|String),
   serverID as (Number|String),
   requestID as (Number|String)
) as null

Summary

Cancel the request with the given host, server, and request IDs.

Parameters
hostID The ID of the host on which the request is running. Typically, you get the ID of a host by executing code similar to:
    xdmp:host("myhost")
serverID The ID of the App Server in which the request is running. Typically, you get the ID of an App Server by executing code similar to:
    xdmp:server("myAppServerName")
requestID The ID of the request. You can access the request IDs in the request elements of the xdmp:server-status output. You get the request ID by executing code similar to:
    declare namespace status=
        "http://marklogic.com/xdmp/status/server"

    xdmp:server-status( xdmp:host("myhost"),
      xdmp:server("myAppServerName") )//status:request
      

Required Privileges

http://marklogic.com/xdmp/privileges/cancel-any-request or http://marklogic.com/xdmp/privileges/cancel-my-requests

Usage Notes

To find out the status of the request after it has been canceled, you can call xdmp:server-status, which has information about each request active or being canceled on the server. Once a request has completed canceling, it will no longer appear in the output of xdmp:server-status.

Example

xdmp.requestCancel(xdmp.host("myhost"),
                      xdmp.server("myAppServerName"),
                      98394839084390843)
=> ()
Powered by MarkLogic Server | Terms of Use | Privacy Policy