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       MultichannelRespiratoryWaveformStorage               1.2.840.10008.5.1.4.1.1.9.6.2
451       RoutineScalpElectroencephalogramWaveformStorage      1.2.840.10008.5.1.4.1.1.9.7.1
452       ElectromyogramWaveformStorage                        1.2.840.10008.5.1.4.1.1.9.7.2
453       ElectrooculogramWaveformStorage                      1.2.840.10008.5.1.4.1.1.9.7.3
454       SleepElectroencephalogramWaveformStorage             1.2.840.10008.5.1.4.1.1.9.7.4
455       BodyPositionWaveformStorage                          1.2.840.10008.5.1.4.1.1.9.8.1
456       RETIRED_StandaloneModalityLUTStorage                 1.2.840.10008.5.1.4.1.1.10
457       RETIRED_StandaloneVOILUTStorage                      1.2.840.10008.5.1.4.1.1.11
458       GrayscaleSoftcopyPresentationStateStorage            1.2.840.10008.5.1.4.1.1.11.1
459       ColorSoftcopyPresentationStateStorage                1.2.840.10008.5.1.4.1.1.11.2
460       PseudoColorSoftcopyPresentationStateStorage          1.2.840.10008.5.1.4.1.1.11.3
461       BlendingSoftcopyPresentationStateStorage             1.2.840.10008.5.1.4.1.1.11.4
462       XAXRFGrayscaleSoftcopyPresentationStateStorage       1.2.840.10008.5.1.4.1.1.11.5
463       GrayscalePlanarMPRVolumetricPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.6
464       CompositingPlanarMPRVolumetricPresent.StateStorage   1.2.840.10008.5.1.4.1.1.11.7
465       AdvancedBlendingPresentationStateStorage             1.2.840.10008.5.1.4.1.1.11.8
466       VolumeRenderingVolumetricPresentationStateStorage    1.2.840.10008.5.1.4.1.1.11.9
467       SegmentedVolumeRenderingVolumetricPres.StateStorage  1.2.840.10008.5.1.4.1.1.11.10
468       MultipleVolumeRenderingVolumetricPres.StateStorage   1.2.840.10008.5.1.4.1.1.11.11
469       XRayAngiographicImageStorage                         1.2.840.10008.5.1.4.1.1.12.1
470       EnhancedXAImageStorage                               1.2.840.10008.5.1.4.1.1.12.1.1
471       XRayRadiofluoroscopicImageStorage                    1.2.840.10008.5.1.4.1.1.12.2
472       EnhancedXRFImageStorage                              1.2.840.10008.5.1.4.1.1.12.2.1
473       RETIRED_XRayAngiographicBiPlaneImageStorage          1.2.840.10008.5.1.4.1.1.12.3
474       XRay3DAngiographicImageStorage                       1.2.840.10008.5.1.4.1.1.13.1.1
475       XRay3DCraniofacialImageStorage                       1.2.840.10008.5.1.4.1.1.13.1.2
476       BreastTomosynthesisImageStorage                      1.2.840.10008.5.1.4.1.1.13.1.3
477       BreastProjectionXRayImageStorageForPresentation      1.2.840.10008.5.1.4.1.1.13.1.4
478       BreastProjectionXRayImageStorageForProcessing        1.2.840.10008.5.1.4.1.1.13.1.5
479       IntravascularOpt.Coh.Tom.ImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.14.1
480       IntravascularOpt.Coh.Tom.ImageStorageForProcessing   1.2.840.10008.5.1.4.1.1.14.2
481       NuclearMedicineImageStorage                          1.2.840.10008.5.1.4.1.1.20
482       ParametricMapStorage                                 1.2.840.10008.5.1.4.1.1.30
483       RawDataStorage                                       1.2.840.10008.5.1.4.1.1.66
484       SpatialRegistrationStorage                           1.2.840.10008.5.1.4.1.1.66.1
485       SpatialFiducialsStorage                              1.2.840.10008.5.1.4.1.1.66.2
486       DeformableSpatialRegistrationStorage                 1.2.840.10008.5.1.4.1.1.66.3
487       SegmentationStorage                                  1.2.840.10008.5.1.4.1.1.66.4
488       SurfaceSegmentationStorage                           1.2.840.10008.5.1.4.1.1.66.5
489       TractographyResultsStorage                           1.2.840.10008.5.1.4.1.1.66.6
490       RealWorldValueMappingStorage                         1.2.840.10008.5.1.4.1.1.67
491       SurfaceScanMeshStorage                               1.2.840.10008.5.1.4.1.1.68.1
492       SurfaceScanPointCloudStorage                         1.2.840.10008.5.1.4.1.1.68.2
493       RETIRED_VLImageStorage                               1.2.840.10008.5.1.4.1.1.77.1
494       VLEndoscopicImageStorage                             1.2.840.10008.5.1.4.1.1.77.1.1
495       VideoEndoscopicImageStorage                          1.2.840.10008.5.1.4.1.1.77.1.1.1
496       VLMicroscopicImageStorage                            1.2.840.10008.5.1.4.1.1.77.1.2
497       VideoMicroscopicImageStorage                         1.2.840.10008.5.1.4.1.1.77.1.2.1
498       VLSlideCoordinatesMicroscopicImageStorage            1.2.840.10008.5.1.4.1.1.77.1.3
499       VLPhotographicImageStorage                           1.2.840.10008.5.1.4.1.1.77.1.4
500       VideoPhotographicImageStorage                        1.2.840.10008.5.1.4.1.1.77.1.4.1
501       OphthalmicPhotography8BitImageStorage                1.2.840.10008.5.1.4.1.1.77.1.5.1
502       OphthalmicPhotography16BitImageStorage               1.2.840.10008.5.1.4.1.1.77.1.5.2
503       StereometricRelationshipStorage                      1.2.840.10008.5.1.4.1.1.77.1.5.3
504       OphthalmicTomographyImageStorage                     1.2.840.10008.5.1.4.1.1.77.1.5.4
505       WideFieldOphthalmicPhoto.Stereogr.Proj.ImageStorage  1.2.840.10008.5.1.4.1.1.77.1.5.5
506       WideFieldOphthalmicPhotogr.3DCoordinatesImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.6
507       OphthalmicOpticalCoherenceTomogr.EnFaceImageStorage  1.2.840.10008.5.1.4.1.1.77.1.5.7
508       OphthalmicOpticalCoh.Tomogr.BscanVolumeAnalysisStor. 1.2.840.10008.5.1.4.1.1.77.1.5.8
509       VLWholeSlideMicroscopyImageStorage                   1.2.840.10008.5.1.4.1.1.77.1.6
510       DermoscopicPhotographyImageStorage                   1.2.840.10008.5.1.4.1.1.77.1.7
511       RETIRED_VLMultiframeImageStorage                     1.2.840.10008.5.1.4.1.1.77.2
512       LensometryMeasurementsStorage                        1.2.840.10008.5.1.4.1.1.78.1
513       AutorefractionMeasurementsStorage                    1.2.840.10008.5.1.4.1.1.78.2
514       KeratometryMeasurementsStorage                       1.2.840.10008.5.1.4.1.1.78.3
515       SubjectiveRefractionMeasurementsStorage              1.2.840.10008.5.1.4.1.1.78.4
516       VisualAcuityMeasurementsStorage                      1.2.840.10008.5.1.4.1.1.78.5
517       SpectaclePrescriptionReportStorage                   1.2.840.10008.5.1.4.1.1.78.6
518       OphthalmicAxialMeasurementsStorage                   1.2.840.10008.5.1.4.1.1.78.7
519       IntraocularLensCalculationsStorage                   1.2.840.10008.5.1.4.1.1.78.8
520       MacularGridThicknessAndVolumeReportStorage           1.2.840.10008.5.1.4.1.1.79.1
521       OphthalmicVisualFieldStaticPerimetryMeasurementsSt.  1.2.840.10008.5.1.4.1.1.80.1
522       OphthalmicThicknessMapStorage                        1.2.840.10008.5.1.4.1.1.81.1
523       CornealTopographyMapStorage                          1.2.840.10008.5.1.4.1.1.82.1
524       DRAFT_SRTextStorage                                  1.2.840.10008.5.1.4.1.1.88.1
525       DRAFT_SRAudioStorage                                 1.2.840.10008.5.1.4.1.1.88.2
526       DRAFT_SRDetailStorage                                1.2.840.10008.5.1.4.1.1.88.3
527       DRAFT_SRComprehensiveStorage                         1.2.840.10008.5.1.4.1.1.88.4
528       BasicTextSRStorage                                   1.2.840.10008.5.1.4.1.1.88.11
529       EnhancedSRStorage                                    1.2.840.10008.5.1.4.1.1.88.22
530       ComprehensiveSRStorage                               1.2.840.10008.5.1.4.1.1.88.33
531       Comprehensive3DSRStorage                             1.2.840.10008.5.1.4.1.1.88.34
532       ExtensibleSRStorage                                  1.2.840.10008.5.1.4.1.1.88.35
533       ProcedureLogStorage                                  1.2.840.10008.5.1.4.1.1.88.40
534       MammographyCADSRStorage                              1.2.840.10008.5.1.4.1.1.88.50
535       KeyObjectSelectionDocumentStorage                    1.2.840.10008.5.1.4.1.1.88.59
536       ChestCADSRStorage                                    1.2.840.10008.5.1.4.1.1.88.65
537       XRayRadiationDoseSRStorage                           1.2.840.10008.5.1.4.1.1.88.67
538       RadiopharmaceuticalRadiationDoseSRStorage            1.2.840.10008.5.1.4.1.1.88.68
539       ColonCADSRStorage                                    1.2.840.10008.5.1.4.1.1.88.69
540       ImplantationPlanSRDocumentStorage                    1.2.840.10008.5.1.4.1.1.88.70
541       AcquisitionContextSRStorage                          1.2.840.10008.5.1.4.1.1.88.71
542       SimplifiedAdultEchoSRStorage                         1.2.840.10008.5.1.4.1.1.88.72
543       PatientRadiationDoseSRStorage                        1.2.840.10008.5.1.4.1.1.88.73
544       PlannedImagingAgentAdministrationSRStorage           1.2.840.10008.5.1.4.1.1.88.74
545       PerformedImagingAgentAdministrationSRStorage         1.2.840.10008.5.1.4.1.1.88.75
546       EnhancedXRayRadiationDoseSRStorage                   1.2.840.10008.5.1.4.1.1.88.76
547       ContentAssessmentResultsStorage                      1.2.840.10008.5.1.4.1.1.90.1
548       MicroscopyBulkSimpleAnnotationsStorage               1.2.840.10008.5.1.4.1.1.91.1
549       EncapsulatedPDFStorage                               1.2.840.10008.5.1.4.1.1.104.1
550       EncapsulatedCDAStorage                               1.2.840.10008.5.1.4.1.1.104.2
551       EncapsulatedSTLStorage                               1.2.840.10008.5.1.4.1.1.104.3
552       EncapsulatedOBJStorage                               1.2.840.10008.5.1.4.1.1.104.4
553       EncapsulatedMTLStorage                               1.2.840.10008.5.1.4.1.1.104.5
554       PositronEmissionTomographyImageStorage               1.2.840.10008.5.1.4.1.1.128
555       LegacyConvertedEnhancedPETImageStorage               1.2.840.10008.5.1.4.1.1.128.1
556       RETIRED_StandalonePETCurveStorage                    1.2.840.10008.5.1.4.1.1.129
557       EnhancedPETImageStorage                              1.2.840.10008.5.1.4.1.1.130
558       BasicStructuredDisplayStorage                        1.2.840.10008.5.1.4.1.1.131
559       CTPerformedProcedureProtocolStorage                  1.2.840.10008.5.1.4.1.1.200.2
560       XAPerformedProcedureProtocolStorage                  1.2.840.10008.5.1.4.1.1.200.8
561       RTImageStorage                                       1.2.840.10008.5.1.4.1.1.481.1
562       RTDoseStorage                                        1.2.840.10008.5.1.4.1.1.481.2
563       RTStructureSetStorage                                1.2.840.10008.5.1.4.1.1.481.3
564       RTBeamsTreatmentRecordStorage                        1.2.840.10008.5.1.4.1.1.481.4
565       RTPlanStorage                                        1.2.840.10008.5.1.4.1.1.481.5
566       RTBrachyTreatmentRecordStorage                       1.2.840.10008.5.1.4.1.1.481.6
567       RTTreatmentSummaryRecordStorage                      1.2.840.10008.5.1.4.1.1.481.7
568       RTIonPlanStorage                                     1.2.840.10008.5.1.4.1.1.481.8
569       RTIonBeamsTreatmentRecordStorage                     1.2.840.10008.5.1.4.1.1.481.9
570       RTPhysicianIntentStorage                             1.2.840.10008.5.1.4.1.1.481.10
571       RTSegmentAnnotationStorage                           1.2.840.10008.5.1.4.1.1.481.11
572       RTRadiationSetStorage                                1.2.840.10008.5.1.4.1.1.481.12
573       CArmPhotonElectronRadiationStorage                   1.2.840.10008.5.1.4.1.1.481.13
574       TomotherapeuticRadiationStorage                      1.2.840.10008.5.1.4.1.1.481.14
575       RoboticArmRadiationStorage                           1.2.840.10008.5.1.4.1.1.481.15
576       RTRadiationRecordSetStorage                          1.2.840.10008.5.1.4.1.1.481.16
577       RTRadiationSalvageRecordStorage                      1.2.840.10008.5.1.4.1.1.481.17
578       TomotherapeuticRadiationRecordStorage                1.2.840.10008.5.1.4.1.1.481.18
579       CArmPhotonElectronRadiationRecordStorage             1.2.840.10008.5.1.4.1.1.481.19
580       RoboticRadiationRecordStorage                        1.2.840.10008.5.1.4.1.1.481.20
581       RTRadiationSetDeliveryInstructionStorage             1.2.840.10008.5.1.4.1.1.481.21
582       RTTreatmentPreparationStorage                        1.2.840.10008.5.1.4.1.1.481.22
583       DICOS_CTImageStorage                                 1.2.840.10008.5.1.4.1.1.501.1
584       DICOS_DigitalXRayImageStorageForPresentation         1.2.840.10008.5.1.4.1.1.501.2.1
585       DICOS_DigitalXRayImageStorageForProcessing           1.2.840.10008.5.1.4.1.1.501.2.2
586       DICOS_ThreatDetectionReportStorage                   1.2.840.10008.5.1.4.1.1.501.3
587       DICOS_2DAITStorage                                   1.2.840.10008.5.1.4.1.1.501.4
588       DICOS_3DAITStorage                                   1.2.840.10008.5.1.4.1.1.501.5
589       DICOS_QuadrupoleResonanceStorage                     1.2.840.10008.5.1.4.1.1.501.6
590       DICONDE_EddyCurrentImageStorage                      1.2.840.10008.5.1.4.1.1.601.1
591       DICONDE_EddyCurrentMultiframeImageStorage            1.2.840.10008.5.1.4.1.1.601.2
592       DRAFT_RTBeamsDeliveryInstructionStorage              1.2.840.10008.5.1.4.34.1
593       RTBeamsDeliveryInstructionStorage                    1.2.840.10008.5.1.4.34.7
594       RTBrachyApplicationSetupDeliveryInstructionStorage   1.2.840.10008.5.1.4.34.10
595
596       The movescu application will usually accept presentation  contexts  for
597       all  of  the  abovementioned  supported  SOP  Classes  using any of the
598       following transfer syntaxes:
599
600       LittleEndianImplicitTransferSyntax                   1.2.840.10008.1.2
601       LittleEndianExplicitTransferSyntax                   1.2.840.10008.1.2.1
602       BigEndianExplicitTransferSyntax                      1.2.840.10008.1.2.2
603
604       When acting as an SCP, the movescu  application  will  prefer  transfer
605       syntaxes having an explicit encoding over the default implicit transfer
606       syntax. If movescu is running on big-endian  hardware  it  will  prefer
607       BigEndianExplicit  to  LittleEndianExplicit  transfer  syntax (and vice
608       versa). This behavior can be changed with  the  --prefer  options  (see
609       above).  Using  option  --accept-all  any  of  the  following  transfer
610       syntaxes is supported:
611
612       LittleEndianImplicitTransferSyntax                   1.2.840.10008.1.2
613       LittleEndianExplicitTransferSyntax                   1.2.840.10008.1.2.1
614       DeflatedExplicitVRLittleEndianTransferSyntax         1.2.840.10008.1.2.1.99 (*)
615       BigEndianExplicitTransferSyntax                      1.2.840.10008.1.2.2
616       JPEGProcess1TransferSyntax                           1.2.840.10008.1.2.4.50
617       JPEGProcess2_4TransferSyntax                         1.2.840.10008.1.2.4.51
618       JPEGProcess14SV1TransferSyntax                       1.2.840.10008.1.2.4.70
619       JPEGLSLosslessTransferSyntax                         1.2.840.10008.1.2.4.80
620       JPEGLSLossyTransferSyntax                            1.2.840.10008.1.2.4.81
621       JPEG2000LosslessOnlyTransferSyntax                   1.2.840.10008.1.2.4.90
622       JPEG2000TransferSyntax                               1.2.840.10008.1.2.4.91
623       MPEG2MainProfileAtMainLevelTransferSyntax            1.2.840.10008.1.2.4.100
624       MPEG2MainProfileAtHighLevelTransferSyntax            1.2.840.10008.1.2.4.101
625       MPEG4HighProfileLevel4_1TransferSyntax               1.2.840.10008.1.2.4.102
626       MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax   1.2.840.10008.1.2.4.103
627       MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax    1.2.840.10008.1.2.4.104
628       MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax    1.2.840.10008.1.2.4.105
629       MPEG4StereoHighProfileLevel4_2TransferSyntax         1.2.840.10008.1.2.4.106
630       HEVCMainProfileLevel5_1TransferSyntax                1.2.840.10008.1.2.4.107
631       HEVCMain10ProfileLevel5_1TransferSyntax              1.2.840.10008.1.2.4.108
632       RLELosslessTransferSyntax                            1.2.840.10008.1.2.5
633
634       (*) if compiled with zlib support enabled (see --version output)
635
636       The movescu application does not support extended negotiation.
637
638   Access Control
639       When compiled on Unix platforms with TCP  wrapper  support,  host-based
640       access  control  can  be enabled with the --access-control command line
641       option. In this case the access control rules defined in  the  system's
642       host  access  control  tables  for  movescu  are  enforced. The default
643       locations of the host access control tables  are  /etc/hosts.allow  and
644       /etc/hosts.deny. Further details are described in hosts_access(5).
645

