STANDARD DATA DICTIONARY #101.22 -- OTP MEDICATION DISPENSE FILE                                                  6/27/25    PAGE 1
STORED IN ^ORD(101.22,  *** NO DATA STORED YET ***   SITE: WWW.BMIRWIN.COM   UCI: VISTA,VISTA                      (VERSION 3.0)   

DATA          NAME                  GLOBAL        DATA
ELEMENT       TITLE                 LOCATION      TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This is the Opioid Treatment Program Medication Dispense record. This file contains the patient name, dispense date and time, and
other information surrounding the dispense of medication. This data comes from third-party vendors like MyAvatar and Methasoft, and
is filed here.  


              DD ACCESS: @
              RD ACCESS: @
              WR ACCESS: @
             DEL ACCESS: @
           LAYGO ACCESS: @
           AUDIT ACCESS: @

CROSS
REFERENCED BY: PATIENT NAME(B), MEDICATION DATE(C)

    LAST MODIFIED: APR 27,2025@08:50:24

101.22,.01    PATIENT NAME           0;1 POINTER TO PATIENT FILE (#2) (Required)

              LAST EDITED:      MAY 01, 2024 
              HELP-PROMPT:      Enter the patient that received the medication. 
              DESCRIPTION:      This field contains a pointer to the PATIENT File (#2) and is the patient that received the
                                medication.  

              CROSS-REFERENCE:  101.22^B 
                                1)= S ^ORD(101.22,"B",$E(X,1,30),DA)=""
                                2)= K ^ORD(101.22,"B",$E(X,1,30),DA)=


101.22,1      OTP DISPENSE RECORD    1;0 DATE Multiple #101.221

              DESCRIPTION:      This is the Opioid Treatment Program dispense record. It is a multiple record field that contains
                                patient(s) dispense record information.  


101.221,.01     MEDICATION DATE        0;1 DATE (Required)

                INPUT TRANSFORM:  S %DT="EX" D ^%DT S X=Y K:X<1 X
                LAST EDITED:      JUL 08, 2024 
                HELP-PROMPT:      Enter the date the medication should be taken. For example, 03/01/24 
                CROSS-REFERENCE:  101.221^B 
                                  1)= S ^ORD(101.22,DA(1),1,"B",$E(X,1,30),DA)=""
                                  2)= K ^ORD(101.22,DA(1),1,"B",$E(X,1,30),DA)

                CROSS-REFERENCE:  101.22^C 
                                  1)= S ^ORD(101.22,"C",$E(X,1,30),DA(1),DA)=""
                                  2)= K ^ORD(101.22,"C",$E(X,1,30),DA(1),DA)
                                  Creates a cross-reference entry by medication date for each entry in the OTP Dispense Record.  



101.221,2       MEDICATION TYPE        0;2 FREE TEXT

                INPUT TRANSFORM:  K:$L(X)>30!($L(X)<1) X
                MAXIMUM LENGTH:   30
                LAST EDITED:      JUN 25, 2024 
                HELP-PROMPT:      Please enter the name of the medication, between 1 and 30 characters. For example, Methadone Tab. 
                DESCRIPTION:
                                  This is the name of the medication being dispensed.  


101.221,3       DISPENSE DATE/TIME     0;3 DATE

                INPUT TRANSFORM:  S %DT="E" D ^%DT S X=Y K:X<1 X
                LAST EDITED:      JUN 25, 2024 
                HELP-PROMPT:      Please enter the date and time the medication was dispensed. For example, t-7@0900 or 
                                  03/01/24@0900 
                DESCRIPTION:
                                  This is the Date and Time that the medication was dispensed.  


101.221,4       DISPENSE BY NAME       0;4 FREE TEXT

                INPUT TRANSFORM:  K:$L(X)>60!($L(X)<2) X
                MAXIMUM LENGTH:   60
                LAST EDITED:      JUN 25, 2024 
                HELP-PROMPT:      Please enter the name of the person dispensing the medication, between 2 and 60 characters. 
                DESCRIPTION:
                                  This is the name of the person dispensing the medication.  


101.221,5       DISPENSE BY INITIALS   0;5 FREE TEXT

                INPUT TRANSFORM:  K:$L(X)>5!($L(X)<1) X
                MAXIMUM LENGTH:   5
                LAST EDITED:      JUN 25, 2024 
                HELP-PROMPT:      Please enter the initials of the person that dispensed the medication, between 1 and 5 
                                  characters. 
                DESCRIPTION:
                                  This is the initials of the person that dispensed the medication.  


101.221,6       DISPENSE ACTION        0;6 SET

                                  'C' FOR CLINIC; 
                                  'H' FOR TAKE HOME; 
                LAST EDITED:      JUN 25, 2024 
                HELP-PROMPT:      For medication dispensed in clinic, enter C. For medication dispensed for in-home consumption, 
                                  enter H. 
                DESCRIPTION:      This field indicates whether the medication was dispensed in Clinic or if it was a Take-Home
                                  dose.  


101.221,7       DISPENSE AMOUNT        0;7 FREE TEXT

                INPUT TRANSFORM:  K:$L(X)>20!($L(X)<1) X
                MAXIMUM LENGTH:   20
                LAST EDITED:      JUN 25, 2024 
                HELP-PROMPT:      Please enter the dosage of the the medication being dispensed. For example, 20MG. 
                DESCRIPTION:
                                  This is the dosage of medication being dispensed.  


101.221,8       INTERFACE RECEIVED DATE/TIME 0;8 DATE

                INPUT TRANSFORM:  S %DT="E" D ^%DT S X=Y K:X<1 X
                LAST EDITED:      JUN 25, 2024 
                HELP-PROMPT:      Please enter the date and time the dispense record was received from the interface. For example, 
                                  t@0930 or 03/01/24@0930. 
                DESCRIPTION:
                                  This is the Date and Time that the interface message was received.  


101.221,9       INTERFACE              0;9 FREE TEXT

                INPUT TRANSFORM:  K:$L(X)>25!($L(X)<2) X
                MAXIMUM LENGTH:   25
                LAST EDITED:      JUN 25, 2024 
                HELP-PROMPT:      Please enter the vendor interface. For example, MyAvatar or Methasoft. 
                DESCRIPTION:
                                  This is the vendor interface name.  





      FILES POINTED TO                      FIELDS

PATIENT (#2)                      PATIENT NAME (#.01)



INPUT TEMPLATE(S):

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):