STANDARD DATA DICTIONARY #53.77 -- BCMA UNABLE TO SCAN LOG FILE 3/24/25 PAGE 1 STORED IN ^PSB(53.77, *** NO DATA STORED YET *** SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 3.0) DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE ----------------------------------------------------------------------------------------------------------------------------------- The Bar Code Medication Administration (BCMA) Unable to Scan Log file is to contain information pertaining to BCMA Scanning and BCMA scanning "failures". This file has been created in effort to support refinement of the BCMA scanning process and BCMA scanning equipment. DD ACCESS: @ RD ACCESS: @ WR ACCESS: @ DEL ACCESS: @ LAYGO ACCESS: @ AUDIT ACCESS: @ APPLICATION GROUP(S): PSB CROSS REFERENCED BY: UAS EVENT DATE/TIME(ASFDT), USER ID(B) 53.77,.01 USER ID 0;1 POINTER TO NEW PERSON FILE (#200) (Required) LAST EDITED: NOV 12, 2008 HELP-PROMPT: The user at the time of the scan event. DESCRIPTION: The user at the time of the scan event. CROSS-REFERENCE: 53.77^B 1)= S ^PSB(53.77,"B",$E(X,1,30),DA)="" 2)= K ^PSB(53.77,"B",$E(X,1,30),DA) 53.77,.02 PATIENT ID 0;2 POINTER TO PATIENT FILE (#2) LAST EDITED: NOV 12, 2008 HELP-PROMPT: The patient involved in the scan event. DESCRIPTION: The patient (if known) involved in the scan event. This information may automatically be derived from user supplied data. 53.77,.03 UAS EVENT LOCATION 0;3 FREE TEXT INPUT TRANSFORM: K:$L(X)>50!($L(X)<1) X LAST EDITED: NOV 06, 2008 HELP-PROMPT: The patient location at the time of scan event. DESCRIPTION: The location where the scan event occurred. The attempt to scan should be at the patient's bedside, therefore this patient's location data is derived from the patient's file. TECHNICAL DESCR: File #2 Field# .1 _ "/" _ File #2 Field # .101 53.77,.04 UAS EVENT DATE/TIME 0;4 DATE INPUT TRANSFORM: S %DT="ESTR" D ^%DT S X=Y K:X<1 X LAST EDITED: NOV 14, 2008 HELP-PROMPT: The date and time at which the scan event occurred. DESCRIPTION: Date and time the scan event documentation occurred. CROSS-REFERENCE: 53.77^ASFDT 1)= S ^PSB(53.77,"ASFDT",$E(X,1,30),DA)="" 2)= K ^PSB(53.77,"ASFDT",$E(X,1,30),DA) This an index to maintain MSF log file (53.77) entries, by date/time. 53.77,.05 UAS TYPE 0;5 SET (Required) 'MUAS' FOR MEDICATION UNABLE TO SCAN; 'WUAS' FOR WRISTBAND UNABLE TO SCAN; 'MKEY' FOR MEDICATION KEYED ENTRY; 'WKEY' FOR WRISTBAND KEYED ENTRY; 'MMME' FOR MEDICATION MAN MED ENTRY; 'MSCN' FOR MEDICATION VIA SCANNER; 'WSCN' FOR WRISTBAND VIA SCANNER; LAST EDITED: NOV 06, 2008 HELP-PROMPT: The type of scan event that was recorded. DESCRIPTION: The type of scan event. The value stored is one of a FileMan set. The value that is placed here is determined by the user's actions when attempting to scan a medication/wristband during an administration. Those types beginning with the "M" are events dealing with medications; those beginning with "W" are events with wristbands. "*UAS" occur when the user actually uses the "unable to scan" functionality to document the activity. "*SCN" are types that occur during normal scanning activities. The "*KEY" designate a type of event where the user has by-passed the BCMA scanning system by "keying", via the system's keyboard device, BCMA input data. 53.77,.06 UAS REASON 0;6 FREE TEXT INPUT TRANSFORM: K:$L(X)>30!($L(X)<1) X LAST EDITED: NOV 06, 2008 HELP-PROMPT: The UTS reason recorded at the time of the scan event. DESCRIPTION: When documenting an "Unable To Scan Event", the user must select an approximate reason as to why the usual BCMA scanning system must be bypassed. That "Unable To Scan Reason" is stored in this field. These are the values available in the GUI application for this field: Damaged Medication Label Damaged Wristband Dose Discrepancy Inactive Patient Manual Medication Entry No Bar Code Scanning Equipment Failure Unable to Determine 53.77,.07 UAS E-MESSAGE ID 0;7 POINTER TO MESSAGE FILE (#3.9) LAST EDITED: OCT 27, 2008 HELP-PROMPT: The MailMan message ID of the sent message for the UTS event. DESCRIPTION: A MailMan message will be sent per documented Unable To Scan Events. That message is referenced by this field, confirming a "given notice" of the Unable To Scan event and documentation. 53.77,.08 ORDER NUMBER 0;8 FREE TEXT INPUT TRANSFORM: K:$L(X)>11!($L(X)<2) X LAST EDITED: NOV 14, 2008 HELP-PROMPT: The order number and type from the Pharmacy Patient file. DESCRIPTION: This field logs the Pharmacy Patient order number of the order involved in the Unable To Scan event, if the order number is available and pertinent. TECHNICAL DESCR: The order number from Pharmacy Patient, with a "U" or "V" appended to specify an order type of Unit Dose or IV order. This is only recorded if the order number is available and meaningful to the UTS event. Because of the appended letter, this is not a pointer strictly speaking. For unit dose orders, the order number is recorded in Pharmacy Patient (File 55) at the level: ^PS(55,D0,5,D1,0)= (#.01) ORDER NUMBER [1N] ^ The order type is at the same level in field 4, TYPE. For IV orders, the order number is recorded in Pharmacy Patient (File 55) at level: ^PS(55,D0,"IV",D1,0)= (#.01) ORDER NUMBER The order type is at the same level in field .04, TYPE 53.77,.09 ENTERED COMMENT 1;1 FREE TEXT INPUT TRANSFORM: K:$L(X)>250!($L(X)<1) X LAST EDITED: NOV 07, 2008 HELP-PROMPT: The user comment for the event, up to 250 characters in length. DESCRIPTION: Optional comment entered by the user when documenting a BCMA Unable To Scan event. TECHNICAL DESCR: This field contains comments from two sources. The system generates messages to document certain events, such as use of the five rights mechanism to administer a medication. The end user can also enter a comment from the client application. If both are entered, both will display, system comment first. System comments are enclosed in brackets. 53.77,10 DISPENSE DRUG 2;0 POINTER Multiple #53.771 DESCRIPTION: The dispensed drug from the order associated with the UTS event. 53.771,.01 DISPENSE DRUG 0;1 POINTER TO DRUG FILE (#50) LAST EDITED: NOV 14, 2008 HELP-PROMPT: The dispensed drug IEN associated with the UTS event. DESCRIPTION: The dispensed drug IEN associated with the UTS event. CROSS-REFERENCE: 53.771^B 1)= S ^PSB(53.77,DA(1),2,"B",$E(X,1,30),DA)="" 2)= K ^PSB(53.77,DA(1),2,"B",$E(X,1,30),DA) 53.771,1 DRUG NAME 0;2 FREE TEXT INPUT TRANSFORM: K:$L(X)>60!($L(X)<1) X LAST EDITED: OCT 27, 2008 HELP-PROMPT: The dispensed drug name associated with the UTS event. DESCRIPTION: This is the drug name associated with the Dispense Drug. 53.77,11 ADDITIVE 3;0 POINTER Multiple #53.7711 DESCRIPTION: List of additives from the order associated with the UTS event. 53.7711,.01 ADDITIVE 0;1 POINTER TO IV ADDITIVES FILE (#52.6) LAST EDITED: OCT 27, 2008 HELP-PROMPT: The additive associated with the UTS event. DESCRIPTION: The IEN of the additive associated with the UTS event. CROSS-REFERENCE: 53.7711^B 1)= S ^PSB(53.77,DA(1),3,"B",$E(X,1,30),DA)="" 2)= K ^PSB(53.77,DA(1),3,"B",$E(X,1,30),DA) 53.7711,1 ADDITIVE NAME 0;2 FREE TEXT INPUT TRANSFORM: K:$L(X)>60!($L(X)<1) X LAST EDITED: OCT 27, 2008 HELP-PROMPT: The name of the additive that is associated with the UTS event. DESCRIPTION: The name of the additive that is associated with the UTS event. 53.77,12 SOLUTIONS 4;0 POINTER Multiple #53.7712 DESCRIPTION: The list of solutions contained in the medication associated with the UTS event. 53.7712,.01 SOLUTIONS 0;1 POINTER TO IV SOLUTIONS FILE (#52.7) LAST EDITED: NOV 07, 2008 HELP-PROMPT: The solution IEN associated with the UTS event. DESCRIPTION: The list of solutions contained in the order associated with the UTS event. CROSS-REFERENCE: 53.7712^B 1)= S ^PSB(53.77,DA(1),4,"B",$E(X,1,30),DA)="" 2)= K ^PSB(53.77,DA(1),4,"B",$E(X,1,30),DA) 53.7712,1 SOLUTION NAME 0;2 FREE TEXT INPUT TRANSFORM: K:$L(X)>60!($L(X)<1) X LAST EDITED: NOV 07, 2008 HELP-PROMPT: The solution name in the medication that is associated with the UTS event. DESCRIPTION: Name of the solution contained in the medication that was Unable to Scan. 53.77,13 UNIQUE ITEM ID 0;9 FREE TEXT INPUT TRANSFORM: K:$L(X)>30!($L(X)<1) X LAST EDITED: NOV 16, 2008 HELP-PROMPT: The ID associated with an IV medication that is UTS. DESCRIPTION: This field will document the identifier of the IV bag associated with the unable to scan event. This item cannot be identified via a specific medication identifier since an IV is made up of one or more Solutions and one or more Additives. TECHNICAL DESCR: The IV Unique ID is stored in the 10th "^" piece of the BCMA Medication Log File. The specific field is #.26, IV UNIQUE ID. The pointer to the BCMA Medication Log File is not retained in this global, so it is not stored a a pointer. If the IV Unique ID contains the letters "WS", then the IV bag was created during ward stack activity. The IEN for the BCMA Medication log entry for the IV Unique ID can be located using the "AUID" cross reference: ^PSB(53.79,"AUID",PATIENT ID,ORDER NUMBER,IV UNIQUE ID,IEN)="" 53.77,14 IV ORDERABLE ITEM 5;1 FREE TEXT INPUT TRANSFORM: K:$L(X)>32!($L(X)<1) X LAST EDITED: NOV 24, 2008 HELP-PROMPT: The IV orderable item ID for the IV order associated with the UTS event. DESCRIPTION: This field is to document the Orderable Item assigned to the IV bag that is contained in the order that is associated with the unable to scan event. 53.77,15 ORDERABLE ITEM NAME 5;2 FREE TEXT INPUT TRANSFORM: K:$L(X)>71!($L(X)<3) X LAST EDITED: APR 06, 2010 HELP-PROMPT: Enter the name of the orderable item (3-71 characters) that is associated with the UTS event. DESCRIPTION: The Orderable Item Name of the medication that is contained in an order that is associated with the UTS event. When the medication only contains a solution with no additive, the Orderable Item Name will include both the Pharmacy Orderable Item and the Dosage Form. TECHNICAL DESCR: The Orderable Item Name entry can be located in file # 50.7 by using the value of field 14 of this file as a pointer. We are storing the value rather than pointing to it for historical purposes. We do not want this field to change if there is a change in file # 50.7. Our goal is to store the value at the time of the UTS event. When the medication only contains a solution with no additive, the Orderable Item Name will be the Name (#.01) field of the Pharmacy Orderable Item file (#50.7) followed by a blank character followed by the Name (#.01) field from the Dosage Form (#50.606) file. The Dosage form can be located in file # 50.606 by using the value of field .02 of the # 50.7 file as a pointer. NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER FILES POINTED TO FIELDS DRUG (#50) DISPENSE DRUG:DISPENSE DRUG (#.01) IV ADDITIVES (#52.6) ADDITIVE:ADDITIVE (#.01) IV SOLUTIONS (#52.7) SOLUTIONS:SOLUTIONS (#.01) MESSAGE (#3.9) UAS E-MESSAGE ID (#.07) NEW PERSON (#200) USER ID (#.01) PATIENT (#2) PATIENT ID (#.02) INPUT TEMPLATE(S): PRINT TEMPLATE(S): SORT TEMPLATE(S): FORM(S)/BLOCK(S):