The following sections describe the DIMSE-N Services. The behavior of these services is also described in PS3.4. The Affected SOP Class UID in the DIMSE-N command need not match the SOP Class UID in the Presentation Context negotiated for the association over which the DIMSE-N command has been sent. PS3.4 specifies which combinations are valid.
The N-EVENT-REPORT service is used by a DIMSE-service-user to report an event to a peer DIMSE-service-user. It is a confirmed service.
Table 10.1-1 lists the parameters for this service.
Table 10.1-1. N-EVENT-REPORT Parameters
|
DIMSE Parameter Name |
Req/Ind |
Rsp/Conf |
|---|---|---|
|
Message ID |
M |
- |
|
Message ID Being Responded To |
- |
M |
|
Affected SOP Class UID |
M |
U(=) |
|
Affected SOP Instance UID |
M |
U(=) |
|
Event Type ID |
M |
C(=) |
|
Event Information |
U |
- |
|
Event Reply |
- |
C |
|
Status |
- |
M |
This parameter identifies the operation. It is used to distinguish this operation from other notifications or operations that the DIMSE-service-provider may have in progress. No two identical values for the Message ID (0000,0110) shall be used for outstanding operations or notifications.
The Message ID (0000,0110) is recommended to be unique within the scope of an Association, to support debug procedures.
This parameter specifies the Message ID (0000,0110) of the notification request/indication to which this response/confirmation applies.
For the request/indication, this parameter specifies the SOP Class of the SOP Instance for the event. It may be included in the response/confirmation. If included in the response/confirmation, this parameter shall be equal to the value in the request/indication.
For the request/indication, this parameter specifies the SOP Instance for the event. It may be included in the response/confirmation. If included in the response/confirmation, this parameter shall be equal to the value in the request/indication.
This parameter specifies the type of event being reported. It may be included in the success response/confirmation and shall be included if the Event Reply parameter is included.
Service Class Specifications contained in PS3.4 defines any application usage of the Event Type ID parameter.
This application-specific parameter contains information that the invoking DIMSE-service-user is able to supply about the event.
Service Class Specifications contained in PS3.4 defines any application usage of the Event Information parameter.
This application-specific parameter contains the optional reply to the event report. It may only be included in the success response/confirmation.
Service Class Specifications contained in PS3.4 defines any application usage of the Event Reply parameter.
This parameter contains the error or success notification for the operation. It shall be included by the performing DIMSE-service-user in any response/confirmation. The following types of status may occur:
class-instance conflict: the specified SOP Instance is not a member of the specified SOP class.
duplicate invocation: the Message ID (0000,0110) specified is allocated to another notification or operation.
invalid argument value: the event information value specified was out of range or otherwise inappropriate.
invalid SOP Instance: the SOP Instance UID specified implied a violation of the UID construction rules.
mistyped argument: one of the parameters supplied has not been agreed for use on the Association between the DIMSE-service-users.
no such argument: the event information specified was not recognized.
no such event type: the event type specified was not recognized.
no such SOP class: the SOP Class was not recognized.
no such SOP Instance: the SOP Instance was not recognized.
processing failure: a general failure in processing the operation was encountered.
resource limitation: the operation was not performed due to resource limitation.
success: successful notification.
unrecognized operation: the operation is not one of those agreed between the DIMSE-service-users.
The following N-EVENT-REPORT procedures apply:
The invoking DIMSE-service-user reports an event to the performing DIMSE-service-user by issuing an N-EVENT-REPORT request primitive to the DIMSE-service-provider.
The DIMSE-service-provider issues an N-EVENT-REPORT indication primitive to the performing DIMSE-service-user.
The performing DIMSE-service-user reports acceptance or rejection of the N-EVENT-REPORT request primitive by issuing an N-EVENT-REPORT response primitive to the DIMSE-service-provider.
The DIMSE-service-provider issues an N-EVENT-REPORT confirmation primitive to the invoking DIMSE-service-user, completing the N-EVENT-REPORT notification.
The performing DIMSE-service-user may return an N-EVENT-REPORT response primitive with the status of Failed or Refused before the entire N-EVENT-REPORT indication (Data Set) has been completely transmitted by the invoking DIMSE-service-user. A N-EVENT-REPORT response primitive with the status of Success or Warning shall not be returned until the entire N-EVENT-REPORT indication has been received by the performing DIMSE-service-user.
Such an occurrence of a "Failed" response is often called an early failed response.
The N-GET service is used by a DIMSE-service-user to retrieve Attribute values from a peer DIMSE-service-user. It is a confirmed service.
Table 10.1-2 lists the parameters for this service.
Table 10.1-2. N-GET Parameters
|
DIMSE Parameter Name |
Req/Ind |
Rsp/Conf |
|---|---|---|
|
Message ID |
M |
- |
|
Message ID Being Responded To |
- |
M |
|
Requested SOP Class UID |
M |
- |
|
Requested SOP Instance UID |
M |
- |
|
Attribute Identifier List |
U |
- |
|
Affected SOP Class UID |
- |
U |
|
Affected SOP Instance UID |
- |
U |
|
Attribute List |
- |
C |
|
Status |
- |
M |
This parameter identifies the operation. It is used to distinguish this operation from other notifications or operations that the DIMSE-service-provider may have in progress. No two identical values for the Message ID (0000,0110) shall be used for outstanding operations or notifications.
The Message ID (0000,0110) is recommended to be unique within the scope of an Association, to support debug procedures.
This parameter specifies the Message ID (0000,0110) of the operation request/indication to which this response/confirmation applies.
This parameter specifies the SOP Class for which Attribute Values are to be retrieved.
This parameter specifies the SOP Instance for which Attribute Values are to be retrieved.
This parameter contains a set of Attribute identifiers for which the Attribute Values are to be returned by the performing DIMSE-service-user. If this parameter is omitted, all Attribute identifiers are assumed. The definitions of the Attributes are found in the specification of the Information Object Definition in PS3.3.
This parameter may be included in the response/confirmation. If included in the response/confirmation, this parameter shall be equal to the Requested SOP Class UID parameter value used in the request/indication.
This parameter specifies the SOP Instance for which Attribute Values are returned. It may be included in any response/confirmation and when included shall be equal to the Requested SOP Instance UID (0000,1001) parameter value used in the invocation.
This parameter contains the set of Attribute identifiers and values that are returned by the performing DIMSE-service-user. It shall be included in the success response/confirmation.
This parameter contains the error or success notification for the operation. It shall be included by the performing DIMSE-service-user in any response/confirmation. The following types of status may occur:
attribute list error: one or more Attribute Values were not read because the specified Attribute was not recognized. The Attribute Values that could be read are returned.
class-instance conflict: the specified SOP Instance is not a member of the specified SOP Class.
duplicate invocation: the Message ID (0000,0110) specified is allocated to another notification or operation.
invalid SOP Instance: the SOP Instance UID specified implied a violation of the UID construction rules.
mistyped argument: one of the parameters supplied has not been agreed for use on the Association between the DIMSE-service-users.
no such SOP class: the SOP Class was not recognized.
no such SOP Instance: the SOP Instance was not recognized.
processing failure: a general failure in processing the operation was encountered.
resource limitation: the operation was not performed due to resource limitation.
success: successful operation.
unrecognized operation: the operation is not one of those agreed between the DIMSE-service-users.
not authorized:the DIMSE-service-user was not authorized to invoke the operation
The following N-GET procedures apply;
The invoking DIMSE-service-user requests the performing DIMSE-service-user to retrieve Attribute Value(s) by issuing an N-GET request primitive to the DIMSE-service-provider.
The DIMSE-service-provider issues an N-GET indication primitive to the performing DIMSE-service-user.
If the operation can be performed, then the performing DIMSE-service-user retrieves the requested Attribute Value(s) and generates a response indicating acceptance of the N-GET request primitive by issuing an N-GET response primitive to the DIMSE-service-provider. In this case the following procedure does not apply.
If the operation cannot be performed, then the performing DIMSE-service-user rejects the N-GET request by issuing an N-GET response primitive with the appropriate error code to the DIMSE-service-provider.
The DIMSE-service-provider issues an N-GET confirmation primitive to the invoking DIMSE-service-user, completing the N-GET operation.
The N-SET service is used by a DIMSE-service-user to request the modification of Attribute Values from a peer DIMSE-service-user. It is a confirmed service.
Table 10.1-3 lists the parameters for this service.
Table 10.1-3. N-SET Parameters
|
DIMSE Parameter Name |
Req/Ind |
Rsp/Conf |
|---|---|---|
|
Message ID |
M |
- |
|
Message ID Being Responded To |
- |
M |
|
Requested SOP Class UID |
M |
- |
|
Requested SOP Instance UID |
M |
- |
|
Modification List |
M |
- |
|
Attribute List |
- |
U |
|
Affected SOP Class UID |
- |
U |
|
Affected SOP Instance UID |
- |
U |
|
Status |
- |
M |
This parameter identifies the operation. It is used to distinguish this operation from other notifications or operations that the DIMSE-service-provider may have in progress. No two identical values for the Message ID (0000,0110) shall be used for outstanding operations or notifications.
The Message ID (0000,0110) is recommended to be unique within the scope of an Association, to support debug procedures.
This parameter specifies the Message ID (0000,0110) of the operation request/indication to which this response/confirmation applies.
This parameter specifies the SOP Class for which Attribute Values are to be modified.
This parameter specifies the SOP Instance for which Attribute Values are to be modified.
This parameter contains the set of Attribute identifiers and values that are to be used by the performing DIMSE-service-user to replace the current values of the Attributes specified.
This parameter contains the set of Attribute identifiers and values that were used by the performing DIMSE-service-user to replace the values of the Attributes specified. It may be included in the success response/confirmation.
This parameter may be included in the response/confirmation. If included in the response/confirmation, this parameter shall be equal to the Requested SOP Class UID parameter value used in the request/indication.
This parameter specifies the SOP Instance for which Attribute Values were modified. It may be included in any response/confirmation and when included shall be equal to the Requested SOP Instance UID (0000,1001) parameter value used in the invocation.
This parameter contains the error or success notification for the operation. It shall be included by the performing DIMSE-service-user in any response/confirmation. The following types of status may occur:
class-instance conflict: the specified SOP Instance is not a member of the specified SOP Class.
duplicate invocation: the Message ID (0000,0110) specified is allocated to another notification or operation.
invalid Attribute Value: the Attribute Value specified was out of range or otherwise inappropriate.
Attribute Value out of range:theAttributeValuespecifiedwasoutofrangeorotherwiseinappropriate.TheAttributeValuesthatcouldbemodifiedweremodified.
mistyped argument: one of the parameters supplied has not been agreed for use on the Association between the DIMSE-service-users.
invalid SOP Instance: the SOP Instance UID specified implied a violation of the UID construction rules.
missing Attribute Value: a required Attribute Value was not supplied.
no such Attribute: the Tag for the specified Attribute was not recognized.
Attribute list error:oneormoreAttributeValueswerenotmodifiedbecausethespecifiedAttributeswerenotrecognized.TheAttributeValuesthatcouldbemodifiedweremodified.
no such SOP class: the SOP Class was not recognized.
no such SOP Instance: the SOP Instance was not recognized.
processing failure: a general failure in processing the operation was encountered.
resource limitation: the operation was not performed due to resource limitation.
success: successful operation.
unrecognized operation: the operation is not one of those agreed between the DIMSE-service-users.
not authorized:the DIMSE-service-user was not authorized to invoke the operation.
The following N-SET procedures apply:
The invoking DIMSE-service-user requests the performing DIMSE-service-user to modify Attribute Value(s) by issuing an N-SET request primitive to the DIMSE-service-provider.
The DIMSE-service provider issues an N-SET indication primitive to the performing DIMSE-service-user.
If the operation can be performed, then the performing DIMSE-service-user modifies the requested Attribute Value(s) and generates a response indicating acceptance of the N-SET request primitive by issuing an N-SET response primitive to the DIMSE-service-provider. In this case the following procedure does not apply.
If the operation cannot be performed, then the performing DIMSE-service-user rejects the N-SET request by issuing an N-SET response primitive with the appropriate error code to the DIMSE-service-provider.
The DIMSE-service-provider issues an N-SET confirmation primitive to the invoking DIMSE-service-user, completing the N-SET operation.
The performing DIMSE-service-user may return an N-SET response primitive with the status of Failed or Refused before the entire N-SET indication (Data Set) has been completely transmitted by the invoking DIMSE-service-user. A N-SET response primitive with the status of Success or Warning shall not be returned until the entire N-SET indication has been received by the performing DIMSE-service-user.
Such an occurrence of a "Failed" response is often called an early failed response.
The N-ACTION service is used by a DIMSE-service-user to request an action by a peer DIMSE-service-user. It is a confirmed service.
Table 10.1-4 lists the parameters for this service.
Table 10.1-4. N-ACTION Parameters
|
DIMSE Parameter Name |
Req/Ind |
Rsp/Conf |
|---|---|---|
|
Message ID |
M |
- |
|
Message ID Being Responded To |
- |
M |
|
Requested SOP Class UID |
M |
- |
|
Requested SOP Instance UID |
M |
- |
|
Action Type ID |
M |
C(=) |
|
Action Information |
U |
- |
|
Affected SOP Class UID |
- |
U |
|
Affected SOP Instance UID |
- |
U |
|
Action Reply |
- |
C |
|
Status |
- |
M |
This parameter identifies the operation. It is used to distinguish this operation from other notifications or operations that the DIMSE-service-provider may have in progress. No two identical values for the Message ID (0000,0110) shall be used for outstanding operations or notifications.
The Message ID (0000,0110) is recommended to be unique within the scope of an Association, to support debug procedures.
This parameter specifies the Message ID (0000,0110) of the operation request/indication to which this response/confirmation applies.
This parameter specifies the SOP Class for which the action is to be performed.
This parameter specifies the SOP Instance on which the action is to be performed.
This parameter specifies a particular action that is to be performed. It may be included in the success response/confirmation and shall be included if the action reply parameter is included.
Service Class Specifications contained in PS3.4 defines any application usage of the Action Type ID (0000,1008) parameter.
This parameter specifies extra application-specific information when necessary to further define the nature, variations, or operands of the action to be performed. The syntax and semantics of the parameter depend upon the action requested. It may only be included in the request/indication.
Service Class Specifications contained in PS3.4 defines any application usage of the Action Information parameter.
This parameter may be included in the response/confirmation. If included in the response/confirmation, this parameter shall be equal to the Requested SOP Class UID parameter value used in the request/indication.
This parameter specifies the SOP Instance on which the action is to be performed. It may be included in any response/confirmation and when included shall be equal to the Requested SOP Instance UID (0000,1001) parameter value used in the invocation.
This parameter contains the application-specific reply to the action. It may be included in the success response/confirmation.
Service Class Specifications contained in PS3.4 defines any application usage of the Action Reply parameter.
This parameter contains the error or success notification for the operation. It shall be included by the performing DIMSE-service-user in any response/confirmation. The following type of status may occur:
class-instance conflict: the specified SOP Instance is not a member of the specified SOP Class.
duplicate invocation: the Message ID (0000,0110) specified is allocated to another notification or operation.
invalid argument value: the action information value specified was out of range or otherwise inappropriate.
invalid SOP Instance: the SOP Instance UID specified implied a violation of the UID construction rules.
mistyped argument: one of the parameters supplied has not been agreed for use on the Association between the DIMSE-service-users.
no such action: the action type specified was not supported.
no such argument: the action information specified was not supported.
no such SOP class: the SOP Class was not recognized.
no such SOP Instance: the SOP Instance was not recognized.
processing failure: a general failure in processing the operation was encountered.
resource limitation: the operation was not performed due to resource limitation.
success: successful operation.
unrecognized operation: the operation is not one of those agreed between the DIMSE-service-users.
not authorized:the DIMSE-service-user was not authorized to invoke the operation.
The following N-ACTION procedures apply:
The invoking DIMSE-service-user requests the performing DIMSE-service-user to perform an action on a managed SOP Instance by issuing an N-ACTION request primitive to the DIMSE-service-provider.
The DIMSE-service provider issues an N-ACTION indication primitive to the performing DIMSE-service-user.
If the operation can be performed, the performing DIMSE-service-user applies the action to the specified SOP Instance and generates a response indicating acceptance of the N-ACTION request primitive by issuing an N-ACTION response primitive to the DIMSE-service-provider. In this case the following procedure does not apply. The Action Reply may be included in a successful response.
If the operation cannot be performed, then the performing DIMSE-service-user rejects the N-ACTION request by issuing an N-ACTION response primitive with the appropriate error code to the DIMSE-service-provider.
The DIMSE-service-provider issues an N-ACTION confirmation primitive to the invoking DIMSE-service-user, completing the N-ACTION operation.
The performing DIMSE-service-user may return an N-ACTION response primitive with the status of Failed or Refused before the entire N-ACTION indication (Data Set) has been completely transmitted by the invoking DIMSE-service-user. A N-ACTION response primitive with the status of Success or Warning shall not be returned until the entire N-ACTION indication has been received by the performing DIMSE-service-user.
Such an occurrence of a "Failed" response is often called an early failed response.
The N-CREATE service is used by a DIMSE-service-user to request a peer DIMSE-service-user to create a new managed SOP Instance, complete with its identification and the values of its associated Attributes, and simultaneously to register its identification. It is a confirmed service.
Table 10.1-5 lists the parameters for this service.
Table 10.1-5. N-CREATE Parameters
|
DIMSE Parameter Name |
Req/Ind |
Rsp/Conf |
|---|---|---|
|
Message ID |
M |
- |
|
Message ID Being Responded To |
- |
M |
|
Affected SOP Class UID |
M |
U(=) |
|
Affected SOP Instance UID |
U |
C |
|
Attribute List |
U |
U |
|
Status |
- |
M |
This parameter identifies the operation. It is used to distinguish this operation from other notifications or operations that the DIMSE-service-provider may have in progress. No two identical values for the Message ID (0000,0110) shall be used for outstanding operations or notifications.
The Message ID (0000,0110) is recommended to be unique within the scope of an Association, to support debug procedures.
This parameter specifies the Message ID (0000,0110) of the operation request/indication to which this response/confirmation applies.
For the request/indication, this parameter specifies the SOP Class of the new SOP Instance that is to be created by the performing DIMSE-service-user. The performing DIMSE-service-user assigns to the new SOP Instance, a set of Attribute Values as specified by the definition of its SOP Class. For the response/confirmation, this parameter specifies the SOP class of the SOP Instance that was created. It may be included in the response/confirmation. If included in the response/confirmation, this parameter shall be equal to the value in the request/indication.
For the request/indication, this parameter specifies the SOP Instance that is used by the performing DIMSE-service-user. If the SOP Instance UID is not supplied by the invoking DIMSE-service-user, then the performing DIMSE-service-user assigns a value to this identification of instance. For the response/confirmation, this parameter may only be included in the success response/confirmation and shall be included if it is not supplied by the invoking DIMSE-service-user.
When this parameter is supplied by the invoking DIMSE-service-user, it contains a set of Attribute identifiers and values that the performing DIMSE-service-user is to assign to the new managed SOP Instance. When returned by the performing DIMSE-service-user in the success response/confirmation, this parameter contains the complete list of all Attribute identifiers and values that were assigned to the new managed SOP Instance.
This parameter contains the error or success notification for the operation. It shall be included by the performing DIMSE-service-user in any response/confirmation. The following type of status may occur:
duplicate invocation: the Message ID (0000,0110) specified is allocated to another notification or operation.
duplicate SOP Instance: the new managed SOP Instance Value supplied by the invoking DIMSE-service-user was already registered for a managed SOP Instance of the specified SOP Class.
invalid Attribute Value: the Attribute Value specified was out of range or otherwise inappropriate.
Attribute Value out of range: the Attribute Value specified was out of range or otherwise inappropriate. The SCP will apply a default value or will not include the attribute in the created instance.
invalid SOP Instance: the SOP Instance UID specified implied a violation of the UID construction rules.
missing Attribute: a required Attribute was not supplied.
missing Attribute Value: a required Attribute Value was not supplied and a default value was not available.
mistyped argument: one of the parameters supplied has not been agreed for use on the Association between the DIMSE-service-users.
no such Attribute: the Tag for the specified Attribute was not recognized.
Attribute list error:one or more specified Attributes were not recognized and not included in the created instance.
no such SOP class: the SOP Class was not recognized.
processing failure: a general failure in processing the operation was encountered.
resource limitation: the operation was not performed due to resource limitation.
success: successful operation.
unrecognized operation: the operation is not one of those agreed between the DIMSE-service-users.
not authorized:the DIMSE-service-user was not authorized to invoke the operation.
The following N-CREATE procedures apply:
The invoking DIMSE-service-user requests the creation and registration of a new managed SOP Instance by issuing an N-CREATE request primitive to the DIMSE-service-provider.
The DIMSE-service provider issues an N-CREATE indication primitive to the performing DIMSE-service-user.
If the operation can be performed, the performing DIMSE-service-user creates and registers the new managed SOP Instance and generates a response indicating acceptance of the N-CREATE request primitive by issuing an N-CREATE response primitive to the DIMSE-service-provider. In this case the following procedure does not apply.
If the operation cannot be performed, then the performing DIMSE-service-user rejects the N-CREATE request by issuing an N-CREATE response primitive with the appropriate error code to the DIMSE-service-provider.
The DIMSE-service-provider issues an N-CREATE confirmation primitive to the invoking DIMSE-service-user, completing the N-CREATE operation.
The performing DIMSE-service-user may return an N-CREATE response primitive with the status of Failed or Refused before the entire N-CREATE indication (Data Set) has been completely transmitted by the invoking DIMSE-service-user. A N-CREATE response primitive with the status of Success or Warning shall not be returned until the entire N-CREATE indication has been received by the performing DIMSE-service-user.
Such an occurrence of a "Failed" response is often called an early failed response.
The N-DELETE service is used by an invoking DIMSE-service-user to request a peer DIMSE-service-user to delete a managed SOP Instance and to de-register its identification. It is a confirmed service.
Table 10.1-6 lists the parameters for this service.
Table 10.1-6. N-DELETE Parameters
|
DIMSE Parameter Name |
Req/Ind |
Rsp/Conf |
|---|---|---|
|
Message ID |
M |
- |
|
Message ID Being Responded To |
- |
M |
|
Requested SOP Class UID |
M |
- |
|
Requested SOP Instance UID |
M |
- |
|
Affected SOP Class UID |
- |
U |
|
Affected SOP Instance UID |
- |
U |
|
Status |
- |
M |
This parameter identifies the operation. It is used to distinguish this operation from other notifications or operations that the DIMSE-service-provider may have in progress. No two identical values for the Message ID (0000,0110) shall be used for outstanding operations or notifications.
The Message ID (0000,0110) is recommended to be unique within the scope of an Association, to support debug procedures.
This parameter specifies the Message ID (0000,0110) of the operation request/indication to which this response/confirmation applies.
This parameter specifies the SOP Instance that is to be deleted.
This parameter may be included in the response/confirmation. If included in the response/confirmation, this parameter shall be equal to the parameter value used in the request/indication.
This parameter specifies the SOP Instance that was deleted. It may be included in any response/confirmation and when included shall be equal to the Requested SOP Instance UID (0000,1001) parameter value used in the invocation.
This parameter contains the error or success notification for the operation. It shall be included by the performing DIMSE-service-user in any response/confirmation. The following types of status may occur
class-instance conflict: the specified SOP Instance is not a member of the specified SOP Class
duplicate invocation: the Message ID (0000,0110) specified is allocated to another notification or operation
invalid SOP Instance: the SOP Instance UID specified implied a violation of the UID construction rules
mistyped argument: one of the parameters supplied has not been agreed for use on the Association between the DIMSE-service-users
no such SOP class: the SOP Class was not recognized
no such SOP Instance: the SOP Instance was not recognized
processing failure: a general failure in processing the operation was encountered
resource limitation: the operation was not performed due to resource limitation
success: successful operation
unrecognized operation: the operation is not one of those agreed between the DIMSE-service-users
not authorized:the DIMSE-service-user was not authorized to invoke the operation.
The following N-DELETE procedures apply:
The invoking DIMSE-service-user requests the performing DIMSE-service-user to delete a managed SOP Instance by issuing an N-DELETE request primitive to the DIMSE-service-provider.
The DIMSE-service provider issues an N-DELETE indication primitive to the performing DIMSE-service-user.
If the operation can be performed, the performing DIMSE-service-user deletes the specified managed SOP Instance and generates a response indicating acceptance of the N-DELETE request primitive by issuing an N-DELETE response primitive to the DIMSE-service-provider. In this case the following procedure does not apply.
If the operation cannot be performed, then the performing DIMSE-service-user rejects the N-DELETE request by issuing an N-DELETE response primitive with the appropriate error code to the DIMSE-service-provider.
The DIMSE-service-provider issues an N-DELETE confirmation primitive to the invoking DIMSE-service-user, completing the N-DELETE operation.