Inventory Query/Retrieve Service Class¶

The Inventory Query/Retrieve Service Class defines a service that facilitates discovery of and access to Inventory composite objects.

Supported SOP Classes¶

UID	SOP Class
1.2.840.10008.5.1.4.1.1.201.2	Inventory FIND
1.2.840.10008.5.1.4.1.1.201.3	Inventory MOVE
1.2.840.10008.5.1.4.1.1.201.4	Inventory GET

DIMSE Services¶

DIMSE Service	Usage SCU/SCP
Inventory FIND
C-FIND	Mandatory/Mandatory

DIMSE Service	Usage SCU/SCP
Inventory MOVE
C-MOVE	Mandatory/Mandatory

DIMSE Service	Usage SCU/SCP
Inventory 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

Inventory Query/Retrieve (Find) Service Statuses¶

Code (hex)	Category	Description
0xA700	Failure	Out of resources
0xA900	Failure	Data Set 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 Inventory Query/Retrieve (Find) Statuses¶

When pynetdicom is acting as an Inventory 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

Inventory 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 Inventory 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

Inventory 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 Inventory 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