MAGV GET IRRADIATION DOSE    ICR (6000)

This is the name of the array, passed by reference,
in which irradiation dose data is saved. All data is returned in its external
format. PHANTOM TYPE will not be used in this iteration. The data returned in
the subscripted array is delimited by the vertical bar "|".

Key variable: ARRAY(1).  The first piece indicates success (0) or failure
(-13).  The second piece is null and the third piece is the number of records
returned.

Note: ARRAY(1) can have a value of "0``0" in which case the VistA RIS takes no
action.

Example: CT SCAN data returned
------------------------------
DVA>ZW ARRAY
ARRAY(1)="0``2"
ARRAY(2)="TYPE|CT"
ARRAY(3)="IRRADIATION INSTANCE UID
1.2.841.113411.2.1.2411.10311244477
.365.1.63874544.8.7.2013.131"
ARRAY(4)="TARGET REGION|T-D0010"
ARRAY(5)="CTDIVOL|8.12"
ARRAY(6)="DLP|365.25"
ARRAY(7)="PHANTOM TYPE|"
ARRAY(8)="TYPE|CT"
ARRAY(9)="IRRADIATION INSTANCE UID
1.2.841.113411.2.1.2411.10311244477
.365.1.63874544.8.7.2013.132"
ARRAY(10)="TARGET REGION|R-FAB56"
ARRAY(11)="CTDIVOL|7.02"
ARRAY(12)="DLP|500.001"
ARRAY(13)="PHANTOM TYPE|"

Please note that for a scout image (a preliminary image taken of a body region
before a definitive imaging study) CTDIvol and DLP may not have values.


Example: Fluoroscopy data returned
----------------------------------
DVA>ZW ARRAY
ARRAY(1)="0``2"
ARRAY(2)="TYPE|FLUORO"
ARRAY(3)="ESTIMATE|"
ARRAY(4)="TOTAL TIME IN FLUOROSCOPY|21"
ARRAY(5)="DOSE AREA PRODUCT|0"
ARRAY(6)="DOSE (RP) TOTAL (AKE)|0"
ARRAY(7)="FLUORO DOSE (RP) TOTAL|0"
ARRAY(8)="FLUORO DOSE AREA PRODUCT TOTAL|0"
ARRAY(9)="CINE DOSE (RP) TOTAL|0"
ARRAY(10)="CINE DOSE AREA PRODUCT TOTAL|0"
ARRAY(11)="CINE TIME|4"
ARRAY(12)="TYPE|FLUORO"
ARRAY(13)="ESTIMATE|"
ARRAY(14)="TOTAL TIME IN FLUOROSCOPY|22"
ARRAY(15)="DOSE AREA PRODUCT|0.00000012"
ARRAY(16)="DOSE (RP) TOTAL (AKE)|4.2"
ARRAY(17)="FLUORO DOSE (RP) TOTAL|5.1"
ARRAY(18)="FLUORO DOSE AREA PRODUCT TOTAL|.00000023"
ARRAY(19)="CINE DOSE (RP) TOTAL|6200"
ARRAY(20)="CINE DOSE AREA PRODUCT TOTAL|3.2"
ARRAY(21)="CINE TIME|23"

The VistA RIS relies on the data from the following attributes: "TOTAL TIME IN
FLUOROSCOPY", "DOSE (RP) TOTAL (AKE)" & "FLUORO DOSE AREA PRODUCT TOTAL".

This is the DFN of the patient.

This is the accession number of the study.

The accession number can be in its legacy format: mmddyy-case_#

-or-

The accession number can be in its site specific format:
site_id-mmddyy-case_#.



Note
----
'site_id' is the first three digits of the station number of the institution
where this software is installed.  Example: Institution Hines; site_id = 578

'mm' is the month represented by two digits. Example: July = 07

'dd' is the day of a month represented by two digits.  Example: the 4th day of
July = 04

'yy' is the year represented by the last two digits of that year.  Example:
2013 = 13

This is the imaging type of the procedure. CT Scan
imaging studies will pass "CT"; General Radiology imaging studies will pass
"FLUORO".