MarkLogic 9 Product Documentation
xdmp.requestCancelxdmp.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)
=> ()
Copyright © 2024 MarkLogic Corporation. MARKLOGIC is a
registered trademark of MarkLogic Corporation.