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

DATA          NAME                  GLOBAL        DATA
ELEMENT       TITLE                 LOCATION      TYPE
-----------------------------------------------------------------------------------------------------------------------------------
  This file is used to tailor the Inpatient Medications package with regards to specific users.  Some of these parameters (fields)
can be set by the users, and others can only be set by an Inpatient supervisor.  (A supervisor is a user who has been assigned the
'PSJU MGR' security key.) 
  This file also contains fields that are used as temporary storage of data during order entry/edit.  


              DD ACCESS: @

   APPLICATION GROUP(S): PSJ




53.45,.01     INPATIENT USER         0;1 POINTER TO NEW PERSON FILE (#200) (Required)

              INPUT TRANSFORM:  S DINUM=X
              LAST EDITED:      NOV 09, 1992 
              HELP-PROMPT:      Select an Inpatient user. 
              DESCRIPTION:
                                  This is a user for whom the Inpatient Medications package can be tailored.  

              LAYGO TEST:       1,0)= S X(1)=$D(^PS(53.45,"B",$E(X,1,30))) S:X(1) X(2)=$P($G(^VA(200,+X,0)),"^") S:$S(X(1):X(2)="",
                                1:0) X(2)=X D:X(1) EN^DDIOL("But an entry for "_X(2)_" already exists!") I 'X(1)

              GROUP:            PSJ

