Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Executing the dcmqr utility will query specified remote Application Entity (=Query/Retrieve SCP) and optionally (s. option -destcget/-cmove) retrieve instances of matching entities. If <port> is not specified, DICOM default port 104 is assumed. If also no <host> is specified localhost is assumed. Also Storage Services can be provided (s. option -cstore) to receive retrieved instances. For receiving objects retrieved by C-MOVE in a separate association, a local listening port must be specified (s.option -L).

Usage

No Format
dcmqr [Options] <aet>[@<host>[:<port>]] [Options]

Options

No Format
 -soclosedelayacceptTO <ms>      delay in ms for Socket close after sending  timeout in ms for receiving A-ASSOCIATE-AC, 5s
                          A-ABORT, 50ms by default
 -acceptTOasync <maxops> <ms>          timeout inmaximum msnumber forof receivingoutstanding AC-ASSOCIATE-AC, 5s byMOVE-RQ it may
                           default invoke -Sasynchronously,--series 1 by default.
 -blocked        perform series level query, multiple exclusive      negotiate private FIND SOP Classes to return
             with -P and -I, perform study level query by default.  -P,--patient    attributes of several matching entities per
  perform patient level query, multiple exclusive                     FIND response.
 -C <num> with -S and -I, perform study level query by default.  -lowprior       cancel query after receive of specified number
 LOW priority of the C-FIND/C-MOVE operation,                       of responses, no MEDIUMcancel by default
 -highpriorcfind <cuid>             HIGH prioritynegotiate ofaddition theprivate C-FIND/C-MOVE operation, SOP class
                            MEDIUMwith byspecified defaultUID
 -releaseTOcfindrspTO <ms>           timeout in ms for receiving AC-RELEASEFIND-RPRSP, 5s60s by
                         default  -async <maxops>default
 -cget       maximum number of outstanding C-MOVE-RQ it may         retrieve instances of matching entities by
           invoke asynchronously, 1 by default.  -reaper <ms>          C-GET.
 period-cgetrspTO in<ms> ms to check for outstanding DIMSE-RSP,      timeout in ms for receiving C-GET-RSP and
             10s by default  -rspTO <ms>          C-MOVE RSP, 600s by timeoutdefault
in ms-closeassoc for receiving DIMSE-RSP, 60s by           Close association between repeated query (and
         default  -I,--image              perform instance level query,retrieve)
multiple exclusive-cmove <aet>               retrieve matching objects to specified move
    with -P and -S, perform study level query by default.  -pdv1             destination.
 -cmoverspTO <ms>    send   only one PDV in one P-Data-TF PDU, pack
  timeout in ms for receiving C-MOVE-RSP and
                      command and data PDV in one P-DATA-TF PDUC-GET RSP, 600s by default.
 -sndpdulenconnectTO <ms>  <KB>         maximal lengthtimeout in KBms offor sent P-DATA-TF PDUs, 16KB
TCP connect, no timeout by
                        by default  -rcvpdulen <KB>default
 -cstore <cuid[:ts]>      maximal length innegotiate KBsupport of received P-DATA-TF PDUs,specified Storage SOP
                         16KB by default Class -caseand Transfer Syntaxes. The Storage SOP
             negotiate support of case-sensitive person name          Class may be specified by its UID or by one of
     attribute matching.  -C <num>                cancel query after receivefollowing ofkey specifiedwords:
number of                          responses, noCR cancel by- defaultComputed Radiography -deviceImage <name>Storage
         set device name, use DCMQR by default  -L <aet[@host][:port]>  set AET, local address and listening port  CT  - CT Image Storage
                  of local Application Entity,       MR  - MRImageStorage
               use device name and pick up any valid      US  - Ultrasound Image Storage
              local address to bind the socket by default  -V,--version     NM  - Nuclear Medicine Image Storage
print the version information and exit  -blocked                negotiate private FIND SOP Classes toPET return- PET Image Storage
                      attributes of several matching entities per FINDSC  - Secondary Capture Image Storage
                   response.  -connectTO <ms>      XA  - timeoutXRay inAngiographic msImage forStorage
TCP connect, no timeout by                        XRF - defaultXRay Radiofluoroscopic -datetimeImage Storage
             negotiate support of combined date and time         DX  - Digital X-Ray Image Storage for
         attribute range matching.  -dest <aet>             retrieve matchingPresentation
