GPWL SCP

Owned by DamienD
Last updated: Jan 31, 2011 by Franz WillerVersion comment
4 min read

Description

DICOM General Purpose Worklist related Service Class Providers

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.
CONFIGURED_AETS = accept any configured AE Title.

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 GP-PPS 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 GP-PPS SCP (=Called) AE by its AE configuration entry. If no Issuer of Patient ID is configured for the GP-PPS 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 GP-PPS SCP (=Called) AE by its AE Configuration entry.

Default Value: DCM4CHEE

#SupplementIssuerOfPatientID

Supplement received GP-PPS 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 GP-PPS SCU AE by its AE Configuration entry.

Default Value: true

#SupplementByHostName

If there is no Issuer of Patient ID associated to the GP-PPS 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 GP-PPS SCU AE will be considered to determine the associated Issuer of Patient ID. If there are several AE configuration entries with matching host name with different non-zero values for Issuer of Patient ID, no Issuer of Patient ID will be supplemented_.

Default Value: false

#SupplementByHostAddress

If there is no Issuer of Patient ID associated to the GP-PPS 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 GP-PPS SCU AE will be considered to determine the associated Issuer of Patient ID. If there are several AE configuration entries with matching host name with different non-zero values for Issuer of Patient ID, no Issuer of Patient ID will be supplemented_.

Default Value: false

#PatientMatching

Defines which Patient Attributes in received GP-PPS 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 GP-PPS 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 GP-PPS 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 GP-PPS 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 GP-PPS N-CREATE request and in the matching Patient Record.

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

#AcceptedSOPClasses

List of accepted GPWL related SOP Classes. Use either the SOP Class UID value, or following defined symbolic names:

  • GeneralPurposeWorklistInformationModelFIND,
  • GeneralPurposeScheduledProcedureStepSOPClass,
  • GeneralPurposePerformedProcedureStepSOPClass,
  • GeneralPurposeWorklistManagementMetaSOPClass,

Default Value:

GeneralPurposeWorklistInformationModelFIND
GeneralPurposeScheduledProcedureStepSOPClass
GeneralPurposePerformedProcedureStepSOPClass
GeneralPurposeWorklistManagementMetaSOPClass

#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

#MaximumPDULength

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

(!)Attention: 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.
A value of zero indicates an unlimited number of outstanding operations.

(!)Attention: 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.

(!)Attention: 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

#AccessBlobAsLongVarBinary

Change JDBC binding for Oracle BLOB's to LONGVARBINARY for accessing attributes stored in BLOB columns of DB records.

Default Value: true

#TransactionIsolationLevel

Transaction isolation level for queries. Values can be one of: DEFAULT|READ_UNCOMMITTED|READ_COMMITTED|REPEATABLE_READ|SERIALIZABLE.
Default Value: DEFAULT

#DcmServerName

Used internally. Do NOT modify.

#AuditLoggerName

Used internally. Do NOT modify.

#AEServiceName

Used internally. Do NOT modify.

#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)