DICOM Query/Retrieve SCP. Provides the DICOM Query/Retrieve SCP. Note that the value of the <b>MaxConcurrentCodec</b> attribute in the Compression Service also effects the on-the-fly compression and decompression during the retrieve of images by the QueryRetrieveScp service. org.dcm4chex.archive.dcm.qrscp.QueryRetrieveScpService The default constructor QueryRetrieveScpService &defaultAttributes; Accepted called AE titles, separated by \(backslash). CalledAETitles java.lang.String ANY = accept any.
CONFIGURED_AETS = accept any configured AE Title. ]]> CallingAETitles java.lang.String DirectForwardingList.]]> LocalStorageAETitle java.lang.String 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.]]> SupplementIssuerOfPatientID boolean 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.]]> SupplementIssuerOfAccessionNumber boolean 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 will be supplemented.]]> SupplementByHostName boolean 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 IP address 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 will be supplemented.]]> SupplementByHostAddress boolean 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.]]> AdjustPatientIDOnRetrieval boolean 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.]]> AdjustAccessionNumberOnRetrieval boolean Use either the Transfer Syntaxes UID value or following defined symbolic names:
  • JPEGBaseline
  • JPEGExtended
  • JPEGLSLossy
  • JPEG2000Lossy
  • MPEG2
  • MPEG2HL
  • MPEG4
  • MPEG4BD

