pynetdicom.pdu.A_ASSOCIATE_AC

class pynetdicom.pdu.A_ASSOCIATE_AC[source]

An A-ASSOCIATE-AC PDU.

An A-ASSOCIATE-AC PDU is sent by an association acceptor to indicate that association negotiation has been successful.

application_context_name

The Application Context Item’s Application Context Name field value (if available).

Type

pydicom.uid.UID

called_ae_title

The requestor’s Called AE Title field value, which is the destination DICOM application name as a 16-byte value. The value is not guaranteed to be the actual title and shall not be tested.

Type

bytes

calling_ae_title

The requestor’s Calling AE Title field value, which is the source DICOM application name as a 16-byte value. The value is not guaranteed to be the actual title and shall not be tested.

Type

bytes

pdu_length

The number of bytes from the first byte following the PDU Length field to the last byte of the PDU.

Type

int

pdu_type

The PDU Type field value (0x02).

Type

int

presentation_context

The Presentation Context Item(s).

Type

list of pdu_items.PresentationContextItemAC

protocol_version

The Protocol Version field value (default 0x01).

Type

int

user_information

The User Information Item (if available).

Type

pdu_items.UserInformationItem

variable_items

A list containing the A-ASSOCIATE-AC’s ‘Variable Items’. Contains one Application Context item, one or more Presentation Context items and one User Information item. The order of the items is not guaranteed.

Type

list

Notes

An A-ASSOCIATE-AC PDU requires the following parameters:

  • PDU type (1, fixed value, 0x02)

  • PDU length (1)

  • Protocol version (1, default value, 0x01)

  • Variable items (1)

    • Application Context Item (1)

      • Item type (1, fixed value, 0x10)

      • Item length (1)

      • Application Context Name (1, fixed in an application)

    • Presentation Context Item(s) (1 or more)

      • Item type (1, fixed value, 0x21)

      • Item length (1)

      • Context ID (1)

      • Result/reason (1)

      • Transfer Syntax Sub-items (1)

        • Item type (1, fixed, 0x40)

        • Item length (1)

        • Transfer syntax name(s) (1)

    • User Information Item (1)

      • Item type (1, fixed, 0x50)

      • Item length (1)

      • User data Sub-items (2 or more)

        • Maximum Length Received Sub-item (1)

        • Implementation Class UID Sub-item (1)

        • Optional User Data Sub-items (0 or more)

Encoding

When encoded, an A-ASSOCIATE-AC PDU has the following structure, taken from Table 9-17 (offsets shown with Python indexing). PDUs are always encoded using Big Endian.

Offset

Length

Description

0

1

PDU type

1

1

Reserved

2

4

PDU length

6

2

Protocol version

8

2

Reserved

10

16

Reserved^

26

16

Reserved^

42

32

Reserved

74

Variable

Variable items

^ The reserved fields shall be sent with a value identical to the value received in the A-ASSOCIATE-RQ but their values shall not be tested.

References

__init__()[source]

Initialise a new A-ASSOCIATE-AC PDU.

Methods

__init__()

Initialise a new A-ASSOCIATE-AC PDU.

decode(bytestream)

Decode bytestream and use the result to set the field values of the PDU.

encode()

Return the encoded PDU as bytes.

from_primitive(primitive)

Setup the current PDU using an A-ASSOCIATE (accept) primitive.

to_primitive()

Return an A-ASSOCIATE (accept) primitive from the current PDU.

Attributes

application_context_name

Return the Application Context Name, if available.

called_ae_title

Return the value sent in the Called AE Title reserved space.

calling_ae_title

Return the value sent in the Calling AE Title reserved space.

pdu_length

Return the PDU Length field value as an int.

pdu_type

Return the PDU Type field value as int.

presentation_context

Return a list of the Presentation Context Items.

user_information

Return the User Information Item, if available.
property application_context_name

Return the Application Context Name, if available.

Returns

The acceptor’s Application Context Name or None if not available.

Return type

pydicom.uid.UID or None

property called_ae_title

Return the value sent in the Called AE Title reserved space.

While the standard says this value should match the A-ASSOCIATE-RQ value there is no guarantee and this should not be used as a check value.

Returns

The value the A-ASSOCIATE-AC sent in the Called AE Title reserved space.

Return type

bytes

property calling_ae_title

Return the value sent in the Calling AE Title reserved space.

While the standard says this value should match the A-ASSOCIATE-RQ value there is no guarantee and this should not be used as a check value.

Returns

The value the A-ASSOCIATE-AC sent in the Calling AE Title reserved space.

Return type

bytes

from_primitive(primitive)[source]

Setup the current PDU using an A-ASSOCIATE (accept) primitive.

Parameters

primitive (pdu_primitives.A_ASSOCIATE) – The primitive to use to set the current PDU field values.

property pdu_length

Return the PDU Length field value as an int.

property presentation_context

Return a list of the Presentation Context Items.

Returns

The Presentation Context Items.

Return type

list of pdu_items.PresentationContextItemAC

to_primitive()[source]

Return an A-ASSOCIATE (accept) primitive from the current PDU.

Returns

The primitive representation of the current PDU.

Return type

pdu_primitives.A_ASSOCIATE

property user_information

Return the User Information Item, if available.

Returns

The acceptor’s User Information object or None, if not available.

Return type

pdu_items.UserInformationItem or None