Protocol Approval Query/Retrieve Service Class

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

Supported SOP Classes

UID SOP Class
1.2.840.10008.5.1.4.1.1.200.4 ProtocolApprovalInformationFind
1.2.840.10008.5.1.4.1.1.200.5 ProtocolApprovalInformationMove
1.2.840.10008.5.1.4.1.1.200.6 ProtocolApprovalInformationGet

DIMSE Services

DIMSE Service Usage SCU/SCP
Protocol Approval Information Model - Find
C-FIND Mandatory/Mandatory
Protocol Approval Information Model - Move
C-MOVE Mandatory/Mandatory
Protocol Approval 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

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 Protocol Approval Query/Retrieve (Find) Statuses

When pynetdicom is acting as a Protocol Approval 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

Protocol Approval 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
0xAA00 Failure None of the frames requested were found in the SOP Instance
0xAA01 Failure Unable to create new object for this SOP class
0xAA02 Failure Unable to extract frames
0xAA03 Failure Time-based request received for a non-time-based original SOP Instance
0xAA04 Failure Invalid request
0xB000 Warning Sub-operations complete, one or more or warnings
0xC000 to 0xCFFF Failure Unable to process
0xFF00 Pending Sub-operations are continuing

pynetdicom Protocol Approval 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

Protocol Approval 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
0xAA00 Failure None of the frames requested were found in the SOP Instance
0xAA01 Failure Unable to create new object for this SOP class
0xAA02 Failure Unable to extract frames
0xAA03 Failure Time-based request received for a non-time-based original SOP Instance
0xAA04 Failure Invalid request
0xB000 Warning Sub-operations complete, one or more or warnings
0xC000 to 0xCFFF Failure Unable to process
0xFF00 Pending Sub-operations are continuing

pynetdicom Protocol Approval 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