Overview
Executing the dcmqr utility will query specified remote Application Entity (Query/Retrieve SCP) and optionally (s. option -dest) 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.
Usage
dcmqr [Options] <aet>[@<host>[:<port>]]
Options
-soclosedelay <ms> delay in ms for Socket close after sending
A-ABORT, 50ms by default
-acceptTO <ms> timeout in ms for receiving A-ASSOCIATE-AC, 5s by
default
-S,--series perform series level query, multiple exclusive
with -P and -I, perform study level query by default.
-P,--patient perform patient level query, multiple exclusive
with -S and -I, perform study level query by default.
-lowprior LOW priority of the C-FIND/C-MOVE operation,
MEDIUM by default
-highprior HIGH priority of the C-FIND/C-MOVE operation,
MEDIUM by default
-releaseTO <ms> timeout in ms for receiving A-RELEASE-RP, 5s by
default
-async <maxops> maximum number of outstanding C-MOVE-RQ it may
invoke asynchronously, 1 by default.
-reaper <ms> period in ms to check for outstanding DIMSE-RSP,
10s by default
-rspTO <ms> timeout in ms for receiving DIMSE-RSP, 60s by
default
-I,--image perform instance level query, multiple exclusive
with -P and -S, perform study level query by default.
-pdv1 send only one PDV in one P-Data-TF PDU, pack
command and data PDV in one P-DATA-TF PDU by default.
-sndpdulen <KB> maximal length in KB of sent P-DATA-TF PDUs, 16KB
by default
-rcvpdulen <KB> maximal length in KB of received P-DATA-TF PDUs,
16KB by default
-case negotiate support of case-sensitive person name
attribute matching.
-C <num> cancel query after receive of specified number of
responses, no cancel by default
-L <aet[@host]> set AET and local address of local Application
Entity, use ANONYMOUS and pick up any valid
local address to bind the socket by default
-V,--version print the version information and exit
-blocked negotiate private FIND SOP Classes to return
attributes of several matching entities per FIND
response.
-connectTO <ms> timeout in ms for TCP connect, no timeout by
default
-datetime negotiate support of combined date and time
attribute range matching.
-dest <aet> retrieve matching objects to specified move
destination.
-h,--help print this message
-ivrle offer only Implicit VR Little Endian Transfer
Syntax.
-noextneg disable extended negotiation.
-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).
-rel negotiate support of relational queries and
retrieval.
-retall negotiate private FIND SOP Classes to fetch all
available attributes of matching entities.
-semantic negotiate support of semantic person name
attribute matching.
-sorcvbuf <KB> set SO_RCVBUF socket option to specified value in
KB
-sosndbuf <KB> set SO_SNDBUF socket option to specified value in
KB
-tcpdelay set TCP_NODELAY socket option to false, true by
default
-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 -dest 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)