Description

DICOM Modality Performed Procedure Step SCP. Process MPPS N-CREATE and N-SET requests received by the DICOM Server.

Modality Procedure Step In Progress

Modality Procedure Step Completed

Modality Procedure Step Discontinued

Dependencies

Attributes

#CalledAETitles

List of accepted called AE titles, separated by "\"(backslash).
For example, DCM4CHEE\DCM4CHEE2.

Default Value: DCM4CHEE

#CallingAETitles

List of accepted calling AE titles, separated by "\"(backslash).
ANY = accept any.

Default Value: ANY

#GeneratePatientID

Generate a patient ID from a hash of the patient name and birth date and/or study instance uid, if the received MPPS N-CREATE message contains no Patient ID.

Use ### and/or $$$ as a placeholder for the decimal hash value of patient name and/or study instance uid.
For example, PACS-##########.

NONE = do not generate Patient IDs.

Issuer of Patient ID for generated Patient IDs will be set to the Issuer of Patient ID associated to the MPPS SCP (=Called) AE by its AE configuration entry. If no Issuer of Patient ID is configured for the MPPS SCP, Issuer of Patient ID is set to the value configured by attribute #IssuerOfPatientIDGeneratedPatientID.

Default Value: PACS-##########

#IssuerOfPatientIDGeneratedPatientID

Issuer of Patient ID for generated Patient IDs, if no Issuer of Patient ID is associated with the MPPS SCP (=Called) AE by its AE Configuration entry.

Default Value: DCM4CHEE

#SupplementIssuerOfPatientID

Supplement received MPPS N-CREATE message containing a Patient ID, but no Issuer Of Patient ID, with a value for Issuer Of Patient ID, if such is associated with the MPPS SCU AE by its AE Configuration entry.

Default Value: true

#SupplementIssuerAccessionNumber

Supplement received MPPS N-CREATE message containing Scheduled Step Attributes Sequence items with a non-empty Accession Number, but no Issuer of Accession Number Sequence, with such Sequence containing one item with <i>Local Namespace Enitity ID_, Universial Enitity ID and Universial Enitity ID Type, if such is associated with the MPPS SCU AE by its AE Configuration entry.

Default Value: true

#SupplementByHostName

If there is no Issuer of Patient ID or Issuer of Accession Number associated to the MPPS SCU AE by an AE configuration entry with matching AE Title, AE configuration entries which host name is equals to the host name of the MPPS SCU AE will be considered to determine the associated Issuer of Patient ID or Issuer of Accession Number. If there are several AE configuration entries with matching host name with different non-zero values for Issuer of Patient ID or Issuer of Accession Number, no Issuer of Patient ID or Issuer of Accession Number will be supplemented.

Default Value: false

#SupplementByHostAddress

If there is no Issuer of Patient ID or Issuer of Accession Number associated to the MPPS SCU AE by an AE configuration entry with matching AE Title, AE configuration entries which host name is equals to the IP address of the MPPS SCU AE will be considered to determine the associated Issuer of Patient ID or Issuer of Accession Number. If there are several AE configuration entries with matching host name with different non-zero values for Issuer of Patient ID or Issuer of Accession Number, no Issuer of Patient ID or Issuer of Accession Number will be supplemented.

Default Value: false

#GeneratePatientIDForUnscheduledFromAETitles

List of AE titles of MPPS SCUs for which the Patient ID in received MPPS N-CREATE request without Scheduled Procedure Step reference shall be replaced by a new generated Patient ID. Separate multiple values by '\'(backslash).

If the list is prefixed by '!\', the Patient ID in MPPS N-CREATE requests without Scheduled Procedure Step reference received from any MPPS SCUs, except which AE title is specified in the list, will be replaced by a new generated Patient ID.

NONE = do not replace Patient IDs in MPPS N-CREATE requests from any MPPS SCU.

Default Value: NONE

#PatientMatching

Defines which Patient Attributes in received MPPS N-CREATE requests shall be considered for the selection of an existing
Patient record in the archive.