EXAMPLES

647       movescu --patient --port 9876 --move TEST_AE --call ARCHIVE caesar 104 q.dcm
648
649       sends  the  attributes contained in the DICOM file 'q.dcm' as part of a
650       C-MOVE request to application entity ARCHIVE on the host caesar at port
651       104 using the Patient Root query model. movescu itself uses the default
652       AE title MOVESCU. The C-MOVE request will specify that images should be
653       transferred  to  the  destination  AE  title  TEST_AE  (via  the --move
654       option).  How  the  SCP  interprets  this  request   depends   on   its
655       configuration.   movescu   will   listen  on  part  9876  for  incoming
656       associations in order to receive the requested images from the SCP.
657
658       Images can be copied to a third party by using a different  destination
659       AE  title (e.g. --move ANOTHER_AE). Of course, the SCP must 'know' this
660       AE title and the destination must be acting as an SCP  of  the  Storage
661       Service Class (the storescp application can be used for this purpose).
662

LOGGING

664       The  level  of  logging  output  of  the various command line tools and
665       underlying libraries can be specified by the  user.  By  default,  only
666       errors  and  warnings  are  written to the standard error stream. Using
667       option --verbose also informational messages  like  processing  details
668       are  reported.  Option  --debug  can be used to get more details on the
669       internal activity, e.g. for debugging purposes.  Other  logging  levels
670       can  be  selected  using option --log-level. In --quiet mode only fatal
671       errors are reported. In such very severe error events, the  application
672       will  usually  terminate.  For  more  details  on the different logging
673       levels, see documentation of module 'oflog'.
674
675       In case the logging output should be written to file  (optionally  with
676       logfile  rotation),  to syslog (Unix) or the event log (Windows) option
677       --log-config can be used.  This  configuration  file  also  allows  for
678       directing  only  certain messages to a particular output stream and for
679       filtering certain messages based on the  module  or  application  where
680       they  are  generated.  An  example  configuration  file  is provided in
681       <etcdir>/logger.cfg.
682

