DCMTK Version 3.7.0 OFFIS DICOM Toolkit

dcmqrset.txt file

    SETTING UP DCMQRSCP AND DCMQRTI

    Before attempting to setup dcmqrscp or dcmqrti you should read the documentation
    for these programs (dcmqrscp and dcmqrti man pages) as well as the documentation
    on configuration (dcmqrcnf.txt).

    Step 1:

    Create a directory where the image databases will be located.
    e.g.
        mkdir /home/dicom/db

    Step 2:

    Create subdirectories for each individual image database storage areas to be
    managed by dcmqrscp.  Each database storage area corresponds to an Application
    Entity (AE) title of dcmqrscp.
    e.g.
        cd /home/dicom/db
        mkdir COMMON ACME_STORE UNITED_STORE

    Step 3:

    Copy the example configuration file (dcmqrscp.cfg) to the main image database
    directory.
    e.g.
        cp /usr/local/etc/dcmtk-<VERSION>/dcmqrscp.cfg /home/dicom/db

    Step 4:

    Edit your copy of the configuration file.  You may have used different image
    database directory and subdirectory names than in the examples above.  If so,
    edit the AETable (near the bottom) of your dcmqrscp.cfg file and change the first
    and second columns to reflect the names you have chosen (AE title and directory
    paths).

    Step 5:

    Determine the hostnames, TCP/IP port numbers, and AE titles of the DICOM
    applications you will be communicating with.  You need to edit your copy of
    dcmqrscp.cfg to include these in the HostTable section.

    Step 6:

    Edit the VendorTable to give a string title to symbolic names declared in the
    HostTable.

    Step 7:

    If you wish to restrict access to image databases to particular remote
    applications (peers) you need to edit the last column of the AETable to contain
    a symbolic name defined in the HostTable.  If no access restrictions are desired
    you can use the constant name ANY.

    Step 8 (optional):

    If you wish to initialize a database storage area to reference a set of external
    images, you can use the dcmqridx utility.  This step would normally only be
    performed on a read-only database storage area since sending images to such a
    storage area (AE title) might cause your original images to be deleted if the
    quota specifications (4th column of the AETable in dcmqrscp.cfg) are exceeded.
    e.g.
        dcmqridx -v /home/dicom/db/COMMON /home/dicom/images/rsna95/*/*/*

    would register the "rsna95" images in the COMMON storage area (which is defined
    as read-only in dcmqrscp.cfg).  The "rsna95" images are available via ftp from
    the Mallinckrodt Institute of Radiology, St. Louis, USA :

        ftp://wuerlim.wustl.edu/pub/dicom/images/version3/RSNA95

    Step 9:

    You can now start the dcmqrscp application.
    e.g.
        dcmqrscp -v -c /home/dicom/db/dcmqrscp.cfg 5678

    will start dcmqrscp in verbose mode, using the configuration file you created
    and edited in steps 3 to 8, and listening on TCP/IP port 5678.  The dcmqrscp
    application will wait for DICOM association requests and will never exit.

    Step 10:

    You can try sending a DICOM image to dcmqrscp from one of the remote machines
    which may access dcmqrscp's storage areas.
    e.g.
        storescu -v --aetitle ACME1 --call ACME_STORE dbhost 5678 ctimage.dcm

    will start the storescu application in verbose mode, giving it the DICOM AE
    title ACME1, and requesting that it transmit the DICOM image ctimage.dcm to
    the ACME_STORE storage area of dcmqrscp which is running on the host dbhost
    (attached to port 5678, as in step 9).  The AE title which storescu uses (via
    the -t option) and the host on which it is running must match the values known
    to dcmqrscp in its dcmqrscp.cfg file.  See the storescu man page for more
    information on the storescu application.

    Step 11:

    On the remote machine used in step 10 you can start a DICOM Storage SCP which
    is capable of receiving images.
    e.g.
        storescp -v 3456

    will start storescp in verbose mode listening on port 3456 for incoming
    associations.  See the storescp man page for more information on the storescp
    application.

    Step 12:

    You can try using the dcmqrti application to examine the database storage
    areas and send images to the storescp application started in step 11.
    dcmqrti should be run on the same host as dcmqrscp.
    e.g.
        dcmqrti -c /home/dicom/db/dcmqrscp.cfg acmeCTcompany

    will start the dcmqrti application using the configuration file you created
    and edited in steps 3 to 8, with the capability to communicate to the
    applications defined by the symbolic name acmeCTcompany.  You can use the
    "database" command to select a database, the "title" command to select a
    remote application, "echo" to send an echo message, and "send study" to
    transmit a complete study.  See the dcmqrti man page for more information on
    the commands accepted by dcmqrti.

Generated on Mon Dec 15 2025 for DCMTK Version 3.7.0 by Doxygen 1.9.1