...
DICOM Query/Retrieve SCP. Provides the DICOM Query/Retrieve SCP.
...
The value of the Compression Service#MaxConcurrentCodec also
...
affects the on-the-fly compression and decompression during the retrieve of images by the QueryRetrieveScp service
Patient Level Attributes
Study Level Attributes
Series Level Attributes
Instance Level Attributes
Dependencies
Attributes
...
#Name
| Anchor | ||||
|---|---|---|---|---|
|
The class name of the MBean
#State
| Anchor | ||||
|---|---|---|---|---|
|
The status of the MBean
#StateString
| Anchor | ||||
|---|---|---|---|---|
|
The status of the MBean in text form
#CalledAETitles
| Anchor | ||||
|---|---|---|---|---|
|
Accepted called AE titles, separated by (backslash).
...
Default Value: DCM4CHEE
#CallingAETitles
| Anchor |
|---|
...
|
...
|
Accepted List of accepted calling AE titles, separated by (backslash).
ANY = accept any.
...
CONFIGURED_AETS = accept any configured AE Title.
Default Value: ANY
#LocalStorageAETitle
| Anchor |
|---|
...
|
...
Move Destination AE titles to which images are sent ALWAYS decompressed. Separate multiple values by (backslash).
NONE = no AE titles match this criteria.
...
Move Destination AE titles to which images are sent without pixel data. Separate multiple values by (backslash).
NONE = no AE titles match this criteria.
...
Move Destination AE titles to which failures, caused by unsupported SOP Classes, in transmitting objects shall NOT return a warning status "Sub-Operation fails" in the final Move Response to the Move SCU.
NONE = no AE titles match this criteria.
...
Failed transfer of instances of listed SOP Classes to move destinations caused by rejection of the SOP Class by the destination STORE SCP will NOT result in a warning status "Sub-Operation fails" in the final Move Response to the Move SCU. Use either the SOP Class UID value or the name specified in DICOM Part 6, Annex A Registry of DICOM unique identifiers, concatenating individual words without spaces.
...
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.
...
Do not match entities with zero-length value for specified matching keys (= non DICOM conform matching behavior).
...
List of accepted Query/Retrieve SOP Classes. Use either the SOP Class UID value, or following defined symbolic names:
- PatientRootQueryRetrieveInformationModelFIND,
- PatientRootQueryRetrieveInformationModelMOVE,
- StudyRootQueryRetrieveInformationModelFIND,
- StudyRootQueryRetrieveInformationModelMOVE,
- PatientStudyOnlyQueryRetrieveInformationModelFIND,
- PatientStudyOnlyQueryRetrieveInformationModelMOVE,
...
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
...
List of accepted Query/Retrieve SOP Classes. Use either the SOP Class UID value, or following defined symbolic names:
- TianiStudyRootQueryRetrieveInformationModelFIND,
- TianiBlockedStudyRootQueryRetrieveInformationModelFIND,
- TianiVirtualMultiFrameStudyRootQueryRetrieveInformationModelFIND,
...
|
AE title of local Storage SCP. Used as Move Destination in forwarded C-Move RQs to external Retrieve AEs, for which no direct forwarding to the Move Destination in the received C-MOVE RQ is configured in #DirectForwardingList.
Default Value: DCM4CHEE
#SupplementIssuerOfPatientID
| Anchor | ||||
|---|---|---|---|---|
|
Supplement received C-FIND RQ identifier with no Issuer Of Patient ID with an Issuer Of Patient ID, if such is associated with the C-FIND SCU AE by its AE Configuration entry.
Default Value: false
#SupplementIssuerOfAccessionNumber
| Anchor | ||||
|---|---|---|---|---|
|
Supplement received C-FIND RQ identifier with no Issuer of Accession Number Sequence, with such Sequence containing one item with Local Namespace Enitity ID, Universial Enitity ID and Universial Enitity ID Type, if such is associated with the C-FIND SCU AE by its AE Configuration entry.
Default Value: false
#SupplementByHostName
| Anchor | ||||
|---|---|---|---|---|
|
If there is no Issuer of Patient ID or Issuer of Accession Number Sequence item associated to the C-FIND SCU AE by an AE configuration entry with matching AE Title, AE configuration entries which host name is equals to the host name of the C-FIND SCU AE will be considered to determine the associated Issuer of Patient ID or Issuer of Accession Number Sequence item. If there are several AE configuration entries with matching host name with different non-zero values for Issuer of Patient ID or Issuer of Accession Number Sequence item, no Issuer of Patient ID or Issuer of Accession Number Sequence item will be supplemented.
Default Value: false
#SupplementByHostAddress
| Anchor | ||||
|---|---|---|---|---|
|
If there is no Issuer of Patient ID or Issuer of Accession Number Sequence item associated to the C-FIND SCU AE by an AE configuration entry with matching AE Title, AE configuration entries which host name is equals to the host name of the C-FIND SCU AE will be considered to determine the associated Issuer of Patient ID or Issuer of Accession Number Sequence item. If there are several AE configuration entries with matching host name with different non-zero values for Issuer of Patient ID or Issuer of Accession Number Sequence item, no Issuer of Patient ID or Issuer of Accession Number Sequence item will be supplemented.
Default Value: false
#AdjustPatientIDOnRetrieval
| Anchor | ||||
|---|---|---|---|---|
|
Perform PIX Query also on retrieval to determine the Patient ID which Issuer of Patient ID match the Issuer of Patient ID associated to the retrieve destination by a corresponding AE configuration entry, and replace the original Patient ID and Issuer of Patient ID in retrieved objects by this value. If there is no such Patient ID, nullify the Patient ID and remove the Issuer of Patient ID in retrieved objects. Return Patient IDs which Issuer of Patient ID does not match the Issuer of Patient ID associated to the retrieve destination in items of the Other Patient ID Sequence.
Default Value: false
#AdjustAccessionNumberOnRetrieval
| Anchor | ||||
|---|---|---|---|---|
|
Nullify Accession Number in retrieved objects, if its Issuer of Accession Number does not match the Issuer of Accession Number associated to the retrieve destination by a corresponding AE configuration entry.
Default Value: false
#DoNotDecompressTransferSyntaxes
| Anchor | ||||
|---|---|---|---|---|
|
List of Transfer Syntaxes for (lossy) Image Compression of stored Image or Video DICOM Composite objects, which shall not be decompressed for retrieval: If no Presentation Context for the transfer of such objects with compressed Transfer Syntax is accepted (C-MOVE) or offered (C-GET) by the retrieve destination, the retrieval of such objects will fail.
Use either the Transfer Syntaxes UID value or following defined symbolic names:
...
- JPEGBaseline
...
- JPEGExtended
...
- JPEGLSLossy
...
- JPEG2000Lossy
...
- MPEG2
...
- MPEG2HL
...
- MPEG4
...
Maximum number of result records blocked in one Find Response by Private Blocked FIND services.
...
Configuration file which defines included attributes in Enhanced CT Instance enities return by Private Virtual Multiframe FIND Service. A relative path name is resolved relative to dcm4chee_home/server/default/.
...
Configuration file which defines included attributes in Enhanced MR Instance entities return by Private Virtual Multiframe FIND Service. A relative path name is resolved relative to dcm4chee_home/server/default/.
...
List of the AE titles for the Q/R SCUs for which XMLized query and result attributes are logged into files <AET>/<timestamp>-cfindrq.xml and <AET>/<timestamp>-cfindrsp.xml in the log directory. Useful for creation of XSL stylesheets for query/result attribute coercion. Separate multiple values by (backslash). NONE = no calling AE titles.
...
Directory where configuration files for query/result attribute coercion are located: if XSL stylesheet "cfindrq.xsl" or "cfindrsp.xsl" exists in this directory or a sub-directory equal to the AE Title of a QR SCU, query/result attributes from/to this SCU will be coerced according these stylesheets. A relative path name is resolved relative to dcm4chee_home/server/default/.
...
Return optional C-Move Response DICOM message with pending status.
...
Use the calling AE title of the requesting Move SCU instead of the called AE title when opening an association to another Move SCP to forward a Move Request.
...
Record last retrieve time of instances of a study. Should be enabled, if delete functions of the File System Management Service are activated, to delete the most infrequently accessed studies.
...
Enable check if unsupported matching key(s) are used in C-FIND. In this case the C-FIND PENDING status is changed from 0xff00 to 0xff01.
...
Maximum number of SOP Instance UIDs in forwarded Move Requests. Larger Move Requests are split into smaller ones according to this constraint.
...
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. |
...
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. |
...
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. |
...
The maximum number of asynchronously invoked storage operations. A value of zero indicates an unlimited number.
...
A-Associate accept timeout in milliseconds. 0 = no timeout.
...
DIMSE message timeout in milliseconds. 0 = no timeout.
...
Socket close delay in milliseconds after an A-Release response.
...
Send packets as quickly as possible (Disable Nagle's algorithmn).
...
Buffer size used for socket output. 0 = use platform default.
...
Buffer size used for socket input. 0 = use platform default.
...
Size of byte buffer used for copying data from TCP channel to file.
...
Transaction isolation level for queries. Values can be one of:
DEFAULT | READ_UNCOMMITTED | READ_COMMITTED | REPEATABLE_READ | SERIALIZABLE
...
Transaction isolation level for retrieves. Values can be one of:
DEFAULT | READ_UNCOMMITTED | READ_COMMITTED | REPEATABLE_READ | SERIALIZABLE
...
Identifies JNDI (e.g: jnp://hostname:1099) with EJBs.
"LOCAL", if EJBs are deployed in same JBoss instance.
...
Used internally. Do NOT modify.
...
Used internally. Do NOT modify.
...
Used internally. Do NOT modify.
...
Used internally. Do NOT modify.
...
Used internally. Do NOT modify.
...
Used internally. Do NOT modify.
...
Used internally. Do NOT modify.
...
The class name of the MBean
...
The status of the MBean
...
The status of the MBean in text form
Operations
...
Standard MBean lifecycle method
...
The start lifecycle operation
...
The stop lifecycle operation
...
The destroy lifecycle operation
...
The detyped lifecycle operation (for internal use only)
...
Reload Stylesheets
- MPEG4BD
Not effective for Move Destinations listed in #SendWithDefaultTransferSyntaxToAETitles.
Default Value:
| No Format |
|---|
MPEG2
MPEG2HL
MPEG4
MPEG4BD
|
#SendWithDefaultTransferSyntaxToAETitles
| Anchor | ||||
|---|---|---|---|---|
|
Move Destination AE titles to which objects are sent always with Default (=Implicit VR Little Endian) Transfer Syntax, which implies, that compressed stored images are always decompressed by this service for retrieval. Separate multiple values by (backslash).
NONE = no AE titles match this criteria.
ANY = all AE titles match this criteria.
Default Value: NONE
#OfferNoPixelDataTransferSyntaxToAETitles
| Anchor | ||||
|---|---|---|---|---|
|
Move Destination AE titles to which images are sent without pixel data, if offered Transfer Syntax No Pixel Data was accepted by the Move Destination AE. Separate multiple values by (backslash).
NONE = do not offer No Pixel Data Transfer Syntax to any Move Destination AE.
ANY = offer No Pixel Data Transfer Syntax to all Move Destination AEs.
Default Value: NONE
#OfferNoPixelDataDeflateTransferSyntaxToAETitles
| Anchor | ||||
|---|---|---|---|---|
|
Move Destination AE titles to which images are sent without pixel data, if offered Transfer Syntax No Pixel Data Deflate or No Pixel Data was accepted by the Move Destination AE. Separate multiple values by (backslash).
NONE = do not offer No Pixel Data Deflate and No Pixel Data Transfer Syntax to any Move Destination AE.
ANY = offer No Pixel Data Deflate and No Pixel Data Transfer Syntax to all Move Destination AE.
Default Value: NONE
#SendNoPixelDataToAETitles
| Anchor | ||||
|---|---|---|---|---|
|
Move Destination AE titles to which images are sent without pixel data. Separate multiple values by (backslash).
NONE = no AE titles match this criteria.
Default Value: NONE
#IgnoreUnsupportedSOPClassFailures
| Anchor | ||||
|---|---|---|---|---|
|
Move Destination AE titles to which failures, caused by unsupported SOP Classes, in transmitting objects shall NOT return a warning status "Sub-Operation fails" in the final Move Response to the Move SCU.
NONE = no AE titles match this criteria.
Default Value: NONE
#PatchJpegLSwithImplementationClassUID
| Anchor | ||||
|---|---|---|---|---|
|
Patch faulty DICOM JPEG-LS images compressed by JAI-IMAGEIO JPEG-LS encoder with matching Implementation SOP Class UID on retrieval by inserting a LSE marker segment with encoder parameter values T1, T2 and T3 actually used by JAI-IMAGEIO JPEG-LS encoder. Also effective for WADO retrieval.
NONE = Disable patching of DICOM JPEG-LS images
ANY = Patch DICOM JPEG-LS images with any Implementation SOP Class UID
Default Value: 1.2.40.0.13.1.1
#PatchJpegLSnewImplementationClassUID
| Anchor | ||||
|---|---|---|---|---|
|
Replace Implementation SOP Class UID in patched DICOM JPEG-LS images by specified value. Only effective for WADO retrieval.
NONE = Keep original Implementation SOP Class UID
Default Value: 1.2.40.0.13.1.1.1
#PIXQueryCallingAETitles
| Anchor | ||||
|---|---|---|---|---|
|
AE Titles of C-FIND SCUs, for which a PIX Query of the data base or an external Patient Cross-reference (PIX) Manager shall be executed, if the query request contains a matching key for the Patient ID, to return also entities of linked patients. Separate multiple values by (backslash).
ANY = Enable PIX Queries for all C-FIND SCUs.
NONE = Disable PIX Queries for all C-FIND SCUs.
Default Value: ANY
#PIXQueryIssuersOfPatientID
| Anchor | ||||
|---|---|---|---|---|
|
Comma separated list of values for Issuers of Patient IDs in C-FIND RQs, for which a PIX Query of the data base or an external Patient Cross-reference (PIX) Manager shall be executed, to return also entities of linked patients.
ANY = Execute PIX Queries for any Issuer of Patient ID.
Default Value: SSN
#PIXQueryDefaultIssuerOfPatientID
| Anchor | ||||
|---|---|---|---|---|
|
Value for Issuer of Patient ID used for PIX Queries, if the query request does not contains a value for the Issuer of Patient ID. Only effective, if PIXQueryIssuersOfPatientID = ANY.
Default Value: DCM4CHEE
#CoerceRequestPatientIds
| Anchor | ||||
|---|---|---|---|---|
|
Override PatientId and IssuerOfPatientID, and those values contained in the OtherPatientIDSequence with the values from the request (including PIX Query results).
Default Value: false
#CoerceRequestPatientIdsAETitles
| Anchor | ||||
|---|---|---|---|---|
|
AE Titles of C-FIND SCUs, for which to Override PatientId and IssuerOfPatientID, and those values contained in the OtherPatientIDSequence with the values from the request (including PIX Query results). Separate multiple values by (backslash).
ANY = Override Ids for all C-FIND SCUs.
Only effective, if #CoerceRequestPatientIds = true.
Default Value: NONE
#UnrestrictedQueryPermissionsToAETitles
| Anchor | ||||
|---|---|---|---|---|
|
AE Titles of C-FIND SCUs with Query Permissions on all archived Studies, independent of Study Permissions to roles of the user associated to the active association. Separate multiple values by (backslash).
ANY = Disable restriction of queries according granted Study Permissions.
Default Value: ANY
#UnrestrictedReadPermissionsToAETitles
| Anchor | ||||
|---|---|---|---|---|
|
AE Titles of Move Destinations with Read Permissions on all archived Studies, independent of Study Permissions to roles of the user associated with the AE. Separate multiple values by (backslash).
ANY = Disable restriction of retrieve to Move Destinations according granted Study Read Permissions.
For successful Media Creation by the archive, the AE Title of the Media Creation Service (default: CDRECORD) have to be included in the configured list.
If the Move Destination differs from the AE requesting the retrieve (= C-MOVE SCU), the associated user is defined by the AE configuration entry. If the C-MOVE SCU also acts as Move Destination, the user identification may be also provided by C-MOVE SCU by User Identity Negotiation.
Default Value: ANY
#UnrestrictedExportPermissionsToAETitles
| Anchor | ||||
|---|---|---|---|---|
|
AE Titles of C-MOVE SCUs with Export Permissions on all archived Studies, independent of Study Permissions to roles of the user associated to the request association. Separate multiple values by (backslash).
ANY = Disable restriction of queries according granted Study Permissions.
For successful auto-forwarding of received objects as for manual DICOM export using the Web Interface, the Calling AE Title of the internal Move SCU Service (default: DCM4CHEE) have to be included in the configured list.
If the C-MOVE SCU also acts as Move Destination, no Export Permission - but still Read Permission - is needed to retrieve a Study.
Default Value: ANY
#HideWithoutIssuerOfPatientIDFromAETitles
| Anchor | ||||
|---|---|---|---|---|
|
AE Titles of C-FIND SCUs to which only responses for matching entities of Patients which Patient ID is qualified by an Issuer Of Patient ID are returned. Separate multiple values by '\'(backslash).
If the list is prefixed by '!', entities of Patients which Patient ID is not qualified by an Issuer Of Patient ID will be hidden from #any C-FIND SCU, #except which AE title is specified in the list.
NONE = do not hide entities of Patients without Issuer of Patient ID_ from any C-FIND SCU.
Default Value: NONE
#IgnorableSOPClasses
| Anchor | ||||
|---|---|---|---|---|
|
Failed transfer of instances of listed SOP Classes to move destinations caused by rejection of the SOP Class by the destination STORE SCP will NOT result in a warning status "Sub-Operation fails" in the final Move Response to the Move SCU. Use either the SOP Class UID value or the name specified in DICOM Part 6, Annex A Registry of DICOM unique identifiers, concatenating individual words without spaces.
Default Value:
| No Format |
|---|
BasicTextSR
EnhancedSR
ComprehensiveSR
ProcedureLogStorage
MammographyCADSR
KeyObjectSelectionDocument
ChestCADSR
XRayRadiationDoseSR
TwelveLeadECGWaveformStorage
GeneralECGWaveformStorage
AmbulatoryECGWaveformStorage
HemodynamicWaveformStorage
CardiacElectrophysiologyWaveformStorage
BasicVoiceAudioWaveformStorage
MRSpectroscopyStorage
GrayscaleSoftcopyPresentationStateStorage
ColorSoftcopyPresentationStateStorage
PseudoColorSoftcopyPresentationStateStorage
BlendingSoftcopyPresentationStateStorage
RawDataStorage
SpatialRegistrationStorage
SpatialFiducialsStorage
RealWorldValueMappingStorage
StereometricRelationshipStorage
EncapsulatedPDFStorage
RTDoseStorage
RTStructureSetStorage
RTBeamsTreatmentRecordStorage
RTPlanStorage
RTBrachyTreatmentRecordStorage
RTTreatmentSummaryRecordStorage
RTIonPlanStorage
RTIonBeamsTreatmentRecordStorage
StandaloneOverlayStorage
StandaloneCurveStorage
StandaloneModalityLUTStorage
StandaloneVOILUTStorage
StandalonePETCurveStorage
AgfaAttributePresentationState
SiemensCSANonImageStorage
StructuredReportTextStorageRetired
StructuredReportAudioStorageRetired
StructuredReportDetailStorageRetired
StructuredComprehensiveStorageRetired
|
#NoMatchForNoValue
| Anchor | ||||
|---|---|---|---|---|
|
Do not match entities with zero-length value for specified matching keys (= non DICOM conform matching behavior).
Default Value: true
#AcceptedStandardSOPClasses
| Anchor | ||||
|---|---|---|---|---|
|
List of accepted Query/Retrieve SOP Classes. Use either the SOP Class UID value, or following defined symbolic names:
- PatientRootQueryRetrieveInformationModelFIND,
- PatientRootQueryRetrieveInformationModelGET
- PatientRootQueryRetrieveInformationModelMOVE,
- StudyRootQueryRetrieveInformationModelFIND,
- StudyRootQueryRetrieveInformationModelGET
- StudyRootQueryRetrieveInformationModelMOVE,
- PatientStudyOnlyQueryRetrieveInformationModelFIND,
- PatientStudyOnlyQueryRetrieveInformationModelGET
- PatientStudyOnlyQueryRetrieveInformationModelMOVE,
Default Value:
| No Format |
|---|
PatientRootQueryRetrieveInformationModelFIND
PatientRootQueryRetrieveInformationModelGET
PatientRootQueryRetrieveInformationModelMOVE
StudyRootQueryRetrieveInformationModelFIND
StudyRootQueryRetrieveInformationModelGET
StudyRootQueryRetrieveInformationModelMOVE
PatientStudyOnlyQueryRetrieveInformationModelFIND
PatientStudyOnlyQueryRetrieveInformationModelGET
PatientStudyOnlyQueryRetrieveInformationModelMOVE
|
#AcceptedTransferSyntaxForStandardSOPClasses
| Anchor | ||||
|---|---|---|---|---|
|
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: ImplicitVRLittleEndian
#AcceptedPrivateSOPClasses
| Anchor | ||||
|---|---|---|---|---|
|
List of accepted Query/Retrieve SOP Classes. Use either the SOP Class UID value, or following defined symbolic names:
- Dcm4cheStudyRootQueryRetrieveInformationModelFIND,
- Dcm4cheBlockedStudyRootQueryRetrieveInformationModelFIND,
Default Value:
| No Format |
|---|
Dcm4cheStudyRootQueryRetrieveInformationModelFIND
Dcm4cheBlockedStudyRootQueryRetrieveInformationModelFIND
|
#AcceptedTransferSyntaxForPrivateSOPClasses
| Anchor | ||||
|---|---|---|---|---|
|
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:
| No Format |
|---|
DeflatedExplicitVRLittleEndian
ExplicitVRLittleEndian
ImplicitVRLittleEndian
|
#MaximumBlockedFindResponse
| Anchor | ||||
|---|---|---|---|---|
|
Maximum number of result records blocked in one Find Response by Private Blocked FIND services.
Default Value: 1000
#LogAETitles
| Anchor | ||||
|---|---|---|---|---|
|
List of the AE titles for the Q/R SCUs for which XMLized query and result attributes are logged into files <AET>/<timestamp>-cfindrq.xml and <AET>/<timestamp>-cfindrsp.xml in the log directory. Useful for creation of XSL stylesheets for query/result attribute coercion. Separate multiple values by (backslash).
NONE = no calling AE titles.
Default Value: NONE
#CoerceConfigDirectory
| Anchor | ||||
|---|---|---|---|---|
|
Directory where configuration files for query/result attribute coercion are located: if XSL stylesheet "cfindrq.xsl" or "cfindrsp.xsl" exists in this directory or a sub-directory equal to the AE Title of a QR SCU, query/result attributes from/to this SCU will be coerced according these stylesheets. A relative path name is resolved relative to DCM4CHEE_HOME/server/default/.
Default Value: conf/dcm4chee-ae
#WriteCoercionXmlLog
| Anchor | ||||
|---|---|---|---|---|
|
Enable logging of coercions in separate log files. FileName: <LOG_DIR>/coercion/<timestamp>.<xsl file>. Coercion logs are only written for Calling AETs specified in #LogAETitles!
Default Value: false
#SendPendingCMoveResponse
| Anchor | ||||
|---|---|---|---|---|
|
Flag indicating if optional C-MOVE Response DICOM message with pending status are returned in the interval defined by attribute #PendingCMoveResponseInterval.
Default Value: true
#PendingCMoveResponseInterval
| Anchor | ||||
|---|---|---|---|---|
|
Interval in ms in which C-MOVE Response DICOM messages with pending status are returned. Even send (identical) response messages, if no storage sub-operation was performed during such interval, to keep the association alive. Only effective, if sending C-Move Response DICOM message with pending status is activated by attribute #SendPendingCMoveResponse.
Default Value: 5000
#SendPendingCGetResponse
| Anchor | ||||
|---|---|---|---|---|
|
Flag indicating if optional C-GET Response DICOM messages with pending status are returned between C-STORE requests. If requested objects have to be fetched from an other/external retrieve AE, identical C-GET Responses with pending status are returned in the interval defined by attribute #PendingCGetResponseInterval, until all requested objects are received from the other/external retrieve AE and sending C-STORE requests to the C-GET SCU starts.
Default Value: false
#PendingCGetResponseInterval
| Anchor | ||||
|---|---|---|---|---|
|
Interval in ms in which identical C-Get Response DICOM messages with pending status are returned if requested objects have to be fetched from an other/external retrieve AE before the first C-STORE requests is sent to the C-GET SCU . Only effective, if sending C-Get Response DICOM message with pending status is activated by attribute #SendPendingCGetResponse.
Default Value: 5000
#RetrieveRspStatusForNoMatchingInstanceToRetrieve
| Anchor | ||||
|---|---|---|---|---|
|
Retrieve response status when there is no matching instance to retrieve for one (or more) requested Patient/Study/Series/Image.
Default Value: 0
#ForwardAsMoveOriginator
| Anchor | ||||
|---|---|---|---|---|
|
Use the calling AE title of the requesting Move SCU instead of the called AE title when opening an association to another Move SCP to forward a Move Request.
Default Value: true
#DirectForwardingList
| Anchor | ||||
|---|---|---|---|---|
|
A list of rules of direct forwarding in C-Move for external retrieve AE. Assume the local AE is A and C-Move to C is requested. The files do not exist in A, but the local database has the database entries for the requested objects with external retrieve AE B. If B to C is defined in the Direct-Forwarding list, a C-Move from B to C will be initiated. If B to C is not included in the list, the requested objects will be first stored to A and then moved from A to C.
Format: <source1>,<destination1>,<destination2>;<source2>,any;...
Use any for all destinations.
#RecordStudyAccessTime
| Anchor | ||||
|---|---|---|---|---|
|
Record last time instances of a study was retrieved by C-GET, C-MOVE or WADO. Should be enabled, if delete functions of the File System Management Service are activated, to delete the least recent accessed studies.
Default Value: true
#MaximumUIDsPerMoveRequest
| Anchor | ||||
|---|---|---|---|---|
|
Maximum number of SOP Instance UIDs in forwarded Move Requests. Larger Move Requests are split into smaller ones according to this constraint.
Default Value: 100
#MaximumPDULength
| Anchor | ||||
|---|---|---|---|---|
|
Maximum protocol data unit (PDU) package length for receiving PDUs.
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
| Anchor | ||||
|---|---|---|---|---|
|
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.
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
| Anchor | ||||
|---|---|---|---|---|
|
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.
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
#MaximumStorageOperationsInvoked
| Anchor | ||||
|---|---|---|---|---|
|
The maximum number of asynchronously invoked storage operations. A value of zero indicates an unlimited number.
Default Value: 0
#AcceptTimeout
| Anchor | ||||
|---|---|---|---|---|
|
A-Associate accept timeout in milliseconds. 0 = no timeout.
Default Value: 10000
#DIMSETimeout
| Anchor | ||||
|---|---|---|---|---|
|
DIMSE message timeout in milliseconds. 0 = no timeout.
Default Value: 60000
#SocketCloseDelay
| Anchor | ||||
|---|---|---|---|---|
|
Socket close delay in milliseconds after an A-Release response.
Default Value: 50
#TcpNoDelay
| Anchor | ||||
|---|---|---|---|---|
|
Send packets as quickly as possible (Disable Nagle's algorithmn).
Default Value: true
#SendBufferSize
| Anchor | ||||
|---|---|---|---|---|
|
Buffer size used for socket output. 0 = use platform default.
Default Value: 0
#ReceiveBufferSize
| Anchor | ||||
|---|---|---|---|---|
|
Buffer size used for socket input. 0 = use platform default.
Default Value: 0
#BufferSize
| Anchor | ||||
|---|---|---|---|---|
|
Size of byte buffer used for copying data from TCP channel to file.
Default Value: 8192
#RetrieveWithoutLeftJoins
| Anchor | ||||
|---|---|---|---|---|
|
Controls usage of LEFT JOINS in executed SQL statement triggered by retrieve requests.
Must be set to false, if the archive is configured as short-term cache, which delegates long-term storage to an external DICOM archive and therefore does not hold file records for each stored instance!
Default Value: false
#LazyFetchSeriesAttrsOnImageLevelQuery
| Anchor | ||||
|---|---|---|---|---|
|
Activates lazy fetch of Series, Study and Instance attributes stored in BLOB columns by an additional query for each series.on queries on IMAGE level.
Default Value: false
#CacheSeriesAttrsOnImageLevelQuery
| Anchor | ||||
|---|---|---|---|---|
|
Activates caching of Series attributes between IMAGE level C-FIND RSPs, which reduces the number of BLOB access
from: 4 × number-of-matching-instances
to: number-of-matching-instances + 3 × number-of-different-series
.
Implicit set by #LazyFetchSeriesAttrsOnImageLevelQuery = true.
Default Value: true
#AccessBlobAsLongVarBinaryOnQuery
| Anchor | ||||
|---|---|---|---|---|
|
Change JDBC binding for Oracle BLOB's to LONGVARBINARY for accessing attributes stored in BLOB columns of DB records on query. Only effective with Oracle as DB.
Default Value: true
#AccessSeriesBlobAsLongVarBinaryOnImageLevelQuery
| Anchor | ||||
|---|---|---|---|---|
|
Change JDBC binding for Oracle BLOB's to LONGVARBINARY for accessing Patient, Study and Series attributes stored in BLOB columns of DB records on query on IMAGE level. Only effective with Oracle as DB.
Should only be enabled with #LazyFetchSeriesAttrsOnImageLevelQuery = true or #CacheSeriesAttrsOnImageLevelQuery = false.
Default Value: false
#LazyFetchSeriesAttrsOnRetrieve
| Anchor | ||||
|---|---|---|---|---|
|
Activates lazy fetch of Series, Study and Instance attributes stored in BLOB columns by an additional query for each series.on DICOM Retrieve and access by WADO with contentType=application/dicom.
Default Value: false
#CacheSeriesAttrsOnRetrieve
| Anchor | ||||
|---|---|---|---|---|
|
Activates caching of Series attributes on DICOM Retrieve, - but also for successive WADO requests for Instances of the same Series - which reduces the number of BLOB access
from: 4 × number-of-retrieved-instances
to: number-of-retrieved-instances + 3 × number-of-different-series
.
Implicit set by #LazyFetchSeriesAttrsOnRetrieve = true.
Default Value: true
#CacheSeriesAttrsOnRetrieveMaxSize
| Anchor | ||||
|---|---|---|---|---|
|
Defines maximal number of Series, which attributes are cached on retrieve of Instances.
Only effective if #CacheSeriesAttrsOnRetrieve = true.
Default Value: 100
#CacheSeriesAttrsOnRetrieveCurrencyTimeLimit
| Anchor | ||||
|---|---|---|---|---|
|
Defines how long cached Series Attributes on retrieve are valid.
Format: ##s (in seconds), ##m (in minutes)
Only effective if #CacheSeriesAttrsOnRetrieve = true.
Default Value: 1m
#AccessBlobAsLongVarBinaryOnRetrieve
| Anchor | ||||
|---|---|---|---|---|
|
Change JDBC binding for Oracle BLOB's to LONGVARBINARY for accessing attributes stored in BLOB columns of DB records on retrieve. Only effective with Oracle as DB.
Default Value: true
#AccessSeriesBlobAsLongVarBinaryOnRetrieve
| Anchor | ||||
|---|---|---|---|---|
|
Change JDBC binding for Oracle BLOB's to LONGVARBINARY for accessing Patient, Study and Series attributes stored in BLOB columns of DB records on retrieve. Only effective with Oracle as DB.
Should only be enabled with #LazyFetchSeriesAttrsOnRetrieve = true or #CacheSeriesAttrsOnRetrieve = false.
Default Value: false
#QueryTransactionIsolationLevel
| Anchor | ||||
|---|---|---|---|---|
|
Transaction isolation level for queries. Values can be one of:
DEFAULTREAD_UNCOMMITTEDREAD_COMMITTEDREPEATABLE_READSERIALIZABLE
Default Value: DEFAULT
#RetrieveTransactionIsolationLevel
| Anchor | ||||
|---|---|---|---|---|
|
Transaction isolation level for retrieves. Values can be one of:
DEFAULTREAD_UNCOMMITTEDREAD_COMMITTEDREPEATABLE_READ
Default Value: DEFAULT
#CoerceAttributeTopDown
| Anchor | ||||
|---|---|---|---|---|
|
Coerce attributes Top-down
Default Value: false
#CFindRspDebugLogDeferToDoBeforeRsp
| Anchor | ||||
|---|---|---|---|---|
|
Defer DEBUG logging of C-Find Response to doBeforeRsp() function just before the response is actually being sent out.
Default Value: false
#DcmServerName
| Anchor | ||||
|---|---|---|---|---|
|
Used internally. Do NOT modify.
#DicomSecurityServiceName
| Anchor | ||||
|---|---|---|---|---|
|
Used internally. Do NOT modify.
#StgCmtScuScpName
| Anchor | ||||
|---|---|---|---|---|
|
Used internally. Do NOT modify.
#TarRetrieverName
| Anchor | ||||
|---|---|---|---|---|
|
Used internally. Do NOT modify.
#TLSConfigName
| Anchor | ||||
|---|---|---|---|---|
|
Used internally. Do NOT modify.
#AEServiceName
| Anchor | ||||
|---|---|---|---|---|
|
Used internally. Do NOT modify.
#TemplatesServiceName
| Anchor | ||||
|---|---|---|---|---|
|
Used internally. Do NOT modify.
#PerfMonServiceName
| Anchor | ||||
|---|---|---|---|---|
|
Used internally. Do NOT modify.
#PixQueryServiceName
| Anchor | ||||
|---|---|---|---|---|
|
Used internally. Do NOT modify.
Operations
#create
| Anchor | ||||
|---|---|---|---|---|
|
Standard MBean lifecycle method
#start
| Anchor | ||||
|---|---|---|---|---|
|
The start lifecycle operation
#stop
| Anchor | ||||
|---|---|---|---|---|
|
The stop lifecycle operation
#destroy
| Anchor | ||||
|---|---|---|---|---|
|
The destroy lifecycle operation
#jbossInternalLifecycle(method)
| Anchor | ||||
|---|---|---|---|---|
|
The detyped lifecycle operation (for internal use only)
#queueStgCmtOrder(calling,called,actionInfo,scpRole)
| Anchor | ||||
|---|---|---|---|---|
|
Used internally
#locateInstance(sopIUID)
| Anchor | ||||
|---|---|---|---|---|
|
Locate SOP Instance. Return a File object, if the instance is locally available, or the hostname as String object if a file of the instance is located on another host.
#locateInstance(sopIUID,studyIUID)
| Anchor | ||||
|---|---|---|---|---|
|
Locate SOP Instance. Return a File object, if the instance is locally available, or the hostname as String object if a file of the instance is located on another host. Update study access time if studyIUID != null and #RecordStudyAccessTime = true.
#locateInstancesOfSeries(seriesIUID,studyIUID)
| Anchor | ||||
|---|---|---|---|---|
|
Locate SOP Instances of one Series. Return a Map which contains one entry for each SOP Instance of a Series, with the SOP Instance UID as key, and a File object if the instance is locally available, or a Retrieve AE Title if the instance is only available from a remote Retrieve SCP, or null if the instance is neither available locally nor from a remote Retrieve SCP, as value. Update study access time if studyIUID != null and #RecordStudyAccessTime = true.
#getFile(dirPath,fileID)
| Anchor | ||||
|---|---|---|---|---|
|
Return file specified by directory path/URL and file ID. If the directory URL specifies a TAR directory, also takes care for fetching the TAR from the HSM and extracting the file from the TAR, making use of the TAR Retriever Service.
#getDatasourceOfInstance(iuid)
| Anchor | ||||
|---|---|---|---|---|
|
Locate SOP Instance. Return a Dataset object, if the instance is locally available. The attributes of the dataset are updated with the attributes from database.
#isLocalRetrieveAET(aet)
| Anchor | ||||
|---|---|---|---|---|
|
Determines if specified AE Title is one of the configured #CalledAETitles.
#addDirectForwarding(source,destination)
| Anchor | ||||
|---|---|---|---|---|
|
Add a direct forward rule of external C-Move from source to destination.
#removeDirectForwarding(source)
| Anchor | ||||
|---|---|---|---|---|
|
Remove a direct forward rule of external C-Move for a source AE
#removeDirectForwarding(source,destination)
| Anchor | ||||
|---|---|---|---|---|
|
Remove a direct forward rule of external C-Move from source to destination
#isDirectForwarding(source,destination)
| Anchor | ||||
|---|---|---|---|---|
|
Check whether an external C-Move should use direct forwarding