pynetdicom._handlers.doc_handle_async

pynetdicom._handlers.doc_handle_async(event: Event, *args: Sequence[Any]) → Tuple[int, int][source]

Documentation for handlers bound to evt.EVT_ASYNC_OPS.

User implementation of this event handler is optional. If a handler is not implemented and bound to evt.EVT_ASYNC_OPS then no response to the Asynchronous Operations Window Negotiation item will be sent in reply to the association requestor.

Because pynetdicom doesn’t support asynchronous operations if the handler is implemented then the response to the asynchronous operations window negotiation request will always return the default number of operations invoked/performed, (1, 1), regardless of what values are returned by the handler.

Event

evt.EVT_ASYNC_OPS

Parameters:

  • event (events.Event) –

    The event representing an association request being received which contains an Asynchronous Operations Window Negotiation item. Event attributes are:

    • assoc: the Association that received the Asynchronous Operations Window Negotiation request.

    • event: the event that occurred as InterventionEvent.

    • invoked: the Maximum Number Operations Invoked parameter value of the Asynchronous Operations Window Negotiation item as an int. If the value is 0 then an unlimited number of invocations are requested.

    • performed: the Maximum Number Operations Performed parameter value of the Asynchronous Operations Window Negotiation item as an int. If the value is 0 then an unlimited number of performances are requested.

    • timestamp: the date and time that the negotiation request was processed as datetime.datetime.

  • args – If the handler was bound to the event using bind(event, handler, args) or by passing evt_handlers=[(event, handler, args), ...], where args is a list then there will be one or more optional extra parameters matching the contents of args.

Returns:

The (maximum number operations invoked, maximum number operations performed). A value of 0 indicates that an unlimited number of operations is supported. As asynchronous operations are not supported the returned values will be ignored and (1, 1) sent in response.

Return type:

int, int

References