DICOM Service Class Provider

Description

DICOMSCP :: Process all C-Service request specified by DICOM.

DICOMSCP [-i IP] -p Port [-d LogDir]  [-l LogMode]
 [-s StorageDir] [-c DBConString] -h AETitle [{-m AETilte@IP:Port}] [-t TimeOut]
[-n IsClientAuthReq] [-k Keystore] [-q keystorepass]  [-r TrustCert] [-e SOPClas
sUID] 

-i                IP Address, default IP address is localhost.
-p                Port
-d                Log directory
                  User's temp directory is taken as default.
-l                Log mode
LogMode           I INFO
                  S SEVER
                  Default Logging Mode is INFO.
-s                Storage directory of DICOM files.
                  User's temp directory is taken as default.
-c                Data base connection string.
-h                Calling(host) AE Title.
-m                Move destination title.
                  For eg. - SDK@localhost:9002
-t                Session time out in milliseconds
-e                SOP Class UID for which extended negotiation is supported
-n                is client authentication required.
CertReq           T TRUE
                  F FALSE
                  Default is FALSE.
-k                path to Keystore for SCP(JKS)
-q                password to open Keystore
-r                path to trusted certificate (multiple trusted certificates ca
                  n be added using -r option multiple times)

Example :

These examples are demonstration of simple C-Store Operation.

1. DICOMSCP -p 9000 -c jdbc:derby://localhost:5050/C:/Database/SDKdb -h SDK
Starts server at localhost listening on port 9000, with SDK as AE Title and
jdbc:derby://localhost:5050/C:/Database/SDKdb data base connection string.

2. DICOMSCP -p 9000 -h SDK
Starts server at localhost listening on port 9000, with SDK as AE Title.
The server process verification and storage request.

3. DICOMSCP -p 9000 -c jdbc:derby://localhost:5050/C:/Database/SDKdb -h SDK
-m XYZ:9002
Starts server at localhost listening on port 9000, SDK as AE Title
and jdbc:derby://localhost:5050/C:/Database/SDKdb data base connection string.
Storage server for move operation started at localhost listening on port 9002

This example is demonstration of C-Store operation with Digital Signature
support.

4. DICOMSCP -p 9000 -h SDK -e 1.2.840.10008.5.1.4.1.1.12.1
Starts server at localhost listening on port 9000, with SDK as AE Title.
The server process verification and storage request for Digitally Signed DataSet
with SOP class UID 1.2.840.10008.5.1.4.1.1.12.1

This example is demonstration of C-Store operation with TLS support.

5. DICOMSCP -p 4546 -h SDK -n T -k C:\Serverkeystore -q private -r C:\ClientCert
.cer
Starts server at localhost listening on port 4546, with SDK as AE Title.The
server process verification and storage request over secure socket connection.


======================================================================================================

CSTORE Service Class User

CSTORESCU :: Sends Storage request to DICOM SCP.

CSTORESCU [-i IP] -p Port [-d LogDir] [-l LogMode]
 -h AETitle -r AETitle -f DICOMFile [-t TimeOut]   [-k PrivateKey]
[-c Certificate][-s SignProfile] [-a MACalg] [-n KeyStorePath]
[-u TrustedCert] [-q Password] 
-i                IP Address, default IP address is localhost.
-p                Port
-d                Log directory
                  User's temp directory is taken as default.
-l                Log mode
LogMode           I INFO
                  S SEVER
                  Default Logging Mode is INFO.
-h                Calling(host) AE Title
-r                Called AE Title
-f                DICOM File which is to be stored at the server
-k                private key(base64 encoded) file path
-c                certificate file path
-s                Digital Signature Profile to be used for MAC calculation
Profiles          BASE
                  CREATOR
                  AUTHORIZATION
                  Default profile is BASE.
-a                Message Authentication Code algorithm
Algorithms        MD5
                  SHA1
                  Default algorithm is SHA1.
-t                Session time out in milliseconds
-n                path to Keystore for SCU(JKS)
-q                password to open Keystore
-u                path to trusted certificate (multiple trusted certificates ca
                  n be added using -r option multiple times)


Example :

This example is demonstration of simple C-Store Operation.
1. CSTORESCU -p 9000 -h ABC -r SDK -f image.dcm
Client ABC, sends DICOM file image.dcm to store at AE SDK listening on port 9000


This example is demonstration of C-Store operation with Digital Signature
support.
2. CSTORESCU -p 9000 -h ABC -r SDK -f image.dcm -k private.key -c certificate.cer 
-s BASE -a SHA1
Client ABC, sends DICOM file image.dcm to store at AE SDK listening on port 9000
 by digitally signing dataset with private key using BASE digital signature