objects to specified move                         MG destination.
 -h,--help Digital Mammography X-Ray Image Storage
         print this message  -ivrle               for Presentation
 offer only Implicit VR Little Endian Transfer                     PR  - Grayscale Softcopy Syntax.Presentation State
-noextneg               disable extended negotiation.  -q <[seq/]attr=value>   specify matching key. attr can beStorage
specified by                          name orKO tag value- (in hex), e.g. PatientName
Key Object Selection Document Storage
                        or 00100010. Attributes in nestedSR Datasets can- Basic Text Structured Report Document
                    be specified by including the name/tag value of Storage
                        the sequence attribute, e.g. 00400275/00400009
       The Transfer Syntaxes may be specified by a
                  for Scheduled Procedure Step ID in the Request   comma separated list of UIDs or by one of
              Attributes Sequence  -r <attr>          following key words:
  specify additional return key. attr can be                    IVRLE - offer only Implicit VR specifiedLittle byEndian
name or tag value (in hex).  -rel                    negotiate support ofTransfer relationalSyntax
queries and                          retrieval. LE -retall offer Explicit and Implicit VR Little
          negotiate private FIND SOP Classes to fetch all           Endian Transfer Syntax
            available attributes of matching entities.  -semantic          BE - offer Explicit VR negotiateBig supportEndian ofTransfer
semantic person name                          attributeSyntax
matching.  -sorcvbuf <KB>          set SO_RCVBUF socket option to specified value in        DEFL - offer Deflated Explicit VR Little
           KB  -sosndbuf <KB>          set SO_SNDBUF socket  optionEndian toTransfer specifiedSyntax
value in                          KB JPLL -tcpdelay offer JEPG Loss Less Transfer Syntaxes
        set TCP_NODELAY socket option to false, true by             JPLY - offer JEPG Lossy Transfer Syntaxes
      default  -vmf                    negotiateMPEG2 private- FINDoffer SOPMPEG2 ClassesTransfer toSyntax
return                          attributes of legacyNOPX CT/MR- imagesoffer ofNo one series asPixel Data Transfer Syntax
                          virtual multiframe object.

Examples

No Format

dcmqr REMOTEAET@192.168.1.10:11112

Queries all studies on entity REMOTEAET at 192.168.1.10 listening on port 11112

No Format

dcmqr MYPACS@exampledomain.com:4040 -qStudyDate=20060204

Queries studies from Feburary 4th 2006 on entity MYPACS at exampledomain.com listening on port 4040.

No Format

dcmqr MYPACS@exampledomain.com:4040 -qStudyDate=20060204 -dest DCMRCV

...

