Print Page as PDF
HIGH RISK MEDICATIONS FOR FEMALE PATIENTS ICR (6199)

HIGH RISK MEDICATIONS FOR FEMALE PATIENTS    ICR (6199)

Name Value
NUMBER 6199
IA # 6199
DATE CREATED 2015/05/26
CUSTODIAL PACKAGE CLINICAL REMINDERS
USAGE Private
TYPE Routine
ROUTINE PXRMCWH1
NAME HIGH RISK MEDICATIONS FOR FEMALE PATIENTS
GENERAL DESCRIPTION
This integration agreement will allow the subscriber to
determine which pharmacy orders are considered teratogenic or unsafe for a
specific female patient.
STATUS Withdrawn
KEYWORDS
  • TERATOGENIC DRUGS
  • UNSAFE DRUGS
DURATION Till Otherwise Agreed
EXPIRATION DATE 2017/06/22
ID PXRMCWH1
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
HIRMEDS(DFN,NGET,BDT,EDT,NFOUND,TEST,DATE,DATA,TEXT)
Returns the teratogenic and unsafe drugs ordered for
a patient that were active or pending during a time period.
VARIABLES TYPE VARIABLES DESCRIPTION
DFN Input
The internal entry number (IEN) of the patient's
entry in the PATIENT file (#2).
NGET Input
The maximum number of orders to return. If this
variable is positive, the returned orders are sorted in reverse chronological
order (most recent order is returned first). If this variable is negative, the
returned orders are sorted in chronological order (oldest order is returned
first).
BDT Input
The beginning date/time in internal FileMan format of
the time range in which to search for orders.
EDT Input
The ending date/time in internal FileMan format of
the time range in which to search for orders.
NFOUND Output
The number of orders found.
TEST Both
INPUT: The caller must specify the REMINDER ORDER
CHECK ITEMS GROUP file entries, the pregnancy status associated with each
entry, and the order's status the API should check for when determining
whether to return an order. This parameter is formatted as:

TEST="PSTATUS_1:ROCG_LIST_1~PSTATUS_N:ROCG_LIST_N^
OSTATUS"

PSTATUS: the patient's status, in the format
XN
X: either P for pregnancy or L for
lactation
N: either 0 for false or 1 for true
and is optional when X is L but
required when X is P
Examples: P1 => patient is pregnant
P0 => patient is not
pregnant
L  => patient is or is not
lactating
ROCG_LIST: comma-delimited list of REMINDER
ORDER CHECK ITEMS GROUP entry
internal entry numbers (IENs)
*Note: Multiple STATUS:ROCG_LIST pairings are
allowed and are delimited by the tilde
character ("~").
OSTATUS: the order's status on the evaluation
date
Valid Values: ACTIVE/CURRENT
ALL
RECENT ACTIVITY

OUTPUT: An array of truth values where 1 is true and 0 is false. The array has
one subscript that starts at one and increments by one. Each subscript
correlates to the order returned in the same numbered first level subscript in
the DATA array.
DATE Output
An array of dates in internal FileMan date format.
The array has one subscript that starts at one and increments by one. Each
subscript correlates to the order returned in the same numbered first level
subscript in the DATA array and contains the date/time the order was entered.
DATA Output
An array of orders that are considered teratogenic or
unsafe. The array has the following format:

DATA(X,"DRUG NAME")="drug name"
GENERIC NAME field (#.01)
in the DRUG file (#50)
DATA(X,"ORDER NUMBER")=order number
Internal Entry Number
(IEN) in the ORDER file
(#100)
DATA(X,"ROC ITEM GROUP",Y)="reminder order
check items group
name"
GROUP NAME field
(#.01) in the
REMINDER ORDER CHECK
ITEMS GROUP file
(#801)

X is a number that starts at one and increments by one. There is only one
number per order.  Y is a number that starts at one and increments by one.
There is only one number per reminder order check items group name.
TEXT Output
An array of text in a human-friendly format
describing the orders that are returned. The array has one subscript that
starts at one and increments by one. Each subscript correlates to the order
returned in the same numbered first level subscript in the DATA array.
SUBSCRIBING PACKAGE ORDER ENTRY/RESULTS REPORTING