Defined Procedure Protocol Query/Retrieve Service Class

The Defined Procedure Protocol Query/Retrieve Service Class defines a service that facilitates access to Defined Procedure Protocol objects.

Supported SOP Classes

UID SOP Class
1.2.840.10008.5.1.4.20.1 DefinedProcedureProtocolInformationModelFind
1.2.840.10008.5.1.4.20.2 DefinedProcedureProtocolInformationModelMove
1.2.840.10008.5.1.4.20.3 DefinedProcedureProtocolInformationModelGet

DIMSE Services

DIMSE Service Usage SCU/SCP
Defined Procedure Protocol Information Model - Find
C-FIND Mandatory/Mandatory
Defined Procedure Protocol Information Model - Move
C-MOVE Mandatory/Mandatory
Defined Procedure Protocol Information Model - Get
C-GET Mandatory/Mandatory

Statuses

C-FIND Statuses

Code (hex) Category Description
0x0000 Success Success
0x0122 Failure SOP Class not supported
0xFE00 Cancel Processing has been terminated

Defined Procedure Protocol Query/Retrieve (Find) Service Statuses

Code (hex) Category Description
0xA700 Failure Out of resources
0xA900 Failure Dataset does not match SOP Class
0xC000 to 0xCFFF Failure Unable to process
0xFF00 Pending Matches are continuing
0xFF01 Pending Matches are continuing; one or more Optional keys was not supported

pynetdicom Defined Procedure Protocol Query/Retrieve (Find) Statuses

When pynetdicom is acting as a Defined Procedure Protocol Query/Retrieve (Find) SCP it uses the following status codes values to indicate the corresponding issue has occurred to help aid in debugging.

Code (hex) Category Description
0xC001 Failure Handler bound to evt.EVT_C_FIND yielded a status Dataset with no (0000,0900) Status element
0xC002 Failure Handler bound to evt.EVT_C_FIND yielded an invalid status object (not a pydicom Dataset or an int)
0xC310 Failure Failed to decode the dataset received from the peer
0xC311 Failure Unhandled exception raised by the handler bound to evt.EVT_C_FIND
0xC312 Failure Failed to encode the dataset received from the handler bound to evt.EVT_C_FIND

C-GET Statuses

Code (hex) Category Description
0x0000 Success Success
0x0122 Failure SOP Class not supported
0x0124 Failure Not authorised
0x0210 Failure Duplicate invocation
0x0212 Failure Mistyped argument
0xFE00 Cancel Sub-operations terminated

Defined Procedure Protocol Query/Retrieve (Get) Service Statuses

Code (hex) Category Description
0xA701 Failure Out of resources; unable to calculate number of matches
0xA702 Failure Out of resources; unable to perform sub-operations
0xA900 Failure Dataset does not match SOP Class
0xB000 Warning Sub-operations complete, one or more or warnings
0xC000 to 0xCFFF Failure Unable to process
0xFF00 Pending Sub-operations are continuing

pynetdicom Defined Procedure Protocol Query/Retrieve (Get) Statuses

Code (hex) Category Description
0xC001 Failure Handler bound to evt.EVT_C_GET yielded a status Dataset with no (0000,0900) Status element
0xC002 Failure Handler bound to evt.EVT_C_GET yielded an invalid status object (not a pydicom Dataset or an int)
0xC410 Failure Failed to decode the dataset received from the peer
0xC411 Failure Unhandled exception raised by the handler bound to evt.EVT_C_GET
0xC413 Failure The handler bound to evt.EVT_C_GET yielded an invalid number of sub-operations

C-MOVE Statuses

Code (hex) Category Description
0x0000 Success Success
0x0122 Failure SOP Class not supported
0x0124 Failure Not authorised
0x0210 Failure Duplicate invocation
0x0211 Failure Unrecognised operation
0x0212 Failure Mistyped argument
0xFE00 Cancel Sub-operations terminated

Defined Procedure Protocol Query/Retrieve (Move) Service Statuses

Code (hex) Category Description
0xA701 Failure Out of resources; unable to calculate number of matches
0xA702 Failure Out of resources; unable to perform sub-operations
0xA801 Failure Move destination unknown
0xA900 Failure Dataset does not match SOP Class
0xB000 Warning Sub-operations complete, one or more or warnings
0xC000 to 0xCFFF Failure Unable to process
0xFF00 Pending Sub-operations are continuing

pynetdicom Defined Procedure Protocol Query/Retrieve (Move) Statuses

Code (hex) Category Description
0xC001 Failure Handler bound to evt.EVT_C_MOVE yielded a status Dataset with no (0000,0900) Status element
0xC002 Failure Handler bound to evt.EVT_C_MOVE yielded an invalid status object (not a pydicom Dataset or an int)
0xC510 Failure Failed to decode the dataset received from the peer
0xC511 Failure Unhandled exception raised by the handler bound to evt.EVT_C_MOVE
0xC513 Failure The handler bound to evt.EVT_C_MOVE yielded an invalid number of sub-operations
0xC514 Failure The handler bound to evt.EVT_C_MOVE failed to yield the (address, port) and/or the number of sub-operations
0xC515 Failure The handler bound to evt.EVT_C_MOVE failed to yield a valid (address, port) pair

References