Print Page as PDF
DBIA3239 ICR (3239)

DBIA3239    ICR (3239)

Name Value
NUMBER 3239
IA # 3239
DATE CREATED 2000/10/31
CUSTODIAL PACKAGE PHARMACY DATA MANAGEMENT
CUSTODIAL ISC Birmingham
USAGE Private
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE PSSUTIL1
NAME DBIA3239
GENERAL DESCRIPTION
This agreement allows Computerized Patient Record
System (CPRS) to pass into Pharmacy Data Management a Pharmacy Orderable Item,
and the Pharmacy application for which a medication order is being entered in
CPRS. In return, Pharmacy Data Management will return an array of active
Dispense Drugs for that Pharmacy application that are tied to the Pharmacy
Orderable Item. This call will be used by CPRS so order checks can be
performed on all Dispense Drugs tied to an Orderable Item, when a Dispense
Drug cannot be associated with a medication order in CPRS.
STATUS Active
DURATION Till Otherwise Agreed
ID PSSUTIL1
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
DRG(PSSDD,PSSOI,PSSPK)
This entry point will return all active Dispense
Drugs tied to a Pharmacy Orderable Item for a specific Pharmacy application.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSDD Input
This is simply the subscripted array name.
PSSOI Input
This variable is the internal entry number from the
PHARMACY ORDERABLE ITEM file (#50.7).
PSSPK Input
This variable indicates which package the medication
order is intended.

'O' for Outpatient, 'I' for Inpatient.
PSSDD(#;#) Output
This array contains all of the active Dispense Drugs
that are matched to the Orderable Item, for that particular package. The first
number subscript of the array is the internal entry number from the DRUG file
(#50). The second number subscript of the array (following the semicolon), is
the pointer to the VA GENERIC file (#50.6) entry that the Dispense Drug is
matched to. Each entry will be equal to the drug name.
ITEM(PSSIT,PSSDR)
This entry point accepts the Pharmacy Orderable Item
and Dispense Drug for a pharmacy order. The call determines whether or not the
Dispense Drug is still matched to the same Pharmacy Orderable Item, or if the
Dispense Drug has been rematched, and if so, will return the new Pharmacy
Orderable Item.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSIT Input
This represents the internal entry number for the
Pharmacy Orderable Item, file #50.7.
PSSDR Input
This represents the internal entry number for the
Dispense Drug, file #50.
$$ITEM Output
This is the output variable, in the following format:
0 means the Dispense Drug is matched to the same Pharmacy Orderable Item.  1^#
means the Dispense Drug is matched to a new Pharmacy Orderable Item, and piece
2 is the internal entry number for that item.  -1 means invalid data has been
passed to the call.
EN1(PSSOA,PSSOAP)
This entry point accepts a Pharmacy Orderable Item,
and a package application identifier. Based on the package, this call looks at
the formulary alternatives for all Dispense Drugs matched to the Pharmacy
Orderable Item, and finds all the Pharmacy Orderable Items that those drugs
are matched to. If an Orderable Item has at least one active Dispense Drug
matched to it for that package, that Orderable Item is returned in the call.
The purpose of this call is to provide Orderable Item formulary alternatives
to CPRS, if a non-formulary Orderable Item is selected in the medication order
process in CPRS.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSOA Input
This variable is passed by reference. The input
variable is equal to the internal entry number of the Pharmacy Orderable Item.

PSSOAP Input
This variable is passed by value. It is either "O"
for Outpatient, or "I" for Inpatient.
PSSOA Output
This is the array of Pharmacy Orderable Items that
are found as formulary alternatives, in the form of PSSOA(#)="", where # is
the internal entry number from the Pharmacy Orderable Item file.
SCH(SCH)
This entry point returns an expanded Schedule for an
Outpatient order entered through CPRS.
VARIABLES TYPE VARIABLES DESCRIPTION
SCH Input
This is the condensed Schedule of the Outpatient
order, passed by reference. Since it is passed by reference, it is returned as
the output variable, as in an expanded form if an expansion if found, or as it
was passed in.
MAXDS(INPUT)
This API accepts an array containing the Pharmacy
Orderable Item (required) and Dispense Drug (optional) and returns the maximum
number of Days Supply allowed to be dispensed for the specific medication.
VARIABLES TYPE VARIABLES DESCRIPTION
INPUT('PSOI') Input
Pointer to the PHARMACY ORDERABLE ITEM file (#50.7).
This parameter is required.
INPUT('DRUG') Input
Pointer to the DRUG file (#50). This parameter is
optional. If not passed, the API will return the  highest value from all the
dispense drugs linked to the Pharmacy Orderable Item.
$$MAXDS Output
Maximum number of days supply that can be dispensed
for the orderable item and/or dispense drug.
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE ISC
ORDER ENTRY/RESULTS REPORTING Salt Lake City
DATE ACTIVATED 2015/10/26