Print Page as PDF
OE/RR CALLS TO PSOORRL ICR (2400)

OE/RR CALLS TO PSOORRL    ICR (2400)

Name Value
NUMBER 2400
IA # 2400
DATE CREATED 1998/05/10
CUSTODIAL PACKAGE OUTPATIENT PHARMACY
CUSTODIAL ISC Birmingham
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE PSOORRL
NAME OE/RR CALLS TO PSOORRL
GENERAL DESCRIPTION
Order Entry/Results Reporting requests approval to make
the following calls to PSOORRL.

Patch PSO*7*622 updated OCL^PSOORRL with two new parameters to accept a second
set of date ranges for Inpatient Medications. Previously, this API only
supported one set of date ranges used for both Outpatient Medications and
Inpatient Medications. Existing callers of this API will not see any change in
behavior, as if nothing is passed into the new parameters, it will behave as
it did previously. Only if a caller wishes to use different date ranges for
Outpatient/Non-VA Medications and Inpatient Medication they need to utilize
the new parameters.
STATUS Active
DURATION Till Otherwise Agreed
ID PSOORRL
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
OCL
Called to return a list of meds.

OCL^PSOORRL(DFN,STARTDATEOUT,ENDDATEOUT,VIEW,STARTDATEINP,ENDDATEINP)

Passed: DFN - Patient's Internal Pointer

StartdateOut - Date/Time to start search for Outpatient & Non-VA
medications (optional)
EnddateOut - Date/Time to terminate search for Outpatient & Non-VA
medications (optional)
View - Sort format for the returned display. (optional) StartdateInp -
Date/Time to start search for Inpatient medications
(Optional)
EnddateInp - Date/Time to terminate search for Inpatient medications
(Optional) Note: If both StartdateInp and EnddateInp are not
passed in to the API, then StartdateOut and EnddateOut will also be used for
the Inpatient medications date range.


Returned: ^TMP("PS",$J,D0,0)=ORDER #_File;PKG^DRUG^INFUSION RATE^STOP
DATE^REFILLS REMAINING^TOTAL DOSE^UNITS PER DOSE^PLACER  #^STATUS^LAST
FILLDATE^DAYS SUPPLY^QUANTITY^NOT TO BE GIVEN^PENDING  RENEWAL (1 or
0)^ISSUE DATE(Outpatient) or START DATE(Inpatient)^LAST RELEASE
DATE/TIME^LAST FILL DAY SUPPLY