Format: 'pid' ['?'] ',issuer' ['?'] [',' [ '[' ] <demograhic-matches> [ ']' ]
<demograhic-matches> ::= <demograhic-match> ['|' ...]
<demograhic-match> ::= [<ignore>','] <demograhic-fields>
<ignore> ::= 'ignore("' <regular-expression> '")'
<demograhic-fields> ::= <demograhic-field> ['?'] [',' ...]
<demograhic-field> ::= 'familyname''(1)' | 'givenname''(1)' | 'middlename''(1)' | 'nameprefix''(1)' | 'namesuffix''(1)' | 'birthdate' | 'sex'

Multiple alternative <demograhic-matches> can be specified using '|' as delimiter.

Substrings specified by 'ignore("' <regular-expression> '")' will be ignored for matching patient name components.

A '(1)' suffix of the attribute name specifies that only the first character need to match.

A question mark('?') after a attribute name specifies that a missing value in received MPPS N-CREATE requests will match with any value for that attribute in existing Patient Records, as Patient Records with missing values for that attribute will match with any value for that attribute in received MPPS N-CREATE requests. Attribute names without question marks specifies, that MPPS N-CREATE requests without values for such attributes will not match any existing Patient Record, and Patient Records without values for such attributes will not get selected on receive of any MPPS N-CREATE request.

With 'pid*?*', you have to configure the Patient's family name complex ('familyname') as additional matching criterium.

Surrounding <demograhic-match> by brackets('[]') defines, that demographic fields shall not be considered for the selection of an existing Patient record, if the Patient ID is qualified by an Issuer/Authority in the received MPPS N-CREATE request and in the matching Patient Record.

Default Value: pid,issuer?[familyname,givenname,middlename?,birthdate]

#AcceptedTransferSyntax

List of accepted Transfer Syntaxes. Order defines selection preference.
Use either the Transfer Syntaxes UID value or following defined symbolic names:

ImplicitVRLittleEndian,
ExplicitVRLittleEndian,
DeflatedExplicitVRLittleEndian,
ExplicitVRBigEndian

Default Value:

ExplicitVRLittleEndian
ImplicitVRLittleEndian

#CoerceConfigDirectory

Directory where configuration files for attribute coercion are located: if XSL stylesheet mpps-ncreaterq.xsl or mpps-nsetrq.xsl exists in this directory or in a sub-directory equal to the AE Title of a MPPS SCU, attributes of MPPS N-CREATE or MPPS N-SET requests from this SCU will be coerced according these stylesheets. A relative path name is resolved relative to $DCM4CHEE_HOME/server/default/.

Default Value: conf/dcm4chee-ae

#WriteCoercionXmlLog

Enable logging of coercions in separate log files.
FileName: <LOG_DIR>/coercion/<timestamp>.<xsl file>.[in]|[out]
Coercion logs are only written for Calling AETs specified in LogAETitles!

Default Value: false

#LogAETitles

List of the AE titles for the MPPS SCUs for which coercion input and output should be logged in the log directory. Useful for creation of XSL stylesheets for attribute coercion. Separate multiple values by \ (backslash). NONE = no calling AE titles.

Default Value: NONE

#MaximumPDULength

Maximum protocol data unit (PDU) package length for receiving PDUs.

This property should be set to equal values for all DICOM SCP services with same called AE Title(s). Otherwise it is non-deterministic, which configured value is effective.

Default Value: 16352

#MaximumOperationsInvoked

The maximum number of outstanding operations and/or sub-operations it allows the Association-requester to invoke asynchronously.

This property should be set to equal values for all DICOM SCP services with same called AE Title(s). Otherwise it is non-deterministic, which configured value is effective.

Default Value: 1

#MaximumOperationsPerformed

The maximum number of outstanding operations and/or sub-operations it allows the Association-requester to perform asynchronously. A value of zero indicates an unlimited number of outstanding operations.

This property should be set to equal values for all DICOM SCP services with same called AE Title(s). Otherwise it is non-deterministic, which configured value is effective.