The DIMSE Services shown in Table CC.2-1, Table CC.2-2, Table CC.2-3 and Table CC.2-4 are applicable to the Unified Procedure Step (UPS) IOD under the UPS Push, UPS Pull, UPS Watch and UPS Event SOP Classes respectively.
Table CC.2-1. DIMSE Service Group - UPS Push
DIMSE Service Element |
Usage SCU/SCP |
---|---|
N-CREATE |
M/M |
N-ACTION - Request UPS Cancel |
M/M |
Table CC.2-2. DIMSE Service Group - UPS Pull
DIMSE Service Element |
Usage SCU/SCP |
---|---|
C-FIND |
M/M |
N-GET |
M/M |
N-SET |
M/M |
N-ACTION - Change UPS State |
M/M |
Table CC.2-3. DIMSE Service Group - UPS Watch
DIMSE Service Element |
SCU/SCP |
---|---|
N-ACTION - Un/Subscribe |
M/M |
N-GET |
M/M |
C-FIND |
U/M |
N-ACTION - Request UPS Cancel |
U/M |
Table CC.2-4. DIMSE Service Group - UPS Event
DIMSE Service Element |
Usage SCU/SCP |
---|---|
N-EVENT-REPORT |
M/M |
This operation allows an SCU to ask the SCP to change the state of a Unified Procedure Step (UPS) instance. This operation shall be invoked by the SCU through the DIMSE N-ACTION Service.
DICOM AEs that claim conformance to the UPS Pull SOP Class as an SCU and/or an SCP shall support the Action Types and Action Information as specified in Table CC.2.1-1.
Table CC.2.1-1. Change UPS State - Action Information
Action Type Name |
Action Type ID |
Attribute |
Tag |
Requirement Type SCU/SCP |
---|---|---|---|---|
Change UPS State |
1 |
Procedure Step State |
(0074,1000) |
1/1 |
Transaction UID |
(0008,1195) |
1/1 |
An SCU uses N-ACTION to ask the SCP to change the state of a UPS Instance as shown in Figure CC.1.1-1. Since all UPSs are created as instances of the UPS Push SOP Class, the Requested SOP Class UID (0000,0003) in the N-ACTION request shall be the UID of the UPS Push SOP Class. See Section CC.3.1 for further details.
To take control of a SCHEDULED UPS, an SCU shall generate a Transaction UID and submit a state change to IN PROGRESS including the Transaction UID in the submission. The SCU shall record and use the Transaction UID in future N-ACTION and N-SET requests for that UPS instance.
The performing SCU may wish to record the Transaction UID in non-volatile storage. This would allow the SCU to retain control over the UPS after recovering from a crash.
If two SCUs try to take control of a UPS, the second SCU will get an error since the first SCU established the correct Transaction UID, so the Transaction UID provided by the second SCU is incorrect.
Upon completion of an IN PROGRESS UPS it controls, an SCU shall submit a state change to COMPLETED and include the Transaction UID for the UPS instance.
To cancel an IN PROGRESS UPS for which it has the Transaction UID, an SCU shall submit a state change to CANCELED and include the Transaction UID for the UPS instance.
Prior to submitting the state change to CANCELED, the performing SCU can N-SET the values of Reason For Cancellation, Procedure Step Discontinuation Reason Code Sequence, Contact Display Name or Contact URI to provide information to observing SCUs about the context of the cancellation.
To request cancellation of an IN PROGRESS UPS for which it does not have the Transaction UID, an SCU uses the Request UPS Cancel action as described in Section CC.2.2, rather than a Change UPS State action.
Prior to submitting a state change to COMPLETED or CANCELED for a UPS instance it controls, the SCU shall perform any N-SETs necessary for the UPS to meet Final State requirements as described in section Section CC.2.5.1.1.
At any time after receipt of the N-ACTION-Response, the SCU may release the association on which it sent the N-ACTION-Request.
The SCP shall perform the submitted state change for the identified UPS instance by setting the Procedure Step State (0074,1000) to the requested value, or shall report the appropriate failure response code.
Upon successfully changing the state of a UPS instance to IN PROGRESS, the SCP shall record the Transaction UID provided by the SCU in the Transaction UID (0008,1195) of the UPS instance.
Upon completion of the N-ACTION request, the SCP shall return, via the N-ACTION response primitive, the N-ACTION Status Code applicable to the associated request as shown in Table CC.2.1-2.
The SCP shall only perform legal state changes as described in Table CC.1.1-2.
The SCP shall refuse requests to change the state of an IN PROGRESS UPS unless the Transaction UID of the UPS instance is provided in the N-ACTION request.
The SCP shall refuse requests to change the state of an IN PROGRESS UPS to COMPLETED or CANCELED if the Final State requirements described in Table CC.2.5-3 have not been met.
After the state of the UPS instance has been changed to COMPLETED or CANCELED, the SCP shall not delete the instance until all deletion locks have been removed.
See Section CC.2.3.2 for a description of how SCUs place and remove deletion locks and see Section GGG.1 “Introduction” in PS3.17 Reliable Watchers and Deletion Locks for further discussion.
The SCP may also modify the Procedure Step State (0074,1000) of a UPS instance independently of an N-ACTION request, e.g., if the SCP is performing the procedure step itself, or if it has been determined that the performing SCU has been disabled.
If the SCP is not performing the procedure step, this should be done with caution.
Upon successfully changing the state of a UPS instance, the SCP shall carry out the appropriate N-EVENT-REPORT behavior as described in Section CC.2.4.3 if it supports the UPS Event SOP Class as an SCP.
Bi-directional Authentication of machines/users/applications is possible at association time (see PS3.7 and PS3.15). PS3.7 provides a "Refused: Not Authorized" error code. Further requiring or documenting authentication and/or authorization features from the SCU or SCP is beyond the scope of this SOP Class.
The status values that are specific for this DIMSE operation are defined in Table CC.2.1-2.
Table CC.2.1-2. Status Values
Status |
Meaning |
Code |
---|---|---|
Success |
The requested state change was performed |
0000 |
Warning |
The UPS is already in the requested state of CANCELED |
B304 |
The UPS is already in the requested state of COMPLETED |
B306 |
|
Failure |
Refused: The UPS may no longer be updated |
C300 |
Refused: The correct Transaction UID was not provided |
C301 |
|
Refused: The UPS is already IN PROGRESS |
C302 |
|
Refused: The UPS may only become SCHEDULED via N-CREATE, not N-SET or N-ACTION |
C303 |
|
Refused: The UPS has not met final state requirements for the requested state change |
C304 |
|
Specified SOP Instance UID does not exist or is not a UPS Instance managed by this SCP |
C307 |
|
Refused: The UPS is not yet in the "IN PROGRESS" state |
C310 |
This operation allows an SCU that does not control a given Unified Procedure Step (UPS) instance to request to the SCP that the instance be canceled. This operation shall be invoked by the SCU through the DIMSE N-ACTION Service.
DICOM AEs that claim conformance to the UPS Push SOP Class as an SCU or an SCP shall support the Action Types and Action Information as specified in Table CC.2.2-1. DICOM AEs that claim conformance to the UPS Watch SOP Class as an SCP or claim conformance to the UPS Watch SOP Class as an SCU and choose to implement Request UPS Cancel shall support the Action Types and Action Information as specified in Table CC.2.2-1.
Table CC.2.2-1. Request UPS Cancel - Action Information
Action Type Name |
Action Type ID |
Attribute |
Tag |
Requirement Type SCU/SCP |
---|---|---|---|---|
Request UPS Cancel |
2 |
Reason For Cancellation |
(0074,1238) |
3/1 |
Procedure Step Discontinuation Reason Code Sequence |
(0074,100e) |
3/1 |
||
>Code Value |
(0008,0100) |
1/1 |
||
>Coding Scheme Designator |
(0008,0102) |
1/1 |
||
>Coding Scheme Version |
(0008,0103) |
1C/1C Required if the value of Coding Scheme Designator (0008,0102) is not sufficient to identify the Code Value (0008,0100) unambiguously |
||
>Code Meaning |
(0008,0104) |
1/1 |
||
Contact URI |
(0074,100a) |
3/1 |
||
Contact Display Name |
(0074,100c) |
3/1 |
An SCU uses N-ACTION to request to the SCP that the state of a UPS Instance be changed to CANCELED as shown in Figure CC.1.1-1. Since all UPSs are created as instances of the UPS Push SOP Class, the Requested SOP Class UID (0000,0003) in the N-ACTION request shall be the UID of the UPS Push SOP Class. See Section CC.3.1 for further details.
The SCU may include a Reason For Cancellation and/or a proposed Procedure Step Discontinuation Reason Code Sequence.
The SCU may also provide a Contact Display Name and/or a Contact URI for the person with whom the cancel request may be discussed.
An N-ACTION Status Code indicating success means that the Request was accepted, not that the UPS has been canceled. The system performing the UPS is not obliged to honor the request to cancel and in some scenarios, may not even receive notification of the request. See Section CC.2.4.
At any time after receipt of the N-ACTION-Response, the SCU may release the association on which it sent the N-ACTION-Request.
To cancel an IN PROGRESS UPS that the SCU is itself performing, the SCU shall instead use the Change UPS State action as described in Section CC.2.1.
The SCP shall send appropriate "UPS Cancel Requested" N-EVENT-REPORT messages, as described in Section CC.2.4.3 or shall report the appropriate failure response code.
If provided, the Reason For Cancellation, a proposed Procedure Step Discontinuation Reason Code Sequence, a Contact Display Name and a Contact URI of someone responsible for the Cancel request might be useful in deciding to cancel the UPS or might be displayed to an operator so they can make contact for the purpose of clarifying or confirming the Cancel request. If the SCP is the performer and chooses to actually Cancel the UPS, it may at its own discretion set the Procedure Step Discontinuation Reason Code Sequence in the UPS instance based on the corresponding values provided.
If the Procedure Step State (0074,1000) of the UPS instance is still SCHEDULED, the SCP shall change the Procedure Step State, as described in Section CC.2.1.3, first to IN PROGRESS and then to CANCELED, ensuring that the Final State requirements, described in section Section CC.2.5.1.1, are met.
If the Procedure Step State (0074,1000) of the UPS instance is IN PROGRESS, and the SCP is itself the performer of the UPS, the SCP may, at its own discretion, choose to cancel the UPS as described in Section CC.2.1.3.
If the SCP is the performer of the UPS and chooses not to cancel, or if there is no possibility that the performing SCU will be informed of the cancel request (e.g., the subscription list for the UPS is empty, or the SCP has determined that the performing SCU has been disabled), the SCP may return a failure.
Upon completion of the N-ACTION request, the SCP shall return, via the N-ACTION response primitive, the N-ACTION Status Code applicable to the associated request as shown in Table CC.2.2-2.
Bi-directional Authentication of machines/users/applications is possible at association time (see PS3.7 and PS3.15). PS3.7 provides a "Refused: Not Authorized" error code. Further requiring or documenting authentication and/or authorization features from the SCU or SCP is beyond the scope of this SOP Class.
The status values that are specific for this DIMSE operation are defined in Table CC.2.2-2.
Table CC.2.2-2. Status Values
Status |
Meaning |
Code |
---|---|---|
Success |
The cancel request is acknowledged |
0000 |
Warning |
The UPS is already in the requested state of CANCELED |
B304 |
Failure |
Refused: The UPS is already COMPLETED |
C311 |
Refused: Performer chooses not to cancel |
C313 |
|
Specified SOP Instance UID does not exist or is not a UPS Instance managed by this SCP |
C307 |
|
Refused: The performer cannot be contacted |
C312 |
This operation allows an SCU to subscribe with an SCP in order to receive N-EVENT-REPORTS of subsequent changes to the state of a UPS instance, or to unsubscribe in order to no longer receive such N-EVENT-REPORTs. This operation shall be invoked by the SCU through the DIMSE N-ACTION Service.
DICOM AEs that claim conformance to the UPS Watch SOP Class as an SCU and/or an SCP shall support the Action Types and Action Information as specified in Table CC.2.3-1.
Table CC.2.3-1. Subscribe/Unsubscribe to Receive UPS Event Reports - Action Information
Action Type Name |
Action Type ID |
Attribute |
Tag |
Requirement Type SCU/SCP |
---|---|---|---|---|
Subscribe to Receive UPS Event Reports |
3 |
Receiving AE |
(0074,1234) |
1/1 |
Deletion Lock |
(0074,1230) |
1/1 |
||
Unsubscribe from Receiving UPS Event Reports |
4 |
Receiving AE |
(0074,1234) |
1/1 |
Suspend Global Subscription |
5 |
Receiving AE |
(0074,1234) |
1/1 |
Each AE may be in one of three UPS Subscription States for each existing UPS Instance: Not Subscribed, Subscribed with Deletion Lock, or Subscribed w/o Deletion Lock. The UPS Subscription State determines whether N-EVENT-REPORTs relating to a UPS Instance will be sent to the AE.
Each AE may also be in one of three Global Subscription States for a given SCP: No Global Subscription, Globally Subscribed with Deletion Lock, Globally Subscribed w/o Deletion Lock. The Global Subscription State mainly determines the initial UPS Subscription State for an AE and new UPS Instances created by the SCP. Changes to the Global Subscription State can also change the UPS Subscription State for existing UPS Instances as described in Table CC.2.3-2.
The three Subscription actions in Table CC.2.3-1 are used to manage the UPS Subscription State and Global Subscription State of an AE.
Table CC.2.3-2 describes the UPS Subscription State transitions of an AE for a given UPS Instance. Each row in the table defines what should happen in response to a Subscription Action, or a UPS creation event, given the initial state. The table also shows when an initial event message should be sent to the AE describing the "Current UPS State".
In general, instance specific instructions take precedence over global instructions. The exception is the Unsubscribe Globally instruction, which removes all subscriptions, global and specific. To simply stop globally subscribing to new instances without removing specific subscriptions, use the Suspend Global Subscription message.
Most actions affect only the UPS Subscription State of a single UPS Instance. However, Global actions potentially affect all existing UPS Instances managed by the SCP and this is indicated in the following table by "All". For example, in the "AE Subscribes Globally with Lock" row, the content of the "Not Subscribed" cell means that in addition to setting the Global Subscription State for the AE to "Global Subscription with Lock", all existing UPS Instances whose UPS Subscription State for the Receiving AE is "Not Subscribed" will each have their UPS Subscription State changed to "Subscribed with Lock" and an event will be sent to the Receiving AE for each Instance.
Table CC.2.3-2. UPS Subscription State Transition Table
States (for a specific UPS and AE) |
||||
---|---|---|---|---|
Events |
null |
Not Subscribed |
Subscribed with Lock |
Subscribed w/o Lock |
A UPS is Created when the AE Global Subscription State is "No Global Subscription" |
Go to Not Subscribed |
N/A |
N/A |
N/A |
A UPS is Created when the AE Global Subscription State is "Global Subscription with Lock" |
Go to Subscribed with Lock; Send initial event |
N/A |
N/A |
N/A |
A UPS is Created when the AE Global Subscription State is "Global Subscription w/o Lock" |
Go to Subscribed w/o Lock; Send initial event |
N/A |
N/A |
N/A |
AE Subscribes Globally with Lock |
N/A |
AE Global State is now "Global Sub. with Lock"; All Go to Subscribed with Lock; All Send initial event |
AE Global State is now "Global Sub. with Lock"; No UPS state change; |
AE Global State is now "Global Sub. with Lock"; No UPS state change; |
AE Subscribes Globally w/o Lock |
N/A |
AE Global State is now "Global Sub. w/o Lock"; All Go to Subscribed w/o Lock; |
AE Global State is now "Global Sub. w/o Lock"; No UPS state change; |
AE Global State is now "Global Sub. w/o Lock"; No UPS state change; |
AE Subscribes to Specific UPS with Lock |
N/A |
Go to Subscribed with Lock; Send initial event |
No UPS state change; Send initial event |
Go to Subscribed with Lock; Send initial event |
AE Subscribes to Specific UPS without Lock |
N/A |
Go to Subscribed w/o Lock; Send initial event |
Go to Subscribed w/o Lock; Send initial event |
No UPS state change; Send initial event |
AE Unsubscribes from Specific UPS |
N/A |
No UPS state change |
Go to Not Subscribed |
Go to Not Subscribed |
AE Unsubscribes Globally |
N/A |
AE Global State is now "No Global Subscription"; No UPS state change; |
AE Global State is now "No Global Subscription"; All Go to Not Subscribed; |
AE Global State is now "No Global Subscription"; All Go to Not Subscribed; |
AE Suspends Global Subscription |
N/A |
AE Global State is now "No Global Subscription"; No UPS state change; |
AE Global State is now "No Global Subscription"; No UPS state change; |
AE Global State is now "No Global Subscription"; No UPS state change; |
See Section GGG.1 “Introduction” in PS3.17 Reliable Watchers and Deletion Locks for further discussion of deletion locks.
The SCU subscribing to track the progress and results of the scheduled procedure step may be the system that created the UPS as an SCU of the UPS Push SOP Class, or it may be some other interested observer.
An SCU shall use the N-ACTION primitive to request the SCP to subscribe an AE (usually the requesting SCU) to receive event reports relating to UPS instances managed by the SCP. Since all UPSs are created as instances of the UPS Push SOP Class, the Requested SOP Class UID (0000,0003) in the N-ACTION request shall be the UID of the UPS Push SOP Class. See Section CC.3.1 for further details.
An SCU shall also use the N-ACTION primitive to request the SCP to unsubscribe an AE to stop receiving event reports relating to UPS instances managed by the SCP. Action Information is specified in Table CC.2.3-1. The SCU shall always provide the AE-TITLE that is to receive (or stop receiving) the N-EVENT-REPORTs.
To subscribe for events relating to a single specific UPS instance managed by the SCP, the SCU shall use Action Type ID 3 (Subscribe to Receive UPS Event Reports) and provide the SOP Instance UID of the specific UPS instance in the N-ACTION primitive request. The SCU shall indicate a need for the UPS instance to persist after its state has changed to COMPLETED or CANCELED by setting the value of the Deletion Lock to TRUE. Otherwise the SCU shall set the value of the Deletion Lock to FALSE.
To unsubscribe for events relating to a single specific UPS instance managed by the SCP, the SCU shall use Action Type ID 4 (Unsubscribe from Receiving UPS Event Reports) and provide the SOP Instance UID of the specific UPS instance in the N-ACTION primitive request.
To subscribe for events relating to all current and subsequently created UPS instances managed by the SCP, the SCU shall use Action Type ID 3 (Subscribe to Receive UPS Event Reports) and provide the well-known UID 1.2.840.10008.5.1.4.34.5 in the N-ACTION primitive request. The SCU shall indicate a need for UPS instances to persist after their states have changed to COMPLETED or CANCELED by setting the value of the Deletion Lock to TRUE. Otherwise the SCU shall set the value of the Deletion Lock to FALSE.
This "global subscription" is useful for SCUs that wish to monitor all activities without having to issue regular C-FINDs to identify new UPS instances.
To unsubscribe for events relating to all current UPS instances managed by the SCP and also stop being subscribed to subsequently created UPS instances, the SCU shall use Action Type ID 4 (Unsubscribe from Receiving UPS Event Reports) and provide the well-known UID 1.2.840.10008.5.1.4.34.5 in the N-ACTION primitive request.
This "global unsubscription" is useful for SCUs that wish to stop monitoring all activities and release all deletion locks (if any) placed for this subscriber.
To just stop being subscribed to subsequently created UPS instances, but still continue to receive events for currently subscribed instances managed by the SCP, the SCU shall use Action Type ID 5 (Suspend Global Subscription) and provide the well-known UID 1.2.840.10008.5.1.4.34.5 in the N-ACTION primitive request.
For each UPS instance on which the SCU has placed a deletion lock, either explicitly on the specific instance or implicitly via a global subscription with lock, the SCU shall remove the deletion lock once any needed final state information for the instance has been obtained. The deletion lock may be removed either by unsubscribing or by subscribing with the value of the Deletion Lock set to FALSE.
The SCP will retain COMPLETED or CANCELED UPS Instances until all deletion locks have been released. Failure by SCUs to release the deletion lock may cause problems for the SCP. SCUs that do not have a significant need for the final state information, or who cannot dependably remove deletion locks should not use deletion locks.
The successful N-ACTION Response Status Code indicates that the SCP has received the N-ACTION request and the Subscription State for the AE has been successfully modified.
When subscribing to a specific instance, the SCU can also expect to receive an initial N-EVENT-REPORT containing the current state of the UPS instance. When subscribing globally with the Deletion Lock set to TRUE, the SCU can expect to receive initial N-EVENT-REPORTs for every instance currently managed by the SCP. Initial N-EVENT-REPORTs for newly created instances, received as a result of a global subscription, will appear as transitions to the SCHEDULED state.
A warning N-ACTION Response Status Code of "Deletion Lock not granted", indicates that the AE subscription requested by the SCU was successful, but the deletion lock has not been set.
A failure N-ACTION Response Status Code indicates that the subscription state change requested will not be processed and no subscription states have been changed. The action taken by the SCU upon receiving this status is beyond the scope of this Standard.
At any time after receipt of the N-ACTION-Response, the SCU may release the association on which it sent the N-ACTION-Request.
Upon receipt of the N-ACTION request, the SCP shall attempt to update the Global Subscription State and/or UPS Subscription State of the specified AE with respect to the specified SOP Instance UID as described in Table CC.2.3-2 and then return, via the N-ACTION response primitive, the appropriate N-ACTION Response Status Code.
A success status conveys that the Global Subscription State and/or UPS Subscription State for the AE specified in Receiving AE (0074,1234) was successfully modified by the SCP. The AE-TITLE in Receiving AE (0074,1234) may be different than the AE-TITLE used by the SCU for the association negotiation. The SCP shall use the AE-TITLE specified in Receiving AE (0074,1234). This allows systems to subscribe other systems they know would be interested in events for a certain UPS.
For all UPS instances managed by the SCP, the SCP shall send N-EVENT-REPORTS (as described in Section CC.2.4.3) to AEs that have a UPS Subscription State of "Subscribed with Lock" or "Subscribed w/o Lock".
Upon successfully processing a subscription action, the SCP shall send initial UPS State Report N-EVENT-REPORTs, as indicated in Table CC.2.3-2, providing the current status of the UPS Instance to the Receiving AE.
The SCP may also refuse both specific and global Subscription requests by returning a failure N-ACTION Response Status Code for "Refused: Not Authorized" if the refusal depends on permissions related to the tasks or the requestor, or "Refused: SCP does not support Event Reports" if the SCP does not support sending the events. The SCP must document in its conformance statement if it might refuse Subscription requests.
The SCP may remove existing Deletion Locks by changing the UPS Subscription State for the AE from "Subscribed with Lock" to "Subscribed w/o Lock" and/or by changing the Global Subscription State for an AE from "Global Subscription with Lock" to "Global Subscription w/o Lock". This is intended to allow the SCP to deal with SCU malfunctions. The SCP must document in its conformance statement if it might remove a Deletion Lock.
The SCP may also refuse the Deletion Lock portion of a specific or global Subscription request. For example, a request to modify the UPS Subscription State for the AE to "Subscribed with Lock" would instead result in a UPS Subscription State of "Subscribed w/o Lock" and a Warning status (see Table CC.2.3-3) returned to the requesting SCU. This is intended to deal with Security and related policy restrictions. The SCP must document in its conformance statement if it might refuse a Deletion Lock.
Bi-directional Authentication of machines/users/applications is possible at association time (see PS3.7 and PS3.15). PS3.7 provides a "Refused: Not Authorized" error code. Further requiring or documenting authentication and/or authorization features from the SCU or SCP is beyond the scope of this SOP Class.
The status values that are specific for this DIMSE operation are defined in Table CC.2.3-3.
Table CC.2.3-3. Status Values
Status |
Meaning |
Code |
---|---|---|
Success |
The requested change of subscription state was performed |
0000 |
Warning |
Deletion Lock not granted. |
B301 |
Failure |
Specified SOP Instance UID does not exist or is not a UPS Instance managed by this SCP |
C307 |
Receiving AE-TITLE is Unknown to this SCP |
C308 |
|
Refused: Specified action not appropriate for specified instance |
C314 |
|
Refused: SCP does not support Event Reports |
C315 |
This operation allows an SCP to notify an SCU of a change in state of a UPS instance or a change in state of the SCP itself. This operation shall be invoked by the SCP through the DIMSE N-EVENT-REPORT Service.
DICOM AEs that claim conformance to the UPS Event SOP Class as an SCU and/or an SCP shall support the Event Type IDs and Event Report Attributes as specified in Table CC.2.4-1.
Table CC.2.4-1. Report a Change in UPS Status - Event Report Information
Event Type Name |
Event Type ID |
Attribute |
Tag |
Req. Type SCU/SCP |
---|---|---|---|---|
UPS State Report |
1 |
Procedure Step State |
(0074,1000) |
-/1 |
Input Readiness State |
(0040,4041) |
-/1 |
||
Reason For Cancellation |
(0074,1238) |
-/3 |
||
Procedure Step Discontinuation Reason Code Sequence |
(0074,100e) |
-/3 |
||
>Code Value |
(0008,0100) |
-/1 |
||
>Coding Scheme Designator |
(0008,0102) |
-/1 |
||
>Coding Scheme Version |
(0008,0103) |
-/1C Required if the value of Coding Scheme Designator (0008,0102) is not sufficient to identify the Code Value (0008,0100) unambiguously |
||
>Code Meaning |
(0008,0104) |
-/1 |
||
UPS Cancel Requested |
2 |
Requesting AE |
(0074,1236) |
-/1 |
Reason For Cancellation |
(0074,1238) |
-/1C Required if provided in the triggering N-ACTION |
||
Procedure Step Discontinuation Reason Code Sequence |
(0074,100e) |
-/1C Required if provided in the triggering N-ACTION |
||
>Code Value |
(0008,0100) |
-/1 |
||
>Coding Scheme Designator |
(0008,0102) |
-/1 |
||
>Coding Scheme Version |
(0008,0103) |
-/1C Required if the value of Coding Scheme Designator (0008,0102) is not sufficient to identify the Code Value (0008,0100) unambiguously |
||
>Code Meaning |
(0008,0104) |
-/1 |
||
Contact URI |
(0074,100a) |
-/1C Required if provided in the triggering N-ACTION |
||
Contact Display Name |
(0074,100c) |
-/1C Required if provided in the triggering N-ACTION |
||
UPS Progress Report |
3 |
Progress Information Sequence |
(0074,1002) |
-/1 |
>Procedure Step Progress |
(0074,1004) |
-/3 |
||
>Procedure Step Progress Description |
(0074,1006) |
-/3 |
||
>Procedure Step Communications URI Sequence |
(0074,1008) |
-/3 |
||
>>Contact URI |
(0074,100a) |
-/1 |
||
>>Contact Display Name |
(0074,100c) |
-/3 |
||
SCP Status Change |
4 |
SCP Status |
(0074,1242) |
-/1 |
Subscription List Status |
(0074,1244) |
-/1 |
||
Unified Procedure Step List Status |
(0074,1246) |
-/1 |
The meanings of the Progress Information Attribute values in the context of a specific task are undefined, and the values may be obsolete when the UPS has moved to the COMPLETED or CANCELED state.
The SCU shall return, via the N-EVENT-REPORT response primitive, the N-EVENT-REPORT Response Status Code applicable to the associated request. See PS3.7 for general response status codes.
The SCU shall accept all Attributes included in any notification. No requirements are placed on what the SCU will do as a result of receiving this information.
An SCU may receive N-EVENT-REPORTs with an Event Type ID of 1 (UPS State Report) either due to a state change to the UPS, or in response to initial subscription to the UPS (possibly when the UPS is initially created). See Section CC.2.3.3.
If an SCU performing a UPS receives an N-EVENT-REPORT for that instance with an Event Type ID of 2 (UPS Cancel Requested), then this SCU may, at its own discretion, choose to cancel the UPS as described in Section CC.2.1.2.
A UPS Cancel Requested notification includes the AE of the Requesting SCU, which could be useful to the performing SCU in deciding the significance/authority of the Cancel Request.
The Reason For Cancellation, a proposed Procedure Step Discontinuation Reason Code Sequence, a Contact Display Name and a Contact URI of someone responsible for the Cancel Request may also be provided in the notification. Some performing SCUs might find this information useful in deciding to cancel the UPS or might provide the information to an operator so they can make contact for the purpose of clarifying or confirming the Cancel Request. If the performing SCU chooses to Cancel the UPS, it may at its own discretion set the Procedure Step Discontinuation Reason Code Sequence in the UPS instance based on the corresponding values provided.
An SCU that wishes to start/stop receiving N-EVENT-REPORTs about UPS instances may subscribe/unsubscribe as described in Section CC.2.3.2.
If an SCU receives an N-EVENT-REPORT with an Event Type ID of 4 (SCP Status Change), it is not required to act on that information, however the SCU may want to consider actions such as: re-subscribing if the subscription list has been Cold Started, verifying (and recreating if necessary) scheduled UPSs if the UPS list has been Cold Started, etc.
An SCU may receive SCP State Change Events from any SCP with which it is currently subscribed either globally or for any specific UPS.
The SCP shall specify in the N-EVENT-REPORT Request Primitive the Event Type ID and the UID of the UPS Instance with which the event is associated. Since all UPSs are created as instances of the UPS Push SOP Class, the Affected SOP Class UID (0000,0002) in the N-EVENT-REPORT request shall be the UID of the UPS Push SOP Class. See Section CC.3.1 for further details. The SCP shall additionally include Attributes related to the event as defined in Table CC.2.4-1.
Each time the SCP completes a Subscribe to Receive UPS Event Reports Action (see Section CC.2.3.1) for a specific UPS instance, the SCP shall send to the Receiving AE a UPS State Report Event and provide the current value of the Procedure Step State (0074,1000) and Input Readiness State (0040,4041) Attributes for the UPS instance.
Each time the SCP completes a Subscribe to Receive UPS Event Reports Action (see Section CC.2.3.1) for the well-known UID 1.2.840.10008.5.1.4.34.5 with the value of the Deletion Lock set to TRUE (i.e., a Global Subscription with Lock), the SCP shall send to the Receiving AE a UPS State Report Event for every UPS Instance managed by the SCP and provide the current value of the Procedure Step State (0074,1000) and Input Readiness State (0040,4041) Attributes.
Each time the SCP creates a new UPS instance, the SCP shall send a UPS State Report Event, indicating a change of status to SCHEDULED and the initial value of and Input Readiness State (0040,4041), to all AEs with a Global Subscription State of "Global Subscription with Lock" or "Global Subscription w/o Lock". (see Section CC.2.3)
In the following text "Subscribed SCUs" means all AEs where the UPS Subscription State of the UPS Instance in question is "Subscribed with Lock" or "Subscribed w/o Lock". (see Section CC.2.3).
Each time the SCP changes the Procedure Step State (0074,1000) Attribute for a UPS instance, the SCP shall send a UPS State Report Event to subscribed SCUs.
Each time the SCP changes the Input Readiness State (0040,4041) Attribute for a UPS instance, the SCP shall send a UPS State Report Event to subscribed SCUs.
Each time the SCP receives an N-ACTION with an Action Type ID of 2 (Request UPS Cancel), the SCP shall send a UPS Cancel Requested Event to subscribed SCUs. The SCP shall include the AE Title of the triggering N-ACTION SCU in the Requesting AE Attribute. The SCP shall include the Reason For Cancellation, Contact Display Name and Contact URI Attributes if they were provided in the triggering N-ACTION.
Each time the SCP updates the Procedure Step Progress (0074,1004), the Procedure Step Progress Description (0074,1006), or the contents of the Procedure Step Communications URI Sequence (0074,1008) for a UPS instance, the SCP shall send a UPS Progress Event, with the current contents of the Progress Information Sequence (0074,1002), to subscribed SCUs.
Each time the SCP is restarted, the SCP shall send an SCP Status Change Event. The SCP, if it knows it is going down, may send an additional SCP Status Change Event before it is shut down. Since the subscription lists may be incomplete or missing in the event of a restart, the SCP shall maintain a fallback list of AEs (for example as a configuration file, or from an LDAP server). The SCP shall send the SCP Status Change Events to:
all AEs on the fallback list and,
all AEs with a Global Subscription State of "Global Subscription with Lock" or "Global Subscription w/o Lock" and,
all AEs with a UPS Subscription State of "Subscribed with Lock" or "Subscribed w/o Lock" for any UPS Instance managed by the SCP
The SCP may choose to not send duplicate messages to an AE.
The value of SCP Status (0074,1242) shall be RESTARTED if the SCP is sending this message due to being restarted and GOING DOWN if the SCP will be shut down soon.
SCPs that report they are GOING DOWN might stop accepting new interactions from SCUs until after they have restarted.
When SCP Status (0074,1242) is RESTARTED, the value of Subscription List Status (0074,1244) shall be WARM START if the SCP preserved the Subscription List to the best of its knowledge, and COLD STARTED if the SCP has not preserved the Subscription List.
When SCP Status (0074,1242) is RESTARTED, the value of Unified Procedure Step List Status (0074,1246) shall be WARM START if the SCP preserved the UPS List to the best of its knowledge, and COLD START if the SCP has not preserved the UPS List.
If the SCP is unable to successfully complete an N-EVENT-REPORT to any given SCU, the SCP has no obligation to queue or retry, and it should not imply any effect on the subscription list or deletion locks.
No Service Class specific status values are defined for the N-EVENT-REPORT Service. See PS3.7 for general response status codes.
This operation allows an SCU to instruct an SCP to create a Unified Procedure Step. This operation shall be invoked by the SCU through the DIMSE N-CREATE Service.
An Application Entity that claims conformance to the UPS Push SOP Class as an SCU shall provide all Required Attributes as specified in Table CC.2.5-3. Additional Attributes defined by the UPS IOD may be provided as well.
An Application Entity that claims conformance to the UPS Push SOP Class as an SCP shall support all required Attributes as specified in Table CC.2.5-3. Additional Attributes defined by the UPS IOD may be supported as well.
COMPLETED and CANCELED are Final States for a UPS instance. The Attributes and values of the UPS instance must meet certain requirements before it may be placed in either of the Final States.
A UPS instance is in the SCHEDULED state when created. See Section CC.1.1 for rules governing state transitions.
Attributes shall be valued as indicated by the Final State Codes in the Final State Column of Table CC.2.5-3 before the Procedure Step State (0074,1000) may be set to COMPLETED or CANCELED (i.e., Final State).
Performing systems are encouraged to ensure that the values for all Attributes reasonably reflect what was done and the Final State of the UPS. This may include blanking Attributes that are permitted to be empty and for which no reasonable value can be determined. The UPS contents should make it clear whether the step was completed, what work was done, what results were produced and whether the results are usable. See Section GGG.3.1 “What Was Scheduled Vs. What Was Performed” in PS3.17 for a discussion of methods to convey things like partial completion.
The SCU may choose not to distribute, or otherwise make available, some or all instances created during the procedure step and referenced in the Output Information Sequence (0040,4033).
Table CC.2.5-1. Final State Codes
Final State Code |
Meaning |
---|---|
R |
The UPS State shall not be set to COMPLETED or CANCELED if this Attribute does not have a value. |
RC |
The UPS State shall not be set to COMPLETED or CANCELED if the condition is met and this Attribute does not have a value. |
P |
The UPS State shall not be set to COMPLETED if this Attribute does not have a value, but may be set to CANCELED. |
X |
The UPS State shall not be set to CANCELED if this Attribute does not have a value, but may be set to COMPLETED. |
O |
The UPS State may be set to either COMPLETED or CANCELED if this Attribute does not have a value. |
To reduce the size and complexity of Table CC.2.5-3, a macro notation is used.
For example, in Table CC.2.5-3, a table entry specifying "Include Table CC.2.5-2a “UPS Code Sequence Macro”" should be interpreted as including the following table of text as a substitution. The nesting level for the sequence inclusion is indicated by the nesting level on the reference to the macro. Where the matching key type requirement is "*" it should be replaced with the matching key type requirement of the sequence Attribute that incorporates this macro.
For code sequences that have requirements for N-CREATE, N-SET, N-GET, or C-FIND behavior that differ from the Macro, the code sequence contents are explicitly listed in the Table rather than specifying inclusion of the Macro.
Table CC.2.5-2a. UPS Code Sequence Macro
Attribute Name |
Tag |
Req. Type N-CREATE (SCU/SCP) |
Req. Type N-SET (SCU/SCP) |
Final State |
Req. Type N-GET (SCU/SCP) |
Match Key Type |
Return Key Type |
Remark/Matching Type |
---|---|---|---|---|---|---|---|---|
Code Value |
(0008,0100) |
1/1 |
1/1 |
-/1 |
* |
1 |
Code Value shall be retrieved with Single Value Matching. |
|
Coding Scheme Designator |
(0008,0102) |
1/1 |
1/1 |
-/1 |
* |
1 |
Coding Scheme Designator shall be retrieved with Single Value Matching. |
|
Coding Scheme Version |
(0008,0103) |
1C/1C |
1C/1C |
-/1 |
- |
1 |
Required if the value of Coding Scheme Designator (0008,0102) is not sufficient to identify the Code Value (0008,0100) unambiguously. |
|
Code Meaning |
(0008,0104) |
1/1 |
1/1 |
-/1 |
- |
1 |
Code Meaning shall not be used as Matching Key. |
Table CC.2.5-2b. UPS Content Item Macro
Attribute Name |
Tag |
Req. Type N-CREATE (SCU/SCP) |
Req. Type N-SET (SCU/SCP) |
Final State |
Req. Type N-GET (SCU/SCP) |
Match Key Type |
Return Key Type |
Remark/Matching Type |
---|---|---|---|---|---|---|---|---|
Value Type |
(0040,A040) |
1/1 |
1/1 |
-/1 |
* |
1 |
The type of the value encoded in this name-value Item. Enumerated Values:
|
|
Concept Name Code Sequence |
(0040,A043) |
1/1 |
1/1 |
-/1 |
* |
1 |
Coded concept name of this name-value Item. |
|
No Baseline CID is defined. |
||||||||
DateTime |
(0040,A120) |
1C/1C |
1/1 |
-/1 |
* |
1 |
Datetime value for this name-value Item. Required if Value Type (0040,A040) is DATETIME. |
|
Date |
(0040,A121) |
1C/1C |
1/1 |
-/1 |
* |
1 |
Date value for this name-value Item. Required if Value Type (0040,A040) is DATE. |
|
Time |
(0040,A122) |
1C/1C |
1/1 |
-/1 |
* |
1 |
Time value for this name-value Item. Required if Value Type (0040,A040) is TIME. |
|
Person Name |
(0040,A123) |
1C/1C |
1/1 |
-/1 |
* |
1 |
Person name value for this name-value Item. Required if Value Type (0040,A040) is PNAME. |
|
UID |
(0040,A124) |
1C/1C |
1/1 |
-/1 |
* |
1 |
UID value for this name-value Item. Required if Value Type (0040,A040) is UIDREF. |
|
Text Value |
(0040,A160) |
1C/1C |
1/1 |
-/1 |
* |
1 |
Text value for this name-value Item. Required if Value Type (0040,A040) is TEXT. |
|
Concept Code Sequence |
(0040,A168) |
1C/1C |
1/1 |
-/1 |
* |
1 |
Coded concept value of this name-value Item. Required if Value Type (0040,A040) is CODE. |
|
No Baseline CID is defined. |
||||||||
Numeric Value |
(0040,A30A) |
1C/1C |
1/1 |
-/1 |
* |
1 |
Numeric value for this name-value Item. Required if Value Type (0040,A040) is NUMERIC. |
|
Measurement Units Code Sequence |
(0040,08EA) |
1C/1C |
1/1 |
-/1 |
* |
1 |
Units of measurement for a numeric value in this name-value Item. Required if Value Type (0040,A040) is NUMERIC. |
|
Baseline CID 82 “Units of Measurement” |
Table CC.2.5-2c. Referenced Instances and Access Macro
Attribute Name |
Tag |
Req. Type N-CREATE (SCU/SCP) |
Req. Type N-SET (SCU/SCP) |
Final State |
Req. Type N-GET (SCU/SCP) |
Match Key Type |
Return Key Type |
Remark/Matching Type |
---|---|---|---|---|---|---|---|---|
Type of Instances |
(0040,E020) |
1/1 |
1/1 |
-/1 |
O |
1 |
||
Study Instance UID |
(0020,000D) |
1C/1 |
1C/1 |
-/1 |
O |
1 |
Required if Type of Instances (0040,E020) is DICOM |
|
Series Instance UID |
(0020,000E) |
1C/1 |
1C/1 |
-/1 |
O |
1 |
Required if Type of Instances (0040,E020) is DICOM |
|
Referenced SOP Sequence |
(0008,1199) |
1/1 |
1/1 |
-/1 |
O |
1 |
||
>Referenced SOP Class UID |
(0008,1150) |
1/1 |
1/1 |
-/1 |
* |
1 |
||
>Referenced SOP Instance UID |
(0008,1155) |
1/1 |
1/1 |
-/1 |
* |
1 |
||
>HL7 Instance Identifier |
(0040,E001) |
1C/1 |
1C/1 |
-/1 |
* |
1 |
Required if Type of Instances (0040,E020) is CDA. |
|
>Referenced Frame Number |
(0008,1160) |
1C/1 |
1C/1 |
-/2 |
* |
1 |
Required if the Referenced SOP Instance is a multi-frame image and the reference does not apply to all frames, and Referenced Segment Number (0062,000B) is not present. |
|
>Referenced Segment Number |
(0062,000B) |
1C/1 |
1C/1 |
-/2 |
* |
1 |
Required if the Referenced SOP Instance is a Segmentation and the reference does not apply to all segments and Referenced Frame Number (0008,1160) is not present. |
|
DICOM Retrieval Sequence |
(0040,E021) |
1C/1 |
1C/1 |
-/1 |
O |
1C |
Required if Media Retrieval Sequence (0040,E022), WADO Retrieval Sequence (0040,E023), and XDS Retrieval Sequence (0040,E024) are not present. May be present otherwise. |
|
>Retrieve AE Title |
(0008,0054) |
1/1 |
1/1 |
-/1 |
* |
1 |
||
Media Retrieval Sequence |
(0040,E022) |
1C/1 |
1C/1 |
-/1 |
O |
1C |
Required if DICOM Retrieval Sequence (0040,E021), WADO Retrieval Sequence (0040,E023), and XDS Retrieval Sequence (0040,E024) are not present. May be present otherwise. |
|
>Storage Media File-Set ID |
(0088,0130) |
2/2 |
2/2 |
-/2 |
* |
2 |
||
>Storage Media File-Set UID |
(0088,0140) |
1/1 |
1/1 |
-/1 |
* |
1 |
||
WADO Retrieval Sequence |
(0040,E023) |
1C/1 |
1C/1 |
-/1 |
O |
1C |
Required if DICOM Retrieval Sequence (0040,E021), Media Retrieval Sequence (0040,E022), and XDS Retrieval Sequence (0040,E024) are not present. May be present otherwise. |
|
>Retrieve Location UID |
(0040,E011) |
1/1 |
1/1 |
-/1 |
* |
1 |
||
>Retrieve URI |
(0040,E010) |
1/1 |
1/1 |
-/1 |
* |
1 |
||
XDS Retrieval Sequence |
(0040,E024) |
1C |
1C/1 |
-/1 |
O |
1C |
Required if DICOM Retrieval Sequence (0040,E021), Media Retrieval Sequence (0040,E022), and WADO Retrieval Sequence (0040,E023) are not present. May be present otherwise. |
|
>Repository Unique ID |
(0040,E030) |
1 |
1/1 |
-/1 |
* |
1 |
||
>Home Community ID |
(0040,E031) |
3/2 |
3/2 |
3/2 |
* |
2 |
Table CC.2.5-2d. HL7V2 Hierarchic Designator Macro
Attribute Name |
Tag |
Req. Type N-CREATE (SCU/SCP) |
Req. Type N-SET (SCU/SCP) |
Final State |
Req. Type N-GET (SCU/SCP) |
Match Key Type |
Return Key Type |
Remark/Matching Type |
---|---|---|---|---|---|---|---|---|
Local Namespace Entity ID |
(0040,0031) |
1C/1 |
Not Allowed |
-/1 |
* |
1C |
Creation required if Universal Entity ID (0040,0032) is not present; may be present otherwise. Return Key required if set. |
|
Universal Entity ID |
(0040,0032) |
1C/1 |
Not Allowed |
-/1 |
* |
1C |
Creation required if Local Namespace Entity ID (0040,0031) is not present; may be present otherwise. Return Key required if set. |
|
Universal Entity ID Type |
(0040,0033) |
1C/1 |
Not Allowed |
-/1 |
* |
1C |
Creation required if Universal Entity ID (0040,0032) is present. Return Key required if set. |
|
Local Namespace Entity ID |
(0040,0031) |
1C/1 |
Not Allowed |
-/1 |
* |
1C |
Creation required if Universal Entity ID (0040,0032) is not present; may be present otherwise. Return Key required if set. |
Table CC.2.5-2e. Issuer of Patient ID Macro
Attribute Name |
Tag |
Req. Type N-CREATE (SCU/SCP) |
Req. Type N-SET (SCU/SCP) |
Final State |
Req. Type N-GET (SCU/SCP) |
Match Key Type |
Return Key Type |
Remark/Matching Type |
---|---|---|---|---|---|---|---|---|
Issuer of Patient ID |
(0010,0021) |
2/2 |
Not allowed |
O |
3/2 |
R |
2 |
|
Issuer of Patient ID Qualifiers Sequence |
(0010,0024) |
2/2 |
Not allowed |
O |
3/2 |
O |
2 |
|
>Universal Entity ID |
(0040,0032) |
2/2 |
Not allowed |
O |
3/2 |
O |
2 |
|
>Universal Entity ID Type |
(0040,0033) |
1C/1 |
Not allowed |
O |
3/2 |
O |
1C |
Required if Universal Entity ID (0040,0032) is present in this item with a value. |
>Identifier Type Code |
(0040,0035) |
2/2 |
Not allowed |
O |
3/2 |
O |
2 |
|
>Assigning Facility Sequence |
(0040,0036) |
2/2 |
Not allowed |
O |
3/2 |
O |
2 |
The Attributes of the Assigning Facility Sequence shall only be retrieved with Sequence Matching. |
>>Include Table CC.2.5-2d “HL7V2 Hierarchic Designator Macro” |
||||||||
>Assigning Jurisdiction Code Sequence |
(0040,0039) |
2/2 |
Not allowed |
O |
3/2 |
O |
2 |
The Attributes of the Assigning Jurisdiction Code Sequence shall only be retrieved with Sequence Matching. |
Baseline CID 5001 “Countries” for country codes. |
||||||||
>Assigning Agency or Department Code Sequence |
(0040,003A) |
2/2 |
Not allowed |
O |
3/2 |
O |
2 |
The Attributes of the Assigning Agency or Department Code Sequence shall only be retrieved with Sequence Matching. |
No Baseline CID. |
Table CC.2.5-2f. SOP Instance Reference Macro
Attribute Name |
Tag |
Req. Type N-CREATE (SCU/SCP) |
Req. Type N-SET (SCU/SCP) |
Final State |
Req. Type N-GET (SCU/SCP) |
Match Key Type |
Return Key Type |
Remark/Matching Type |
---|---|---|---|---|---|---|---|---|
Referenced SOP Class UID |
(0008,1150) |
1/1 |
1/1 |
-/1 |
* |
1 |
Code Value shall be retrieved with Single Value Matching. |
|
Referenced SOP Instance UID |
(0008,1155) |
1/1 |
1/1 |
-/1 |
* |
1 |
Coding Scheme Designator shall be retrieved with Single Value Matching. |
This table combines the Attribute requirements for multiple DIMSE services (N-CREATE, N-SET, N-GET, C-FIND) to facilitate consistency between the requirements.
See PS3.4 for the meaning of the requirement codes used in the N-CREATE, N-SET, N-GET and Return Key columns in the following table.
See Section C.1.2 for the meaning of the requirement codes used in the Match Key column in the following table.
See Table CC.2.5-1 for the meaning of the requirement codes used in the Final State column of the following table.
Table CC.2.5-3. UPS SOP Class N-CREATE/N-SET/N-GET/C-FIND Attributes
Attribute Name |
Tag |
Req. Type N-CREATE (SCU/SCP) |
Req. Type N-SET (SCU/SCP) |
Final State |
Req. Type N-GET (SCU/SCP) |
Match Key Type |
Return Key Type |
Remark/Matching Type |
---|---|---|---|---|---|---|---|---|
Transaction UID |
(0008,1195) |
2/2 Shall be empty |
(see CC.2.6.3) |
O |
Not allowed |
- |
- |
Cannot be queried. |
SOP Common Module |
||||||||
Specific Character Set |
(0008,0005) |
1C/1C |
1C/1C |
RC |
3/1 |
- |
1C |
Required if extended or replacement character set is used |
SOP Class UID |
(0008,0016) |
See CC.2.5.1.3.1 |
Not allowed |
R |
Not allowed |
O |
1 |
Uniquely identifies the SOP Class of the Unified Procedure Step. See Section CC.3.1 for further explanation. |
SOP Instance UID |
(0008,0018) |
Not allowed. SOP Instance is conveyed in the Affected SOP Instance UID (0000,1000) |
Not allowed. SOP Instance is conveyed in the Requested SOP Instance UID (0000,1001) |
R |
Not allowed. SOP Instance is conveyed in the Requested SOP Instance UID (0000,1001) |
U |
1 |
Uniquely identifies the SOP Instance of the UPS. SOP Instance UID shall be retrieved with Single Value Matching. |
All other Attributes from the SOP Common Module |
3/3 |
3/3 |
O |
3/3 |
- |
- |
||
Unified Procedure Step Scheduled Procedure Information Module |
||||||||
Scheduled Procedure Step Priority |
(0074,1200) |
1/1 |
3/1 |
R |
3/1 |
R |
1 |
Scheduled Procedure Step Priority shall be retrieved with Single Value Matching. |
Scheduled Procedure Step Modification Date and Time |
(0040,4010) |
2/1 SCP shall use time of CREATE rather than any value provided |
-/1 SCP will use time of SET |
R |
3/1 |
O |
3 |
Scheduled Procedure Step Modification Date and Time shall be retrieved with Single Value Matching or Range Matching. |
Procedure Step Label |
(0074,1204) |
1/1 |
3/1 |
O |
3/1 |
R |
1 |
|
Worklist Label |
(0074,1202) |
2/1 If a value is not provided by the SCU, the SCP shall fill in the Worklist Label, e.g., using a default value or by assigning the UPS instance to a logical worklist. |
3/1 |
O |
3/1 |
R |
1 |
|
Scheduled Processing Parameters Sequence |
(0074,1210) |
2/2 |
3/2 |
O |
3/2 |
- |
2 |
|
Scheduled Station Name Code Sequence |
(0040,4025) |
2/2 |
3/2 |
O |
3/2 |
R |
2 |
The Attributes of the Scheduled Station Name Code Sequence shall only be retrieved with Sequence Matching. NoteIn Push Scenario, the SCP-Performer has to create empty but could self fill later. |
Scheduled Station Class Code Sequence |
(0040,4026) |
2/2 |
3/2 |
O |
3/2 |
R |
2 |
The Attributes of the Scheduled Station Class Code Sequence shall only be retrieved with Sequence Matching. |
Scheduled Station Geographic Location Code Sequence |
(0040,4027) |
2/2 |
3/2 |
O |
3/2 |
R |
2 |
The Attributes of the Scheduled Station Geographic Location Code Sequence shall only be retrieved with Sequence Matching. |
Scheduled Human Performers Sequence |
(0040,4034) |
2C/2C |
3/2 |
O |
3/2 |
R |
2 |
The Attributes of the Scheduled Human Performers Sequence shall only be retrieved with Sequence Matching. Required if a Human Performer is specified. |
>Human Performer Code Sequence |
(0040,4009) |
1/1 |
1/1 |
O |
-/1 |
R |
1 |
The Attributes of the Scheduled Human Performers Code Sequence shall only be retrieved with Sequence Matching. |
>Human Performer's Name |
(0040,4037) |
1/1 |
1/1 |
O |
-/1 |
O |
3 |
|
>Human Performer's Organization |
(0040,4036) |
1/1 |
1/1 |
O |
-/1 |
O |
3 |
|
Scheduled Procedure Step Start Date and Time |
(0040,4005) |
1/1 |
3/1 |
R |
3/1 |
R |
1 |
Scheduled Procedure Step Start Date and Time shall be retrieved with Single Value Matching or Range Matching. |
Expected Completion Date and Time |
(0040,4011) |
3/1 |
3/1 |
O |
3/1 |
R |
3 |
Expected Completion Date and Time shall be retrieved with Single Value Matching or Range Matching. |
Scheduled Workitem Code Sequence |
(0040,4018) |
2/2 |
3/1 |
O |
3/1 |
R |
2 |
The Attributes of the Scheduled Workitem Code Sequence shall only be retrieved with Sequence Matching. |
Comments on the Scheduled Procedure Step |
(0040,0400) |
2/2 |
3/1 |
O |
3/1 |
O |
3 |
|
Input Readiness State |
(0040,4041) |
1/1 |
3/1 |
R |
3/1 |
R |
1 |
Input Readiness State shall be retrieved with Single Value Matching. |
Input Information Sequence |
(0040,4021) |
2/2 |
3/2 |
O |
3/2 |
O |
2 |
The Attributes of the Input Information Sequence shall only be retrieved with Sequence Matching. |
>Include Table CC.2.5-2c “Referenced Instances and Access Macro” |
||||||||
Study Instance UID |
(0020,000D) |
1C/2 |
3/2 |
O |
3/2 |
O |
2 |
Required if the Workitem is expected to result in the creation of any DICOM Composite Instances whose IOD contains the Study IE. There may be situations where the performer does not use the Study Instance UID suggested by the Scheduler. |
All other Attributes from the Unified Procedure Step Scheduled Procedure Information Module |
3/3 |
3/3 |
O |
3/3 |
- |
- |
||
Unified Procedure Step Relationship Module |
||||||||
Patient's Name |
(0010,0010) |
2/2 |
Not allowed |
O |
3/2 |
R |
2 |
|
Patient ID |
(0010,0020) |
1C/2 |
Not allowed |
O |
3/2 |
R |
2 |
Required if the subject of the workitem requires identification or if the workitem is expected to result in the creation of objects that identify the subject. |
Other Patient IDs Sequence |
(0010,1002) |
2/2 |
3/3 |
O |
3/2 |
O |
2 |
|
>Patient ID |
(0010,0020) |
1/1 |
1/1 |
O |
-/1 |
O |
1 |
|
Patient's Birth Date |
(0010,0030) |
2/2 |
Not allowed |
O |
3/2 |
R |
2 |
|
Patient's Sex |
(0010,0040) |
2/2 |
Not allowed |
O |
3/2 |
R |
2 |
|
Admission ID |
(0038,0010) |
2/2 |
Not allowed |
O |
3/2 |
R |
2 |
|
Issuer of Admission ID Sequence |
(0038,0014) |
2/2 |
Not allowed |
O |
3/2 |
R |
2 |
|
>Include Table CC.2.5-2d “HL7V2 Hierarchic Designator Macro” |
||||||||
Admitting Diagnoses Description |
(0008,1080) |
2/2 |
Not allowed |
O |
3/2 |
O |
2 |
|
Admitting Diagnoses Code Sequence |
(0008,1084) |
2/2 |
Not allowed |
O |
3/2 |
O |
2 |
The Attributes of the Admitting Diagnoses Code Sequence shall only be retrieved with Sequence Matching. |
Referenced Request Sequence |
(0040,A370) |
2/2 |
Not allowed |
O |
3/2 |
O |
2 |
Could be "changed" while SCHEDULED by canceling and re-creating with the "correct" values. |
>Study Instance UID |
(0020,000D) |
1/1 |
Not allowed |
O |
-/1 |
O |
1 |
|
>Accession Number |
(0008,0050) |
2/2 |
Not allowed |
O |
-/2 |
R |
2 |
|
>Issuer of Accession Number Sequence |
(0008,0051) |
2/2 |
Not allowed |
O |
-/2 |
R |
2 |
The Issuer of Accession Number Sequence shall only be retrieved with Sequence Matching. |
>>Include Table CC.2.5-2d “HL7V2 Hierarchic Designator Macro” |
||||||||
>Placer Order Number/Imaging Service Request |
(0040,2016) |
3/1 |
Not allowed |
O |
-/1 |
O |
1C |
Required if set. |
>Order Placer Identifier Sequence |
(0040,0026) |
2/2 |
Not allowed |
O |
-/2 |
O |
2 |
The Order Placer Identifier Sequence shall only be retrieved with Sequence Matching. |
>>Include Table CC.2.5-2d “HL7V2 Hierarchic Designator Macro” |
||||||||
>Filler Order Number/Imaging Service Request |
(0040,2017) |
3/1 |
Not allowed |
O |
-/1 |
O |
1C |
Required if set. |
>Order Filler Identifier Sequence |
(0040,0027) |
2/2 |
Not allowed |
O |
-/2 |
O |
2 |
The Order Filler Identifier Sequence shall only be retrieved with Sequence Matching. |
>>Include Table CC.2.5-2d “HL7V2 Hierarchic Designator Macro” |
||||||||
>Requested Procedure ID |
(0040,1001) |
2/2 |
Not allowed |
O |
-/2 |
R |
2 |
|
>Requested Procedure Description |
(0032,1060) |
2/2 |
Not allowed |
O |
-/2 |
O |
2 |
|
>Requested Procedure Code Sequence |
(0032,1064) |
2/2 |
Not allowed |
O |
-/2 |
O |
2 |
|
>Reason for the Requested Procedure |
(0040,1002) |
3/3 |
3/3 |
O |
-/3 |
- |
- |
|
> Reason for Requested Procedure Code Sequence |
(0040,100A) |
3/3 |
3/3 |
O |
-/3 |
- |
- |
|
>Requested Procedure Comments |
(0040,1400) |
3/3 |
3/3 |
O |
-/3 |
O |
1C |
Required if set. |
>Confidentiality Code |
(0040,1008) |
3/3 |
3/3 |
O |
-/3 |
O |
3 |
|
>Names of Intended Recipients of Results |
(0040,1010) |
3/3 |
3/3 |
O |
-/3 |
O |
3 |
|
>Imaging Service Request Comments |
(0040,2400) |
3/3 |
3/3 |
O |
-/3 |
O |
3 |
|
>Requesting Physician |
(0032,1032) |
3/3 |
3/3 |
O |
-/3 |
O |
3 |
|
>Requesting Service |
(0032,1033) |
3/1 |
3/1 |
O |
-/3 |
R |
3 |
|
>Issue Date of Imaging Service Request |
(0040,2004) |
3/3 |
3/3 |
O |
-/3 |
O |
3 |
|
>Issue Time of Imaging Service Request |
(0040,2005) |
3/3 |
3/3 |
O |
-/3 |
O |
3 |
|
>Referring Physician's Name |
(0008,0090) |
3/3 |
3/3 |
O |
-/3 |
O |
3 |
|
Replaced Procedure Step Sequence |
(0074,1224) |
1C/1C |
Not allowed |
O |
3/2 |
R |
3 |
Required if the UPS replaces another Procedure Step. |
Patient Medical Module |
||||||||
Medical Alerts |
(0010,2000) |
3/2 |
3/2 |
O |
3/2 |
O |
2C |
Required if present. |
Pregnancy Status |
(0010,21C0) |
3/2 |
3/2 |
O |
3/2 |
O |
2C |
Required if present. |
Special Needs |
(0038,0050) |
3/2 |
3/2 |
O |
3/2 |
O |
2C |
Required if present. |
All other Attributes from the Patient Medical Module |
3/3 |
3/3 |
O |
3/3 |
O |
3 |
||
Unified Procedure Step Progress Information Module |
||||||||
Procedure Step State |
(0074,1000) |
1/1 Shall be created with a value of "SCHEDULED" |
Not Allowed. Use N-ACTION |
R |
3/1 |
R |
1 |
Procedure Step State shall be retrieved with Single Value Matching |
Progress Information Sequence |
(0074,1002) |
2/2 Shall be empty |
3/2 |
X |
3/2 |
2 |
||
>Procedure Step Progress |
(0074,1004) |
Not Allowed |
3/1 |
O |
-/1 |
- |
- |
|
>Procedure Step Progress Description |
(0074,1006) |
Not Allowed |
3/1 |
O |
-/1 |
- |
- |
|
>Procedure Step Communications URI Sequence |
(0074,1008) |
Not Allowed |
3/1 |
O |
-/1 |
- |
- |
|
>>Contact URI |
(0074,100a) |
Not Allowed |
1/1 |
O |
-/1 |
- |
- |
|
>>Contact Display Name |
(0074,100c) |
Not Allowed |
3/1 |
O |
-/1 |
- |
- |
|
Procedure Step Cancellation DateTime |
(0040,4052) |
Not Allowed |
3/1 |
X |
-/1 |
- |
- |
If changing the UPS State (0074,1000) to CANCELED and this Attribute has no value, the SCP shall fill it with the current datetime. |
>Reason For Cancellation |
(0074,1238) |
Not Allowed |
3/1 |
O |
-/1 |
- |
- |
|
>Procedure Step Discontinuation Reason Code Sequence |
(0074,100e) |
Not Allowed |
3/1 |
X |
-/1 |
|||
Unified Procedure Step Performed Procedure Information Module |
||||||||
Unified Procedure Step Performed Procedure Sequence |
(0074,1216) |
2/2 Shall be created empty |
3/2 |
P |
3/2 |
- |
- |
See CC.2.5.1.3.2. |
>Actual Human Performers Sequence |
(0040,4035) |
Not Allowed |
3/1 |
RC |
-/1 |
O |
1C |
Shall be provided if known. Return Key required if set. The Attributes of the Actual Human Performers Sequence shall only be retrieved with Sequence Matching. |
>>Human Performer Code Sequence |
(0040,4009) |
Not Allowed |
3/1 |
RC |
-/1 |
- |
- |
Shall be provided if known. |
>>>Include Table CC.2.5-2a “UPS Code Sequence Macro” |
||||||||
>>Human Performer's Name |
(0040,4037) |
Not Allowed |
3/1 |
RC |
-/1 |
- |
- |
Shall be provided if known |
>>Human Performer's Organization |
(0040,4036) |
Not Allowed |
3/1 |
O |
-/1 |
- |
- |
|
>Performed Station Name Code Sequence |
(0040,4028) |
Not Allowed |
3/2 |
P |
-/2 |
O |
3 |
|
>Performed Station Class Code Sequence |
(0040,4029) |
Not Allowed |
3/2 |
O |
-/2 |
- |
- |
|
>Performed Station Geographic Location Code Sequence |
(0040,4030) |
Not Allowed |
3/2 |
O |
-/2 |
- |
- |
|
>Performed Procedure Step Start DateTime |
(0040,0244) |
Not Allowed |
3/1 |
P |
-/1 |
- |
- |
|
>Performed Procedure Step Description |
(0040,0254) |
Not Allowed |
3/1 |
O |
-/1 |
- |
- |
|
>Comments on the Performed Procedure Step |
(0040,0280) |
Not Allowed |
3/1 |
O |
-/1 |
- |
- |
|
>Performed Workitem Code Sequence |
(0040,4019) |
Not Allowed |
3/1 |
P |
-/1 |
- |
- |
|
>Performed Processing Parameters Sequence |
(0074,1212) |
Not Allowed |
3/1 |
O |
-/1 |
- |
- |
|
>>Include Table CC.2.5-2b “UPS Content Item Macro” |
||||||||
>Performed Procedure Step End DateTime |
(0040,0250) |
Not Allowed |
3/1 |
P |
-/1 |
O |
1C |
Required if set. |
>Output Information Sequence |
(0040,4033) |
Not Allowed |
2/2 |
P |
-/2 |
- |
- |
If there are no relevant output objects, then this sequence may have no items. |
>Include Table CC.2.5-2c “Referenced Instances and Access Macro” |
The Attributes of the UPS Performed Procedure Sequence shall only be retrieved with Sequence Matching.
Since this Attribute may be created empty and has a Final State requirement of X, a UPS in the SCHEDULED state may be canceled with two N-ACTIONS (IN PROGRESS then CANCELED) and no N-SETs.
An SCU uses N-CREATE to request the SCP schedule a new UPS.
The SCU shall specify in the N-CREATE request primitive the UPS Push SOP Class UID and the SOP Instance UID for the UPS that is to be created and for which Attribute Values are to be provided. See Section CC.3.1 for further discussion of UPS SOP Class UIDs.
The SCU shall provide Attribute values in the N-CREATE request primitive for all required UPS Attributes as specified in Table CC.2.5-3. Additionally, values may be provided for optional Attributes as specified in Table CC.2.5-3.
The SCU shall specify a value of "SCHEDULED" for the Attribute Procedure Step State (0074,1000) in the N-CREATE request primitive.
The SCP shall create and maintain UPS instances as instructed by N-CREATE requests and as specified by Table CC.2.5-3.
The SCP shall return, via the N-CREATE response primitive, the N-CREATE Response Status Code applicable to the associated request.
The SCP shall accept N-CREATE request primitives only if the value of the Procedure Step State (0074,1000) Attribute is "SCHEDULED". If the Procedure Step State Attribute has another value, the SCP shall fail the N-CREATE.
The SCP may modify Attributes of a UPS instance, e.g., to correct invalid Attribute values. A description of the modifications the SCP may perform shall be documented in the conformance statement of the SCP.
The SCP may also create and maintain UPS instances without receiving a UPS instance N-CREATE request, e.g., based on internal logic, operator inputs or HL7 messages. The contents of the instance created by the SCP must still comply with the N-CREATE requirements in Table CC.2.5-3.
Upon creating a new UPS Instance, the SCP shall update UPS Subscription Status of the Instance for each AE with a Global Subscription as described in Section CC.2.3.
Upon creating a new UPS Instance, the SCP shall send UPS State Reports (if it supports the UPS Event SOP Class) as described in Section CC.2.4.3 regardless of whether the creation was based on an N-CREATE or on internal logic.
Bi-directional Authentication of machines/users/applications is possible at association time (see PS3.7 and PS3.15). PS3.7 provides a "Refused: Not Authorized" error code. There are no specific requirements to perform authorization.
The status values that are specific for this DIMSE operation are defined in Table CC.2.5-4.
Table CC.2.5-4. Status Values
Status |
Meaning |
Code |
---|---|---|
Success |
The UPS was created as requested |
0000 |
Warning |
The UPS was created with modifications |
B300 |
Failure |
Refused: The provided value of UPS State was not "SCHEDULED". |
C309 |
This operation allows an SCU to set Attribute Values of a UPS Instance and provide information about a specific real-world UPS that is under control of the SCU. This operation shall be invoked by the SCU through the DIMSE N-SET Service.
The Application Entity that claims conformance to the UPS Pull SOP Class as an SCU may choose to modify a subset of the Attributes maintained by the SCP. The Application Entity that claims conformance as an SCP to the UPS Pull SOP Class shall support Attributes specified in Table CC.2.5-3
The SCU shall specify in the N-SET request primitive the UID of the UPS Instance for which it wants to set Attribute Values. Since all UPSs are created as instances of the UPS Push SOP Class, the Requested SOP Class UID in the N-SET request shall be the UID of the UPS Push SOP Class. See Section CC.3.1 for further details.
To N-SET a UPS instance currently in the SCHEDULED state, the Transaction UID Attribute shall not be present in the request. For a UPS instance in the IN PROGRESS state, the SCU shall provide the current Transaction UID (0008,1195) as an Attribute.
The SCU shall be permitted to set Attribute values as specified in Table CC.2.5-3. The SCU shall specify the list of Attributes for which it wants to set the Attribute Values. The SCU shall provide, with one or more N-SET request primitives, the Attribute values specified in Table CC.2.5-3.
When modifying a sequence, the SCU shall include in the N-SET request all Items in the sequence, not just the Items to be modified.
N-SET requests shall be atomic (indivisible) and idempotent (repeat executions have no additional effect). Since it is possible for an N-GET to occur between two N-SET requests, any given N-SET shall leave the UPS instance in an internally consistent state (i.e., when multiple Attributes need updating as a group, do this as multiple Attributes in a single N-SET request, not as multiple N-SET requests)
The SCU shall not set the value of the Procedure Step State (0074,1000) Attribute using N-SET. Procedure Step State is managed using N-ACTION as described in Section CC.2.1
The SCU shall create or set all Attributes to meet Final State requirements prior to using N-ACTION to set the value of Procedure Step State (0074,1000) to "COMPLETED" or "CANCELED". See Section CC.2.5.1.1 for further details.
Once the Procedure Step State (0074,1000) has been set to "COMPLETED" or "CANCELED" the SCU shall no longer modify the UPS SOP Instance.
The SCU can only set Attribute Values that have already been created with an N-CREATE request.
The SOP Class UID of the specified UPS instance will always be the UPS Push SOP Class UID, which might not match the UPS SOP Class negotiated with the SCU. See Section CC.3.1 for further details.
The SCP shall support the Attribute changes to the UPS instance specified by the SCU in the N-SET request primitive as specified in Table CC.2.5-3.
The SCP shall refuse N-SET requests on an IN PROGRESS UPS and not modify the UPS if the N-SET request does not include the Transaction UID (0008,1195) Attribute with the same value as currently recorded in the UPS instance.
The SCP shall refuse N-SET requests on a COMPLETED or CANCELED UPS.
The SCP shall use the Specific Character Set (0008,0005) value to appropriately modify its internal representation so that subsequent operations reflect the combination of the character sets in use by the Attributes in this N-SET and those used by Attributes that have not been modified.
The SCP shall return, via the N-SET response primitive, the N-SET Response Status Code applicable to the associated request as specified in Section CC.2.6.4.
The SCP may itself modify any Attributes of a UPS instance independently of an N-SET request, e.g., if the SCP is performing the procedure step itself, if it has been determined that the performing SCU has been disabled, or if it is necessary to correct Attribute values after completion of the procedure in order to carry out reconciliation of the data. A description of the coercions the SCP may perform shall be documented in the conformance statement of the SCP.
Bi-directional Authentication of machines/users/applications is possible at association time (see PS3.7 and PS3.15). PS3.7 provides a "Refused: Not Authorized" error code. There are no specific requirements to perform authorization.
The status values that are specific for this DIMSE operation are defined in Table CC.2.6-1. See PS3.7 for additional response status codes.
Table CC.2.6-1. Status Values
Status |
Meaning |
Code |
---|---|---|
Success |
The requested modification of the Attribute values is performed |
0000 |
Warning |
Requested optional Attributes are not supported. |
0001 |
Coerced invalid values to valid values |
B305 |
|
Failure |
Refused: The UPS is not in the "IN PROGRESS" state |
C310 |
Refused: The correct Transaction UID was not provided |
C301 |
|
Refused: The UPS may no longer be updated |
C300 |
|
Specified SOP Instance UID does not exist or is not a UPS Instance managed by this SCP |
C307 |
This operation allows an SCU to get information from an SCP about a specific real-world Procedure Step that is represented as a Unified Procedure Step Instance. This operation shall be invoked by the SCU through the DIMSE N-GET Service.
The Application Entity that claims conformance to the UPS Pull or UPS Watch SOP Classes as an SCU may choose to retrieve a subset of the Attribute values maintained by the SCP. The Application Entity that claims conformance as an SCP to these SOP Classes shall support the Attributes specified in Table CC.2.5-3.
The SCU uses the N-GET to request the SCP to provide Attributes and values of a Unified Procedure Step Instance. Since all UPSs are created as instances of the UPS Push SOP Class, the Affected SOP Class UID (0000,0002) in the N-GET request shall be the UID of the UPS Push SOP Class. See Section CC.3.1 for further details.
The SCU shall specify in the N-GET Service Element the UID of the SOP Instance from which Attributes are to be retrieved.
The SCU shall specify the list of Unified Procedure Step Attributes for which values are to be returned. The SCU shall not specify Attributes that are defined within a Sequence, but rather specify the sequence itself to be retrieved in its entirety.
The SCU shall not request the value of the Transaction UID (0008,1195) Attribute.
The SCU may request Attribute Values for optional Attributes that are not maintained by the SCP. In such a case, the SCU shall function properly regardless of whether the SCP returns values for those Attributes or not. This Service Class Specification places no requirements on what the SCU shall do as a result of receiving this information.
In order to accurately interpret the character set used for the Attribute Values returned, it is recommended that the Attribute Value for the Specific Character Set (0008,0005) be requested in the N-GET request primitive.
The SCU shall be permitted to request and shall be capable of receiving values for any Attribute as specified in Table CC.2.5-3. Additionally, values may be requested for optional Attributes.
The SCU shall be capable of receiving all requested Attribute Values provided by the SCP in response to the N-GET indication primitive.
If the SCU or the user will need access to the final state Attributes it is the responsibility of the SCU to Subscribe (see Section CC.2.2) in order to receive State Change Events and then N-GET the necessary Attributes promptly upon notification of a state change to COMPLETED or CANCELED. If the SCU sets the Deletion Lock when subscribing, a COMPLETED or CANCELLED instance will continue to persist on the SCP, using resources. It is important that the SCU remove the lock (e.g., by unsubscribing) after doing the N-GET on the COMPLETED or CANCELED instance.
The SOP Class UID of the specified UPS instance will always be the UPS Push SOP Class UID, which might not match the UPS SOP Classes negotiated with the SCU. See Section CC.3.1 for further details.
The SCP shall return, via the N-GET response primitive, the selected Attribute values from the indicated Unified Procedure Step Instance to the SCU.
The requirement for the SCP to respond to N-GET requests for UPS Instances that have moved to the COMPLETED or CANCELED state is limited. See Section CC.2.1.3 Service Class Provider Behavior.
The SCP shall not return the Transaction UID (0008,1195) Attribute. This is necessary to preserve this Attribute's role as an access lock.
The SCP shall return, via the N-GET response primitive, the N-GET Response Status Code applicable to the associated request. A Failure Code shall indicate that the SCP has not retrieved the SOP Instance.
Bi-directional Authentication of machines/users/applications is possible at association time (see PS3.7 and PS3.15). PS3.7 provides a "Refused: Not Authorized" error code. Further requiring or documenting authentication and/or authorization features from the SCU or SCP is beyond the scope of this SOP Class.
The status values that are specific for this DIMSE operation are defined in Table CC.2.7-1. See PS3.7 for additional response status codes.
Table CC.2.7-1. Status Values
Status |
Meaning |
Code |
---|---|---|
Warning |
Requested optional Attributes are not supported |
0001 |
Failure |
Specified SOP Instance UID does not exist or is not a UPS Instance managed by this SCP |
C307 |
This operation allows an SCU to locate and get information about Unified Procedure Step instances of interest that are managed by an SCP. This operation shall be invoked by the SCU through the DIMSE C-FIND Service. The SCP processes such queries, matches UPS instances it manages against the keys present in the Identifier and returns C-FIND responses.
The SCU might be searching for UPS instance with the intention of starting work on one of them or perhaps with the intention of subscribing to monitor the progress of an instance.
In response to a given C-FIND request, the SCP might send several C-FIND responses, (i.e., one C-FIND response per matching worklist item). Each worklist item describes a single task and its related information.
The Unified Procedure Step Query Information Model is represented by the Entity Relationship diagram shown in Figure CC.2.8-1.
There is only one Information Entity in the model, which is the Unified Procedure Step. The Attributes of a Unified Procedure Step can be found in Table CC.2.5-3.
The Affected SOP Class UID of the C-FIND DIMSE request shall always be the UPS SOP Class negotiated for the Presentation Context under which the service is requested. This will always be either the UPS Pull SOP Class or the UPS Watch SOP Class. See Section CC.3.1 for further details.
For both the UPS Pull SOP Class and the UPS Watch SOP Class, the C-FIND is performed against the Unified Procedure Step Information Model shown in Figure CC.2.8-1.
The Priority Attribute defines the requested priority of the C-FIND operation with respect to other DIMSE operations being performed by the same SCP.
Processing of priority requests is not required of SCPs. Whether or not an SCP supports priority processing and the meaning of the different priority levels shall be stated in the Conformance Statement of the SCP.
Both the C-FIND request and response contain an Identifier encoded as a Data Set (see PS3.5).
An Identifier in a C-FIND request shall contain:
Key Attributes values to be matched against the values of Attributes specified in the SOP Class identified by the Affected SOP Class UID.
Conditionally, the Attribute Specific Character Set (0008,0005). This Attribute shall be included if expanded or replacement character sets may be used in any of the Attributes in the Request Identifier. It shall not be included otherwise.
Conditionally, the Attribute Timezone Offset From UTC (0008,0201). This Attribute shall be included if Key Attributes of time are to be interpreted explicitly in the designated local time zone. It shall not be present otherwise, i.e., it shall not be sent with a zero-length value.
This means that Specific Character Set (0008,0005) is included if the SCU supports expanded or replacement character sets in the context of this service. It will not be included if expanded or replacement character sets are not supported by the SCU.
The Key Attributes and values allowable for the query shall be defined in the SOP Class definition corresponding to the Affected SOP Class UID for the corresponding Unified Worklist And Procedure Step Information Model.
The C-FIND response shall not contain Attributes that were not in the request or specified in this section.
An Identifier in a C-FIND response shall contain:
Key Attributes with values corresponding to Key Attributes contained in the Identifier of the request (Key Attributes as defined in Table CC.2.5-3.)
Conditionally, the Attribute Specific Character Set (0008,0005). This Attribute shall be included if expanded or replacement character sets may be used in any of the Attributes in the Response Identifier. It shall not be included otherwise. The C-FIND SCP is not required to return responses in the Specific Character Set requested by the SCU if that character set is not supported by the SCP. The SCP may return responses with a different Specific Character Set.
Conditionally, the Attribute Timezone Offset From UTC (0008,0201). This Attribute shall be included if any Attributes of time in the Response Identifier are to be interpreted explicitly in the designated local time zone. It shall not be present otherwise, i.e., it shall not be sent with a zero-length value.
This means that Specific Character Set (0008,0005) is included if the SCP supports expanded or replacement character sets in the context of this service. It will not be included if expanded or replacement character sets are not supported by the SCP.
All C-FIND SCUs shall be capable of generating query requests that meet the requirements of the "Worklist" Search Method (see Section CC.2.8.3.1).
Required Keys and Optional Keys, identified in Table CC.2.5-3, associated with the Query may be contained in the Identifier.
An SCU conveys the following semantics using the C-FIND requests and responses:
The SCU requests that the SCP perform a match of all keys specified in the Identifier of the request against the information it possesses of the Query specified in the request.
The SCU shall interpret Pending responses to convey the Attributes of a match of an item.
The SCU shall interpret a response with a status equal to Success, Failure, or Cancel to convey the end of Pending responses.
The SCU shall interpret a Failure response to a C-FIND request as an indication that the SCP is unable to process the request.
The SCU may cancel the C-FIND service by issuing a C-FIND-CANCEL request at any time during the processing of the C-FIND. The SCU shall recognize a status of Cancel to indicate that the C-FIND-CANCEL was successful.
All C-FIND SCPs shall be capable of processing queries that meet the requirements of the "Worklist" Search (see Section CC.2.8.3.1). This does not imply that an SCP that supports the UPS Watch SOP Class must also be an SCP of the UPS Pull SOP Class.
The SCP shall support Attribute matching as described in Section C.2.2.2.
An SCP conveys the following semantics using the C-FIND requests and responses:
The SCP is requested to perform a match of all the keys specified in the Identifier of the request, against the information it possesses. Attribute matching is performed using the key values specified in the Identifier of the C-FIND request as defined in Table CC.2.5-3.
The SCP generates a C-FIND response for each match using the "Worklist" Search method. All such responses shall contain an Identifier whose Attributes contain values from a single match. All such responses shall contain a status of Pending.
When all matches have been sent, the SCP generates a C-FIND response that contains a status of Success. A status of Success shall indicate that a response has been sent for each match known to the SCP.
No Identifier is contained in a response with a status of Success. For a complete definition, see PS3.7.
When there are no matches, then no responses with a status of Pending are sent, only a single response with a status of Success.
The SCP shall generate a response with a status of Failure if it is unable to process the request. A Failure response shall contain no Identifier.
If the SCP receives C-FIND-CANCEL indication before it has completed the processing of the matches it shall interrupt the matching process and return a status of Cancel.
Bi-directional Authentication of machines/users/applications is possible at association time (see PS3.7 and PS3.15). PS3.7 provides a "Refused: Not Authorized" error code. Further requiring or documenting authentication and/or authorization features from the SCU or SCP is beyond the scope of this SOP Class.
The following steps are used to generate match responses.
Match the key match Attributes contained in the Identifier of the C-FIND request against the values of the Key Attributes for each worklist entity.
If there are no matching keys, then there are no matches, return a response with a status equal to Success and with no Identifier.
Otherwise,
For each entity for which the Attributes match all of the specified matching key Attributes, construct an Identifier. This Identifier shall contain all of the values of the Attributes for this entity that correspond to the return keys specified in the C-FIND request.
Return a response for each remaining Identifier.
Table CC.2.5-3 defines the Attributes of the Unified Procedure Step Information Model, the requirements for key matching, and the requirements for return keys.
Table CC.2.8-2 defines the status code values that might be returned in a C-FIND response. Fields related to status code values are defined in PS3.7.
Table CC.2.8-2. C-FIND Response Status Values
Service Status |
Further Meaning |
Status Codes |
Related Fields |
---|---|---|---|
Failure |
Refused: Out of Resources |
A700 |
(0000,0902) |
Identifier Does Not Match SOP Class |
A900 |
(0000,0901) (0000,0902) |
|
SOP Class not Supported |
0122 |
||
Unable to process |
(any value C000 through CFFF as assigned by the implementation) |
(0000,0901) (0000,0902) |
|
Cancel |
Matching terminated due to Cancel request |
FE00 |
None |
Success |
Matching is complete - No final Identifier is supplied. |
0000 |
None |
Pending |
Matches are continuing - Current Match is supplied and any Optional Keys were supported in the same manner as Required Keys. |
FF00 |
Identifier |
Matches are continuing - Warning that one or more Optional Keys were not supported for existence for this Identifier. |
FF01 |
Identifier |
Status Codes are returned in DIMSE response messages (see PS3.7). The code values stated in column "Status Codes" are returned in Status Command Element (0000,0900).