profile and SHA1 MAC algorithm.

This example is demonstration of C-Store operation with TLS support.
3. CSTORESCU -p 4546 -h ABC -r SDK -f image.dcm -n Clientkeystore -q private -u
ServerCert.cer
Client ABC, sends DICOM file image.dcm to store at AE SDK listening on port 4546
 over secure socket connection with SCP.
This example is demonstration of simple C-Store Operation.

======================================================================================================

CECHO Service Class User

CECHOSCU :: Sends verification request to DICOM SCP.

CECHOSCU [-i IP] -p Port [-d LogDir] [-l LogMode]
 -h AETitle -r AETitle [-t TimeOut] 

-i                IP Address, default IP address is localhost.
-p                Port
-d                Log directory
                  User's temp directory is taken as default.
-l                Log mode
LogMode           I INFO
                  S SEVER
                  Default Logging Mode is INFO.
-h                Calling(host) AE Title
-r                Called AE Title
-t                Session time out in milliseconds

Example :

1. CECHOSCU -p 9000 -h ABC -r SDK
Client ABC, verifies connection with AE SDK, running on localhost and listening
on port 9000.

======================================================================================================

CFIND Service Class User

Description

CFINDSCU :: Sends query request to DICOM SCP.

CFINDSCU [-i IP] -p Port [-d LogDir] [-l LogMode]
 -h AETitle -r AETitle -k GroupNo,ElementNo:Value {-q GroupNo:ElementNo}
 -a SOPClassUID [-t TimeOut] 

-i                IP Address, default IP address is localhost.
-p                Port
-d                Log directory
                  User's temp directory is taken as default.
-l                Log mode
LogMode           I INFO
                  S SEVER
                  Default Logging Mode is INFO.
-h                Calling(host) AE Title
-r                Called AE Title
-k                Key Attribute
                  For eg.- 0010,0020:abc
-q                Required Attribute
                  For eg.- 0010:0020
-a                Affected SOP class UID
-t                Session time out in milliseconds

Example :

1. CFINDSCU -p 9000 -h ABC -r SDK -k 0008,0020:19930325 -q 0010,0020
-q 0008,0030 -a 1.2.840.10008.5.1.4.1.2.1.1

Client ABC, query the AE SDK running on localhost and listening on port 9000,
for attribute 0008, 0020 having value 19930325. Retrieve value of attributes
0010, 0020 and 0008,0030 for C-Find SOP class UID 1.2.840.10008.5.1.4.1.2.1.1.


======================================================================================================

CGET Service Class User

Description
CGETSCU :: Sends C-Get request to DICOM SCP.

CGETSCU [-i IP] -p Port [-d LogDir] [-l LogMode]
 -h AETitle -r AETitle -k GroupNo,ElementNo:Value [-s StorageDir]
 -c DBConString -a SOPClassUID -g SOPClassUID:TS [-t TimeOut] 
 
-i                IP Address, default IP address is localhost.
-p                Port
-d                Log directory
                  User's temp directory is taken as default.
-l                Log mode
LogMode           I INFO
                  S SEVER
                  Default Logging Mode is INFO.
-h                Calling(host) AE Title
-r                Called AE Title
-k                Key Attribute
                  For eg.- 0010,0020:abc
-s                Storage directory of DICOM files
                  User's temp directory is taken as default.
-c                Data base connection string
-a                Affected SOP class UID
-g                SOP Class UID and Transfer syntax of DICOM files to be retriev

                  ed.
                  For eg.- 1.2.840.10008.5.1.4.1.1.12.1:1.2.840.10008.1.2.4.50
-t                Session time out in milliseconds

Example :

1. CGETSCU -p 9000 -h ABC -r SDK -k 0008,0018:1.3.12.2.1107.5.4.3.284980.19951129.170916 
-a 1.2.840.10008.5.1.4.1.2.1.3 -g 1.2.840.10008.5.1.4.1.1.12.1:1.2.840.10008.1.2.4.50

Client ABC, request the AE SDK running on localhost and listening on port 9000,
to retrieve DICOM file having attribute 0008, 0018 and value
1.3.12.2.1107.5.4.3.284980.19951129.170916, for C-Get SOP class UID
1.2.840.10008.5.1.4.1.2.1.3. Retrieve request for DICOM Files having SOP class
UID 1.2.840.10008.5.1.4.1.1.12.1 and Transfer syntax 1.2.840.10008.1.2.4.50.


======================================================================================================

CMOVE Service Class User

Description
CMOVESCU :: Sends Move request to DICOM SCP.

