Modality Performed Procedure Step SCP
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.
Default Value: 0
#DcmServerName
Used internally - do NOT modify.
Default Value: dcm4chee.archive:service=DcmServer
#AuditLoggerName
Used internally - do NOT modify.
Default Value: dcm4chee.archive:service=AuditLogger
#TemplatesServiceName
Used internally. Do NOT modify.
Default Value: dcm4chee.archive:service=Templates
#Name
The class name of the MBean
#State
The status of the MBean
#StateString
The status of the MBean in text form
Operations
#create
Standard MBean lifecycle method
#start
The start lifecycle operation
#stop
The stop lifecycle operation
#destroy
The destroy lifecycle operation
#jbossInternalLifecycle
The detyped lifecycle operation (for internal use only)
#linkMppsToMwl
Link MPPS to MWL entries.
#unlinkMpps
Unlink MPPS to MWL entries.
#deleteMPPSEntries
Deletes a list of MPPS entries.