...
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