CMOVESCU [-i IP] -p Port [-d LogDir] [-l LogMode]
 -h AETitle -r AETitle -k GroupNo,ElementNo:Value  -o MoveDest -a SOPClassUID /n
 [-t TimeOut] 
-i                IP Address, default IP address is localhost.
-p                Port
-d                Log directory
                  User's temp directory is taken as default.
-l                Log mode
LogMode           I INFO
                  S SEVER
                  Default Logging Mode is INFO.
-h                Calling(host) AE Title
-r                Called AE Title
-k                Key Attribute
                  For eg.- 0010,0020:abc
-o                Move destination for DICOM files
-a                Affected SOP class UID
-t                Session time out in milliseconds

Example :

1. CMOVESCU -p 9000 -h ABC -r SDK -k 0008,0018:1.3.12.2.1107.5.4.3.284980.199511
29.170916.9 -a 1.2.840.10008.5.1.4.1.2.1.2 -o XYZ

Client ABC, request AE SDK running on localhost listening on port 9000, to move
the DICOM Object having attribute 0008, 0018 and value 1.3.12.2.1107.5.4.3.28498
0.19951129.170916.9, on third party move destination server named XYZ for C-Move
 SOP class UID 1.2.840.10008.5.1.4.1.2.1.2.

======================================================================================================

DICOM Editor

Description
DICOMEDITOR :: Edits DICOM file. This can add , remove or update Data Elements i
n DICOM file.

DICOMEDITOR [-d LogDir] [-l LogMode] -f DICOMFile
 -u GroupNo,ElementNo:Value  [-s AtrributeName:Value]
[-e GroupNo,ElementNo] [-h "AttributeName"] 

-d                Log directory
                  User's temp directory is taken as default.
-l                Log mode
LogMode           I INFO
                  S SEVER
                  Default Logging Mode is INFO
-f                DICOM File which is to be updated.
-u                Tag value which is to be modified or added to the DICOM file.
                  For eg - 0008,0030:123456
-s                Data Element(attribute) which is to be modified or added to
                  the DICOM file.
                  For eg -  "Study Time:126457"
-e                Tag value which is to be removed to the file.
                  For eg - 0008,0030
-h                Data Element(attribute) which is to be removed to the file.
                  For eg - "Study Time"


Example :

1. DICOMEDITOR -f image.dcm -u 0008,0030:123456
Edit the DICOM file image.dcm. Add attribute 0008, 0030 with value 123456
if it is not present in the file otherwise update it.

2. DICOMEDITOR -f image.dcm -s "Study Time:126457"
Edit the DICOM file image.dcm. Add attribute Study Time with value 126457
if it is not present in the file otherwise update it.

3. DICOMEDITOR -f image.dcm -e 0008,0030
Edit the DICOM file image.dcm. Remove attribute 0008, 0030 from the DICOM file.

4. DICOMEDITOR -f image.dcm -h "Study Time"
Edit the DICOM file image.dcm. Remove attribute Study Time from the DICOM file.

======================================================================================================

DICOM Validator

Description
DICOMVALIDATOR :: Validates DICOM file according to the validation mode specifie
d.

DICOMVALIDATOR [-d LogDir] [-l LogMode] -f DICOMFile 

-d                Log directory
                  User's temp directory is taken as default.
-l                Log mode
LogMode           I INFO
                  S SEVER
                  Default Logging Mode is INFO.
-f                DICOM File which is to be validated.

Example :

1. DICOMVALIDATOR S -f image.dcm
Validates image.dcm file.

=========================================================================================================

Dicom Security Profile

DICOMSECURE :: Secures DICOM file by encryption/digest/signature generation.

DICOMSECURE [-d LogDir]  [-l LogMode] [-o Operation to perfor
m] -f DICOMFile
 [-k SecretKeyFilePath] [-p Public/private key file path]
[-s path to store digest/signature] [-g Algo] 

-d                Log directory
                  User's temp directory is taken as default.
-l                Log mode
LogMode           I INFO
                  S SEVER
                  Default Logging Mode is INFO
-o                Operation to perform
Operation         E Encrypt
                  D Decrypt
                  S Generate digital signature
                  V verify Digital Signature
                  F Generate digest
                  P Verify digest
-f                Source DICOM file for specified operation.
-k                Secret key file path for encryption/decryption
-p                Public/Private key for digital signature generation or verifi
                  cation
-s                Source/Destination path for digital signature/digest generati
                  on/verification or path to store encrypted/decrypted Dicom fi
                  le.
