pynetdicom.pdu_items.UserIdentitySubItemAC

class pynetdicom.pdu_items.UserIdentitySubItemAC

A User Identity (AC) Sub-item.

A User Identity (AC) Sub-item is used to response with the server identity to the association requestor.

item_length

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

Type

int

item_type

The Item Type field value (0x59).

Type

int

server_response_length

The Server Response Length field value.

Type

int

server_response

The Server Response field value.

Type

bytes

Notes

A User Identity (RQ) Sub-item requires the following parameters:

• Item type (1, fixed, 0x59)

• Item length (1)

• Server response length (1)

• Server response (1)

Encoding

When encoded, a User Identity (AC) Sub-item has the following structure, taken from Tables D.3-15 of the DICOM Standard (offsets shown with Python indexing). Items are always encoded using Big Endian.

Offset	Length	Description
0	1	Item type
1	1	Reserved
2	2	Item length
4	2	Server response length
6	Variable	Server response

References

• DICOM Standard, Part 7, Annex D.3.3.7

• DICOM Standard, Part 8, Section 9.3.1

__init__()

Initialise a new User Identity (AC) Item.

Methods

__init__()	Initialise a new User Identity (AC) Item.
decode(bytestream)	Decode bytestream and use the result to set the field values of the PDU item.
encode()	Return the encoded PDU as bytes.
from_primitive(primitive)	Set the item’s values using an User Identity primitive.
to_primitive()	Return an User Identity primitive from the current Item.

Attributes

item_length	Return the item’s Item Length field value as int.
item_type	Return the item’s Item Type field value as int.
response	Return the item’s Server Response field value.
server_response_length	Return the item’s Server Response Length field value.

from_primitive(primitive)

Set the item’s values using an User Identity primitive.

Parameters

primitive (pdu_primitives.UserIdentityNegotiation) – The primitive to use to set the Item’s field values.

property item_length

Return the item’s Item Length field value as int.

property response

Return the item’s Server Response field value.

property server_response_length

Return the item’s Server Response Length field value.

to_primitive()

Return an User Identity primitive from the current Item.

Returns

The primitive representation of the current Item.

Return type

pdu_primitives.UserIdentityNegotiation