pynetdicom._handlers.doc_handle_n_get

pynetdicom._handlers.doc_handle_n_get(event)[source][source]

Documentation for handlers bound to evt.EVT_N_GET.

User implementation of this event handler is required if one or more services that use N-GET are to be supported. If a handler is not implemented and bound to evt.EVT_N_GET then the N_GET request will be responded to using a Status value of 0x0110 - Processing Failure.

Event

evt.EVT_N_GET

Supported Service Classes

  • Display System Management Service Class

  • Modality Performed Procedure Step Management

Status

Success
0x0000 - Success
Failure
0x0107 - Attribute list error
0x0110 - Processing failure
0x0112 - No such SOP Instance
0x0117 - Invalid object Instance
0x0118 - No such SOP Class
0x0119 - Class-Instance conflict
0x0124 - Not authorised
0x0210 - Duplicate invocation
0x0211 - Unrecognised operation
0x0212 - Mistyped argument
0x0213 - Resource limitation
0xC112 - Applicable Machine Verification Instance not found
0xC307 - Specified SOP Instance UID doesn’t exist or is not a UPS Instance managed by this SCP
Warning
0x0001 - Requested optional Attributes are not supported
0x0107 Attribute list error
Parameters

event (events.Event) –

The event representing a service class receiving an N-GET request message. Event attributes are:

  • assoc : the association that is running the service that received the N-GET request.

  • context : the presentation context the request was sent under as a presentation.PresentationContextTuple.

  • description : a description of the event that occurred as str.

  • name : the name of the event that occurred as str.

  • request : the received N-GET request

  • timestamp : the date and time that the N-GET request was processed by the service.

Returns

  • status (pydicom.dataset.Dataset or int) – The status returned to the peer AE in the N-GET response. Must be a valid N-GET status value for the applicable Service Class as either an int or a Dataset object containing (at a minimum) a (0000,0900) Status element. If returning a Dataset object then it may also contain optional elements related to the Status (as in DICOM Standard Part 7, Annex C).

  • dataset (pydicom.dataset.Dataset or None) – If the status category is ‘Success’ or ‘Warning’ then a Dataset containing elements matching the request’s Attribute List conformant to the specifications in the corresponding Service Class.

    If the status category is not ‘Success’ or ‘Warning’ then None.

See also

send_n_get() N_GET DisplaySystemManagementServiceClass ModalityPerformedProcedureStepServiceClass

References