DICOM PS3.2 2020a - Conformance |
Page 291 |
H.4.2.1.4.1.4 SOP Specific Conformance for Product Characteristics Query SOP Class
The PHARMACY-SCP AE supports the Return Key Attributes shown in Tables H.4.2-9 and H.4.2-10. Only those attributes requested in the query identifier are returned. Note that queries about devices are not supported.
Table H.4.2-9. Return Key Attributes Supported for Product Characteristics Query
Product Package Identifier |
(0044,0001) |
Returned with query match value |
Product Type Code Sequence |
(0044,0007) |
RxNorm coded type of drug |
Manufacturer |
(0008,0070) |
|
Product Name |
(0044,0008) |
|
Product Description |
(0044,0009) |
|
Product Lot Identifier |
(0044,000A) |
|
Product Expiration DateTime |
(0044,000B) |
|
Product Parameter Sequence |
(0044,0013) |
See Table H.4.2-10 for parameters |
|
|
supported |
Pertinent Documents Sequence |
(0038,0100) |
Zero or one item returned |
>Retrieve URI |
(0040,E010) |
|
Table H.4.2-10. Product Parameter Sequence Item Concepts Supported
Concept Name Code Sequence (0040,A043)
(118565006, SCT, "Volume")
(127489000, SCT, "Active Ingredient")
Only the ASCII (DICOM Default) character set is supported by the Pharmacy Information System; Specific Character Set (0008,0005) is not used.
H.4.2.1.4.1.5 SOP Specific Conformance for Substance Approval Query SOP Class
The PHARMACY-SCP AE supports the Matching Key Attributes shown in Table H.4.2-11. It can be configured to match on Patient ID, or on Admission ID, or on a combination of Patient ID and Issuer of Patient ID, or on a combination of Admission ID and Issuer of Admission ID. As required by the SOP Class, one of Patient ID or Admission ID must be present in the query, as must Product PackageIdentifierandAdministrationRouteCodeSequence.Note,however,thatthePharmacyInformationSystemdoesnotsupport verification of administration route. Also note that queries about devices are not supported.
Table H.4.2-11. Matching Key Attributes Supported for Substance Approval Query
Patient ID |
(0010,0020) |
Issuer of Patient ID |
(0010,0021) |
Admission ID |
(0038,0010) |
Issuer of Admission ID |
(0038,0011) |
Product Package Identifier |
(0044,0001) |
Administration Route Code Sequence |
(0054,0302) |
>Code Value |
(0008,0100) |
>Coding Scheme Designator |
(0008,0102) |
The PHARMACY-SCP AE supports the Return Key Attributes shown in Table H.4.2-12. Only those attributes requested in the query identifier are returned.
- Standard -
Page 292 DICOM PS3.2 2020a - Conformance
Table H.4.2-12. Return Key Attributes Supported for Substance Approval Query
Patient's Name |
(0010,0010) |
Obtained from Patient Registration System |
Patient ID |
(0010,0020) |
Obtained from Patient Registration System if AE configured |
|
|
for Admission ID matching, or Admission ID + Issuer of |
|
|
Admission ID matching |
Issuer of Patient ID |
(0010,0021) |
ReturnedonlyifAEconfiguredforPatientID+IssuerofPatient |
|
|
ID matching |
Patient's Birth Date |
(0010,0030) |
Obtained from Patient Registration System |
Patient's Sex |
(0010,0040) |
Obtained from Patient Registration System |
Admission ID |
(0038,0010) |
Returned only if AE configured for Admission ID matching, or |
|
|
Admission ID + Issuer of Admission ID matching |
Issuer of Admission ID |
(0038,0011) |
Returned only if AE configured for Admission ID + Issuer of |
|
|
Admission ID matching |
Product Package Identifier |
(0044,0001) |
Returned with query match value |
Administration Route Code Sequence |
(0054,0302) |
Returned with query match value |
Substance Administration Approval |
(0044,0002) |
Obtained from Pharmacy Information System |
Approval Status Further Description |
(0044,0003) |
Obtained from Pharmacy Information System |
Approval Status DateTime |
(0044,0004) |
|
Specific Character Set (0008,0005) is returned with value ISO_IR 192 if the Patient Registration System provides non-ASCII Unicode characters in Patient Name.
H.4.2.1.4.1.6 PHARMACY-SCP AE C-FIND Response Behavior
The PHARMACY-SCP AE supports the C-FIND Response Status return values and behavior shown in Table H.4.2-13.
Table H.4.2-13. PHARMACY-SCP AE C-FIND Response Status Return Behavior
Service |
Further Meaning |
Error Code |
Behavior |
Status |
|
|
|
Success Success |
0000 |
Matching is complete. No final identifier is supplied. |
|
Failure |
Out of Resources |
A700 |
System reached the limit in memory usage for queuing requests to |
|
|
|
the Pharmacy Information System. |
|
|
|
Error message is output to as an alert to the Service Audit Trail. |
|
Identifier does not match SOP |
A900 |
The C-FIND query identifier contains invalid Elements or values, or |
|
Class |
|
ismissingmandatoryElementsorvaluesforthespecifiedSOPClass. |
|
|
|
Error message is output to the Service Audit Trail. |
|
Unable to process |
C001 |
TheAEisunabletoestablishasessionwiththePharmacyInformation |
|
|
|
System. |
|
|
|
Error message is output to the Service Audit Trail. |
|
Unable to process |
C002 |
The AE is unable to establish a session with the Patient Registration |
|
|
|
System. |
|
|
|
Error message is output to the Service Audit Trail. |
|
Unable to process |
C110 |
The AE is unable to identify the Patient. |
|
|
|
Error message is output to the Service Audit Trail. |
- Standard -
|
|
DICOM PS3.2 2020a - Conformance |
Page 293 |
Service |
Further Meaning |
Error Code |
Behavior |
Status |
|
|
|
|
Unable to process |
C120 |
Cancel |
Matching terminated due to |
FE00 |
|
Cancel Request |
|
Pending |
Matches are continuing and |
FF00 |
|
current match is supplied. |
|
MatchesarecontinuingbutoneorFF01 more Optional Keys were not supported.
The AE is unable to identify the Product.
Error message is output to the Service Audit Trail.
The C-FIND SCU sent a Cancel Request. This has been acknowledged and the search for matches has been halted.
Indicatesthatthesuccessfulmatchisreturnedandafurtherresponse (0000)isforthcoming.ThisstatuscodeisreturnedifallOptionalkeys in the query identifier are actually supported.
Indicatesthatthesuccessfulmatchisreturnedandafurtherresponse (0000)isforthcoming.ThisstatuscodeisreturnedifthereareOptional keys in the query identifier that are not supported.
H.4.2.2 MAR-SCP Application Entity Specification
H.4.2.2.1 SOP Classes
The MAR-SCP AE provides Standard Conformance to the following DICOM SOP Classes:
Table H.4.2-14. SOP Classes for MAR-SCP AE
SOP Class Name |
SOP Class UID |
SCU |
SCP |
Verification |
1.2.840.10008.1.1 |
No |
Yes |
Substance Administration Logging |
1.2.840.10008.1.42 |
No |
Yes |
H.4.2.2.2 Association Policies
H.4.2.2.2.1 General
The MAR-SCP AE will never initiate Associations; it only accepts Association Requests from external DICOM AEs. The MAR-SCP AE will accept Associations for Verification (C-ECHO) and Substance Administration Logging (N-ACTION) requests.
The DICOM standard Application Context Name for DICOM is always accepted and proposed:
Table H.4.2-15. DICOM Application Context for MAR-SCP AE
Application Context Name |
1.2.840.10008.3.1.1.1 |
H.4.2.2.2.2 Number of Associations |
|
The MAR-SCP AE can support multiple simultaneous Associations. Each time the MAR-SCP AE receives an Association, a child process will be spawned to process the Verification or Substance Administration Logging request. The maximum number of child processes, and thus the maximum number of simultaneous Associations that can be processed, is set by configuration. The default maximum number is 10 in total.
Table H.4.2-16. Number of Simultaneous Associations as an SCP for MAR-SCP AE
Maximum number of simultaneous Associations requested by peer AEs |
10 (Configurable) |
H.4.2.2.2.3 Asynchronous Nature |
|
The MAR-SCP AE does not support asynchronous communication (multiple outstanding transactions over a single Association). All Association requests must be completed and acknowledged before a new operation can be initiated.
- Standard -
Page 294 DICOM PS3.2 2020a - Conformance
Table H.4.2-17. Asynchronous Nature as a SCP for MAR-SCP AE
Maximum number of outstanding asynchronous transactions |
1 (Not Configurable) |
H.4.2.2.2.4 Implementation Identifying Information |
|
The implementation information for this Application Entity is: |
|
Table H.4.2-18. DICOM Implementation Class and Version for MAR-SCP AE |
|
Implementation Class UID |
1.840.xxxxxxx.yyy.etc… |
Implementation Version Name |
EX_VERS_01 |
NotethatallEXAMPLE-MEDICATION-SYSTEM-GATEWAYAEsusethesameImplementationClassUIDandImplementationVersion Name. This Version Name is updated with each new release of the product software, as the different AE versions are never released independently.
H.4.2.2.3 Association Initiation Policy
The MAR-SCP AE does not initiate Associations.
H.4.2.2.4 Association Acceptance Policy
H.4.2.2.4.1 Activity - Handling Substance Administration Logging Requests
H.4.2.2.4.1.1 Description and Sequencing of Activity
The MAR-SCP AE accepts Associations only if they have valid Presentation Contexts. If none of the requested Presentation Contexts are accepted then the Association Request itself is rejected. It can be configured to only accept Associations with certain hosts (using TCP/IP address) and/or Application Entity Titles.
The following sequencing applies to the MAR-SCP AE for handling Substance Administration Logging Requests (N-ACTION) :
1.Peer AE opens an Association with the MAR-SCP AE.
2.Peer AE sends N-ACTION-RQ to request logging of a substance administration event.
3.If the request does not include the Patient ID, MAR-SCP AE requests the Patient ID corresponding to the Admission ID from the Patient Registration System
4.MAR-SCPAEtranslatestheloggingrequestintoadatabaseoperationontheMedicationAdministrationRecordSystemdatabase.
5.MAR-SCP AE responds with N-ACTION-RSP to indicate that it received and processed the request.
6.Peer AE closes the Association. Note that the peer AE does not have to close the Association immediately. Further N-ACTION Requests can be sent over the Association before it is closed.
The MAR-SCP AE may reject Association attempts as shown in the Table below. The Result, Source and Reason/Diag columns represent the values returned in the corresponding fields of an ASSOCIATE-RJ PDU (see Section 9.3.4 “A-ASSOCIATE-RJ PDU Structure” in PS3.8). The following abbreviations are used in the Source column:
a.1 - DICOM UL service-user
b.2 - DICOM UL service-provider (ASCE related function)
c.3 - DICOM UL service-provider (Presentation related function)
- Standard -
|
|
|
DICOM PS3.2 2020a - Conformance |
Page 295 |
|
|
|
|
Table H.4.2-19. Association Rejection Reasons |
|
|
Result |
Source |
Reason/Diag |
Explanation |
|
|
2 - |
c |
2 |
- local-limit-exceeded |
The (configurable) maximum number of simultaneous |
|
rejected-transient |
|
|
|
Associations has been reached. An Association request with |
|
|
|
|
|
the same parameters may succeed at a later time. |
|
2 - |
c |
1 |
- temporary-congestion |
No Associations can be accepted at this time due to the |
|
rejected-transient |
|
|
|
real-timerequirementsofhigherpriorityactivities(e.g.,during |
|
|
|
|
|
image acquisition no Associations will be accepted) or |
|
|
|
|
|
because insufficient resources are available (e.g., memory, |
|
|
|
|
|
processes, threads). An Association request with the same |
|
|
|
|
|
parameters may succeed at a later time. |
|
1 - |
a |
2 |
- |
The Association request contained an unsupported |
|
rejected-permanent |
application-context-name-not-supportedApplication Context Name. An association request with the |
||||
|
|
|
|
same parameters will not succeed at a later time. |
|
1 - |
a |
7 |
- called-AE-title-not-recognized |
The Association request contained an unrecognized Called |
|
rejected-permanent |
|
|
AE Title. An Association request with the same parameters |
||
|
|
|
|
will not succeed at a later time unless configuration changes |
|
|
|
|
|
are made. This rejection reason normally occurs when the |
|
|
|
|
|
Association initiator is incorrectly configured and attempts to |
|
|
|
|
|
address the Association acceptor using the wrong AE Title. |
|
1 - |
a |
3 |
- calling-AE-title-not-recognized |
The Association request contained an unrecognized Calling |
|
rejected-permanent |
|
|
AE Title. An Association request with the same parameters |
||
|
|
|
|
will not succeed at a later time unless configuration changes |
|
|
|
|
|
are made. This rejection reason normally occurs when the |
|
|
|
|
|
Association acceptor has not been configured to recognize |
|
|
|
|
|
the AE Title of the Association initiator. |
|
1 - |
b |
1 |
- no-reason-given |
TheAssociationrequestcouldnotbeparsed.AnAssociation |
|
rejected-permanent |
|
|
request with the same format will not succeed at a later time. |
||
The MAR-SCP AE will close the Association under the exceptional circumstances listed in Table H.4.2-20.
Table H.4.2-20. PHARMACY-SCP AE Communication Failure Behavior
Exception
Behavior
Timeout expiry for an expected DICOM Message Request (DIMSE level The Association is aborted by issuing a DICOM timeout). I.e. The MAR-SCP AE is waiting for the next N-ACTION RequestA-ABORT.
on an open Association but the timer expires.
Error message is output to the Service Audit Trail.
Timeout expiry for an expected DICOM PDU or TCP/IP packet (Low-levelThe Association is aborted by issuing a DICOM timeout). I.e. The MAR-SCP AE is waiting for the next message PDU butA-ABORT.
the timer expires.
|
Error message is output to the Service Audit Trail. |
Association aborted by the SCU or the network layers indicate |
Error message is output to the Service Audit Trail. |
communication loss (i.e., low-level TCP/IP socket closure) |
|
H.4.2.2.4.1.2 Accepted Presentation Contexts
The MAR-SCP AE will accept Presentation Contexts as shown in Table H.4.2-21.
- Standard -