Print Page as PDF
DBIA2043 ICR (2043)

DBIA2043    ICR (2043)

Name Value
NUMBER 2043
IA # 2043
DATE CREATED 1997/06/27
CUSTODIAL PACKAGE RADIOLOGY/NUCLEAR MEDICINE
CUSTODIAL ISC Chicago
USAGE Supported
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE RAO7PC1
NAME DBIA2043
GENERAL DESCRIPTION
EN1^RAO7PC1 can be used to return a list of a patient's
Rad/Nuc Med procedures and related information.  Cancelled exams may be
included, depending upon the RACINC input parameter. Exam ID output can be
used as input to another API to retrieve result reports. (See DBIA #2265)
Report ien output can also be used to retrieve a report. (See DBIA #1177)
STATUS Active
DURATION Till Otherwise Agreed
ID RAO7PC1
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT VARIABLES
EN1(RADFN,RABDT,RAEDT,RAEXN,RACINC)
VARIABLES TYPE VARIABLES DESCRIPTION
RADFN Input
Internal entry number (ien) of the patient in the
Rad/Nuc Med Patient file #70.  (Note: this ien is the same ien used in the
Patient file #2.  File 70 is DINUMED to file 2.  RADFN is also known as the
patient ien.
RABDT Input
Beginning date used to extract exam data for a
specific time frame.
RAEDT Input
Ending date used to extract exam data for a specific
time frame.
RAEXN Input
Maximum number of exams to extract within a time
frame.  If RAEXN is numeric, then each case within a parent procedure is
counted separately.  However, if RAEXN has a trailing "P", then all cases
within a parent procedure are counted together as 1.
RACINC Input
Include cancelled exams flag (1 if yes, default is
no). This input parameter was added in RA*5.0*26.  A later patch, RA*5.0*36,
further restricts when cancelled cases would be returned: (1) case's
division's ALLOW RPTS ON CANCELLED CASES? is "Y" and (2) case has a report.
TMP($J,'RAE1', Output

^TMP($J,"RAE1",patient ien,exam id)= procedure name^case number^report
status^ abnormal alert flag^report ien^exam status order #~exam status
name^imaging location name^ imaging type abbr~imaging type name^ abnormal
results flag^CPT Code^CPRS Order ien^ Images exist flag

subscripts
----------
Patient ien: Internal entry number of the patient in both the Rad/Nuc Med
Patient file #70 and the Patient file #2.

Exam Id: Reverse exam date/time of the exam concatenated to the ien of the
case.  Example: 7019698.9093-1 (where the exam date/time is 03/01/1998@9:06am
and the case ien is 1.  '70119689.9093' is derived from:
9999999.9999-2980301.0906)

array value (in ascending piece position)
-----------------------------------------
Procedure Name: Name of the procedure in the Rad/Nuc Med Procedure file #71.
It is possible for users to change the procedure prior to the exam reaching a
'COMPLETE' status.

Case Number: Identifying external case number for an exam.  Can be a number
between 1 and 99999.

Report Status: External name of the report status.  Possible statuses include:
DRAFT, PROBLEM DRAFT, RELEASED/NOT VERIFIED, VERIFIED and NO REPORT. It is
possible for the exam to have a report with a 'NO REPORT' status.  A 'NO
REPORT' status refers to a stub report that was created for the Imaging
package file of images, this stub report record has no data entered by
Radiology/Nuclear Medicine staff.

Abnormal Alert Flag: Set to 'Y' if an abnormal diagnostic code is assigned to
this case, blank if no abnormal code.  A diagnostic code is considered
abnormal if its entry in the Diagnostics Codes file #78.3 contains a 'Y' in
the 'Generate Abnormal Alert' field.

Report ien: This is the internal entry number of a report in the Rad/Nuc Med
Reports file #74.

Exam Status Order Number: A number between 0 and 9 where: 0=cancelled,
1=waiting for exam & 9=complete. All other order numbers are site
configurable.

Exam Status Name: External representation of exam status.  Examples: WAITING
FOR EXAM, EXAMINED, CANCELLED and COMPLETE.

Imaging Location Name: Name of the imaging location in the Imaging Location
file #79.1.  This file points to the Hospital Location file #44.  These files
are not DINUMED.

Imaging Type Abbreviation: This is a 1-4 character abbreviation of the imaging
type of the exam.  Examples: ANI, CARD, CT, MAM, MRI, NM, RAD, US and VAS.

Imaging Type Name: External representation of the imaging type name.
Examples: ANGIO/NEURO/INTERVENTIONAL, CARDIOLOGY STUDIES (NUC MED), CT SCAN,
GENERAL RADIOLOGY, MAGNETIC RESONANCE IMAGING, MAMMOGRAPHY, NUCLEAR MEDICINE,
ULTRASOUND and VASCULAR LAB.

Abnormal Results Flag: Set to 'Y' if our primary diagnostic code has the
field, PRINT ON ABNORMAL REPORT set to 'Yes'.  If the field is set to any
other value than 'Yes', our flag value is blank (null).

CPT Code: This is the Current Procedural Terminology (CPT) code assigned to
the registered procedure. Detailed and Series procedure types have CPT codes.
Broad and Parent procedure types do not have CPT codes.

CPRS Order ien: This is a pointer data type that indicates the record number
of the order in the Order Entry/Results Reporting (OE/RR) package.  This piece
will be non-null if the OE/RR package is running and the Radiology/Nuclear
Medicine package is available through OE/RR.

Images exist flag: Set to 'Y' if images are associated with the report
identified by Report ien above. If no images exist this flag will be set to
'N'. This flag was introduced in RA*5.0*26.

Patch RA*5.0*10 provides additional ^TMP nodes for optional retrieval:

Output: ^TMP($J,"RAE1",patient ien, exam id,"CMOD",n)= CPT modifier^CPT
modifier name

where  n=1,2,3...total number of CPT modifiers for the exam

Patch RA*5.0*36 provides additional ^TMP nodes for optional retrieval:

Output: ^TMP($J,"RAE1",patient ien, exam id,"CPRS")= member of set^parent
procedure name

where member of set is the value of MEMBER OF SET in subfile 70.03

If the name of the Parent Procedure cannot be found, then "PARENT PROCEDURE"
will be put into the second piece.