Print Page as PDF
DBIA3181-A ICR (3181)

DBIA3181-A    ICR (3181)

Name Value
NUMBER 3181
IA # 3181
DATE CREATED 2003/09/16
CUSTODIAL PACKAGE VBECS
CUSTODIAL ISC Chicago
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE VBECA1
NAME DBIA3181-A
ORIGINAL NUMBER 3181
GENERAL DESCRIPTION
These API's are provided to return Blood Bank data to
subscribing packages.
STATUS Active
DURATION Till Otherwise Agreed
ID VBECA1
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
ABORH
INPUT DEFINITION:

DFN = internal entry number from the PATIENT file (#2) (Passed as a
parameter).  You must precede the internal entry number with the accent grave
character ( ` ).

OUTPUT DEFINITION:

ABO RH


This function will return the ABO Blood Group and RH Type value found for the
patient provided in the call.  This is an extrinsic function call.  If no
valid patient identifier is provided, the call will return a value of -1. If
no ABO Blood Group or RH Type value for the patient exists in the database,
the function will return a null value to the call.  The values will be return
separated by a space (" ").  For example, if a patient has Blood Group "A" and
RH Type "POS" (positive), the function would return "A POS".
VARIABLES TYPE VARIABLES DESCRIPTION
ABORH
DFN Input
This is the internal entry number from the PATIENT
file (#2) (Passed as a parameter).  You must precede the internal entry number
with the accent grave character ( ` ).
ABO
INPUT DEFINITION:

DFN = internal entry number from the PATIENT file (#2) (Passed as a
parameter).  You must precede the internal entry number with the accent grave
character ( ` ).

OUTPUT DEFINITION:

"A" or "B" or "AB" or "O"

This function will return the ABO Blood Group value found for the patient
provided in the call.  This is an extrinsic function call. If no valid patient
identifier is provided, the call will return a value of -1. If no ABO Blood
Group value for the patient exists in the database, the function will return a
null value to the call.
VARIABLES TYPE VARIABLES DESCRIPTION
DFN Input
This is the internal entry number from the PATIENT
file (#2) (Passed as a parameter).  You must precede the internal entry number
with the accent grave character ( ` ).
RH
INPUT DEFINITION:

DFN = internal entry number from the PATIENT file (#2) (Passed as a
parameter).  You must precede the internal entry number with the accent grave
character ( ` ).

OUTPUT DEFINITION:

"POS" or "NEG"

This function will return the RH Type value for the patient provided in the
call.  This is an extrinsic function call.  If no valid patient identifier is
provided, the call will return a value of -1. If no RH Type value for the
patient exists in the database, the function will return a null value to the
call.
VARIABLES TYPE VARIABLES DESCRIPTION
DFN Input
This is the internal entry number from the PATIENT
file (#2) (Passed as a parameter).  You must precede the internal entry number
with the accent grave character ( ` ).
ABID
INPUT DEFINITION:

DFN = internal entry number from the PATIENT file (#2) (Passed as a
parameter).  You must precede the internal entry number with the accent grave
character ( ` ).

.ARR = The name of an array that will store the value of any antibodies found
in Blood Bank patient records by the function.  This array must be passed by
reference.


OUTPUT DEFINITION:

If no antibodies are found, the array will be returned empty.

For each antibody record found, the array will contain the name of the
antibody in the first data piece of the array and any antibody comments in the
second data piece.  The populated array will be returned with the following
structure:

ARR("ABID",n) = Antibody ^ Antibody comment

Where "n" is a sequential number index for the array.
VARIABLES TYPE VARIABLES DESCRIPTION
DFN Input
This is the internal entry number from the PATIENT
file (#2) (Passed as a parameter).  You must precede the internal entry number
with the accent grave character ( ` ).
.ARR Both
The name of an array that will store the value of any
antibodies found in Blood Bank patient records by the function.  This array
must be passed by reference.

For each antibody record found, the returned array will contain the name of
the antibody in the first data piece of the array and any antibody comments in
the second data piece.  The populated array will be returned with the
following structure: ARR("ABID",n) = Antibody ^ Antibody comment

Where "n" is a sequential number index for the array.
AGAB
This component is no longer supported with the
release of VBECS.
TRRX
DFN = internal entry number from the PATIENT file
(#2) (Passed as a parameter).  You must precede the internal entry number with
the accent grave character ( ` ).

.ARR = The name of an array that will store the value of any absent antigens
found by the function.  Must be passed by reference.


OUTPUT DEFINITION:

ARR = The name of the array, passed to the API by reference, that will be used
to store the transfusion reactions found in Blood Bank patient records via the
function.

Retrieve any previously recorded transfusion reactions.  If none exist on
record, the array will be returned empty.

For each transfusion reaction found, the array element will be assigned the
transfusion reaction date/time value at the first data piece and the
transfusion reaction type value at the second data piece.

The populated array be returned with the following structure:

ARR("TRRX",n) = RXN D/T ^ RXN Type

Where "n" is a sequential index number.
VARIABLES TYPE VARIABLES DESCRIPTION
DFN Input
This is the internal entry number from the PATIENT
file (#2) (Passed as a parameter).  You must precede the internal entry number
with the accent grave character ( ` ).
.ARR Both
The name of the array, passed to the API by
reference, that will be used to store the transfusion reactions found in Blood
Bank patient records via the function.

Retrieve any previously recorded transfusion reactions.  If none exist on
record, the array will be returned empty.

For each transfusion reaction found, the array element will be assigned the
transfusion reaction date/time value at the first data piece and the
transfusion reaction type value at the second data piece.

The populated array be returned with the following structure: ARR("TRRX",n) =
RXN D/T ^ RXN Type

Where "n" is a sequential index number.
BBCMT
This component is no longer supported with the
release of VBECS.
AUTO
This component is no longer supported with the
release of VBECS.
AGPRES
This component is no longer supported with the
release of VBECS.
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE ISC SUBSCRIBING DETAILS
LAB SERVICE Dallas
2/25/14-Access to entry points ABO and RH for Lab is
also documented in ICRs #3182 and 3183.  These ICRs were retired as duplicates
of ICR #3181.
ORDER ENTRY/RESULTS REPORTING