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
CREATOR ROCHA,MARCELO
DBA Comments
10/21/15-MM:  Opened ICR #3239 for editing for the Pharmacy
Safety Updates Project.  The project team is enhancing the maximum of number
of Days Supply allowed for outpatient medication through the Pharmacy Safety
Updates Project (PSS*1*189, PSO*7*444, PSJ*5*313, PSN*4*429 and IB*2*545).
Part of this project consists of providing a PSS API to the CPRS application
that will return the Maximum Days Supply allowed for a specific medication.
They are modifying the existing PSS API routine PSSUTIL1 to include a new API
called $$MAXDS^PSSUTIL1, which was designed specifically to be invoked by
CPRS.

Associated CPRS patch is OR*3*377 (CPRS GUI v31).

10/26/15-MM: ICR #3239 has been activated for th Pharmacy Safety Updates
Project (PSS*1*189, PSO*7*444, PSJ*5*313, PSN*4*429 and IB*2*545).
DATE ACTIVATED 2015/10/26
MAIL MESSAGE 33057731
DATE/TIME EDITED
DATE/TIME EDITED ACTION AT THE REQUEST OF WITH CONCURRENCE OF
2015/10/21 17:27 DEACTIVATED FOR EDITS ROCHA,MARCELO ROCHA,MARCELO
2015/10/26 14:54 APPROVED ROCHA,MARCELO HAWSEY,JASON
Generated from AUG 12, 2020@ IA Listing Descriptions