Print Page as PDF
DBIA 5425 ICR (5425)

DBIA 5425    ICR (5425)

Name Value
NUMBER 5425
IA # 5425
DATE CREATED 2009/04/07
CUSTODIAL PACKAGE PHARMACY DATA MANAGEMENT
USAGE Private
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE PSSDSAPI
NAME DBIA 5425
GENERAL DESCRIPTION
This DBIA provides various components that will be used
for Pharmacy Re-engineering order checking functionality.
STATUS Active
DURATION Till Otherwise Agreed
ID PSSDSAPI
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
$$EXMT(PSSVLIEN)
This component tells whether or not an entry from the
DRUG (#50) file should have Dosing checks performed against it.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSVLIEN Input
This is the Internal Entry Number from the DRUG (#50)
File. (Required)
$$EXMT Output
A '1' indicates the entry is exempt from Dosing
checks, a '0' indicates the entry is not exempt from Dosing checks.
$$SUP(PSSSPLIN)
This component tells whether or not an entry in the
DRUG (#50) File is marked as a Supply item or not. If marked as a Supply,
there is no need to do Drug Interaction and Duplicate Therapy order checks
against the item.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSSPLIN Input
This is the Internal Entry Number from the DRUG (#50)
File. (Required)
$$SUP Output
A '1' indicates that the item is marked as a Supply
item, and Drug Interaction and Duplicate Therapy order checks do not need to
be performed against this item. A '0' indicates the item is not marked as a
Supply item, and that Drug Interaction and Duplicate Therapy order checks
should be performed against this item.
$$MRT(PSSRS1)
This component returns the Standard Medication Route
mapping and it's associated First DataBank Medication Route for an entry in
the MEDICATION ROUTES (#51.2) File.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSRS1 Input
This is the Internal Entry Number from the MEDICATION
ROUTES (#51.2) File. (Required)
$$MRT Output
This is a two piece result, delimited by the '^'
character. The first piece is the NAME (#.01) Field from the STANDARD
MEDICATION ROUTES (#51.23) File entry that the entry in the MEDICATION ROUTES
(#51.2) File is mapped to. The second piece is the FIRST DATABANK MED ROUTE
(#1) Field from the STANDARD MEDICATION ROUTES (#51.23) File for that same
entry. The '^' character is always returned, regardless of whether or not
there is data in either of the two pieces.
$$UNIT(PSSVUTUN)
This component returns the FIRST DATABANK DOSE UNIT
(#1) Field from the DOSE UNITS (#51.24) File for the Drug Unit that is passed
in.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSVUTUN Input
This is the text value of the Drug Unit. This usually
will come from the NAME (#.01) Field of the DRUG UNITS (#50.607) Field.
(Required)
$$UNIT Output
This is the FIRST DATABANK DOSE UNIT (#1) Field from
the DOSE UNITS (#51.24) File. A null will be returned if no FIRST DATABANK
DOSE UNIT value can be found.
$$DS
This component tells the calling application whether
or not the Dosing Order checks should be invoked.
VARIABLES TYPE VARIABLES DESCRIPTION
$$DS Output
If '1', Dosing checks are enabled and should be
invoked. If '0^reason', Dosing checks are not enabled and should not be
invoked. Piece 2 (reason), using '^' as the delimiter, is a reason that can be
displayed to the end user.
$$IV(PSSADFOI)
This component returns a default value to
Computerized Patient Record System (CPRS) for the Additive Frequency field,
for continuous IV orders that are entered with additives. All active IV
Additives that are matched to the Pharmacy Orderable Item are evaluated, and
for any value other than null to be returned, all entries must be set to the
same value.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSADFOI Input
This is the internal entry number from the PHARMACY
ORDERABLE ITEM (#50.7) File.
$$IV Output
This will be equal to the internal code value from
the ADDITIVE FREQUENCY (#18) Field of the IV ADDITIVES (#52.6) File. If a
value from the list of codes cannot be determined, a null will be returned.
$$BSA(PSSBSADF)
This component returns a patients height (in
centimeters), weight (in kilograms), and Body Surface Area. The Body Surface
Area is calculated using the DuBois formula.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSBSADF Input
This is the Internal Entry Number from the PATIENT
(#2) File.
$$BSA Output
This is a three-piece variable delimited by the '^'
character. Piece 1 is the patients height, in centimeters. Piece 2 is the
patients weight, in kilograms. Piece 3 is the patients Body Surface Area. If
height is not entered for the patient in VistA, a 0 (zero) will be returned
for height.  If weight is not entered for the patient in VistA, a 0 (zero)
will be returned for weight. If weight or height is not entered for the
patient in VistA, a 0 (zero) will be returned for Body Surface Area.
$$UNITD(PSSDBI4)
This component returns the FIRST DATABANK DOSE UNIT
(#1) Field from the DOSE UNITS (#51.24) File for the Drug Unit that is passed
in. It will only return data from an entry in the file if the DOSE FORM
INDICATOR (#3) Field is set to NO for that entry.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSDBI4 Input
This is the text value of the Drug Unit. (Required)
$$UNITD Output
This is the FIRST DATABANK DOSE UNIT (#1) Field from
the DOSE UNITS (#51.24) File. A value will only be returned for an entry the
has the DOSE FORM INDICATOR (#3) Field set to NO. A null will be returned if
no FIRST DATABANK DOSE UNIT value can be found.
$$FRQ(PSSFWSCC,PSSFWFR,PSSFWPK,PSSFWDRC,PSSFWDRG)
This component returns Frequency information to be
used for the Daily Dose checks.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSFWSCC Input
This is the free text schedule. (required)
PSSFWFR Input
This is the numeric frequency in minutes. A 'D' may
also be passed in to indicate that this is a Day Of Week schedule. (optional)
PSSFWPK Input
This is the package use. 'O' for Outpatient, 'I' for
Inpatient. (required)
PSSFWDRC Input
This is the duration. (Optional) The following format
is required: '120M' will represent 120 minutes.  '12H'  will represent 12
hours '3D'  will represent 3 days.  '2W'  will represent 2 weeks.  '1L'  will
represent 1 month.

If only a numeric is passed in with no alpha, Days will be assumed.
PSSFWDRG Input
This is the Internal Entry Number from the DRUG (#50)
File. (Optional) This data is used to check for the Dosing Check Frequency
specified for this drug.

Please note that this Input Variable (PSSFWDRG) will not be valid to pass in
until the installation of patch PSS*1.0*178.
$$FRQ Output
This is the returned frequency, in 2 pieces,
separated by the '^' character. Piece 1 is the adjusted daily frequency, an
adjustment may have to be made if a duration is passed in. Piece 2 is the
Daily Frequency solely based on the schedule. For example, if 'Q2H' is passed
in with no duration, the returned value will be '12^12'. If 'Q2H' is passed in
with a duration of '8H', the returned value would be '4^12', since the '8H'
duration limits the number of doses in the day. The return can be numeric, or
it can be in the text format that the Vendor can use. For example, a valid
return could be "Q2D^Q2D".
SUBSCRIBING PACKAGE
DATE ACTIVATED 2014/06/19