-a                Algorithm for encryption/decryption
Algorithm         AES
                  DES
                  TRIPPLE_DES
                  Default algorithm is AES.

Example :

1. Secure DICOM file by using encryption/Decryption

a. Secures the DICOM file by encrypting it using secret key
    DICOMSECURE.bat -o E -f 0003.dcm -k Secret.key -s C:\encryptedfile.dcm

b. Decrypts the DICOM file which is secured using secret key
    DICOMSECURE.bat -o D -f C:\encryptedfile.dcm -k Secret.key -s C:\decrypted.dcm

2.Generate/Verify Digital signature for DICOM file

 a. Generate Digital Signature using Private Key
    DICOMSECURE.bat -o S -f 0003.dcm -p private.key  -s C:\signature

 b. Verify Digital Signature using Public key
    DICOMSECURE.bat -o V -f 0003.dcm -p public.key  -s C:\signature

3. Genarate/Verify Digest for DICOM File

 a. Generate Digest for DICOM File
    DICOMSECURE.bat -o F -f 0003.dcm -s C:\digest

 b. Verify Digest for DICOM file
    DICOMSECURE.bat -o P -f 0003.dcm -s C:\digest



=========================================================================================================

DICOM file to XML Convertor

DCM2XML :: Converts the DICOM file to XML document.

DCM2XML [-d LogDir] [-l LogMode] -f DCMfile [-s DestinationF
older] 

-d                Log directory
                  User's temp directory is taken as default.
-l                Log mode
LogMode           I INFO
                  S SEVER
                  Default Logging Mode is INFO
-f                Source DICOM file for XML conversion.
-s                Destination folder path to store converted xml file.
                  User's temp directory is taken as default.

Example :

1. DCM2XML -f image.dcm -s C:/XMLContent
Converts the image.dcm to its XML representation and stores same to folder
C:/XMLContent.

 
=========================================================================================================

Dicom Basic App Conf Profile

DICOMSECBALC ::DICOM Basic Application Level Confidentiality Profile, This tool
secures DICOM file by encrypting confidential attributes.

DICOMSECBALC [-d LogDir] [-l LogMode] -o Operation to perfor
m -f DICOMFile -k SecretKeyFilePath -s DestinationStoragePath [-a Algorithm] 

-d                Log directory
                  User's temp directory is taken as default.
-l                Log mode
LogMode           I INFO
                  S SEVER
                  Default Logging Mode is INFO
-o                Operation to perform
Operation         E Encrypt
                  D Decrypt
-f                Source DICOM file for specified operation.
-k                Secret key file path for encryption/decryption
-s                Destination file path to store encrypted/decrypted Dicom file
                  .
-a                Algorithm for encryption/decryption
Algorithm         AES
                  DES
                  TRIPPLE_DES
                  Default algorithm is AES.


Example :

1. Secure DICOM file by using encryption/decryption

 a.Secures the DICOM file by encrypting confidential attributes using secret key

DICOMSECBALC -o E -f 0003.dcm -k Secret.key  -s C:\encryptedfile.dcm

 b.Decrypts the DICOM file attributes which are secured using secret key

DICOMSECBALC -o D -f C:\encryptedfile.dcm -k Secret.key  -s C:\decrypted.dcm

=========================================================================================================

DICOM DIR

DICOMDIRSCP :: Process all C-Service request specified by DICOM using DICOMDIR.

DICOMDIRSCP [-i IP] -p Port [-d LogDir]  [-l LogMode]
 [-s StorageDir] -h AETitle [{-m AETilte@IP:Port}] [-t TimeOut]
 -o DICOMDIRStorageDir 

-i                IP Address, default IP address is localhost.
-p                Port
-d                Log directory
                  User's temp directory is taken as default.
-l                Log mode
LogMode           I INFO
                  S SEVER
                  Default Logging Mode is INFO.
-s                Storage directory of DICOM files.
                  User's temp directory is taken as default.
-h                Calling(host) AE Title.
-m                Move destination title.
                  For eg. - SDK@localhost:9002
-t                Session time out in milliseconds
-o                Reads the DICOMDIR file and renders its contents on console.


Example :

These examples are demonstration of simple C-Store Operation.


1. DICOMDIRSCP -p 9000 -h SDK
Starts server at localhost listening on port 9000, with SDK as AE Title


2. DICOMDIRSCP -p 9000 -h SDK -m XYZ:9002
Starts server at localhost listening on port 9000, SDK as AE Title Storage
server for move operation started at localhost listening on port 9002


3. DICOMDIRSCP -o c:\StoragePath
Reads the DICOMDIR file from c:\StoragePath and prints its contents on console.


==========================================================================================================

