1movescu(1)                        OFFIS DCMTK                       movescu(1)
2
3
4

NAME

6       movescu - DICOM retrieve (C-MOVE) SCU
7
8

SYNOPSIS

10       movescu [options] peer port [dcmfile-in...]
11

DESCRIPTION

13       The  movescu  application implements both an SCU for the Query/Retrieve
14       Service Class and  an  SCP  for  the  Storage  Service  Class.  movescu
15       supports  retrieve  functionality  using  the  C-MOVE message. It sends
16       query keys to an SCP and awaits responses. It will accept  associations
17       for  the  purpose  of  receiving  images sent as a result of the C-MOVE
18       request. The application can be used to test SCPs of the Query/Retrieve
19       Service  Class.  The  movescu  application can initiate the transfer of
20       images to a third party or can retrieve images to itself. Note that the
21       use  of  the  term  'move' is a misnomer. The C-MOVE operation actually
22       performs an image copy (no images will be deleted from the SCP).
23

PARAMETERS

25       peer        hostname of DICOM peer
26
27       port        tcp/ip port number of peer
28
29       dcmfile-in  DICOM query file(s)
30

OPTIONS

32   general options
33         -h    --help
34                 print this help text and exit
35
36               --version
37                 print version information and exit
38
39               --arguments
40                 print expanded command line arguments
41
42         -q    --quiet
43                 quiet mode, print no warnings and errors
44
45         -v    --verbose
46                 verbose mode, print processing details
47
48         -d    --debug
49                 debug mode, print debug information
50
51         -ll   --log-level  [l]evel: string constant
52                 (fatal, error, warn, info, debug, trace)
53                 use level l for the logger
54
55         -lc   --log-config  [f]ilename: string
56                 use config file f for the logger
57
58   network options
59       override matching keys:
60
61         -k    --key  [k]ey: gggg,eeee="str" or dictionary name="str"
62                 override matching key
63
64       query information model:
65
66         -P    --patient
67                 use patient root information model (default)
68
69         -S    --study
70                 use study root information model
71
72         -O    --psonly
73                 use patient/study only information model
74
75       application entity titles:
76
77         -aet  --aetitle  [a]etitle: string
78                 set my calling AE title (default: MOVESCU)
79
80         -aec  --call  [a]etitle: string
81                 set called AE title of peer (default: ANY-SCP)
82
83         -aem  --move  [a]etitle: string
84                 set move destination AE title (default: MOVESCU)
85
86       preferred network transfer syntaxes (incoming associations):
87
88         +x=   --prefer-uncompr
89                 prefer explicit VR local byte order (default)
90
91         +xe   --prefer-little
92                 prefer explicit VR little endian TS
93
94         +xb   --prefer-big
95                 prefer explicit VR big endian TS
96
97         +xs   --prefer-lossless
98                 prefer default JPEG lossless TS
99
100         +xy   --prefer-jpeg8
101                 prefer default JPEG lossy TS for 8 bit data
102
103         +xx   --prefer-jpeg12
104                 prefer default JPEG lossy TS for 12 bit data
105
106         +xv   --prefer-j2k-lossless
107                 prefer JPEG 2000 lossless TS
108
109         +xw   --prefer-j2k-lossy
110                 prefer JPEG 2000 lossy TS
111
112         +xt   --prefer-jls-lossless
113                 prefer JPEG-LS lossless TS
114
115         +xu   --prefer-jls-lossy
116                 prefer JPEG-LS lossy TS
117
118         +xm   --prefer-mpeg2
119                 prefer MPEG2 Main Profile @ Main Level TS
120
121         +xh   --prefer-mpeg2-high
122                 prefer MPEG2 Main Profile @ High Level TS
123
124         +xn   --prefer-mpeg4
125                 prefer MPEG4 AVC/H.264 High Profile / Level 4.1 TS
126
127         +xl   --prefer-mpeg4-bd
128                 prefer MPEG4 AVC/H.264 BD-compatible HP / Level 4.1 TS
129
130         +x2   --prefer-mpeg4-2-2d
131                 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 2D Videos
132
133         +x3   --prefer-mpeg4-2-3d
134                 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 3D Videos
135
136         +xo   --prefer-mpeg4-2-st
137                 prefer MPEG4 AVC/H.264 Stereo HP / Level 4.2 TS
138
139         +x4   --prefer-hevc
140                 prefer HEVC H.265 Main Profile / Level 5.1 TS
141
142         +x5   --prefer-hevc10
143                 prefer HEVC H.265 Main 10 Profile / Level 5.1 TS
144
145         +xr   --prefer-rle
146                 prefer RLE lossless TS
147
148         +xd   --prefer-deflated
149                 prefer deflated explicit VR little endian TS
150
151         +xi   --implicit
152                 accept implicit VR little endian TS only
153
154         +xa   --accept-all
155                 accept all supported transfer syntaxes
156
157       proposed transmission transfer syntaxes (outgoing associations):
158
159         -x=   --propose-uncompr
160                 propose all uncompressed TS, explicit VR
161                 with local byte ordering first (default)
162
163         -xe   --propose-little
164                 propose all uncompressed TS, explicit VR little endian first
165
166         -xb   --propose-big
167                 propose all uncompressed TS, explicit VR big endian first
168
169         -xd   --propose-deflated
170                 propose deflated explicit VR little endian TS
171                 and all uncompressed transfer syntaxes
172
173         -xi   --propose-implicit
174                 propose implicit VR little endian TS only
175
176       network host access control (tcp wrapper):
177
178         -ac   --access-full
179                 accept connections from any host (default)
180
181         +ac   --access-control
182                 enforce host access control rules
183
184       port for incoming network associations:
185
186               --no-port
187                 no port for incoming associations (default)
188
189         +P    --port  [n]umber: integer
190                 port number for incoming associations
191
192       handling of illegal datasets following 'pending' move responses:
193
194         -pi   --pending-ignore
195                 assume no dataset present (default)
196
197         -pr   --pending-read
198                 read and ignore dataset
199
200       other network options:
201
202         -to   --timeout  [s]econds: integer (default: unlimited)
203                 timeout for connection requests
204
205         -ta   --acse-timeout  [s]econds: integer (default: 30)
206                 timeout for ACSE messages
207
208         -td   --dimse-timeout  [s]econds: integer (default: unlimited)
209                 timeout for DIMSE messages
210
211         -pdu  --max-pdu  [n]umber of bytes: integer (4096..131072)
212                 set max receive pdu to n bytes (default: 16384)
213
214         -dhl  --disable-host-lookup
215                 disable hostname lookup
216
217               --repeat  [n]umber: integer
218                 repeat n times
219
220               --abort
221                 abort association instead of releasing it
222
223               --ignore
224                 ignore store data, receive but do not store
225
226               --cancel  [n]umber: integer
227                 cancel after n responses (default: never)
228
229         -up   --uid-padding
230                 silently correct space-padded UIDs
231
232   output options
233       general:
234
235         -od   --output-directory  [d]irectory: string (default: ".")
236                 write received objects to existing directory d
237
238       bit preserving mode:
239
240         -B    --normal
241                 allow implicit format conversions (default)
242
243         +B    --bit-preserving
244                 write data exactly as read
245
246       output file format:
247
248         +F    --write-file
249                 write file format (default)
250
251         -F    --write-dataset
252                 write data set without file meta information
253
254       output transfer syntax
255       (not with --bit-preserving or compressed transmission):
256
257         +t=   --write-xfer-same
258                 write with same TS as input (default)
259
260         +te   --write-xfer-little
261                 write with explicit VR little endian TS
262
263         +tb   --write-xfer-big
264                 write with explicit VR big endian TS
265
266         +ti   --write-xfer-implicit
267                 write with implicit VR little endian TS
268
269         +td   --write-xfer-deflated
270                 write with deflated explicit VR little endian TS
271
272       post-1993 value representations (not with --bit-preserving):
273
274         +u    --enable-new-vr
275                 enable support for new VRs (UN/UT) (default)
276
277         -u    --disable-new-vr
278                 disable support for new VRs, convert to OB
279
280       group length encoding (not with --bit-preserving):
281
282         +g=   --group-length-recalc
283                 recalculate group lengths if present (default)
284
285         +g    --group-length-create
286                 always write with group length elements
287
288         -g    --group-length-remove
289                 always write without group length elements
290
291       length encoding in sequences and items (not with --bit-preserving):
292
293         +e    --length-explicit
294                 write with explicit lengths (default)
295
296         -e    --length-undefined
297                 write with undefined lengths
298
299       data set trailing padding
300       (not with --write-dataset or --bit-preserving):
301
302         -p    --padding-off
303                 no padding (default)
304
305         +p    --padding-create  [f]ile-pad [i]tem-pad: integer
306                 align file on multiple of f bytes and items on
307                 multiple of i bytes
308
309       deflate compression level
310       (only with --propose-deflated or --write-xfer-deflated/same):
311
312         +cl   --compression-level  [l]evel: integer (default: 6)
313                 0=uncompressed, 1=fastest, 9=best compression
314

