GMRADPT ICR (10099)

Name

Value

NUMBER

10099

IA #

10099

DATE CREATED

1996/02/08

CUSTODIAL PACKAGE

ADVERSE REACTION TRACKING

CUSTODIAL ISC

Salt Lake City

USAGE

Supported

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

GMRADPT

NAME

GMRADPT

ORIGINAL NUMBER

10099

GENERAL DESCRIPTION

This integration agreement documents a data extract
utility which allows other packages to gather adverse reaction data about a
patient for use in the calling package.

STATUS

Active

GMRADPT

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

EN1

**NOTE: New subscribers of this agreement should use
the EN2 component.  Existing subscribers should make changes to use the EN2
component instead of this component as the EN2 component returns more data.

VARIABLES

TYPE

VARIABLES DESCRIPTION

DFN

Input

The Internal Entry Number (IEN) of the patient in the
PATIENT file (#2).

GMRA

Input

This GMRA variable is optional. The default value is
"0^0^111" which means return "all reactions (allergic/non-allergic)^all data
(verified or non verified)^all food, drug and other type reactions".

GMRA must be in the format A^B^C
if A = 0 return all reactions
(allergic/non-allergic).
1 return allergies only.
2 return non-allergies only.
B = 0 return all data (verified or
non-verified).
1 return only verified data.
2 return only non-verified data.
C = X_Y_Z
where X, Y, and Z are either 0 or
1.  1 would mean to return an
Adverse Reaction of that particular
type, and zero means do not return
an Adverse Reaction of that type.
X is for TYPE=OTHER
Y is for TYPE=FOOD
Z is for TYPE=DRUG.
E.g., 001 (return drug only), 111
(returns all types), and 010
(returns food only).

GMRAL

Output

The GMRAL variable and GMRAL array are returned as
output.

GMRAL = 1 if the patient has an Adverse Reaction
0 if the patient has no known Adverse
Reaction
null if the patient has not been asked
about Adverse Reaction

GMRAL(PTR TO File #120.8) = A^B^C^D^E^F^G^H^I
where A = Pointer to Patient file.
B = Free text of the causative agent.
*C = Type of reaction, where D is drug, F
is food, and O is other.
D = 1 if the Adverse Reaction has been
verified
0 if the Adverse Reaction has not
been verified
E = 0 if this is an allergic reaction
1 if this is not an allergic
reaction
**F = the mechanism of reaction in the
format:
External format;Internal format
(ALLERGY;0, PHARMACOLOGIC;2,
UNKNOWN;U).
G = Type of reaction.
D = drug
DF = drug/food
DFO = drug/food/other
DO = drug/other
F = food
FO = food/other
O = other
H = the mechanism of reaction in the
format:
External format;Internal format
(ALLERGY;A, PHARMACOLGIC;P,
UNKNOWN;U)
I = variable pointer to the causative
agent returned in piece B
GMRAL(PTR TO File #120.8,"S",COUNT) = S
where COUNT = number 1 to number of
signs/symptoms for this reaction.
S = a sign/symptom for this reaction
in the format:
External format;Internal format

* NOTE: This piece will no longer be supported
after 9/1/97, please use piece G.
** NOTE: This piece will no longer be supported
after 9/1/97, please use piece H.

EN2

VARIABLES

TYPE

VARIABLES DESCRIPTION

DFN

Input

The Internal Entry Number (IEN) of the patient in the
PATIENT file (#2).

GMRA

Input

An optional parameter specifying the types of
reactions to return. This is formatted as a caret-delimited string with five
pieces:
Piece   Criteria
==================================================
1       Allergies, Non-Allergies, or Both
0 (Default) for both
1 for allergies only
2 for non-allergies only
2       Verified, Non-Verified, or Both
0 (Default) for both
1 for verified data only
2 for non-verified data only
3       Reaction Type
Three digit number where each digit is
either a one or a zero. Default value is
"111". If the digit is a one, return
reactions of that type. If the digit is
a zero, do not return reactions of that
type.
Digit  Reaction Type
=====================
1      OTHER
2      FOOD
3      DRUG
4       Reaction Documentation Site Type
0 (Default) for locally documented
reactions only
1 for locally and remotely documented
reactions
5       Entered in Error Reactions
0 (Default) to exclude reactions entered
in error
1 to include reactions entered in error

GMRAL

Output

GMRAL = Empty string if the patient is not
assessed
0 if the patient has no known adverse
reactions
1 if the patient has an adverse reaction GMRAL(PTR)=Caret-delimited
string
PTR - for local reactions, the IEN in the
PATIENT ALLERGIES file (#120.8) and for
remote reactions, "R" followed by the
reaction's number in the
^XTMP("ORRDI","ART",DFN) global (DFN is
the patient's internal entry number in the
PATIENT file, #2).
Caret-delimited string:
Piece   Value
==================================================
1      Internal format of the PATIENT field
(#.01) in the PATIENT ALLERGIES file
(#120.8)
2      REACTANT field (#.02) in the PATIENT
ALLERGIES file (#120.8)
3      Not supported; use piece seven
4      Internal format of the VERIFIED field
(#19) in the PATIENT ALLERGIES file
(#120.8)
5      Allergy or Non-Allergy
1 for allergy
0 for non-allergy
6      Not supported; use piece eight
7      Internal format of the ALLERGY TYPE
field (#3.1) in the PATIENT ALLERGIES
file (#120.8)
8      MECHANISM field (#17) in the PATIENT
ALLERGIES file (#120.8)
The first semi-colon piece is the
external format and the second semi-
colon piece is the internal format.
9      Internal format of the GMR ALLERGY field
(#1) in the PATIENT ALLERGIES file
(#120.8)
10     OBSERVED/HISTORICAL field (#6) in the
PATIENT ALLERGIES file (#120.8)
The first semi-colon piece is the
external format and the second semi-
colon piece is the internal format.
GMRAL(PTR,"O",COUNT)=Caret-delimited string
COUNT - starts at one for the first
observation and increments by one
for subsequent observations
Caret-delimited string:
For those pieces that contain sub-fields, the
sub-fields are separated by ";".
Piece   Value
==================================================
1      SEVERITY field (#14.5) in the ADVERSE
REACTION REPORTING file (#120.85)
Sub-Field 1: External format
Sub-Field 2: Internal format
2      DATE/TIME OF EVENT field (#.01) in the
ADVERSE REACTION REPORTING file
(#120.85)
Sub-Field 1: External format
Sub-Field 2: Internal format GMRAL(PTR,"S",COUNT)=Caret-delimited
string
COUNT - starts at one for the first sign or
symptom and increments by one for
subsequent signs or symptoms
Caret-delimited string:
For those pieces that contain sub-fields, the
sub-fields are separated by ";".
Piece   Value
==================================================
1      REACTION sub-field (#.01) in the
REACTIONS field (#10) in the PATIENT
ALLERGIES file (#120.8)
Sub-Field 1: External format
Sub-Field 2: Internal format
2      DATE ENTERED sub-field (#.01) in the
REACTIONS field (#10) in the PATIENT
ALLERGIES file (#120.8)
Sub-Field 1: External format
Sub-Field 2: Internal format GMRAL(PTR,"ERROR")=DATE/TIME ENTERED IN
ERROR
field (#23) in the PATIENT
ALLERGIES file (#120.9)
Sub-Field 1: External format
Sub-Field 2: Internal format
NOTE: The sub-fields are separated by ";".
Only reactions documented at the local
site (PTR is all numeric) will have the
"ERROR" node defined.  GMRAL(PTR,"SITE")=Caret-delimited string
The site the documented this reaction.
NOTE: Only reactions documented at a remote site
(PTR will begin with "R") will have the
"SITE" node defined.
Caret-delimited string:
Piece   Value
==================================================
1      IEN in the INSTITUTION file (#4)
2      NAME field (#.01) in the INSTITUTION
file (#4)
3      STATION NUMBER field (#99) in the
INSTITUTION file (#4)

DATE ACTIVATED

2019/05/20