pynetdicom.service_class.VerificationServiceClass¶

class pynetdicom.service_class.VerificationServiceClass(assoc)[source]¶

Implementation of the Verification Service Class.

__init__(assoc)[source]¶: Create a new ServiceClass.

Methods

`SCP`(req, context)	The SCP implementation for the Verification Service Class.
`__init__`(assoc)	Create a new ServiceClass.
`is_cancelled`(msg_id)	Return True if a C-CANCEL message with msg_id has been received.
`is_valid_status`(status)	Return True if status is valid for the service class.
`validate_status`(status, rsp)	Validate status and set rsp.Status accordingly.

Attributes

`ae`	Return the AE.
`dimse`	Return the DIMSE service provider.
`statuses`

SCP(req, context)[source]¶

The SCP implementation for the Verification Service Class.

Will always return 0x0000 (Success) unless the user returns a different (valid) status value from the handler bound to evt.EVT_C_ECHO.

Parameters

req (dimse_primitives.C_ECHO) – The C-ECHO request primitive sent by the peer.
context (presentation.PresentationContext) – The presentation context that the SCP is operating under.

See also

association.Association.send_c_echo()

Notes

C-ECHO Request

Parameters

(M) Message ID

(M) Affected SOP Class UID

C-ECHO Response

Parameters

(U) Message ID
(M) Message ID Being Responded To
(U) Affected SOP Class UID
(M) Status

Status

The DICOM Standard, Part 7 (Table 9.3-13) indicates that the Status value of a C-ECHO response “shall have a value of Success”. However Section 9.1.5.1.4 indicates it may have any of the following values:

Success: 0x0000 Success
Failure: 0x0122 Refused: SOP Class Not Supported

0x0210 Refused: Duplicate Invocation

0x0211 Refused: Unrecognised Operation

0x0212 Refused: Mistyped Argument

References

DICOM Standard, Part 4, Annex A
DICOM Standard, Part 7, Sections 9.1.5, 9.3.5 and Annex C

property ae¶: Return the AE.

property dimse¶: Return the DIMSE service provider.

is_cancelled(msg_id)[source]¶

Return True if a C-CANCEL message with msg_id has been received.

Parameters: msg_id (int) – The (0000,0120) Message ID Being Responded To value to use to match against.
Returns: True if a C-CANCEL message has been received with a Message ID Being Responded To corresponding to msg_id, False otherwise.
Return type: bool

is_valid_status(status)[source]¶

Return True if status is valid for the service class.

Parameters: status (int) – The Status value to check for validity.
Returns: True if the status is valid, False otherwise.
Return type: bool

validate_status(status, rsp)[source]¶

Validate status and set rsp.Status accordingly.

Parameters

status (pydicom.dataset.Dataset or int) – A Dataset containing a Status element or an int.
rsp (dimse_primitive) – The response primitive to be sent to the peer.

Returns

rsp – The response primitie to be sent to the peer (containing a valid Status parameter).

Return type

dimse_primitive