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.
|
|
|
|