NOPXD - offer No Pixel Data Deflate Transfer
                            Syntax
                            If only the Storage SOP Class is specified,
                            all Transfer Syntaxes listed above except No
                            Pixel Data and No Pixel Data Delflate Transfer
                            Syntax are offered.
 -cstoredest <dir>          store received objects into files in specified
                            directory <dir>. Do not store received objects
                            by default.
 -datetime                  negotiate support of combined date and time
                            attribute range matching.
 -device <name>             set device name, use DCMQR by default
 -evalRetrieveAET           Only Move studies not allready stored on
                            destination AET
 -filebuf <KB>              minimal buffer size to write received object
                            to file, 1KB by default
 -fuzzy                     negotiate support of fuzzy semantic person
                            name attribute matching.
 -h,--help                  print this message
 -highprior                 HIGH priority of the C-FIND/C-MOVE operation,
                            MEDIUM by default
 -I,--image                 perform instance level query, multiple
                            exclusive with -P and -S, perform study level
                            query by default.
 -ivrle                     offer only Implicit VR Little Endian Transfer
                            Syntax.
 -keypw <password>          password for accessing the key in the
                            keystore, keystore password by default
 -keystore <file|url>       file path or URL of P12 or JKS keystore,
                            resource:tls/test_sys_1.p12 by default
 -keystorepw <password>     password for keystore file, 'secret' by
                            default
 -L <aet[@host][:port]>     set AET, local address and listening port of
                            localApplication Entity, use device name and
                            pick up any valid local address to bind the
                            socket by default
 -lowprior                  LOW priority of the C-FIND/C-MOVE operation,
                            MEDIUM by default
 -no_ssl2                   disable the use of SSLv2 for TLS connections
 -no_ssl3                   disable the use of SSLv3 for TLS connections
 -no_tls1                   disable the use of TLSv1 for TLS connections
 -noclientauth              disable client authentification for TLS
 -noextneg                  disable extended negotiation.
 -P,--patient               perform patient level query, multiple
                            exclusive with -S and -I, perform study level
                            query by default.
 -passcode <passcode>       optional passcode for User Identity
                            Negotiation, only effective with option
                            -username
 -pdv1                      send only one PDV in one P-Data-TF PDU, pack
                            command and data PDV in one P-DATA-TF PDU by
                            default.
 -q <[seq/]attr=value>      specify matching key. attr can be specified by
                            name or tag value (in hex), e.g. PatientName
                            or 00100010. Attributes in nested Datasets can
                            be specified by including the name/tag value
                            of the sequence attribute, e.g.
                            00400275/00400009 for Scheduled Procedure Step
                            ID in the Request Attributes Sequence
 -r <attr>                  specify additional return key. attr can be
                            specified by name or tag value (in hex).
 -rcvpdulen <KB>            maximal length in KB of received P-DATA-TF
                            PDUs, 16KB by default
 -reaper <ms>               period in ms to check for outstanding
                            DIMSE-RSP, 10s by default
 -rel                       negotiate support of relational queries and
                            retrieval.
 -releaseTO <ms>            timeout in ms for receiving A-RELEASE-RP, 5s
                            by default
 -repeat <num>              repeat query (and retrieve) several times
 -repeatdelay <ms>          delay in ms between repeated query (and
                            retrieve), no delay by default
 -retall                    negotiate private FIND SOP Classes to fetch
                            all available attributes of matching entities.
 -reuseassoc                Reuse association for repeated query (and
                            retrieve)
 -S,--series                perform series level query, multiple exclusive
                            with -P and -I, perform study level query by
                            default.
 -sndpdulen <KB>            maximal length in KB of sent P-DATA-TF PDUs,
                            16KB by default
 -soclosedelay <ms>         delay in ms for Socket close after sending
                            A-ABORT, 50ms by default
 -sorcvbuf <KB>             set SO_RCVBUF socket option to specified value
                            in KB
 -sosndbuf <KB>             set SO_SNDBUF socket option to specified value
                            in KB
 -ssl3                      disable the use of TLSv1 and SSLv2 for TLS
                            connections
 -storeasync <maxops>       maximum number of outstanding storage
                            operations performed asynchronously, unlimited
                            by default.
 -tcpdelay                  set TCP_NODELAY socket option to false, true
                            by default
 -tls <NULL|3DES|AES>       enable TLS connection without, 3DES or AES
                            encryption
 -tls1                      disable the use of SSLv3 and SSLv2 for TLS
                            connections
 -truststore <file|url>     file path or URL of JKS truststore,
                            resource:tls/mesa_certs.jks by default
 -truststorepw <password>   password for truststore file, 'secret' by
                            default
 -uidnegrsp                 request positive User Identity Negotation
                            response, only effective with option -username
 -username <username>       enable User Identity Negotiation with
                            specified username and  optional passcode
 -V,--version               print the version information and exit
 -vmf                       negotiate private FIND SOP Classes to return
                            attributes of legacy CT/MR images of one
                            series as virtual multiframe object

Examples

No Format

dcmqr REMOTEAET@192.168.1.10:11112

Queries all studies on entity REMOTEAET at 192.168.1.10 listening on port 11112

No Format

dcmqr MYPACS@exampledomain.com:4040 -qStudyDate=20060204

Queries studies from Feburary 4th 2006 on entity MYPACS at exampledomain.com listening on port 4040.

No Format

dcmqr MYPACS@exampledomain.com:4040 -qStudyDate=20060204 -cmove DCMRCV

Queries studies from Feburary 4th 2006 on entity MYPACS at exampledomain.com and executes a C-MOVE to the entity DCMRCV on all matches. (Note: MYPACS must be aware of the entity DCMRCV for this to work)

No Format

dcmqr -L QRSCU:11113 QRSCP@localhost:11112 -cmove QRSCU -qStudyDate=20060204 -qModalitiesInStudy=CT
                                           -cstore CT -cstore PR:LE -cstoredest /tmp

Queries Application Entity QRSCP listening on local port 11112 for CT studies from Feb 4, 2006 and retrieves matching studies by C-MOVE to own Application Entity QRSCU listing on local port 11113, storing received CT images and Grayscale Softcopy Presentation states to /tmp

See also

dcmrcv