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