Print Page as PDF
DBIA3234 ICR (3234)

DBIA3234    ICR (3234)

Name Value
NUMBER 3234
IA # 3234
DATE CREATED 2000/10/30
CUSTODIAL PACKAGE PHARMACY DATA MANAGEMENT
CUSTODIAL ISC Birmingham
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE PSSORPH
NAME DBIA3234
GENERAL DESCRIPTION
With the implementation of the Pharmacy Ordering
Enhancements project, Dosages will now be stored in the DRUG file (#50), in
the form of Possible Dosages and Local Possible Dosages. When a Dispense Drug
is selected during the medication order entry process in the Outpatient
Pharmacy and Inpatient Medications applications, that drug will be passed to
the Pharmacy Data Management application, along with the Pharmacy application
and Patient. Pharmacy Data Management will pass back the available Dosages
from the DRUG file (#50) and other related information.
STATUS Active
DURATION Till Otherwise Agreed
ID PSSORPH
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
DOSE(PSSX,PD,TYPE,PSSDFN,PSSDUPD)
This entry point will be used by the Outpatient
Pharmacy and the Inpatient Medications applications. Returned in this call
will be all of the available Dosages for that drug. Additionally, other
information will be returned from the DRUG file (#50) and the DOSAGE FORM file
(#50.606) that will be used in the medication order entry process in the
Pharmacy applications.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSX Input
This is simply the name of the array to be built that
will return the information to the Pharmacy applications.
PD Input
This is the internal entry number from the DRUG file
(#50).
TYPE Input
This variable will indicate the pharmacy application
of the order. It will be "O" for Outpatient, "U" for Unit Dose, and "I" for
IV.
PSSDFN Input
This variable is optional. It is the internal entry
number from the PATIENT file (#2). It will only be used for Outpatient orders,
to calculate the maximum number of refills allowed.
PSSUPD Input
This variable is optional. If this variable is passed
in, it represents a Dispense Units per Dose value that was entered during the
medication order entry process in the pharmacy application. A new Dosage will
be calculated for this Dispense Units per Dose, and returned in the array.
PSSX(#) Output
This is the array returned in the call, subscripted
with whatever variable name is passed into the call. This output array will
increment for as many unique Drug dosages that are found. This output array is
divided into 12 pieces, separated by the "^" character. The pieces are:

Piece 1 = Possible Dosage. This piece is a numeric value, and will only have
data if it is a Possible Dosage that is being returned. This is calculated by
multiplying the Strength by the Dispense Units per Dose.

Piece 2 = Unit. This is the Unit of measure for the product. This value is
formatted via the API $$DOSE^PSSORUTE(DOSE) (see IA# 4555) in order to add
leading zeros to decimal numbers and a blank space between number and unit.

Piece 3 = Dispense Units per Dose, or Local Possible Dosage. If there is data
in piece 1 of this array, indicating that this is a Possible Dosage, then
piece 3 will be the Dispense Units per Dose for the Possible Dosage.  If piece
1 is null, then piece 3 is the Local Possible Dosage.

Piece 4 = Dispense Drug. This is the internal entry number from the DRUG file
(#50).

Piece 5 = Strength. This is a value that represents the single dose of
medication supplied by this product. This field could be null for some drugs,
such as multi-ingredient drugs.

Piece 6 = Noun. This is the Noun that is associated with the Dosage. For
example, a Dosage Form of TAB would likely have a Noun of TABLET(S).

Piece 7 = Dosage Form. This is the name of the Dosage Form of the product.

Piece 8 = Verb. This is the verb associated with the Dosage Form. Examples
would be INSTILL for the Dosage Form of SOLN,OTIC, and TAKE for the Dosage
Form of TAB.

Piece 9 = Preposition. This is the preposition associated with the Dosage
Form. Examples would be BY for the Dosage Form of TAB, and TO for the Dosage
Form of CREAM.

Piece 10 = Conjunction. This is the conjunction associated with the Dosage
Form. Most Dosage Forms would have a conjunction of OF. This is only returned
when Local Possible Dosages are being returned.

Piece 11 = Dosage Display. This is only returned for Possible Dosages. It is a
combination of Strength and Unit, which makes for a readable selection
display. This value is formatted via the API $$DOSE^PSSORUTE(DOSE) (see IA#
4555) in order to add leading zeros to decimal numbers and a blank space
between number and unit.

Piece 12 = BCMA Units Per Dose. This will only be returned for Inpatient
Orders.
PSSX('DD',#) Output
This array contains specific Drug information of the
Drug that is associated with the Dosage. For every drug entry (piece 3 of the
PSSX(#) array), there will be a corresponding entry in this PSSX("DD",
Dispense Drug IEN) array. The pieces of this array are separated by the "^"
character, and they are as follows:

Piece 1 = Name. This is the name of the Drug, the .01 field of the DRUG file
(#50).

Piece 2 = Price Per Dispense Unit. This is the price per dispense unit for
this drug.

Piece 3 = Local Non-formulary flag. If the drug is designated as
non-formulary, then a 1 will be returned in this piece, otherwise, a null will
be returned.

Piece 4 = Dispense Unit. This is the Dispense Unit for the drug.

Piece 5 = Strength. This is a value that represents the single dose of
medication supplied by this product. This field could be null for some drugs,
such as multi-ingredient drugs.

Piece 6 = Unit. This is the unit of measure of this product. This value is
formatted via the API $$DOSE^PSSORUTE(DOSE) (see IA# 4555) in order to add
leading zeros to decimal numbers and a blank space between number and unit.

Piece 7 = Maximum # of refills. This will only be returned for Outpatient
medication orders. It can be used as a default for the maximum number of
refills allowed for the medication order.

Piece 8 = This piece is not being used.

Piece 9 = Noun. This is the Noun that is associated with the Dosage. For
example, a Dosage Form of TAB would likely have a Noun of TABLET(S).

Piece 10 = Verb. This is the verb associated with the Dosage Form.  Examples
would be INSTILL for the Dosage Form of SOLN,OTIC, and TAKE for the Dosage
Form of TAB.

Piece 11 = Dosage flag. 1 means that a numeric free text entry in the dosage
field can be interpreted as a Possible Dosage, with an associated numeric
Dispense Units per Dose. 0 means that a numeric free text entry in the dosage
field cannot be interpreted as a Possible Dosage, and must be interpreted as a
Local Possible Dosage.
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE ISC
OUTPATIENT PHARMACY Birmingham
INPATIENT MEDICATIONS Birmingham
DATE ACTIVATED 2015/09/02