53.45,.02     MAY SELECT DISPENSE DRUGS 0;2 SET

                                '0' FOR NO; 
                                '1' FOR YES; 
              LAST EDITED:      AUG 20, 1991 
              HELP-PROMPT:      Answer 'YES' if this user can select dispense drugs when entering orders. 
              DESCRIPTION:        Unless the user is a pharmacist, the user can be set up to allow Unit Dose orders to be entered
                                by Orderable Item or Dispense Drug. If selection is by dispense drug the order's Orderable Item
                                will be determined based on that dispense drug.  

              TECHNICAL DESCR:    When entering new Unit Dose orders pharmacists select directly from the DRUG file (#50). The
                                order's Orderable Item is determined from the Orderable Item assigned to the entry selected from
                                the DRUG file (#50).  Users who are not identified as pharmacists may only select from the PHARMACY
                                ORDERABLE ITEM file (#50.7) unless this field is set to 'YES'.  

              GROUP:            PSJ

53.45,.03     ALLOW USER TO RENEW ORDERS 0;3 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      JAN 19, 1992 
              HELP-PROMPT:      Answer 'YES' to allow this ward clerk (or pharmacy technician) to renew orders. 
              DESCRIPTION:        If this is set to 'YES', this ward clerk/pharmacy technician may actually renew orders for
                                patients on this ward. If this is set to 'NO' (or not set), this clerk/technician can only mark
                                orders to be renewed. 

              TECHNICAL DESCR:    For ward clerks and pharmacy technicians.  Used by the renewal routines to determine if the user
                                can renew orders or only mark the orders to be renewed later by a nurse or pharmacist.  Can only be
                                edited by a supervisor.  

              GROUP:            PSJ

53.45,.04     ALLOW USER TO HOLD ORDERS 0;4 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      JAN 19, 1992 
              HELP-PROMPT:      Answer 'YES' to allow this ward clerk/pharmacy technician to hold/unhold orders. 
              DESCRIPTION:        If this is set to 'YES', this ward clerk/pharmacy technician may actually place Inpatient orders
                                on hold or take orders off of hold.  If this is set to 'NO' (or not set), this clerk/technician can
                                only mark orders for hold/unhold, and only a pharmacist or nurse can hold/unhold the orders.  

              TECHNICAL DESCR:    Used by the hold routines to determine if this ward clerk/pharmacy technician can actually place
                                an order on hold or take an order off of hold.  Can only be set by a supervisor.  

              GROUP:            PSJ

53.45,.05     ALLOW USER TO D/C ORDERS 0;5 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      JUL 09, 1992 
              HELP-PROMPT:      Answer 'YES' to allow this ward clerk/pharmacy technician to discontinue orders. 
              DESCRIPTION:        If this is set to 'YES', this ward clerk/pharmacy technician may actually cancel patients'
                                Inpatient orders.  If this is set to 'NO' (or not set), this clerk/technician can only mark orders
                                to be cancelled by another user.  

              TECHNICAL DESCR:    For ward clerks and pharmacy technicians.  Used by the cancel routines to determine if the user
                                can cancel orders or only mark the orders to be canceled later by another user.  Can only be set by
                                a supervisor.  

              GROUP:            PSJ

53.45,.06     PRINT PROFILE IN ORDER ENTRY 0;6 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      NOV 27, 1991 
              HELP-PROMPT:      Answer 'YES" for the opportunity to print a profile after entering Unit Dose orders for a patient. 
              DESCRIPTION:        If you answer 'YES' here, you will be given the opportunity to print a profile for a patient
                                after entering Unit Dose orders for the patient.  

              TECHNICAL DESCR:    Used by the order entry routines to determine if the user should be given the opportunity to
                                print a profile for a patient after entering orders for the patient.  Can be set by the user.  

              GROUP:            PSJ

53.45,.07     *LABEL PRINTER         0;7 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>20!($L(X)<1) X I $G(X)]"" D ENDLP^PSGSET
              LAST EDITED:      MAY 15, 1998 
              HELP-PROMPT:      Select the device to which you want your labels to print. 
              DESCRIPTION:        This is a device to which labels created by this user will print.  If a device is entered here,
                                it will be used instead of any device selected for the ward or pharmacy to print label created by
                                this user.  

              TECHNICAL DESCR:    This is the device the user selects for label printing.  If the user does enter a device here,
                                that device will be used instead any device selected for the ward or pharmacy.  This can be edited
                                by the user.  

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


53.45,.08     TYPE OF USER           0;8 SET

                                '3' FOR PHARMACIST; 
                                '2' FOR PHARMACY TECHNICIAN; 
                                '1' FOR NURSE; 
                                '0' FOR WARD STAFF; 
              LAST EDITED:      NOV 29, 1991 
              HELP-PROMPT:      Is this user a Pharmacist, Nurse, Pharmacy Technician, or Ward Staff? 
              DESCRIPTION:        This is used to define what type of user this user is.  The type of user helps define what
                                actions the user can or cannot take on Inpatient Medications orders.  If no entry is made here, the
                                user is assumed to be WARD STAFF.  

              TECHNICAL DESCR:    This allows the supervisor to define what type of user the site's users are to the package.  This
                                is only editable by the supervisor.  

              GROUP:            PSJ

53.45,.09     ALLOW AUTO-VERIFY FOR USER 0;9 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      NOV 29, 1991 
              HELP-PROMPT:      Answer 'YES' if verification can be automatic when this user enters orders. 
              DESCRIPTION:        This is used to determine if the user can enter Unit Dose orders as ACTIVE, allowing the user to
                                skip the extra step of manually verifying those orders entered by this user.  

              TECHNICAL DESCR:    If this is set to 'YES' for a user that has been designated as a nurse or pharmacist, orders
                                entered by this user will be transcribed as ACTIVE (by the routine PSGOETO).  This is editable only
                                by the supervisor.  

              GROUP:            PSJ

53.45,.1      USE WARD LABEL SETTINGS 0;10 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      DEC 05, 1991 
              HELP-PROMPT:      Answer 'YES' to have any labels created by your actions print on the printer designated for the 
                                ward instead of the printer designated for the pharmacy. 
              DESCRIPTION:        This allows the pharmacist (or pharmacy technician) that may be working on the ward(s) to use the
                                label settings defined for the ward(s) instead of the label setting defined for the pharmacy.  
                                  PLEASE NOTE that if you have defined a LABEL PRINTER, that printer will always be used to print
                                labels instead of either the ward or pharmacy label printer.  

              TECHNICAL DESCR:    This allows pharmacists and pharmacy technicians to use the label settings defined for the
                                ward(s) instead of those label setting defined for th pharmacy.  This is most useful when the
                                pharmacist or tech is working mostly on the wards.  This is editable by the user, but only those
                                users designated as either a pharmacist or tech.  
                                  PLEASE NOTE that if the user has defined a LABEL PRINTER (field #7), that printer is always used
                                instead of either the ward label printer or the pharmacy printer.  

              GROUP:            PSJ

53.45,.11     INPATIENT PROFILE ORDER SORT 0;11 SET

                                '0' FOR MEDICATION NAME; 
                                '1' FOR START DATE OF ORDER; 
              LAST EDITED:      DEC 03, 1991 
              HELP-PROMPT:      Enter how the Inpatient profile is to sort and show orders. 
              DESCRIPTION:        This is the sort order in which the Inpatient Profile will show inpatient orders.  Enter
                                'MEDICATION NAME' (or '0') to show the orders alphabetically by drug name.  Enter 'START DATE OF
                                ORDER' (or '1') to show the orders chronologically by start date, with the most recent dates 
                                showing first.  
                                  PLEASE NOTE - The profile will always first show orders by status (active, non-verified, and then
                                non-active), and within status, schedule type (continuous, one-time, and then PRN).  

              TECHNICAL DESCR:    This allows the user to define the order in which Inpatient Medications orders are shown on an
                                Inpatient profile.  This is also used by the Inpatient profile shown in the LABEL PRINT/REPRINT
                                option.  This is editable by the user.  

              GROUP:            PSJ

53.45,.12     ORDER ENTRY PROCESS    0;12 SET

                                '0' FOR REGULAR; 
                                '1' FOR ABBREVIATED; 
                                '2' FOR WARD; 
              LAST EDITED:      JAN 25, 1992 
              HELP-PROMPT:      Enter the type of Unit Dose order entry to be used by this user. 
              DESCRIPTION:        This is the type of order entry process to be used by this user.  The REGULAR order entry is the
                                full set of prompts for the entry of an order, after which the user is shown a full view of the
                                order and allowed to take immediate action on the order. The ABBREVIATED order entry gives the user 
                                fewer prompts for the entry of an order, after which the user is shown a full view of the order and
                                is allowed to take immediate action on the order.  The WARD order entry gives the user the same
                                prompts as the ABBREVIATED order entry, but then gives a brief view of the entered order and does 
                                not allow immediate action to be taken on the order.  No entry here is the same as selecting
                                REGULAR order entry.  
                                 
                                  This does not affect the entering of Inpatient Medication orders through the Order Entry/Results
                                Reporting (OE/RR) package.  This is only for the entering of Unit Dose orders through the Unit Dose
                                Order Entry option and the Inpatient Order Entry option.  

              TECHNICAL DESCR:    This is used by the Unit Dose order entry functionality to determine the order entry process to
                                be given each user.  This is referenced in the routines PSGOE0 and PSJOE0.  This does not affect
                                OE/RR.  

              GROUP:            PSJU

53.45,.13     LABEL PRINTER POINTER  0;13 POINTER TO DEVICE FILE (#3.5)

              LAST EDITED:      APR 08, 1998 
              HELP-PROMPT:      Select the device to which labels created by this user will print. 
              DESCRIPTION:      This is a device to which labels created by this user will print. If a device is entered here, it
                                will be used instead of any device selected for the ward or pharmacy to print labels created by
                                this user.  

              TECHNICAL DESCR:  This is the device the user selects for label printing. If the user does enter a device here, that
                                device will be used instead of any device selected for the ward or pharmacy. This can be edited by
                                the user.  


53.45,1       COMMENTS               1;0   WORD-PROCESSING #53.4501

              TECHNICAL DESCR:    Used by the Inpatient Medications package as temporary storage when processing orders.  This
                                should not be directly accessed by any user.  

              GROUP:            PSJ

                LAST EDITED:      JUL 02, 1991 
                DESCRIPTION:
                                    This is any comments, notes, instructions, etc. that a user may enter for an order.  

                GROUP:            PSJ



53.45,2       DISPENSE DRUG          2;0 POINTER Multiple #53.4502

              LAST EDITED:      DEC 09, 1997 
              DESCRIPTION:        This is the medication(s) that will actually be dispensed by the pharmacy for the Unit Dose
                                order.  

              TECHNICAL DESCR:    Used by the Inpatient Medications package as temporary storage when processing orders.  This
                                should not be directly accessed by the user.  

              GROUP:            PSJ

53.4502,.01     DISPENSE DRUG          0;1 POINTER TO DRUG FILE (#50) (Multiply asked)

                INPUT TRANSFORM:S DIC("S")="I $P($G(^(2)),U,3)[""U"",$S('$G(PSGPDRG):1,1:PSGPDRG=+$G(^(2))) I (($G(^PSDRUG(+$G(Y),"
                                "I""))>(DT-1))!'$G(^PSDRUG(+$G(Y),""I"")))" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
                LAST EDITED:    MAY 09, 2011 
                SCREEN:         S DIC("S")="I $P($G(^(2)),U,3)[""U"",$S('$G(PSGPDRG):1,1:PSGPDRG=+$G(^(2)))"
                EXPLANATION:    Only dispense drugs marked for Unit Dose use.
                EXECUTABLE HELP:I $G(PSGPDRG) S X(1)=$G(PSGPDRGN) S:X(1)="" X(1)=PSGPDRG S X(1)="Only dispense drugs tied to the Or
                                derable Item "_X(1)_" are selectable." D EN^DDIOL(" ") F X(2)=1:1:$L(X(1)," ") S X(3)=$P(X(1)," ",X
                                (2)) D:$L(X(3))+$X>78 EN^DDIOL(" "_X(3))
                PRE-LOOKUP:     S DIC("S")="I 1"
                DELETE TEST:    1,0)= D:$G(PSGOEEND) EN^DDIOL("Dispense Drugs for active orders cannot be deleted, but can be given
                                 an INACTIVE DATE.") D:$G(PSJPNDRN)&$G(^PS(53.1,+$G(ON),1,+$G(DA),0)) EN^DDIOL($P(PSJPNDRN,"^",2)) 
                                I $G(PSGOEEND)!$G(PSJPNDRN)

                LAYGO TEST:     1,0)= S X(1)=$D(^PS(53.45,DA,2,"B",+X)) D:X(1) EN^DDIOL("This dispense drug has already been entere
                                d for this order.") I 'X(1)

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

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


53.4502,.02     UNITS PER DOSE       0;2 NUMBER

                UNITS PER DOSE   
                INPUT TRANSFORM:S:X?1.2N1"/"1.2N X=+$J(+X/$P(X,"/",2),0,2) K:X'?.N.1".".N!(X>30)!(X<0)!(X?.E1"."5.N) X
                OUTPUT TRANSFORM:S Y=$S(Y=.5:"1/2",Y=.25:"1/4",Y?1".".N:"0"_Y,1:Y)
                LAST EDITED:    FEB 20, 2003 
                HELP-PROMPT:    Enter a number between 0 and 30, no more than 4 decimals (will accept fractions). 
                DESCRIPTION:      This is the number of UNITS (tablets, capsules, etc.) to be dispensed as a DOSE for this order. 
                                The literals '1/2' and '1/4' may be entered.  If there is no entry (or an entry of `0'), it is
                                assumed to be ONE (1).  
                                                          ** PLEASE NOTE ** 
                                 1. If the provider prescribes 30 ml's of a medication that is usually dispensed and administered
                                as 60 ml's, the correct UNITS PER DOSE would be `1/2' (or .5), NOT 30 ml's.  The correct entry of
                                30 ml's would be in the DOSAGE ORDERED field.  
                                 2. If the UNITS PER DOSE prescribed is a variable amount (1-2 tab.), it is suggested that the
                                maximum amount be entered and the actual amount prescribed noted either in the DOSAGE ORDERED or
                                SPECIAL INSTRUCTIONS fields.  

                EXECUTABLE HELP:D EN^DDIOL("ONE (1) UNIT PER DOSE WILL BE ASSUMED IF THERE IS NO ENTRY (OR AN ENTRY OF ZERO (0)) IN
                                TO THIS FIELD.")
                GROUP:          PSJU
                NOTES:          XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER


53.4502,.03     INACTIVE DATE        0;3 DATE

                INPUT TRANSFORM:S %DT="EX" D ^%DT S X=Y K:Y<1 X
                LAST EDITED:    APR 26, 1992 
                HELP-PROMPT:    Enter the date that this drug will no longer be dispense for this order. 
                DESCRIPTION:      This is the date that this dispense drug will no longer be dispensed for this order.  Once an
                                order becomes active, dispense drugs cannot be deleted.  

                TECHNICAL DESCR:
                                  This is used by pharmacy when the dispense drug is no longer to be dispensed for the order.  

                GROUP:          PSJU



53.45,4       PROVIDER COMMENTS      4;0   WORD-PROCESSING #53.4504

              TECHNICAL DESCR:    This is used by the Inpatient Medications package as temporary storage when processing orders to
                                provide rudimentary transactional processing.  Any data found here is deleted prior to each time
                                this is used.  This should not be directly edited.  

              GROUP:            PSJ

                LAST EDITED:      NOV 14, 1991 
                DESCRIPTION:        This is any comments about the order that the provider needs to pass along to the pharmacy and
                                  ward personnel.  

                TECHNICAL DESCR:    This is used by the Inpatient Medications package as temporary storage when processing orders
                                  to allow for rudimentary transactional processing.  

                EXECUTABLE HELP:  I $G(PSGORD),$G(PSGOEE)="R" D ENVPPC^PSGOER1
                GROUP:            PSJ



53.45,5       SPECIAL INSTRUCTIONS   5;0   WORD-PROCESSING #53.455   (NOWRAP)   (IGNORE "|")

              TECHNICAL DESCR:  This is used by the Inpatient Medications package as temporary storage when processing orders to
                                provide rudimentary transactional processing. Any data found here is deleted prior to each time
                                this is used. This should not be directly edited.  


                LAST EDITED:      NOV 02, 2011 
                DESCRIPTION:      This is any special instructions needed for this order. This would include the reason for
                                  ordering a PRN.  

                TECHNICAL DESCR:  This is used by the Inpatient Medications package as temporary storage when processing orders to
                                  provide rudimentary transactional processing.  Any data found here is deleted prior to each time
                                  this is used. This should not be directly edited.  




53.45,6       OTHER PRINT INFO       6;0   WORD-PROCESSING #53.456   (NOWRAP)   (IGNORE "|")

              LAST EDITED:      JAN 11, 2012 
              TECHNICAL DESCR:  This is used by the Inpatient Medications package as temporary storage when processing orders to
                                provide rudimentary transactional processing. Any data found here is deleted prior to each time
                                this is used. This should not be directly edited.  


                LAST EDITED:      NOV 04, 2011 




      FILES POINTED TO                      FIELDS

DEVICE (#3.5)                     LABEL PRINTER POINTER (#.13)

DRUG (#50)                        DISPENSE DRUG:DISPENSE DRUG (#.01)

NEW PERSON (#200)                 INPATIENT USER (#.01)



INPUT TEMPLATE(S):
PSJ IUP SUPER EDIT            JAN 25, 1992@18:16  USER #0    
       Used by the Inpatient Medications package to allow Inpatient Supervisors
     to tailor some aspects of how the packge should work for specific users.
PSJ IUP USER EDIT             APR 09, 1998@15:15  USER #0    
       Used by the Inpatient Medications package to allow users to tailor
     various aspects of how the package works for themselves.

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):