11.8 Request Cancellation Transaction

11.8 Request Cancellation Transaction (Current)
Prev	11 Worklist Service and Resources	Next

This transaction allows a user agent that does not own a Workitem to request that it be canceled. It corresponds to the UPS DIMSE N-ACTION operation "Request UPS Cancel". See Section CC.2.2 in PS3.4 .

To cancel a Workitem that the user agent owns, i.e., that is in the IN PROGRESS state, the user agent uses the Change Workitem State transaction as described in Section 11.7.

11.8.1 Request

The request shall have the following syntax:

POST SP /workitems/{workitem}/cancelrequest SP version CRLF

Content-Type: dicom-media-type

(Content-Length: uint / Transfer-Encoding: encoding) CRLF

*(header-field CRLF)

CRLF

[Payload]

The user agent shall conform to the SCU behavior specified in Section CC.2.2.2 “Service Class User Behavior” in PS3.4.

11.8.1.1 Target Resources

The Target Resource for this transaction is a Workitem.

11.8.1.2 Query Parameters

The user agent shall supply, and the origin server shall support, the Common Query Parameters in Section 11.1.2.

11.8.1.3 Request Header Fields

The origin server shall support Header Fields as required in Table 11.8.1-1.

The user agent shall supply in the Request Header Fields as defined in Table 11.8.1-1.

Table 11.8.1-1. Request Header Fields

Name	Values	Usage		Description
Name	Values	User Agent	Origin Server	Description
Content-Type	dicom-media-type	M	M	The media-type of the payload.
Content-Length	uint	C	M	Shall be present if a transfer encoding has not been applied to the payload.
Transfer-Encoding	encoding	C	M	Shall be present if a transfer encoding has been applied to the payload.

11.8.1.4 Request Payload

The request payload, if present, may describe the reason for requesting the cancellation of the Workitem, a Contact Display Name, and/or a Contact URI for the person with whom the cancel request may be discussed.

The Request UPS Cancel Action Information is specified in Table CC.2.2-1 “Request UPS Cancel - Action Information” in PS3.4.

Prev	Up	Next
11.7.3.3 Response Payload	Home	11.8.2 Behavior