Storage Commit Service

Description

DICOM Storage Commitment SCU/SCP. Provides a DICOM Storage Commitment Service in the Service Class Provider (SCP) and the Service Class User (SCU) Role. When acting as the SCP, the service handles storage commitment requests that it receives from modalities or evidence creators (workstations). When acting as the SCU, it may request storage commitment for objects for itself that were retrieved from the archive to a remote application. Typically this application is a further archive instance acting as a long-term or central archive.

Dependencies

Attributes

#CalledAETitles

Accepted called AE titles, separated by \ (backslash). Used when acting as a SCP.

Default Value: DCM4CHEE

#CallingAETitles

Accepted calling AE titles, separated by \ (backslash). Used when acting as a SCU.
ANY = accept any.

Default Value: ANY

#RequestStorageCommitFromAETitles

Move Destination AE titles, from which Storage Commitment for transmitted objects shall be requested.

Format: <storage scp aet> ':' <storage commitment scp aet>
The AE title of the Storage Commitment Service <storage commitment scp aet> can be omitted, if identical to the AE title of the Move Destination <storage scp aet>. Separate multiple values with a (backslash).

NONE = No Move Destination from which Storage Commitment will be requested.

Default Value: NONE

#TrustStorageCommitFromAETitles

AE titles of trusted Storage Commitment SCPs. Only Storage Commitment results received from these sources will cause to mark referenced instances as external retrievable. Separate multiple values with a (backslash).

NONE = Do not mark instances as external retrievable.
ANY = Trust Storage Commitment results from any Storage Commitment SCP.

Default Value: NONE

#ReceiveResultInSameAssociationTimeout

Time in milliseconds that the Storage Commit SCU waits to receive the Storage Commit Result in the same association as the storage commit was requested, before releasing the association. For IHE compliance, use a new association. But non-compliant modalities can use single association, so you may need to set the timeout to a value higher than 0. Do not enable this timeout by default.

Default Value: 0

#SCURetryIntervals

Number and interval of retries by the SCU to invoke Storage Commitment Requests.

Syntax:

intervals = retries 'x' interval { ','  retries 'x' interval }
retries = integer
interval = integer ('s' | 'm' | 'h' | 'd')  (* in seconds, minutes, hours or days *)

Example: 5x1m,10x10m
=> retry a total of 5 times, one minute apart for each retry; then retry a total of 10 times, 10 minutes apart for each retry.

Default Value: 5x1m,12x5m

#SCPRetryIntervals

Number and interval of retries by the SCP to send Storage Commitment Results to the SCU.

Syntax:

intervals = retries 'x' interval { ','  retries 'x' interval }
retries = integer
interval = integer ('s' | 'm' | 'h' | 'd')  (* in seconds, minutes, hours or days *)

Example: 5x1m,10x10m
=> retry a total of 5 times, one minute apart for each retry; then retry a total of 10 times, 10 minutes apart for each retry.

Default Value: 5x1m,12x5m

#AcceptedTransferSyntax

List of accepted Transfer Syntaxes. Order defines selection preference.
Use either the Transfer Syntaxes UID value or following defined symbolic names:

  • ImplicitVRLittleEndian
  • ExplicitVRLittleEndian
  • DeflatedExplicitVRLittleEndian
  • ExplicitVRBigEndian

Default Value:

ExplicitVRLittleEndian
ImplicitVRLittleEndian

#CoerceConfigDirectory

Directory where configuration files for Storage Commitment Result attribute coercion are located: if XSL stylesheet stgcmt-neventreportrq.xsl exists in this directory or a sub-directory equal to the AE Title of a Storage Commitment SCP, Storage Commitment Result attributes from this SCP will be coerced according this stylesheet. A relative path name is resolved relative to DCM4CHEE_HOME/server/default/.

Default Value: conf/dcm4chee-ae

#Concurrency

Maximum number of concurrent invoked or processed Storage Commit Requests. This setting determines how many listeners are processing orders on the queue. Only one queue exists for storage commits; SCP and SCU are not separated.

Default Value: 1

#MaximumPDULength

Maximum protocol data unit (PDU) package length for receiving PDUs.

(warning) This property should be set to equal values for all DICOM SCP services with same called AE Title(s). Otherwise it is non-deterministic, which configured value is effective.

Default Value: 16352

#MaximumOperationsInvoked

The maximum number of outstanding operations and/or sub-operations it allows the Association-requester to invoke asynchronously. A value of zero indicates an unlimited number of outstanding operations.

(warning) This property should be set to equal values for all DICOM SCP services with same called AE Title(s). Otherwise it is non-deterministic, which configured value is effective.

Default Value: 1

#MaximumOperationsPerformed

The maximum number of outstanding operations and/or sub-operations it allows the Association-requester to perform asynchronously. A value of zero indicates an unlimited number of outstanding operations.

(warning) This property should be set to equal values for all DICOM SCP services with same called AE Title(s). Otherwise it is non-deterministic, which configured value is effective.

Default Value: 1

#AcceptTimeout

A-Associate accept timeout in milliseconds. 0 = no timeout.

Default Value: 10000

#DIMSETimeout

DIMSE message timeout in milliseconds. 0 = no timeout.

Default Value: 60000

#SocketCloseDelay

Socket close delay in milliseconds after an A-Release response.

Default Value: 50

#TcpNoDelay

Send packets as quickly as possible (Disable Nagle's algorithmn).

Default Value: true

#SendBufferSize

Buffer size used for socket output. 0 = use platform default.

Default Value: 0

#ReceiveBufferSize

Buffer size used for socket input. 0 = use platform default.

Default Value: 0

#EJBProviderURL

Identifies JNDI (e.g: jnp://hostname:1099) with EJBs.
LOCAL, if EJBs are deployed in same JBoss instance.

Default Value: LOCAL

#QueueName

Used internally. Do NOT modify.

Default Value: StgCmtScuScp

#JMSServiceName

Used internally. Do NOT modify.

Default Value: dcm4chee.archive:service=JMS

#FileSystemMgtName

Used internally. Do NOT modify.

Default Value: dcm4chee.archive:service=FileSystemMgt

#DcmServerName

Used internally. Do NOT modify.

Default Value: dcm4chee.archive:service=DcmServer

#TLSConfigName

Used internally. Do NOT modify.

Default Value: dcm4chee.archive:service=TLSConfig

#AEServiceName

Used internally. Do NOT modify.

Default Value: dcm4chee.archive:service=AE

#TemplatesServiceName

Used internally. Do NOT modify.

Default Value: dcm4chee.archive:service=Templates

#Name

The class name of the MBean

#State

The status of the MBean

#StateString

The status of the MBean in text form

Operations

#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)

#queueStgCmtOrder

Used internally.

Notifications