Not effective for Move Destinations listed in SendWithDefaultTransferSyntaxToAETitles.]]> DoNotDecompressTransferSyntaxes java.lang.String NONE = no AE titles match this criteria.
ANY = all AE titles match this criteria.]]> SendWithDefaultTransferSyntaxToAETitles java.lang.String 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.]]> OfferNoPixelDataTransferSyntaxToAETitles java.lang.String 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.]]> OfferNoPixelDataDeflateTransferSyntaxToAETitles java.lang.String Move Destination AE titles to which images are sent without pixel data. Separate multiple values by \(backslash). NONE = no AE titles match this criteria. SendNoPixelDataToAETitles java.lang.String 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. IgnoreUnsupportedSOPClassFailures java.lang.String NONE = Disable patching of DICOM JPEG-LS images
ANY = Patch DICOM JPEG-LS images with any Implementation SOP Class UID]]> PatchJpegLSwithImplementationClassUID java.lang.String NONE = Keep original Implementation SOP Class UID]]> PatchJpegLSnewImplementationClassUID java.lang.String 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.]]> PIXQueryCallingAETitles java.lang.String 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.]]> PIXQueryIssuersOfPatientID java.lang.String PIXQueryIssuersOfPatientID = ANY.]]> PIXQueryDefaultIssuerOfPatientID java.lang.String UnrestrictedQueryPermissionsToAETitles java.lang.String Separate multiple values by \(backslash). ANY = Disable restriction of retrieve to Move Destinations according granted Study Read Permissions.
Attention: 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.
Note: 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. ]]> UnrestrictedReadPermissionsToAETitles java.lang.String Attention: 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.
Note: If the C-MOVE SCU also acts as Move Destination, no Export Permission - but still Read Permission - is needed to retrieve a Study.]]> UnrestrictedExportPermissionsToAETitles java.lang.String 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.]]> HideWithoutIssuerOfPatientIDFromAETitles java.lang.String IgnorableSOPClasses java.lang.String Do not match entities with zero-length value for specified matching keys (= non DICOM conform matching behavior). NoMatchForNoValue boolean AcceptedStandardSOPClasses java.lang.String AcceptedTransferSyntaxForStandardSOPClasses java.lang.String AcceptedPrivateSOPClasses java.lang.String AcceptedTransferSyntaxForPrivateSOPClasses java.lang.String Maximum number of result records blocked in one Find Response by Private Blocked FIND services. MaximumBlockedFindResponse int 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.]]> LogAETitles java.lang.String archive-install-directory/server/default/.]]> CoerceConfigDirectory java.lang.String FileName: <LOG_DIR>/coercion/<timestamp>.<xsl file>.[in]|[out]
Coercion logs are only written for Calling AETs specified in LogAETitles!]]> WriteCoercionXmlLog boolean PendingCMoveResponseInterval.]]> SendPendingCMoveResponse boolean SendPendingCMoveResponse.]]> PendingCMoveResponseInterval long PendingCGetResponseInterval, until all requested objects are received from the other/external retrieve AE and sending C-STORE requests to the C-GET SCU starts.]]> SendPendingCGetResponse boolean SendPendingCGetResponse.]]> PendingCGetResponseInterval long Retrieve response status when there is no matching instance to retrieve for one (or more) requested Patient/Study/Series/Image. Default is 0 = SUCCESS. RetrieveRspStatusForNoMatchingInstanceToRetrieve int 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. ForwardAsMoveOriginator boolean Format:
[source1],[destination1],[destination2];[source2],any;...
Use 'any' for all destinations.
]]> DirectForwardingList java.lang.String 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. RecordStudyAccessTime boolean Maximum number of SOP Instance UIDs in forwarded Move Requests. Larger Move Requests are split into smaller ones according to this constraint. MaximumUIDsPerMoveRequest int Maximum protocol data unit (PDU) package length for receiving PDUs. Attention: 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! MaximumPDULength int 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. Attention: 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! MaximumOperationsInvoked int 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. Attention: 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! MaximumOperationsPerformed int The maximum number of asynchronously invoked storage operations. A value of zero indicates an unlimited number. MaximumStorageOperationsInvoked int A-Associate accept timeout in milliseconds. 0 = no timeout. AcceptTimeout int DIMSE message timeout in milliseconds. 0 = no timeout. DIMSETimeout int Socket close delay in milliseconds after an A-Release response. SocketCloseDelay int Send packets as quickly as possible (Disable Nagle's algorithmn). TcpNoDelay boolean Buffer size used for socket output. 0 = use platform default. SendBufferSize int Buffer size used for socket input. 0 = use platform default. ReceiveBufferSize int Size of byte buffer used for copying data from TCP channel to file. BufferSize int Attention: 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!]]> RetrieveWithoutLeftJoins boolean 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. LazyFetchSeriesAttrsOnImageLevelQuery boolean Activates caching of Series attributes between IMAGE level C-FIND RSPs, which reduces the number of BLOB access from 4 x Number of matching Instances to Number of matching Instances + 3 * Number of different Series. Implicit set by LazyFetchSeriesAttrsOnImageLevelQuery = true. CacheSeriesAttrsOnImageLevelQuery boolean 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. AccessBlobAsLongVarBinaryOnQuery boolean 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. AccessSeriesBlobAsLongVarBinaryOnImageLevelQuery boolean 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. LazyFetchSeriesAttrsOnRetrieve boolean 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 x Number of retrieved Instances to Number of retrieved Instances + 3 * Number of different Series. Implicit set by LazyFetchSeriesAttrsOnRetrieve = true. CacheSeriesAttrsOnRetrieve boolean Defines maximal number of Series, which attributes are cached on retrieve of Instances. Only effective if CacheSeriesAttrsOnRetrieve = true. CacheSeriesAttrsOnRetrieveMaxSize int Defines how long cached Series Attributes on retrieve are valid. Format: ##s (in seconds), ##m (in minutes) Only effective if CacheSeriesAttrsOnRetrieve = true CacheSeriesAttrsOnRetrieveCurrencyTimeLimit java.lang.String 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. AccessBlobAsLongVarBinaryOnRetrieve boolean 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. AccessSeriesBlobAsLongVarBinaryOnRetrieve boolean Transaction isolation level for queries. Values can be one of: DEFAULT|READ_UNCOMMITTED|READ_COMMITTED|REPEATABLE_READ|SERIALIZABLE QueryTransactionIsolationLevel java.lang.String Transaction isolation level for retrieves. Values can be one of: DEFAULT|READ_UNCOMMITTED|READ_COMMITTED|REPEATABLE_READ|SERIALIZABLE RetrieveTransactionIsolationLevel java.lang.String Coerce attributes Top-down CoerceAttributeTopDown boolean Defer DEBUG logging of C-Find Response to doBeforeRsp() function just before the response is actually being sent out CFindRspDebugLogDeferToDoBeforeRsp boolean Perform an MD5 check on the file in the filesystem prior to performing a CMOVE or CGET VerifyMD5OnMakeCStoreRQ boolean JDBC Fetch size. FetchSize int Configurable file system prefix to ignore check of file size or NONE. IgnoreFileSizeCheckFS java.lang.String Configurable file system prefix to auto update DICOM Attributes in database or NONE to disable auto update. AutoUpdateAttributesFromFS java.lang.String Only series updated before this specified date will trigger UpdateAttributes service.
Format: YYYY-MM-DD hh:mm:ss, with YYYY = Year, MM = Month, DD = Day, hh = Hour, mm = Minute, ss = Second. ]]> AutoUpdateAttributesBeforeDate java.lang.String Set this value > 0 to activate caching of already updated series.
This caching prevents re-updating series if AutoUpdateAttributesBeforeDate can not be used to exclude already updated series.
]]> AutoUpdateAttributesMaxSeriesCacheSize int Configurable file system prefix to check TransferSyntax of file with database entry during retrieve and correct db entry if necessary. Use NONE to disable this feature. CheckTransfersyntaxFromFS java.lang.String Used internally. Do NOT modify. DcmServerName javax.management.ObjectName Used internally. Do NOT modify. DicomSecurityServiceName javax.management.ObjectName Used internally. Do NOT modify. StgCmtScuScpName javax.management.ObjectName Format:<protocol>=<Reriever Service Name>[<newline><protocol>=<...>[..]]
Use 'NONE' to disable mapping.
Note: The retriever service must provide java.io.File retrieveFile(java.lang.String fsID, java.lang.String fileID) method
Example:
tar:=dcm4chee.archive:service=TarRetriever
ftp:=%lt;Objectname of FTP retriever service> ]]> ProtocolRetrieverMapping java.lang.String Used internally. Do NOT modify. TLSConfigName javax.management.ObjectName Used internally. Do NOT modify. AEServiceName javax.management.ObjectName Used internally. Do NOT modify. TemplatesServiceName javax.management.ObjectName Used internally. Do NOT modify. PerfMonServiceName javax.management.ObjectName Used internally. Do NOT modify. PixQueryServiceName javax.management.ObjectName Used internally. Do NOT modify. UpdateAttributesServiceName javax.management.ObjectName &defaultOperations; Used internally queueStgCmtOrder calling java.lang.String called java.lang.String actionInfo org.dcmche.data.Dataset scpRole boolean void 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 SOP Instance UID iuid java.lang.String java.lang.Object 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. locateInstance SOP Instance UID sopIUID java.lang.String Study Instance UID studyIUID java.lang.String java.lang.Object 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. locateInstancesOfSeries Series Instance UID seriesIUID java.lang.String Study Instance UID studyIUID java.lang.String java.util.Map 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. getFile Directory/Mount Point file system dirPath java.lang.String File ID fileID java.lang.String java.io.File 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. getDatasourceOfInstance SOP Instance UID iuid java.lang.String org.dcm4che.net.DataSource CalledAETitles.]]> isLocalRetrieveAET AE Title aet java.lang.String boolean addDirectForwarding source java.lang.String destination java.lang.String void removeDirectForwarding source java.lang.String void removeDirectForwarding source java.lang.String destination java.lang.String void isDirectForwarding source java.lang.String destination java.lang.String boolean clearCachedSeriesAttrs void