How to configure coercion of Patient and Study attributes in retrieved objects according Leading Archive

vrindanayak edited this page Oct 12, 2016 · 3 revisions
Clone this wiki locally


Brief Description

This functionality is provided in archive so that updated patient/study objects are sent back to worklist station/viewers when they query DCM4CHEE archive which acts as a long term archive and there exists another 'Leading' archive which receives the regular DICOM/HL7 updates but doesn't forward the same to the long term archive.


You may either

  • create a LDIF file (e.g.):

    version: 1
    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmLeadingCFindSCPQueryCacheStaleTimeout
    dcmLeadingCFindSCPQueryCacheStaleTimeout: PT5M
    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmLeadingCFindSCPQueryCacheSize
    dcmLeadingCFindSCPQueryCacheSize: 50
    dn: cn=Leading DCMQRSCP,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    objectClass: dcmArchiveAttributeCoercion
    cn: Leading DCMQRSCP
    dicomTransferRole: SCP
    dcmAETitle: STORESCP
    dcmLeadingCFindSCP: QRSCP

    and import it to the LDAP Server by using the ldapmodify command line utility.

  • or use the Add Attribute... and Add Value... function of Apache Directory Studio to add attributes on Device Level (e.g.: dicomDeviceName=dcm4chee-arc) of the Archive Configuration.

Note that if dcmLeadingCFindSCPQueryCacheSize attribute is set to 0, then one must set dcmLeadingCFindSCPQueryCacheStaleTimeout to avoid out of memory issues.

One may refer to Archive Device and Archive Attribute Coercion to understand the description of attributes.

Refer ISO-8601 Duration format for more know-how on Durations.

Testing using dcmTools

  1. Start dcmqrscp tool to act as leading archive and feed the tool with a study using movescu

         dcmqrscp -b QRSCP:11113 --dicomdir \tmp\DICOMDIR
  2. Start storescp tool to act as viewer/worklist station, which should eventually receive updated patient/study object from dcmqrscp

         storescp -b STORESCP:11115
  3. Modify patient/study attribute of original patient/study using archive UI (after it has been sent to the QRSCP). Now using movescu store the study/patient on STORESCP destination. The original study/patient should be received on STORESCP.

          movescu -c DCM4CHEE@localhost:11112 -m StudyInstanceUID= --dest STORESCP