STANDARD DATA DICTIONARY #58.63 -- PADE DISPENSING DEVICE FILE                                                    3/24/25    PAGE 1
STORED IN ^PS(58.63,  *** NO DATA STORED YET ***   SITE: WWW.BMIRWIN.COM   UCI: VISTA,VISTA                        (VERSION 5.0)   

DATA          NAME                  GLOBAL        DATA
ELEMENT       TITLE                 LOCATION      TYPE
-----------------------------------------------------------------------------------------------------------------------------------
Pharmacy Automated Dispensing Equipment (PADE) devices contain drug items that may be removed to satisfy a pharmacy medication
order. An inbound (to VistA) HL7 PADE interface receives transactions indicating drug items were added or removed from a specific
PADE device. Each dispensing device in this file must be associated with a VistA Division and one or more hospital locations
(Wards, Ward Groups, Clinics, Clinic Groups) in order for inbound PADE transactions to properly update PADE inventory balances in
the PADE INVENTORY SYSTEM (#58.601) file.  
 
The PADE DISPENSING DEVICE entry must be unique for the PADE INVENTORY SYSTEM (#58.601) file entry to which is linked; this file
may contain multiple PADE dispensing devices with the same NAME (.01) field value, provided each duplicate name is associated with
a different PADE INVENTORY SYSTEM file entry. New entries may be added to this file automatically via the PADE HL7 interface.  


FILE SCREEN (SCR-node) : I $S('$G(PSJPSYS):1,1:+$G(PSJPSYS)=+$P($G(^(0)),"^",2))
              DD ACCESS: @
              RD ACCESS: 
              WR ACCESS: 
             DEL ACCESS: 
           LAYGO ACCESS: 
           AUDIT ACCESS: @
IDENTIFIED BY: PADE STATUS (#4)

PRIMARY KEY:        A (#125)
  Uniqueness Index: C (#1378)
       File, Field: 1) DISPENSING DEVICE (58.63,.01)  2) PADE INVENTORY SYSTEM (58.63,1)

POINTED TO BY: DISPENSING DEVICE field (#.01) of the DISPENSING DEVICE sub-field (#58.6011) of the PADE INVENTORY SYSTEM File 
                   (#58.601) 
               DWO MESSAGE ENTITY field (#.01) of the DWO MESSAGE ENTITY sub-field (#58.6014) of the PADE INVENTORY SYSTEM File 
                   (#58.601) 
               

CROSS
REFERENCED BY: DISPENSING DEVICE(B), ALTERNATE IDENTIFIER(E)

INDEXED BY:    DISPENSING DEVICE & PADE INVENTORY SYSTEM (AC), DISPENSING DEVICE & PADE INVENTORY SYSTEM (C), CLINIC GROUP (CG),
               CLINIC LOCATION (CL), DIVISION & DISPENSING DEVICE (D), (F), WILDCARD CLINIC NAME (WC), WARD LOCATION (WD), WARD
               GROUP (WG)


    LAST MODIFIED: OCT 6,2016@13:01:37

58.63,.01     DISPENSING DEVICE      0;1 FREE TEXT (Required) (Key field)

              INPUT TRANSFORM:  K:$L(X)>30!($L(X)<1)!'(X'?1P.E) X
              LAST EDITED:      MAR 18, 2016 
              HELP-PROMPT:      Answer must be 1-30 characters in length. 
              DESCRIPTION:      The name of the PADE DISPENSING DEVICE; the name must match exactly the name of the device on the
                                vendor PADE system.  

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

              RECORD INDEXES:   AC (#1377), C (#1378), D (#1381)

58.63,1       PADE INVENTORY SYSTEM  0;2 POINTER TO PADE INVENTORY SYSTEM FILE (#58.601) (Required) (Key field)

              INPUT TRANSFORM:  S DIC("S")="I $S('$G(PSJPSYS):1,1:PSJPSYS=+$G(Y))" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
              LAST EDITED:      OCT 08, 2015 
              HELP-PROMPT:      Enter the PADE INVENTORY SYSTEM associated with this PADE device. 
              DESCRIPTION:
                                The PADE INVENTORY SYSTEM associated with this PADE device.  

              SCREEN:           S DIC("S")="I $S('$G(PSJPSYS):1,1:PSJPSYS=+$G(Y))"
              EXPLANATION:      Default to current Inventory System
              RECORD INDEXES:   AC (#1377), C (#1378)

58.63,2       DIVISION               2;1 POINTER TO MEDICAL CENTER DIVISION FILE (#40.8)

              LAST EDITED:      APR 11, 2016 
              HELP-PROMPT:      Enter the primary DIVISION supplied by this PADE device. 
              DESCRIPTION:
                                The primary DIVISION associated with this PADE device.  

              RECORD INDEXES:   D (#1381)

58.63,3       SEND DWO MESSAGES      0;3 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      MAR 24, 2016 
              HELP-PROMPT:      Enter 'YES' if Dispense Without Orders should generate a message 
              DESCRIPTION:      This field contains a flag indicating if Dispensed Without Order (DWO) MailMan messages should be
                                sent when this PADE device is involved in a dispense transaction that is not linked to a pharmacy
                                order.  


58.63,4       PADE STATUS            0;4 SET

                                'A' FOR ACTIVE; 
                                'I' FOR INACTIVE; 
              LAST EDITED:      DEC 07, 2015 
              HELP-PROMPT:      Enter the status of the PADE dispensing device, ACTIVE or INACTIVE. 
              DESCRIPTION:      This field allows a PADE dispensing device's status to be set to ACTIVE or INACTIVE. Setting the
                                status to INACTIVE does not affect the PADE's medication balances; however, an Inactive status
                                prevents the PADE cabinet's medication balances from being displayed as available in Inpatient
                                Order Entry. Inactive PADE cabinets will continue to display in all PADE reports.  
                                 
                                 If a PADE cabinet is being removed from service, the list of 
                                 medications stocked in a cabinet may be deleted using the 
                                 RESET/INITIALIZE PADE DEVICE? field.  


58.63,5       WARD GROUP             3;0 POINTER Multiple #58.635

              DESCRIPTION:
                                Ward Groups associated with this PADE device.  


58.635,.01      WARD GROUP             0;1 POINTER TO WARD GROUP FILE (#57.5) (Multiply asked)

                INPUT TRANSFORM:  S DIC("S")="I $$WGCHK2^PSJPADSI(Y,DA)" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
                LAST EDITED:      DEC 08, 2015 
                HELP-PROMPT:      Enter a Ward Group supplied by this PADE device. 
                DESCRIPTION:
                                  Ward Group associated with this PADE device.  

                SCREEN:           S DIC("S")="I $$WGCHK2^PSJPADSI(Y,DA)"
                EXPLANATION:      Ward must be associated with Device's Division.
                CROSS-REFERENCE:  58.635^B 
                                  1)= S ^PS(58.63,DA(1),3,"B",$E(X,1,30),DA)=""
                                  2)= K ^PS(58.63,DA(1),3,"B",$E(X,1,30),DA)

                FIELD INDEX:      WG (#1385)    MUMPS    IR    LOOKUP & SORTING    WHOLE FILE (#58.63)
                    Short Descr:  WARD GROUPS
                    Description:  This cross reference contains Ward Groups associated with PADE Dispensing cabinets. This cross
                                  reference will be used to enable and disable the display of PADE information in Inpatient Order
                                  Entry by enabling the display when the patient's ward location is linked to a PADE device, and 
                                  disabling the display when the patient's ward location is not linked to a PADE device.  
                      Set Logic:  S ^PS(58.63,"WG",X(1),$G(DA(1)))=""
                     Kill Logic:  K ^PS(58.63,"WG",X(1),$G(DA(1)))
                     Whole Kill:  K ^PS(58.63,"WG")
                           X(1):  WARD GROUP  (58.635,.01)  (Subscr 1)  (forwards)




58.63,6       WARD LOCATION          4;0 POINTER Multiple #58.636

              DESCRIPTION:
                                Ward Locations associated with this PADE device.  


58.636,.01      WARD LOCATION          0;1 POINTER TO WARD LOCATION FILE (#42) (Multiply asked)

                INPUT TRANSFORM:  S DIC("S")="I $$WARDSCR2^PSJPADSI(Y,DA)" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
                LAST EDITED:      DEC 08, 2015 
                HELP-PROMPT:      Enter a Ward Location supplied by this PADE device. 
                DESCRIPTION:
                                  Ward Location associated with this PADE device.  

                SCREEN:           S DIC("S")="I $$WARDSCR2^PSJPADSI(Y,DA)"
                EXPLANATION:      Only allow ward associated with Division
                CROSS-REFERENCE:  58.636^B 
                                  1)= S ^PS(58.63,DA(1),4,"B",$E(X,1,30),DA)=""
                                  2)= K ^PS(58.63,DA(1),4,"B",$E(X,1,30),DA)

                FIELD INDEX:      WD (#1384)    REGULAR    IR    LOOKUP & SORTING    WHOLE FILE (#58.63)
                    Short Descr:  WARDS
                    Description:  This cross reference contains list of all Wards linked to PADE cabinets. This cross reference is
                                  used to determine if Inpatient Order Entry screens include Pharmacy Automated Dispensing
                                  Equipment (PADE) information.  
                      Set Logic:  S ^PS(58.63,"WD",X,DA(1),DA)=""
                     Kill Logic:  K ^PS(58.63,"WD",X,DA(1),DA)
                     Whole Kill:  K ^PS(58.63,"WD")
                           X(1):  WARD LOCATION  (58.636,.01)  (Subscr 1)  (forwards)




58.63,7       CLINIC GROUP           5;0 POINTER Multiple #58.637

              DESCRIPTION:
                                Clinic Groups associated with this PADE device.  


58.637,.01      CLINIC GROUP           0;1 POINTER TO CLINIC GROUP FILE (#57.8) (Multiply asked)

                INPUT TRANSFORM:  S DIC("S")="I $$CGCHK2^PSJPADSI(Y,DA)" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
                LAST EDITED:      DEC 08, 2015 
                HELP-PROMPT:      Enter a Clinic Group supplied by this PADE device. 
                DESCRIPTION:
                                  Clinic Groups associated with this PADE device.  

                SCREEN:           S DIC("S")="I $$CGCHK2^PSJPADSI(Y,DA)"
                EXPLANATION:      Allow only Clinic Groups associated with Division
                CROSS-REFERENCE:  58.637^B 
                                  1)= S ^PS(58.63,DA(1),5,"B",$E(X,1,30),DA)=""
                                  2)= K ^PS(58.63,DA(1),5,"B",$E(X,1,30),DA)

                FIELD INDEX:      CG (#1379)    MUMPS    IR    LOOKUP & SORTING    WHOLE FILE (#58.63)
                    Short Descr:  CLINIC GROUPS
                      Set Logic:  S ^PS(58.63,"CG",X(1),$G(DA(1)))=""
                     Kill Logic:  K ^PS(58.63,"CG",X(1),$G(DA(1)))
                     Whole Kill:  K ^PS(58.63,"CG")
                           X(1):  CLINIC GROUP  (58.637,.01)  (Subscr 1)  (forwards)




58.63,8       CLINIC LOCATION        6;0 POINTER Multiple #58.638

              DESCRIPTION:
                                Clinic Locations associated with this PADE device.  


58.638,.01      CLINIC LOCATION        0;1 POINTER TO HOSPITAL LOCATION FILE (#44) (Multiply asked)

                INPUT TRANSFORM:  S DIC("S")="I $$CLCHK2^PSJPADSI(Y,DA)" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
                LAST EDITED:      DEC 08, 2015 
                HELP-PROMPT:      Enter a Clinic location supplied by this PADE device. 
                DESCRIPTION:
                                  Clinic locations associated with this PADE device.  

                SCREEN:           S DIC("S")="I $$CLCHK2^PSJPADSI(Y,DA)"
                EXPLANATION:      Allow only Clinic associated with Division
                CROSS-REFERENCE:  58.638^B 
                                  1)= S ^PS(58.63,DA(1),6,"B",$E(X,1,30),DA)=""
                                  2)= K ^PS(58.63,DA(1),6,"B",$E(X,1,30),DA)

                FIELD INDEX:      CL (#1380)    MUMPS    IR    LOOKUP & SORTING    WHOLE FILE (#58.63)
                    Short Descr:  CLINIC LOCATIONS
                    Description:  This cross reference contains Clinics associated with PADE Dispensing cabinets. This cross
                                  reference will be used to enable and disable the display of PADE information in Inpatient Order
                                  Entry by enabling the display when an order's clinic location is linked to a PADE device, and 
                                  disabling the display when a patient's clinic location is not linked to a PADE device.  
                      Set Logic:  S ^PS(58.63,"CL",X(1),$G(DA(1)))=""
                     Kill Logic:  K ^PS(58.63,"CL",X(1),$G(DA(1)))
                     Whole Kill:  K ^PS(58.63,"CL")
                           X(1):  CLINIC LOCATION  (58.638,.01)  (Subscr 1)  (forwards)




58.63,9       PADE RESET             1;0 DATE Multiple #58.639 (Add New Entry without Asking)

              DESCRIPTION:
                                This multiple stores the date and time a PADE reset occurred.  


58.639,.01      PADE RESET             0;1 DATE

                INPUT TRANSFORM:  S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
                LAST EDITED:      DEC 08, 2015 
                HELP-PROMPT:      Enter the Date/Time the PADE cabinet balances were reset to zero. 
                DESCRIPTION:      This field removes all medications linked to this PADE cabinet in VistA, making the cabinet
                                  appear empty to VistA users. Resetting a PADE cabinet does not affect the PADE vendor, and does
                                  not trigger any HL7 messages to the PADE system. Resetting a PADE cabinet makes the device
                                  unavailable for selection when running the PADE INVENTORY REPORT, and also removes the device
                                  from the list of PADE cabinets used to update Inpatient Order Entry with PADE information.  
                                   
                                  After a PADE cabinet is reset, medications will be automatically added back to the PADE as new
                                  HL7 messages are received from the vendor.  

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




58.63,10      WILDCARD CLINIC NAME   7;0 Multiple #58.65

              DESCRIPTION:      This field allows a group of CLINICS with a common naming convention to be linked to a PADE
                                cabinet, making it unnecessary to type in each individual Clinic name. For example, if all surgery
                                clinics in a division begin with 'AL-SURGERY', the surgery clinics could all be linked to a PADE 
                                cabinet by creating a wildcard called "AL-SURGERY". When clinic orders are viewed, finished, or
                                edited in Inpatient Order Entry, the order's clinic location is compared to this pattern/wildcard
                                to determine if PADE information should be displayed, indicating the order's medication may be
                                dispensed from a PADE cabinet.  


58.65,.01       WILDCARD CLINIC NAME   0;1 FREE TEXT (Multiply asked)

                INPUT TRANSFORM:  K:$L(X)>30!($L(X)<3) X
                LAST EDITED:      DEC 08, 2015 
                HELP-PROMPT:      Answer must be 3-30 characters in length. 
                DESCRIPTION:      This field allows a group of Clinics with a common naming convention, or 'wildcard', to be linked
                                  to a PADE cabinet, automatically linking all matching Clinic names with the PADE cabinet. 
                                   
                                  For example, if all of a division's surgery clinics began with 'AL-SURGERY', all the surgery
                                  clinics could be linked to a PADE cabinet by creating a wildcard called "AL-SURGERY".  

                CROSS-REFERENCE:  58.65^B 
                                  1)= S ^PS(58.63,DA(1),7,"B",$E(X,1,30),DA)=""
                                  2)= K ^PS(58.63,DA(1),7,"B",$E(X,1,30),DA)

                FIELD INDEX:      WC (#1383)    MUMPS    IR    LOOKUP & SORTING    WHOLE FILE (#58.63)
                    Short Descr:  CLINIC WILDCARD
                    Description:  This cross reference allows a group of CLINICS with a common naming convention, where that naming
                                  convention or 'wildcard' has been linked to a PADE cabinet, to be quickly searched and tested to
                                  determine if a given clinic is linked to any PADE cabinets.  
                                   
                                  For example, if all of a division's surgery clinics began with 'AL-SURGERY', all the surgery
                                  clinics could be linked to a PADE cabinet by creating a wildcard called "AL-SURGERY". Other PADE
                                  cabinets could be linked to the "AL-SURGERY" wildcard as well. 
                                   
                                  When clinic orders are viewed, finished, or edited in Inpatient Order Entry, the order's clinic
                                  location is compared to the pattern/wildcard in this cross reference to determine if PADE
                                  information should be displayed, indicating the order's medication may be dispensed from a PADE
                                  cabinet.  
                      Set Logic:  S ^PS(58.63,"WC",X(1),DA(1))=""
                     Kill Logic:  K ^PS(58.63,"WC",X(1),DA(1))
                     Whole Kill:  K ^PS(58.63,"WC")
                           X(1):  WILDCARD CLINIC NAME  (58.65,.01)  (Subscr 1)  (forwards)




58.63,11      SEND 'PATIENT NOT ON FILE' MSG 8;1 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      JAN 25, 2016 
              HELP-PROMPT:      Enter 'YES' to generate error messages when invalid patient ID's are received. 
              DESCRIPTION:      This field contains a flag indicating whether or not an error message should be generated by the
                                inbound PADE HL7 interface when a patient ID is received that does not exist in the local system.  


58.63,12      ALTERNATE IDENTIFIER   8;2 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>30!($L(X)<1) X S X=$$UPPER^PSJPDRUT(X)
              LAST EDITED:      MAR 18, 2016 
              HELP-PROMPT:      *No editing*  
              DESCRIPTION:      This is an internal alternate identifier that is used to create the "E" cross reference used to
                                help identify the PADE dispensing device/cabinet when lower case and/or mixed case cabinet names
                                are entered.  ** Do NOT edit directly using VA FileMan.  ** 

              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER

              CROSS-REFERENCE:  58.63^E 
                                1)= S ^PS(58.63,"E",$E(X,1,30),DA)=""
                                2)= K ^PS(58.63,"E",$E(X,1,30),DA)



      FILES POINTED TO                      FIELDS

CLINIC GROUP (#57.8)              CLINIC GROUP:CLINIC GROUP (#.01)

HOSPITAL LOCATION (#44)           CLINIC LOCATION:CLINIC LOCATION (#.01)

MEDICAL CENTER DIVISION (#40.8)   DIVISION (#2)

PADE INVENTORY SYSTEM (#58.601)   PADE INVENTORY SYSTEM (#1)

WARD GROUP (#57.5)                WARD GROUP:WARD GROUP (#.01)

WARD LOCATION (#42)               WARD LOCATION:WARD LOCATION (#.01)


File #58.63

  Record Indexes:

  AC (#1377)    RECORD    MUMPS    IR    ACTION
      Short Descr:  Add device to PADE INVENTORY file (#58.601)
      Description:  This Action cross reference files new entries into the PADE INVENTORY SYSTEM (#58.601) file, if not already on
                    file.  
        Set Logic:  D FILEDEV^PSJPADIT(.X)
       Kill Logic:  Q
             X(1):  DISPENSING DEVICE  (58.63,.01)  (Subscr 1)  (forwards)
             X(2):  PADE INVENTORY SYSTEM  (58.63,1)  (Subscr 2)  (forwards)

  C (#1378)    RECORD    REGULAR    IR    LOOKUP & SORTING
       Unique for:  Key A (#125), File #58.63
      Short Descr:  Uniqueness Index for Key 'A' of File #58.63
      Description:  This cross reference enforces the uniquess of PADE devices with duplicate names. While this file may contain
                    multiple PADE dispensing devices with the same NAME (.01) field value, each duplicate name must remain unique 
                    by being associated with a different PADE INVENTORY SYSTEM (#58.601) file entry.  
        Set Logic:  S ^PS(58.63,"C",X(1),X(2),DA)=""
       Kill Logic:  K ^PS(58.63,"C",X(1),X(2),DA)
       Whole Kill:  K ^PS(58.63,"C")
             X(1):  DISPENSING DEVICE  (58.63,.01)  (Subscr 1)
             X(2):  PADE INVENTORY SYSTEM  (58.63,1)  (Subscr 2)

  D (#1381)    RECORD    REGULAR    IR    LOOKUP & SORTING
      Short Descr:  Link Division to PADE device
      Description:  This cross reference allows PADE dispensing devices to be sorted by the Division to which the device is
                    associated, to optimize lookups and reports. Each dispensing device in this file must be associated with a 
                    VistA Division in order for inbound PADE transactions to properly update PADE inventory in the PADE INVENTORY
                    SYSTEM (#58.601) file. Each dispensing device must be associated with one or more hospital locations (Wards,
                    Ward Groups, Clinics, Clinic Groups) in order for PADE inventory to display in Inpatient Order Entry.  
        Set Logic:  S ^PS(58.63,"D",X(1),$E(X(2),1,30),DA)=""
       Kill Logic:  K ^PS(58.63,"D",X(1),$E(X(2),1,30),DA)
       Whole Kill:  K ^PS(58.63,"D")
             X(1):  DIVISION  (58.63,2)  (Subscr 1)  (forwards)
             X(2):  DISPENSING DEVICE  (58.63,.01)  (Subscr 2)  (Len 30)  (forwards)


INPUT TEMPLATE(S):
PSJ PADE DISPENSING DEVICE    JAN 25, 2016@09:13  USER #0    

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):