File:
R;O = prescription (file #52),
P;O = pending outpatient order (file #52.41),
N;O = Non-VA Med (file #55, subfile #55.05),
P;I = pending inpatient order (file #53.1),
U;I = unit dose order (file #55, subfile 55.06),
V;I = IV order (file #55, subfile 55.01)

PKG = I (inpatient) or O (outpatient)

^TMP("PS",$J,D0,"MDR",0)= # of LINES ^TMP("PS",$J,D0,"MDR",D1,0)=MED ROUTE
ABBR. ^TMP("PS",$J,D0,"SCH",0)= # of LINES
^TMP("PS",$J,D0,"SCH",D1,0)=SCHEDULE  NAME

^TMP("PS",$J,D0,"A",0)= # of LINES ^TMP("PS",$J,D0,"A",D1,0)=ADDITIVE
NAME^AMOUNT^BOTTLE

^TMP("PS",$J,D0,"B",0)= # of LINES ^TMP("PS",$J,D0,"B",D1,0)=SOLUTION
NAME^AMOUNT

^TMP("PS",$J,D0,"P",0)=IEN^.01 of VA 200

^TMP("PS",$J,D0,"SIG",0)= # of LINES ^TMP("PS",$J,D0,"SIG",D1,0)=SIG
(outpatient) or INSTRUCTIONS (inpatient)

^TMP("PS",$J,"ADM",0)= # of LINES ^TMP("PS",$J,"ADM",D1,0)=ADMINISTRATION
TIMES Where: administration time = Free text 2-119 characters

^TMP("PS",$J,"RMV",0)= # of LINES ^TMP("PS",$J,"RMV",D1,0)=REMOVAL TIMES
Where: Removal time = Free text 2-119  characters

^TMP("PS",$J,"SIO",0)= # of LINES ^TMP("PS",$J,"SIO",D1,0)=SPECIAL
INSTRUCTIONS/OTHER PRINT INFO (Special instructions = Free text 1-180
characters)

^TMP("PS",$J,D0,"P",0)=IEN of provider^.01 of VA 200.

^TMP("PS",$J,D0,"IND",0)=INDICATION
VARIABLES TYPE VARIABLES DESCRIPTION
DFN Input
BEGDATEOUT Input
Beginning date for search of Outpatient & Non-VA
medications.
ENDDATEOUT Input
Ending date for search of Outpatient & Non-VA
medications.
TMP('PS',$J, Output
Global location of returned list of meds.
VIEW Input
Numeric value of 0,1,2,3 or null to denote which
sorting option to print the display in CPRS.  (optional)

0 or null - This provides the medication list as it was prior to CPRS GUI v27
so that other applications calling this API will not see any changes.

1 - Sorts the medication list by Prescription Status Group and Stop
Date/Expiration Date.  Following is the sort order:

Pending group:
Non-Verified
Pending
Active group:
Active
Hold
Suspended (Active/Susp)
Provider Hold
Expired group:
Expired
Discontinued/Deleted group:
Discontinued by Provider
Discontinued (Edit)

2 - Sorts the medication list by Prescription Status Group, Status, and Drug
Name.  Following is the sort order:

Active group:
Active
Hold
Pending group:
Non-Verified
Pending
Discontinued group:
Discontinued by Provider
Discontinued (Edit)

3 - Sorts the medication list by Drug Name, Active/Suspended and Stop
Date/Expiration Date.
BEGDATEINP Input
Beginning date for search of Inpatient medications.
ENDDATEINP Input
Ending date for search of Inpatient medications.

Note: If both BEGDATEINP and ENDDATEINP are not passed in to the API, then
BEGDATEOUT and ENDDATEOUT will also be used for the Inpatient medications date
range.
OEL
Returns detailed information on a particular pharmacy
order.

OEL^PSOORRL(DFN,ORDER) Passed:  DFN - Patient's Internal Pointer
ORDER - ORDER #_File;PKG (from condensed list)

Returned: ^TMP("PS",$J,0)=DRUG^INFUSION RATE^STOPDATE^REFILLS  REMAINING^START
DATE^EXTERNAL STATUS^DAYS SUPPLY^QUANTITY^TOTAL  DOSE^UNIT PER DOSE^PLACER
#^LAST FILLDATE^NOT TO BE GIVEN^PENDING  RENEWAL (1 or 0)

^TMP("PS",$J,"RXN",0)=EXTERNAL Rx NUMBER^LAST RELEASE DATE^ORIGINAL  FILL
ROUTING (W or M)^Remarks^FINISHED BY^ORIGINAL FILL DATE^ORIGINAL RELEASE DATE

^TMP("PS",$J,"RXN","RSTC")=ACTIVITY LOG^INITIATOR OF ACTIVITY^COMMENT

^TMP("PS",$J,"MDR",0)= # of LINES

^TMP("PS",$J,"MDR",D1,0)=MED ROUTE ABBR.

^TMP("PS",$J,"SCH",0)= # of LINES

^TMP("PS",$J,"SCH",D1,0)=SCHEDULE NAME

^TMP("PS",$J,"SIG",0)= # of LINES

^TMP("PS",$J,"SIG",D1,0)=SIG (outpatient) or INSTRUCTIONS (inpatient)

^TMP("PS",$J,"PAR",0) = # of LINES

^TMP("PS",$J,"PAR",n,0) = Fill Date^Days Supply^Quantity^Release Date^Routing
(W  or M)^REMARKS

^TMP("PS",$J,"PC",0)= # of LINES

^TMP("PS",$J,"PC",D1,0)=PROVIDER COMMENTS

^TMP("PS",$J,"A",0)= # of LINES

^TMP("PS",$J,"A",D1,0)=ADDITIVE NAME^AMOUNT^BOTTLE

^TMP("PS",$J,"B",0)= #  of LINES

^TMP("PS",$J,"B",D1,0)=SOLUTION NAME^AMOUNT

^TMP("PS",$J,"P",0)=IEN of provider^.01 of VA 200

^TMP("PS",$J,"ADM",0)= # of LINES

^TMP("PS",$J,"ADM",D1,0)=ADMINISTRATION TIMES Where: administration time =
Free text 2-119 characters

^TMP("PS",$J,"RMV",0)= # of LINES

^TMP("PS",$J,"RMV",D1,0)=REMOVAL TIMES Where: Removal time = Free text 2-119
characters

^TMP("PS",$J,"SIO",0)= # of LINES

^TMP("PS",$J,"SIO",D1,0)=SPECIAL INSTRUCTIONS/OTHER PRINT INFO (Special
instructions = Free text 1-180 characters)

^TMP("PS",$J,"DD",0)   = # of LINES

^TMP("PS",$J,"DD",D1,0)= DISPENSE DRUG  IEN(from the U/D order)^Unit per
Dose^CORRESPONDING OUTPATIENT DRUG  IEN^ORDERABLE ITEM IEN

^TMP("PS",$J,"REF",0) = # of LINES

^TMP("PS",$J,"REF",n,0) = Refill Date^Days Supply^Quantity^Release
Date^Routing  (W or M)^Remarks

^TMP("PS",$J,"REF",n,"RSTC")=ACTIVITY LOG^INITIATOR OF ACTIVITY^COMMENT

^TMP("PS",$J,"IND",0)=1

^TMP("PS",$J,"IND",1,0)=INDICATION
VARIABLES TYPE VARIABLES DESCRIPTION
DFN Input
RXNUM Input
Prescription number.
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE ISC SUBSCRIBING DETAILS
ORDER ENTRY/RESULTS REPORTING Salt Lake City
TEXT INTEGRATION UTILITIES Salt Lake City
CLINICAL CASE REGISTRIES
INPATIENT MEDICATIONS
VBECS
NATIONAL HEALTH INFO NETWORK
VIRTUAL PATIENT RECORD
SURGERY
WOMEN'S HEALTH
Women's Health will begin using this ICR in patch
WV*1*24, part of the CPRS version 31 release. Women's Health needs to retrieve
all of the contraceptive medications prescribed or administered to a patient,
as well as the date last filled or last administered. With this information,
Women's Health can calculate a patient's risk level of becoming pregnant while
taking prescribed contraceptive medications. As some contraceptive medications
are administered as clinic meds, Women's Health needs to retrieve both
inpatient and outpatient medications. The risk level is calculated as low if
the patient's prescription was last filled or a clinic medication was last
administered within the last 100 days otherwise, the risk level is set to
high. This data is only needed if the patient is identified within the Women's
Health package as using a shot or pill, vaginal ring or patch as a
contraceptive method. Women's Health is already approved to use ICR #6029
RETURN REMINDER ORDER CHECK ITEMS to identify contraceptive medications.
VA POINT OF SERVICE (KIOSKS)
HEALTH MANAGEMENT PLATFORM
HMP's subscription to this ICR expired on 10/27/17 with
the shutdown of HMP.  HMP*2.0*12 released on 10/17/17 is an informational
patch outlining the steps for the sites to shut down the application.

If HMP is reactivated in the future, the HMP project team should review the
access provided by this ICR with the custodial application before reactivating
HMP's subscription to this ICR.
HEALTH SUMMARY
DATE ACTIVATED 2008/07/28