dcmqr
Overview
Executing the dcmqr utility will query specified remote Application Entity (=Query/Retrieve SCP) and optionally (s. option -cget/-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
dcmqr <aet>[@<host>[:<port>]] [Options]
Options
-acceptTO <ms> timeout in ms for receiving A-ASSOCIATE-AC, 5s
by default
-async <maxops> maximum number of outstanding C-MOVE-RQ it may
invoke asynchronously, 1 by default.
-blocked negotiate private FIND SOP Classes to return
attributes of several matching entities per
FIND response.
-C <num> cancel query after receive of specified number
of responses, no cancel by default
-cfind <cuid> negotiate addition private C-FIND SOP class
with specified UID
-cfindrspTO <ms> timeout in ms for receiving C-FIND-RSP, 60s by
default
-cget retrieve instances of matching entities by
C-GET.
-cgetrspTO <ms> timeout in ms for receiving C-GET-RSP and
C-MOVE RSP, 600s by default
-closeassoc Close association between repeated query (and
retrieve)
-cmove <aet> retrieve matching objects to specified move
destination.
-cmoverspTO <ms> timeout in ms for receiving C-MOVE-RSP and
C-GET RSP, 600s by default
-connectTO <ms> timeout in ms for TCP connect, no timeout by
default
-cstore <cuid[:ts]> negotiate support of specified Storage SOP
Class and Transfer Syntaxes. The Storage SOP
Class may be specified by its UID or by one of
following key words:
CR - Computed Radiography Image Storage
CT - CT Image Storage
MR - MRImageStorage
US - Ultrasound Image Storage
NM - Nuclear Medicine Image Storage
PET - PET Image Storage
SC - Secondary Capture Image Storage
XA - XRay Angiographic Image Storage
XRF - XRay Radiofluoroscopic Image Storage
DX - Digital X-Ray Image Storage for
Presentation
MG - Digital Mammography X-Ray Image Storage
for Presentation
PR - Grayscale Softcopy Presentation State
Storage
KO - Key Object Selection Document Storage
SR - Basic Text Structured Report Document
Storage
The Transfer Syntaxes may be specified by a
comma separated list of UIDs or by one of
following key words:
IVRLE - offer only Implicit VR Little Endian
Transfer Syntax
LE - offer Explicit and Implicit VR Little
Endian Transfer Syntax
BE - offer Explicit VR Big Endian Transfer
Syntax
DEFL - offer Deflated Explicit VR Little
Endian Transfer Syntax
JPLL - offer JEPG Loss Less Transfer Syntaxes
JPLY - offer JEPG Lossy Transfer Syntaxes
MPEG2 - offer MPEG2 Transfer Syntax
NOPX - offer No Pixel Data Transfer Syntax
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
dcmqr REMOTEAET@192.168.1.10:11112
Queries all studies on entity REMOTEAET at 192.168.1.10 listening on port 11112
dcmqr MYPACS@exampledomain.com:4040 -qStudyDate=20060204
Queries studies from Feburary 4th 2006 on entity MYPACS at exampledomain.com listening on port 4040.
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)
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
dcmqr -L QRSCU:11113 QRSCP@localhost:11112 -S -qStudyDate=20100521-20100521 -qStudyTime=001529-011529 -r PatientID -r PatientName -r PatientSex -r PatientBirthDate -r ModalitiesInStudy -r StudyDescription
Sends a Series level Q/R which includes patient and other attributes using the -r option. While using the -r option, make sure not to have any overlap between any -r attributes and -q attributes. So if querying using StudyDate, make sure the command does not contain -r StudyDate or the query does not work