| PSSX |
Input |
This is simply the name of the array to be built that
will return the information to CPRS.
|
PD |
Input |
This is the internal entry number from the PHARMACY
ORDERABLE ITEM file (#50.7) of the selected Orderable Item in the CPRS
medication order entry process.
|
TYPE |
Input |
This variable will indicate the Pharmacy package of
the order. It will be "O" for Outpatient, "U" for Unit Dose, or "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 package
orders, to calculate the maximum number of refills allowed.
|
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 6 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. Similar to piece 1, this is a numeric
value, and will only be returned if a Possible Dosage is being returned. This
value multiplied by the Strength will be the Possible Dosage.
Piece 4 = 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 5 = Instructions. This can be used for the dosage selection. For a
Possible Dosage, it is the numeric dosage concatenated with the Unit. Some
examples would be 325 MG, 650 MG, and 10 MG/15 ML. For a Local Possible
Dosage, it would be a text dosage. Some examples would be 1 DROP, 2 DROPS, and
1 TEAPSOONFUL. 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 6 = Dispense Drug. This is internal entry number from the DRUG file
(#50).
Piece 7 = Price. If the Drug has a Price Per Dispense Unit associated with it,
this will be that price times the Dispense Units per Dose. If the Dosage does
not have a Dispense Units per Dose, and does not have a Price Per Dispense
Unit, this will be null.
|
PSSX('DD',Dispense Drug) |
Output |
This array contains specific Drug information of the
Drug that is associated with the Dosage. For every drug entry (piece 6 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 = Dosage Form. This is the name of the Dosage Form of the product.
Piece 8 = 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 9 = Schedule requirement flag. This is always set to 1. This piece is
not currently used.
Piece 10 = DEA Special Handling Flag. This field can have 1 of 3 values:
1 = The DEA Special Handling field contains a "1", or contains a "2".
This indicates that a wet signature is required.
2 = The DEA Special Handling field does not meet wet signature
requirements, but does indicate a Controlled Substance. This is the
case if the field contains a "3", or a "4", or a "5".
0 = All others.
Piece 11 = Flag for splitting Dosage Form. This will be a 0 or a 1. The only
time it will be a 1 is if there are Possible Dosages associated with the drug,
and there is at least 1 Possible Dosage that is entered for the drug with a
decimal point. This indicates that the Dosage Form can be split.
|
PSSX('MISC') |
Output |
This array contains information relating to the
Dosage Form that is associated with the selected Orderable Item. It contains 3
pieces, separated by the "^" character. The pieces are:
Piece 1 = 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 2 = 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 3 = Conjunction. This is the conjunction associated with the Dosage
Form. Most Dosage Forms would have a conjunction of OF.
|
PSSX(#,#) |
Output |
This array contains the same information as the
PSSX(#) array. This array is only returned when Possible Dosages are being
returned, and there are duplicate Possible Dosages with different Dispense
Units per Dose. The PSSX(#) array would contain the Possible Dosage with the
lowest Dispense Units per Dose, and the PSSX(#,#) arrays would contain all
other Possible Dosages with higher Dispense Units per Dose.
|
PSSX('PI',#) |
Output |
This array holds the default Patient Instructions
from the Pharmacy Orderable Item (#50.7) file.
|
PSSX('DEA') |
Output |
This output variable indicates the DEA Special
Handling code at the Pharmacy Orderable Item level, based on dispense drugs
matched to the Item. This variable can be one of four values, a "1", a "2", a
"0", or null. If a "1" is returned, that indicates that there is at least one
active dispense drug matched to that Pharmacy Orderable Item for the specified
package, that has a DEA Special Handling Code that contains a "1", or contains
a "2". This means that a wet signature is required. If a "2" is returned, that
indicates that the first condition wasn't met, and that there is at least one
active dispense drug matched to that Pharmacy Orderable Item for the specified
package, that has a DEA Special Handling Code that contains a "3", or contains
a "4", or contains a "5". This means a wet signature is not required, but it
does indicate a Controlled Substance. A "0" is returned if neither of the
first two conditions are met, but there are active drugs matched to the
Pharmacy orderable Item for the specified package. If there are no active
drugs for the specified package matched to the Pharmacy Orderable Item, then a
null is returned.
|