...
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 cancel MEDIUM 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>cget maximum number ofretrieve outstanding C-MOVE-RQ it may
instances of matching entities by
invoke asynchronously, 1 by defaultC-GET.
-reapercgetrspTO <ms> periodtimeout in ms to check for outstandingreceiving DIMSEC-GET-RSP, and
10sC-MOVE RSP, 600s by default
-rspTOcloseassoc <ms> timeout in msClose forassociation receiving DIMSE-RSP, 60s bybetween repeated query (and
default -I,--image retrieve)
-cmove <aet> perform instance level query, multiple exclusiveretrieve matching objects to specified move
with -P and -S, perform study level query by defaultdestination.
-pdv1cmoverspTO <ms> timeout in ms for receiving send only one PDV in one P-Data-TF PDU, packC-MOVE-RSP and
C-GET RSP, 600s by default
command-connectTO and<ms> data PDV in one P-DATA-TF PDU by default. -sndpdulen <KB> timeout in ms for TCP connect, no timeout maximalby
length in KB of sent P-DATA-TF PDUs, 16KB default
-cstore <cuid[:ts]> by default -rcvpdulen <KB> negotiate support of specified Storage SOP
maximal length in KB of received P-DATA-TF PDUs, Class and Transfer Syntaxes. The Storage 16KBSOP
by default -case negotiate support of case-sensitive person name Class may be specified by its UID or by one of
attribute matching. -C <num> following key words:
cancel query after receive of specified number of CR - Computed Radiography Image Storage
responses, no cancel by default -L <aet[@host]> set AET and local address of local Application CT - CT Image Storage
Entity, use ANONYMOUS and pick up any valid MR - MRImageStorage
local address to bind the socket by default -V,--version US - Ultrasound Image Storage
print the version information and exit -blocked negotiate privateNM FIND SOP- ClassesNuclear toMedicine returnImage Storage
attributes of several matching entitiesPET per- FINDPET Image Storage
response. -connectTO <ms> SC - Secondary Capture Image Storage
timeout in ms for TCP connect, no timeout by XA - XRay Angiographic Image defaultStorage
-datetime negotiate support of combined date and time XRF - XRay Radiofluoroscopic Image Storage
attribute range matching. -dest <aet> DX - Digital retrieveX-Ray matchingImage objectsStorage tofor
specified move destination. Presentation
-h,--help print this message -ivrle MG - Digital Mammography X-Ray Image Storage
offer only Implicit VR Little Endian Transfer for Presentation
Syntax. -noextneg disable extended negotiation. -q <[seq/]attr=value> specifyPR matching key.- attrGrayscale canSoftcopy bePresentation specifiedState
by name or tagStorage
value (in hex), e.g. PatientName KO or- 00100010.Key AttributesObject inSelection nestedDocument DatasetsStorage
can be specified bySR including the- name/tagBasic valueText ofStructured Report Document
the sequence attribute, e.g. 00400275/00400009 Storage
for Scheduled Procedure Step IDThe inTransfer theSyntaxes Requestmay be specified by a
Attributes Sequence -r <attr> comma separated list of UIDs or by one of
specify additional return key. attr can be following key words:
specified by name or tag value (in hex). -rel IVRLE - offer only Implicit negotiateVR supportLittle ofEndian
relational queries and retrieval.Transfer Syntax
-retall negotiate private FIND SOP Classes to fetch all LE - offer Explicit and Implicit VR Little
available attributes of matching entities. -semantic Endian Transfer Syntax
negotiate support of semantic person name BE - offer Explicit VR Big Endian attributeTransfer
matching. -sorcvbuf <KB> set SO_RCVBUF socket option to specified value in Syntax
KB -sosndbuf <KB> DEFL - offer setDeflated SO_SNDBUFExplicit socketVR optionLittle
to specified value in Endian KBTransfer Syntax
-tcpdelay set TCP_NODELAY socket option to false, true by JPLL - offer JEPG Loss Less Transfer Syntaxes
default -vmf JPLY - offer JEPG Lossy Transfer Syntaxes
negotiate private FIND SOP Classes to return MPEG2 - offer MPEG2 Transfer Syntax
attributes of legacy CT/MR images of one series as NOPX - offer No Pixel 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
No Format |
---|
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
See also
dcmrcv