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