NOTES

316       Each file supplied on the command line will be sent to the SCP as  part
317       of  a  C-MOVE  request.  The  query file must be a valid DICOM data set
318       containing the dataset part of a  C-MOVE-RQ  message.  The  query  file
319       could, for instance, be created with the dump2dcm utility from a script
320       like the following example:
321
322       # request all images for the patient with ID=PAT001
323       (0008,0052) CS [PATIENT]     # QueryRetrieveLevel
324       (0010,0020) LO [PAT001]      # PatientID
325
326       Individual attributes of each file sent can be modified or supplemented
327       using the -k (or --key) option. For example the command:
328
329       movescu -k 0010,0020=PAT002 caesar 5678 patqry.dcm
330
331       will,  when  sent  to  the  SCP  caesar  at TCP/IP port 5678, cause any
332       PatientID attribute in patqry.dcm to have the value 'PAT002'.  If  such
333       an  attribute  is  present  it  will  be replaced, if absent it will be
334       inserted. The -k option can be present more than once. The  value  part
335       (after  the  '=')  may  be absent causing the attribute to be sent with
336       zero length. It is not possible to replace or insert attributes  within
337       sequences using the -k option.
338
339       If  no  file  is  specified  on  the  command  line,  the query must be
340       specified completely with one or more -k  options.  If  multiple  query
341       files  are  provided, movescu will send multiple C-MOVE requests to the
342       SCP.
343
344       For all uses of movescu, the SCP must be configured to 'know' about the
345       AE title where the images are to be transmitted. This is required since
346       the C-MOVE request only contains the AE Title of the target and the SCP
347       must  be  able  to  convert  this AE Title into TCP/IP address and port
348       number  in  order  to  actually  send  the  images  over   a   separate
349       association.
350
351       The  C-MOVE  operation  of  the  Query/Retrieve  Service  Class is able
352       retrieve images (when option --port is used) or to initiate a  copy  of
353       images to a third party.
354
355   Known Problems
356       movescu  is  intended  to  be used as a testing tool for DICOM software
357       developers. The query keys file must be created by hand based upon  the
358       contents of the SCP.
359
360       The  movescu application makes no attempt to prevent incorrect queries.
361       In particular, the query keys of a C-MOVE request should  only  contain
362       the  QueryRetrieveLevel  attribute  and  one  or  more of the so-called
363       'unique key attributes' (PatientID, StudyInstanceUID, SeriesInstanceUID
364       and SOPInstanceUID).
365
366       In case the storage client does not end the connection while movescu is
367       playing the role of the storage server (i. e. the --port is  used)  but
368       the   client   instead  expects  movescu  to  close  down  the  storage
369       connection, movescu will wait infinitely. In  that  case  movescu  will
370       neither close the association that was used to issue the C-MOVE request
371       to the C-MOVE server.
372
373   DICOM Conformance
374   SCU Conformance
375       The movescu application supports the following SOP Classes as an SCU:
376
377       MOVEPatientRootQueryRetrieveInformationModel         1.2.840.10008.5.1.4.1.2.1.2
378       MOVEStudyRootQueryRetrieveInformationModel           1.2.840.10008.5.1.4.1.2.2.2
379       MOVEPatientStudyOnlyQueryRetrieveInformationModel    1.2.840.10008.5.1.4.1.2.3.2
380
381       The movescu application will propose presentation contexts for  one  of
382       the  abovementioned supported SOP Classes depending on the command line
383       options (-P, -S, or -O). It will also  propose  the  corresponding  SOP
384       Class  from the following list, although it is not really used (this is
385       a relict of the RSNA'93 demonstration):
386
387       FINDPatientRootQueryRetrieveInformationModel         1.2.840.10008.5.1.4.1.2.1.1
388       FINDStudyRootQueryRetrieveInformationModel           1.2.840.10008.5.1.4.1.2.2.1
389       FINDPatientStudyOnlyQueryRetrieveInformationModel    1.2.840.10008.5.1.4.1.2.3.1
390
391       For  outgoing  associations,  the  following  transfer   syntaxes   are
392       supported:
393
394       LittleEndianImplicitTransferSyntax                   1.2.840.10008.1.2
395       LittleEndianExplicitTransferSyntax                   1.2.840.10008.1.2.1
396       DeflatedExplicitVRLittleEndianTransferSyntax         1.2.840.10008.1.2.1.99 (*)
397       BigEndianExplicitTransferSyntax                      1.2.840.10008.1.2.2
398
399       (*) if compiled with zlib support enabled (see --version output)
400
401       Which  transfer  syntaxes  are  actually proposed in what order, can be
402       specified with the --propose options.
403
404   SCP Conformance
405       The movescu application supports the following SOP Classes as an SCP:
406
407       VerificationSOPClass                                 1.2.840.10008.1.1
408
409       RETIRED_StoredPrintStorage                           1.2.840.10008.5.1.1.27
410       RETIRED_HardcopyGrayscaleImageStorage                1.2.840.10008.5.1.1.29
411       RETIRED_HardcopyColorImageStorage                    1.2.840.10008.5.1.1.30
412       ComputedRadiographyImageStorage                      1.2.840.10008.5.1.4.1.1.1
413       DigitalXRayImageStorageForPresentation               1.2.840.10008.5.1.4.1.1.1.1
414       DigitalXRayImageStorageForProcessing                 1.2.840.10008.5.1.4.1.1.1.1.1
415       DigitalMammographyXRayImageStorageForPresentation    1.2.840.10008.5.1.4.1.1.1.2
416       DigitalMammographyXRayImageStorageForProcessing      1.2.840.10008.5.1.4.1.1.1.2.1
417       DigitalIntraOralXRayImageStorageForPresentation      1.2.840.10008.5.1.4.1.1.1.3
418       DigitalIntraOralXRayImageStorageForProcessing        1.2.840.10008.5.1.4.1.1.1.3.1
419       CTImageStorage                                       1.2.840.10008.5.1.4.1.1.2
420       EnhancedCTImageStorage                               1.2.840.10008.5.1.4.1.1.2.1
421       LegacyConvertedEnhancedCTImageStorage                1.2.840.10008.5.1.4.1.1.2.2
422       RETIRED_UltrasoundMultiframeImageStorage             1.2.840.10008.5.1.4.1.1.3
423       UltrasoundMultiframeImageStorage                     1.2.840.10008.5.1.4.1.1.3.1
424       MRImageStorage                                       1.2.840.10008.5.1.4.1.1.4
425       EnhancedMRImageStorage                               1.2.840.10008.5.1.4.1.1.4.1
426       MRSpectroscopyStorage                                1.2.840.10008.5.1.4.1.1.4.2
427       EnhancedMRColorImageStorage                          1.2.840.10008.5.1.4.1.1.4.3
428       LegacyConvertedEnhancedMRImageStorage                1.2.840.10008.5.1.4.1.1.4.4
429       RETIRED_NuclearMedicineImageStorage                  1.2.840.10008.5.1.4.1.1.5
430       RETIRED_UltrasoundImageStorage                       1.2.840.10008.5.1.4.1.1.6
431       UltrasoundImageStorage                               1.2.840.10008.5.1.4.1.1.6.1
432       EnhancedUSVolumeStorage                              1.2.840.10008.5.1.4.1.1.6.2
433       SecondaryCaptureImageStorage                         1.2.840.10008.5.1.4.1.1.7
434       MultiframeSingleBitSecondaryCaptureImageStorage      1.2.840.10008.5.1.4.1.1.7.1
435       MultiframeGrayscaleByteSecondaryCaptureImageStorage  1.2.840.10008.5.1.4.1.1.7.2
436       MultiframeGrayscaleWordSecondaryCaptureImageStorage  1.2.840.10008.5.1.4.1.1.7.3
437       MultiframeTrueColorSecondaryCaptureImageStorage      1.2.840.10008.5.1.4.1.1.7.4
438       RETIRED_StandaloneOverlayStorage                     1.2.840.10008.5.1.4.1.1.8
439       RETIRED_StandaloneCurveStorage                       1.2.840.10008.5.1.4.1.1.9
440       DRAFT_WaveformStorage                                1.2.840.10008.5.1.4.1.1.9.1
441       TwelveLeadECGWaveformStorage                         1.2.840.10008.5.1.4.1.1.9.1.1
442       GeneralECGWaveformStorage                            1.2.840.10008.5.1.4.1.1.9.1.2
443       AmbulatoryECGWaveformStorage                         1.2.840.10008.5.1.4.1.1.9.1.3
444       HemodynamicWaveformStorage                           1.2.840.10008.5.1.4.1.1.9.2.1
445       CardiacElectrophysiologyWaveformStorage              1.2.840.10008.5.1.4.1.1.9.3.1
446       BasicVoiceAudioWaveformStorage                       1.2.840.10008.5.1.4.1.1.9.4.1
447       GeneralAudioWaveformStorage                          1.2.840.10008.5.1.4.1.1.9.4.2
448       ArterialPulseWaveformStorage                         1.2.840.10008.5.1.4.1.1.9.5.1
449       RespiratoryWaveformStorage                           1.2.840.10008.5.1.4.1.1.9.6.1
450       RETIRED_StandaloneModalityLUTStorage                 1.2.840.10008.5.1.4.1.1.10
451       RETIRED_StandaloneVOILUTStorage                      1.2.840.10008.5.1.4.1.1.11
452       GrayscaleSoftcopyPresentationStateStorage            1.2.840.10008.5.1.4.1.1.11.1
453       ColorSoftcopyPresentationStateStorage                1.2.840.10008.5.1.4.1.1.11.2
454       PseudoColorSoftcopyPresentationStateStorage          1.2.840.10008.5.1.4.1.1.11.3
455       BlendingSoftcopyPresentationStateStorage             1.2.840.10008.5.1.4.1.1.11.4
456       XAXRFGrayscaleSoftcopyPresentationStateStorage       1.2.840.10008.5.1.4.1.1.11.5
457       GrayscalePlanarMPRVolumetricPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.6
458       CompositingPlanarMPRVolumetricPresent.StateStorage   1.2.840.10008.5.1.4.1.1.11.7
459       AdvancedBlendingPresentationStateStorage             1.2.840.10008.5.1.4.1.1.11.8
460       VolumeRenderingVolumetricPresentationStateStorage    1.2.840.10008.5.1.4.1.1.11.9
461       SegmentedVolumeRenderingVolumetricPres.StateStorage  1.2.840.10008.5.1.4.1.1.11.10
462       MultipleVolumeRenderingVolumetricPres.StateStorage   1.2.840.10008.5.1.4.1.1.11.11
463       XRayAngiographicImageStorage                         1.2.840.10008.5.1.4.1.1.12.1
464       EnhancedXAImageStorage                               1.2.840.10008.5.1.4.1.1.12.1.1
465       XRayRadiofluoroscopicImageStorage                    1.2.840.10008.5.1.4.1.1.12.2
466       EnhancedXRFImageStorage                              1.2.840.10008.5.1.4.1.1.12.2.1
467       RETIRED_XRayAngiographicBiPlaneImageStorage          1.2.840.10008.5.1.4.1.1.12.3
468       XRay3DAngiographicImageStorage                       1.2.840.10008.5.1.4.1.1.13.1.1
469       XRay3DCraniofacialImageStorage                       1.2.840.10008.5.1.4.1.1.13.1.2
470       BreastTomosynthesisImageStorage                      1.2.840.10008.5.1.4.1.1.13.1.3
471       BreastProjectionXRayImageStorageForPresentation      1.2.840.10008.5.1.4.1.1.13.1.4
472       BreastProjectionXRayImageStorageForProcessing        1.2.840.10008.5.1.4.1.1.13.1.5
473       IntravascularOpt.Coh.Tom.ImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.14.1
474       IntravascularOpt.Coh.Tom.ImageStorageForProcessing   1.2.840.10008.5.1.4.1.1.14.2
475       NuclearMedicineImageStorage                          1.2.840.10008.5.1.4.1.1.20
476       ParametricMapStorage                                 1.2.840.10008.5.1.4.1.1.30
477       RawDataStorage                                       1.2.840.10008.5.1.4.1.1.66
478       SpatialRegistrationStorage                           1.2.840.10008.5.1.4.1.1.66.1
479       SpatialFiducialsStorage                              1.2.840.10008.5.1.4.1.1.66.2
480       DeformableSpatialRegistrationStorage                 1.2.840.10008.5.1.4.1.1.66.3
481       SegmentationStorage                                  1.2.840.10008.5.1.4.1.1.66.4
482       SurfaceSegmentationStorage                           1.2.840.10008.5.1.4.1.1.66.5
483       TractographyResultsStorage                           1.2.840.10008.5.1.4.1.1.66.6
484       RealWorldValueMappingStorage                         1.2.840.10008.5.1.4.1.1.67
485       SurfaceScanMeshStorage                               1.2.840.10008.5.1.4.1.1.68.1
486       SurfaceScanPointCloudStorage                         1.2.840.10008.5.1.4.1.1.68.2
487       RETIRED_VLImageStorage                               1.2.840.10008.5.1.4.1.1.77.1
488       VLEndoscopicImageStorage                             1.2.840.10008.5.1.4.1.1.77.1.1
489       VideoEndoscopicImageStorage                          1.2.840.10008.5.1.4.1.1.77.1.1.1
490       VLMicroscopicImageStorage                            1.2.840.10008.5.1.4.1.1.77.1.2
491       VideoMicroscopicImageStorage                         1.2.840.10008.5.1.4.1.1.77.1.2.1
492       VLSlideCoordinatesMicroscopicImageStorage            1.2.840.10008.5.1.4.1.1.77.1.3
493       VLPhotographicImageStorage                           1.2.840.10008.5.1.4.1.1.77.1.4
494       VideoPhotographicImageStorage                        1.2.840.10008.5.1.4.1.1.77.1.4.1
495       OphthalmicPhotography8BitImageStorage                1.2.840.10008.5.1.4.1.1.77.1.5.1
496       OphthalmicPhotography16BitImageStorage               1.2.840.10008.5.1.4.1.1.77.1.5.2
497       StereometricRelationshipStorage                      1.2.840.10008.5.1.4.1.1.77.1.5.3
498       OphthalmicTomographyImageStorage                     1.2.840.10008.5.1.4.1.1.77.1.5.4
499       WideFieldOphthalmicPhoto.Stereogr.Proj.ImageStorage  1.2.840.10008.5.1.4.1.1.77.1.5.5
500       WideFieldOphthalmicPhotogr.3DCoordinatesImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.6
501       OphthalmicOpticalCoherenceTomogr.EnFaceImageStorage  1.2.840.10008.5.1.4.1.1.77.1.5.7
502       OphthalmicOpticalCoh.Tomogr.BscanVolumeAnalysisStor. 1.2.840.10008.5.1.4.1.1.77.1.5.8
503       VLWholeSlideMicroscopyImageStorage                   1.2.840.10008.5.1.4.1.1.77.1.6
504       RETIRED_VLMultiFrameImageStorage                     1.2.840.10008.5.1.4.1.1.77.2
505       LensometryMeasurementsStorage                        1.2.840.10008.5.1.4.1.1.78.1
506       AutorefractionMeasurementsStorage                    1.2.840.10008.5.1.4.1.1.78.2
507       KeratometryMeasurementsStorage                       1.2.840.10008.5.1.4.1.1.78.3
508       SubjectiveRefractionMeasurementsStorage              1.2.840.10008.5.1.4.1.1.78.4
509       VisualAcuityMeasurementsStorage                      1.2.840.10008.5.1.4.1.1.78.5
510       SpectaclePrescriptionReportStorage                   1.2.840.10008.5.1.4.1.1.78.6
511       OphthalmicAxialMeasurementsStorage                   1.2.840.10008.5.1.4.1.1.78.7
512       IntraocularLensCalculationsStorage                   1.2.840.10008.5.1.4.1.1.78.8
513       MacularGridThicknessAndVolumeReportStorage           1.2.840.10008.5.1.4.1.1.79.1
514       OphthalmicVisualFieldStaticPerimetryMeasurementsSt.  1.2.840.10008.5.1.4.1.1.80.1
515       OphthalmicThicknessMapStorage                        1.2.840.10008.5.1.4.1.1.81.1
516       CornealTopographyMapStorage                          1.2.840.10008.5.1.4.1.1.82.1
517       DRAFT_SRTextStorage                                  1.2.840.10008.5.1.4.1.1.88.1
518       DRAFT_SRAudioStorage                                 1.2.840.10008.5.1.4.1.1.88.2
519       DRAFT_SRDetailStorage                                1.2.840.10008.5.1.4.1.1.88.3
520       DRAFT_SRComprehensiveStorage                         1.2.840.10008.5.1.4.1.1.88.4
521       BasicTextSRStorage                                   1.2.840.10008.5.1.4.1.1.88.11
522       EnhancedSRStorage                                    1.2.840.10008.5.1.4.1.1.88.22
523       ComprehensiveSRStorage                               1.2.840.10008.5.1.4.1.1.88.33
524       Comprehensive3DSRStorage                             1.2.840.10008.5.1.4.1.1.88.34
525       ExtensibleSRStorage                                  1.2.840.10008.5.1.4.1.1.88.35
526       ProcedureLogStorage                                  1.2.840.10008.5.1.4.1.1.88.40
527       MammographyCADSRStorage                              1.2.840.10008.5.1.4.1.1.88.50
528       KeyObjectSelectionDocumentStorage                    1.2.840.10008.5.1.4.1.1.88.59
529       ChestCADSRStorage                                    1.2.840.10008.5.1.4.1.1.88.65
530       XRayRadiationDoseSRStorage                           1.2.840.10008.5.1.4.1.1.88.67
531       RadiopharmaceuticalRadiationDoseSRStorage            1.2.840.10008.5.1.4.1.1.88.68
532       ColonCADSRStorage                                    1.2.840.10008.5.1.4.1.1.88.69
533       ImplantationPlanSRDocumentStorage                    1.2.840.10008.5.1.4.1.1.88.70
534       AcquisitionContextSRStorage                          1.2.840.10008.5.1.4.1.1.88.71
535       SimplifiedAdultEchoSRStorage                         1.2.840.10008.5.1.4.1.1.88.72
536       PatientRadiationDoseSRStorage                        1.2.840.10008.5.1.4.1.1.88.73
537       ContentAssessmentResultsStorage                      1.2.840.10008.5.1.4.1.1.90.1
538       EncapsulatedPDFStorage                               1.2.840.10008.5.1.4.1.1.104.1
539       EncapsulatedCDAStorage                               1.2.840.10008.5.1.4.1.1.104.2
540       PositronEmissionTomographyImageStorage               1.2.840.10008.5.1.4.1.1.128
541       LegacyConvertedEnhancedPETImageStorage               1.2.840.10008.5.1.4.1.1.128.1
542       RETIRED_StandalonePETCurveStorage                    1.2.840.10008.5.1.4.1.1.129
543       EnhancedPETImageStorage                              1.2.840.10008.5.1.4.1.1.130
544       BasicStructuredDisplayStorage                        1.2.840.10008.5.1.4.1.1.131
545       CTPerformedProcedureProtocolStorage                  1.2.840.10008.5.1.4.1.1.200.2
546       RTImageStorage                                       1.2.840.10008.5.1.4.1.1.481.1
547       RTDoseStorage                                        1.2.840.10008.5.1.4.1.1.481.2
548       RTStructureSetStorage                                1.2.840.10008.5.1.4.1.1.481.3
549       RTBeamsTreatmentRecordStorage                        1.2.840.10008.5.1.4.1.1.481.4
550       RTPlanStorage                                        1.2.840.10008.5.1.4.1.1.481.5
551       RTBrachyTreatmentRecordStorage                       1.2.840.10008.5.1.4.1.1.481.6
552       RTTreatmentSummaryRecordStorage                      1.2.840.10008.5.1.4.1.1.481.7
553       RTIonPlanStorage                                     1.2.840.10008.5.1.4.1.1.481.8
554       RTIonBeamsTreatmentRecordStorage                     1.2.840.10008.5.1.4.1.1.481.9
555       DICOS_CTImageStorage                                 1.2.840.10008.5.1.4.1.1.501.1
556       DICOS_DigitalXRayImageStorageForPresentation         1.2.840.10008.5.1.4.1.1.501.2.1
557       DICOS_DigitalXRayImageStorageForProcessing           1.2.840.10008.5.1.4.1.1.501.2.2
558       DICOS_ThreatDetectionReportStorage                   1.2.840.10008.5.1.4.1.1.501.3
559       DICOS_2DAITStorage                                   1.2.840.10008.5.1.4.1.1.501.4
560       DICOS_3DAITStorage                                   1.2.840.10008.5.1.4.1.1.501.5
561       DICOS_QuadrupoleResonanceStorage                     1.2.840.10008.5.1.4.1.1.501.6
562       DICONDE_EddyCurrentImageStorage                      1.2.840.10008.5.1.4.1.1.601.1
563       DICONDE_EddyCurrentMultiframeImageStorage            1.2.840.10008.5.1.4.1.1.601.2
564       DRAFT_RTBeamsDeliveryInstructionStorage              1.2.840.10008.5.1.4.34.1
565       RTBeamsDeliveryInstructionStorage                    1.2.840.10008.5.1.4.34.7
566       RTBrachyApplicationSetupDeliveryInstructionStorage   1.2.840.10008.5.1.4.34.10
567
568       The movescu application will usually accept presentation  contexts  for
569       all  of  the  abovementioned  supported  SOP  Classes  using any of the
570       following transfer syntaxes:
571
572       LittleEndianImplicitTransferSyntax                   1.2.840.10008.1.2
573       LittleEndianExplicitTransferSyntax                   1.2.840.10008.1.2.1
574       BigEndianExplicitTransferSyntax                      1.2.840.10008.1.2.2
575
576       When acting as an SCP, the movescu  application  will  prefer  transfer
577       syntaxes having an explicit encoding over the default implicit transfer
578       syntax. If movescu is running on big-endian  hardware  it  will  prefer
579       BigEndianExplicit  to  LittleEndianExplicit  transfer  syntax (and vice
580       versa). This behavior can be changed with  the  --prefer  options  (see
581       above).  Using  option  --accept-all  any  of  the  following  transfer
582       syntaxes is supported:
583
584       LittleEndianImplicitTransferSyntax                   1.2.840.10008.1.2
585       LittleEndianExplicitTransferSyntax                   1.2.840.10008.1.2.1
586       DeflatedExplicitVRLittleEndianTransferSyntax         1.2.840.10008.1.2.1.99 (*)
587       BigEndianExplicitTransferSyntax                      1.2.840.10008.1.2.2
588       JPEGProcess1TransferSyntax                           1.2.840.10008.1.2.4.50
589       JPEGProcess2_4TransferSyntax                         1.2.840.10008.1.2.4.51
590       JPEGProcess14SV1TransferSyntax                       1.2.840.10008.1.2.4.70
591       JPEGLSLosslessTransferSyntax                         1.2.840.10008.1.2.4.80
592       JPEGLSLossyTransferSyntax                            1.2.840.10008.1.2.4.81
593       JPEG2000LosslessOnlyTransferSyntax                   1.2.840.10008.1.2.4.90
594       JPEG2000TransferSyntax                               1.2.840.10008.1.2.4.91
595       MPEG2MainProfileAtMainLevelTransferSyntax            1.2.840.10008.1.2.4.100
596       MPEG2MainProfileAtHighLevelTransferSyntax            1.2.840.10008.1.2.4.101
597       MPEG4HighProfileLevel4_1TransferSyntax               1.2.840.10008.1.2.4.102
598       MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax   1.2.840.10008.1.2.4.103
599       MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax    1.2.840.10008.1.2.4.104
600       MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax    1.2.840.10008.1.2.4.105
601       MPEG4StereoHighProfileLevel4_2TransferSyntax         1.2.840.10008.1.2.4.106
602       HEVCMainProfileLevel5_1TransferSyntax                1.2.840.10008.1.2.4.107
603       HEVCMain10ProfileLevel5_1TransferSyntax              1.2.840.10008.1.2.4.108
604       RLELosslessTransferSyntax                            1.2.840.10008.1.2.5
605
606       (*) if compiled with zlib support enabled (see --version output)
607
608       The movescu application does not support extended negotiation.
609
610   Access Control
611       When compiled on Unix platforms with TCP  wrapper  support,  host-based
612       access  control  can  be enabled with the --access-control command line
613       option. In this case the access control rules defined in  the  system's
614       host  access  control  tables  for  movescu  are  enforced. The default
615       locations of the host access control tables  are  /etc/hosts.allow  and
616       /etc/hosts.deny. Further details are described in hosts_access(5).
617

EXAMPLES

619       movescu --patient --port 9876 --move TEST_AE --call ARCHIVE caesar 104 q.dcm
620
621       sends  the  attributes contained in the DICOM file 'q.dcm' as part of a
622       C-MOVE request to application entity ARCHIVE on the host caesar at port
623       104 using the Patient Root query model. movescu itself uses the default
624       AE title MOVESCU. The C-MOVE request will specify that images should be
625       transferred  to  the  destination  AE  title  TEST_AE  (via  the --move
626       option).  How  the  SCP  interprets  this  request   depends   on   its
627       configuration.   movescu   will   listen  on  part  9876  for  incoming
628       associations in order to receive the requested images from the SCP.
629
630       Images can be copied to a third party by using a different  destination
631       AE  title (e.g. --move ANOTHER_AE). Of course, the SCP must 'know' this
632       AE title and the destination must be acting as an SCP  of  the  Storage
633       Service Class (the storescp application can be used for this purpose).
634

LOGGING

636       The  level  of  logging  output  of  the various command line tools and
637       underlying libraries can be specified by the  user.  By  default,  only
638       errors  and  warnings  are  written to the standard error stream. Using
639       option --verbose also informational messages  like  processing  details
640       are  reported.  Option  --debug  can be used to get more details on the
641       internal activity, e.g. for debugging purposes.  Other  logging  levels
642       can  be  selected  using option --log-level. In --quiet mode only fatal
643       errors are reported. In such very severe error events, the  application
644       will  usually  terminate.  For  more  details  on the different logging
645       levels, see documentation of module 'oflog'.
646
647       In case the logging output should be written to file  (optionally  with
648       logfile  rotation),  to syslog (Unix) or the event log (Windows) option
649       --log-config can be used.  This  configuration  file  also  allows  for
650       directing  only  certain messages to a particular output stream and for
651       filtering certain messages based on the  module  or  application  where
652       they  are  generated.  An  example  configuration  file  is provided in
653       <etcdir>/logger.cfg.
654

COMMAND LINE

656       All command line tools  use  the  following  notation  for  parameters:
657       square  brackets  enclose  optional  values  (0-1), three trailing dots
658       indicate that multiple values are allowed (1-n), a combination of  both
659       means 0 to n values.
660
661       Command line options are distinguished from parameters by a leading '+'
662       or '-' sign, respectively. Usually, order and position of command  line
663       options  are  arbitrary  (i.e.  they  can appear anywhere). However, if
664       options are mutually exclusive the rightmost appearance is  used.  This
665       behavior  conforms  to  the  standard  evaluation  rules of common Unix
666       shells.
667
668       In addition, one or more command files can be specified  using  an  '@'
669       sign  as  a  prefix to the filename (e.g. @command.txt). Such a command
670       argument is replaced by the content  of  the  corresponding  text  file
671       (multiple  whitespaces  are  treated  as a single separator unless they
672       appear between two quotation marks) prior to  any  further  evaluation.
673       Please  note  that  a command file cannot contain another command file.
674       This simple but effective  approach  allows  one  to  summarize  common
675       combinations  of  options/parameters  and  avoids longish and confusing
676       command lines (an example is provided in file <datadir>/dumppat.txt).
677

EXIT CODES

679       The movescu utility uses the following  exit  codes  when  terminating.
680       This  enables  the  user  to  check  for the reason why the application
681       terminated.
682
683   general
684       EXITCODE_NO_ERROR                         0
685       EXITCODE_COMMANDLINE_SYNTAX_ERROR         1
686       EXITCODE_INSUFFICIENT_PRIVILEGES          2
687       EXITCODE_SETUID_FAILED                    3
688
689   output file errors
690       EXITCODE_CANNOT_WRITE_OUTPUT_FILE        40
691       EXITCODE_INVALID_OUTPUT_DIRECTORY        45
692
693   network errors
694       EXITCODE_CANNOT_INITIALIZE_NETWORK       60
695       EXITCODE_CANNOT_NEGOTIATE_ASSOCIATION    61
696       EXITCODE_CANNOT_CREATE_ASSOC_PARAMETERS  65
697       EXITCODE_NO_PRESENTATION_CONTEXT         66
698       EXITCODE_CANNOT_CLOSE_ASSOCIATION        67
699       EXITCODE_CMOVE_WARNING                   68
700       EXITCODE_CMOVE_ERROR                     69
701

ENVIRONMENT

703       The movescu utility  will  attempt  to  load  DICOM  data  dictionaries
704       specified  in the DCMDICTPATH environment variable. By default, i.e. if
705       the  DCMDICTPATH  environment   variable   is   not   set,   the   file
706       <datadir>/dicom.dic  will be loaded unless the dictionary is built into
707       the application (default for Windows).
708
709       The  default  behavior  should  be  preferred   and   the   DCMDICTPATH
710       environment  variable  only used when alternative data dictionaries are
711       required. The DCMDICTPATH environment variable has the same  format  as
712       the  Unix  shell PATH variable in that a colon (':') separates entries.
713       On Windows systems, a semicolon (';') is used as a separator. The  data
714       dictionary  code  will  attempt  to  load  each  file  specified in the
715       DCMDICTPATH environment variable. It is an error if no data  dictionary
716       can be loaded.
717

SEE ALSO

719       findscu(1), storescp(1), dump2dcm(1)
720
722       Copyright  (C)  1994-2017  by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
723       Germany.
724
725
726
727Version 3.6.2                   Fri Jul 14 2017                     movescu(1)
Impressum