PSSOPKI1    ICR (3739)

This is the name of the array to be built that will
return the information to CPRS.

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.

This variable will indicate the Pharmacy package of
the order. It will be "O" for Outpatient, "U" for Unit Dose, or "I" for "IV".

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.

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 7 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 BCMA Units per Dose
for that Dosage. If there is no BCMA Units per Dose for that
Dosage, this will be Price Per Dispense Unit times the Dispense
Units per Dose. If the Dosage does not have a BCMA Units per
Dose, and does not have a Price Per Dispense Unit, this will be
null.

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 = CS FEDERAL SCHEDULE code / DEA SPECIAL HDLG code, it can
have one of the following values:
1;1  -  Schedule I Narcotics
1;2  -  Schedule II Narcotics
1;2n -  Schedule II Non-Narcotics
2;3  -  Schedule III Narcotics
2;3n -  Schedule III Non-Narcotics
2;4  -  Schedule IV Narcotics
2;5  -  Schedule V Narcotics
0    -  for other active drugs
"" (Null)- There are no active drugs for the given package.

Schedule I-V Narcotics will have a 2 piece value separated
by a semicolon. 1st piece makes it compatible with the old API
3233, where 1 requires a wet signature and 2 does not.
2nd piece provides the controlled substance schedule.

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.

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.

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.

This array holds the default Patient Instructions
from the Pharmacy Orderable Item (#50.7) file.

This output returns the most restrictive CS FEDERAL
SCHEDULE code / DEA SPECIAL HDLG code for a Pharmacy Orderable Item, based on
the Dispense Drugs that are associated with that Pharmacy Orderable Item, and
they are derived as follows: If any of the active dispense drugs associated
with the orderable item for the specified package are matched to an entry in
the National Drug File, then the most restrictive CS FEDERAL SCHEDULE code
from the National Drug File will be returned. If there is no match or the CS
FEDERAL SCHEDULE code is undefined then the most restrictive DEA SPECIAL HDLG
code mapped to the corresponding CS FEDERAL SCHEDULE code as listed below will
be returned.

DEA, SPECIAL HDLG      CS FEDERAL SCHEDULE
1                      1    (Schedule I narcotics)
2A                     2    (Schedule II narcotics)
2C                     2n   (Schedule II non-narcotics)
3A                     3    (Schedule III narcotics)
3C                     3n   (Schedule III non-narcotics)
4                      4    (Schedule IV narcotics)
5                      5    (Schedule V narcotics)

This output variable will have the most restrictive CS FEDERAL SCHEDULE code
or the DEA SPECIAL HDLG code as mapped to the corresponding CS FEDERAL
SCHEDULE code (as defined below), of the active Dispense Drugs that are
matched to the Pharmacy Orderable Item for the specified package.

It can have one of the following values:

1;1  -  Schedule I Narcotics 1;2  -  Schedule II Narcotics - requires a wet
signature 1;2n -  Schedule II Non-Narcotics - requires a wet signature 2;3  -
Schedule III Narcotics 2;3n -  Schedule III Non-Narcotics 2;4  -  Schedule IV
Narcotics 2;5  -  Schedule V Narcotics 0    -  None of the above but there are
active drugs matched to the
Pharmacy Orderable Item for the specified package "" (Null)- There are
no active drugs for the specified package matched to
the Pharmacy Orderable Item.  Schedule I-V Narcotics will return a
2 piece value separated by a semicolon. 1st piece makes it compatible with the
old API 3233, where value 1 requires a wet signature and 2 does not.

2nd piece provides the controlled substance schedule.