AE Title Configuration Service

Description

The AE (Application Entity) Configuration Service.  Used to list/add/remove AE configuration entities.  A programmatic alternative to the more convenient AE Management console of the web Administration Tools user interface. Used/Required by various DICOM services (Query/Retrieve SCP, Storage Commitment SCU/SCP, DICOM Hanging Protocol SCP) to 'guess' the port number of DICOM peer Application Entities, if no AE configuration entry is defined for given AE Title matches.

Dependencies

Attributes

#AEConfiguration

Configured application entities. Use the addAE and removeAE commands below to add and remove AE configurations.

#PortNumbers

Port numbers used for automatic configuration of AE titles. In C-Move and Storage commit messages, if the server does not know AE title of the move destination, the server automatically tries to connect to the unknown AE title on the ports defined in PortNumbers. The defaults are port 104 and port 11112.  The method getAE(title, hostname) uses this list to find a DICOM service hosted by hostname. If the AE title can be found, it is automatically added to the AE Management console in the web Administration Tools.

'NONE' disables automatic AE configuration.

Changes to this value are applied immediately. 

Default Value: 104,11112

#DontSaveIP

This flag is used by automatic AE configuration, if no hostname is available. Set this flag to false if you explicitly allow the saving of IP addresses. This should only be necessary if your network has static IP addresses and no domain name service (DNS) active. Otherwise, set the value to true if you are running a DNS.

(warning) Avoid this option if you use DHCP!

Default Value: true

#AutoUpdateIP

Controls if configured IP addresses of AE Titles shall be updated automatically on receive of C-MOVE requests with the requester's AE Title as Move Destination. Useful for retrieve to clients with dynamic IP.

Default Value: false

#MaxCacheSize

Maximal number of cached AE configurations.

Default Value: 20

#CacheSize

Current number of cached AE configurations.

#AuditLoggerName

Used internally. Do not modify.

Default Value: dcm4chee.archive:service=AuditLogger

#EchoServiceName

Used internally. Do not modify.

Default Value: dcm4chee.archive:service=ECHOService

#Name

The class name of the MBean

#State

The status of the MBean

#StateString

The status of the MBean in text form

Operations

#listAEs

Get list of AE Configurations

#getAE

Get AE Configuration

#getAE

Get AE Configuration

#getAE

Get AE Configuration

#updateAE

Update AE configuration

#addAE

Add AE configuration

#removeAE

Remove AE Configuration

#updateAETitle

Update AE Title of existing AE configuration

#clearCache

Clear AE Cache

#create

Standard MBean lifecycle method

#start

The start lifecycle operation

#stop

The stop lifecycle operation

#destroy

The destroy lifecycle operation

#jbossInternalLifecycle

The detyped lifecycle operation (for internal use only)

Notifications