COMMAND LINE

684       All command line tools  use  the  following  notation  for  parameters:
685       square  brackets  enclose  optional  values  (0-1), three trailing dots
686       indicate that multiple values are allowed (1-n), a combination of  both
687       means 0 to n values.
688
689       Command line options are distinguished from parameters by a leading '+'
690       or '-' sign, respectively. Usually, order and position of command  line
691       options  are  arbitrary  (i.e.  they  can appear anywhere). However, if
692       options are mutually exclusive the rightmost appearance is  used.  This
693       behavior  conforms  to  the  standard  evaluation  rules of common Unix
694       shells.
695
696       In addition, one or more command files can be specified  using  an  '@'
697       sign  as  a  prefix to the filename (e.g. @command.txt). Such a command
698       argument is replaced by the content  of  the  corresponding  text  file
699       (multiple  whitespaces  are  treated  as a single separator unless they
700       appear between two quotation marks) prior to  any  further  evaluation.
701       Please  note  that  a command file cannot contain another command file.
702       This simple but effective  approach  allows  one  to  summarize  common
703       combinations  of  options/parameters  and  avoids longish and confusing
704       command lines (an example is provided in file <datadir>/dumppat.txt).
705

EXIT CODES

707       The movescu utility uses the following  exit  codes  when  terminating.
708       This  enables  the  user  to  check  for the reason why the application
709       terminated.
710
711   general
712       EXITCODE_NO_ERROR                         0
713       EXITCODE_COMMANDLINE_SYNTAX_ERROR         1
714       EXITCODE_INSUFFICIENT_PRIVILEGES          2
715       EXITCODE_SETUID_FAILED                    3
716
717   output file errors
718       EXITCODE_CANNOT_WRITE_OUTPUT_FILE        40
719       EXITCODE_INVALID_OUTPUT_DIRECTORY        45
720
721   network errors
722       EXITCODE_CANNOT_INITIALIZE_NETWORK       60
723       EXITCODE_CANNOT_NEGOTIATE_ASSOCIATION    61
724       EXITCODE_CANNOT_CREATE_ASSOC_PARAMETERS  65
725       EXITCODE_NO_PRESENTATION_CONTEXT         66
726       EXITCODE_CANNOT_CLOSE_ASSOCIATION        67
727       EXITCODE_CMOVE_WARNING                   68
728       EXITCODE_CMOVE_ERROR                     69
729

ENVIRONMENT

731       The movescu utility  will  attempt  to  load  DICOM  data  dictionaries
732       specified  in the DCMDICTPATH environment variable. By default, i.e. if
733       the  DCMDICTPATH  environment   variable   is   not   set,   the   file
734       <datadir>/dicom.dic  will be loaded unless the dictionary is built into
735       the application (default for Windows).
736
737       The  default  behavior  should  be  preferred   and   the   DCMDICTPATH
738       environment  variable  only used when alternative data dictionaries are
739       required. The DCMDICTPATH environment variable has the same  format  as
740       the  Unix  shell PATH variable in that a colon (':') separates entries.
741       On Windows systems, a semicolon (';') is used as a separator. The  data
742       dictionary  code  will  attempt  to  load  each  file  specified in the
743       DCMDICTPATH environment variable. It is an error if no data  dictionary
744       can be loaded.
745

SEE ALSO

747       findscu(1), storescp(1), dump2dcm(1)
748
750       Copyright  (C)  1994-2022  by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
751       Germany.
752
753
754
755Version 3.6.7                   Fri Apr 22 2022                     movescu(1)
Impressum