Print Page as PDF
Rad/Nuc Med accession number/SIUID utilities ICR (5020)

Rad/Nuc Med accession number/SIUID utilities    ICR (5020)

Name Value
NUMBER 5020
IA # 5020
DATE CREATED 2007/08/01
CUSTODIAL PACKAGE RADIOLOGY/NUCLEAR MEDICINE
USAGE Private
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE RAAPI
NAME Rad/Nuc Med accession number/SIUID utilities
GENERAL DESCRIPTION
$$ACCNUM
--------
The $$ACCNUM function creates and returns a site specific accession number
based on the input of the following case specific identifiers: RADFN (patient
DFN), RADTI (inv. date/time of the exam), & RACNI (the exam record IEN).

$$ACCFIND
---------
Based on the input of an accession number or a site specific accession number
and if successful the $$ACCFIND function returns case specific identifiers:
RADFN (patient DFN), RADTI (inv. date/time of the exam), & RACNI (the exam
record IEN) in array 'RAA(Z)'. The variable 'Z' is also returned to indicate
the number of 'RAA' array elements created.

If unsuccessful, 'Z' is returned as a string: the first piece is a negative
number indicating the error type and the second piece is the error type text.

$$ACCRPT
--------
Based on the input of a pointer to a record in the RAD/NUC MED REPORTS (#74)
file, the $$ACCRPT function returns the accession number(s) in the 'RAA(n)'
array, if successful.  If n=1 the single accession number is returned in
RAA(1).  If n>1 the 'lead' accession number (for printsets) is returned in
RAA(1) and subsequent ones are returned in RAA(2) thru RAA(n).  Accession
numbers are returned in either standard "mmddyy-case#" format or in the site
specific "sss-mmddyy-case#" format.

If unsuccessful, a "-1" (invalid file #74 pointer value) is returned.

$$GETSIUID
----------
Based on the input of exam data, the RADFN (patient DFN), RADTI (inverse
date/time of registered exam) and RACNI (exam record), the $$GETSIUID function
returns the Study Instance UID field value [^DD(70.03,81)].

$$SIUIDFND
----------
Based on the input of a Study Instance UID, if successful the $$SIUIDFND
function returns a '1' and also returns the case specific identifiers: RADFN
(patient DFN), RADTI (inv. date/time of the exam), & RACNI (the exam record
IEN) in array 'RAA(1)'.

If unsuccessful, '-1^"no data associated with this study instance UID"^siuid'
is returned as a string: the first piece is a '-1' indicating the lookup was
not successful, the second piece is the error text and the third piece is the
SIUID which was the original input.


STATUS Active
KEYWORDS
  • accession number
  • site specific accession number
  • day-case number
  • imaging radiology
  • radiology imaging
DURATION Till Otherwise Agreed
ID RAAPI
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
ACCNUM
Given the following input into the function: RADFN,
RADTI, & RACNI a site specific accession number in the following format
'sss-ddmmyy-case#' is returned.
VARIABLES TYPE VARIABLES DESCRIPTION
RADFN Input
RADFN is the DFN of the patient record in the PATIENT
(#2) file.
RADTI Input
RADTI is the inverse date/time of the exam.

Example: an inverse date/time of: 6929488.8676 is equivalent to a FileMan
internal date/time value of: 3070511.1323 when the FileMan internal date/time
is subtracted from the constant: 9999999.9999.
RACNI Input
RACNI is the IEN of the case level record.
Output
This extrinsic function returns a site specific
accession number in the following format: 'sss-ddmmyy-case#'.
ACCFIND
When an accession number in either a
'sss-mmddyy-xxxxx' or 'mmddyy-xxxxx' format is entered the function returns
(if successful):

An array (RAA(Z)) defined to be a string in the following format:
RADFN_^_RADTI_^_RACNI. The value 'Z' is returned to indicate, if set to a
positive value, the number of array elements return.

An error string if the lookup failed. These error strings are: -1^"invalid
site accession number format"^accession # -2^"invalid accession number
format"^accession # -3^"no data associated with this accession
number"^accession #


VARIABLES TYPE VARIABLES DESCRIPTION
Y Input
'Y' is the accession number in either a
'sss-mmddyy-xxxxx' or 'mmddyy-xxxxx' format.
RAA (conditional) Output
If the accession number lookup is successful, the
array 'RAA(Z)' will return data in the following format:
RADFN_^_RADTI_^_RACNI.
Z Output
'Z' is the number of array elements when successful.
When unsuccessful (Z<0) 'Z' is a specific error dialog which is returned along
with the invalid accession number.

Examples:
---------
-1^"invalid site accession number format"^accession # -2^"invalid accession
number format"^accession # -3^"no data associated with this accession
number"^accession #
ACCRPT
When a pointer to a record in the RAD/NUC MED REPORTS
(#74) file is entered, the function returns:

If successful, an array (RAA(Z)) containing the accession number(s).  The
variable 'Z' is returned to indicate the number of array elements.  If Z=1,
the single accession number is returned in RAA(1).  If Z>1 the 'lead'
accession number (for printsets) is returned in RAA(1) and subsequent ones are
returned in RAA(2) thru RAA(Z).  Accession numbers are returned in either
standard "mmddyy-case#" format or in site specific "sss-mmddyy-case#" format.

If unsuccessful, a "-1" (indicating an invalid file #74 pointer value) is
returned.

VARIABLES TYPE VARIABLES DESCRIPTION
Z Output
'Z' is the number of array elements when successful.
If unsuccessful, indicating an invalid pointer value to file #74, 'Z' is -1.

Y Input
'Y' is a pointer to the RAD/NUC MED REPORTS (#74)
file.

RAA Output
If the lookup is successful, the array 'RAA(Z)' will
return the accession number(s) in the standard "mmddyy-case#" or site specific
"sss-mmddyy-case#" format.

GETSIUID
When the exam data (RADFN-patient DFN, RADTI-inverse
date/time of registered exam and RACNI-exam record), is entered the function
returns the Study Instance UID field value [^DD(70.03,81)].

VARIABLES TYPE VARIABLES DESCRIPTION
RADFN Input
RADFN is the DFN of the patient record in the PATIENT
(#2) file.

RADTI Input
RADTI is the inverse date/time of the exam.

Example: an inverse date/time of: 6929488.8676 is equivalent to a FileMan
internal date/time value of: 3070511.1323 when the FileMan internal date/time
is subtracted from the constant: 9999999.9999.

RACNI Input
RACNI is the IEN of the case level record.

SIUIDFND
Based on the input of a Study Instance UID, if
successful the $$SIUIDFND function returns a '1' and also returns the case
specific identifiers: RADFN (patient DFN), RADTI (inv. date/time of the exam),
& RACNI (the exam record IEN) in array 'RAA(1)'.

If unsuccessful, '-1^"no data associated with this study instance UID"^siuid'
is returned as a string: the first piece is a '-1' indicating the lookup was
not successful, the second piece is the error text and the third piece is the
SIUID which was the original input.

VARIABLES TYPE VARIABLES DESCRIPTION
Z Output
'Z' is equal to '1' when successful.  When
unsuccessful, 'Z' is equal to '-1' concatenated with a specific error dialog
which is returned along with the invalid study instance UID.

Examples:
---------
-1^"no data associated with this study instance UID"^siuid

Y Input
'Y' is the Study Instance UID to be looked up.

RAA (Conditional) Output
If the Study Instance UID lookup is successful, the
array 'RAA(1)' will return data in the following format:
RADFN_^_RADTI_^_RACNI.

SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE SUBSCRIBING DETAILS
IMAGING
MEDICOM TECHNOLOGIES
Patch MECH*1.0*1 processes HL7 new-order messages about
imaging studies performed in the community but not entered through VistA.  In
order to do this, it needs to invoke Radiology routines and make FileMan calls
to add entries to the RAD/NUC MED PATIENT File (#70) (for existing VA
patients), the ORDER File (#100), and the RAD/NUC MED ORDERS File (#75.1). The
patch then creates an HL7 order-update message that transmits the study's
accession number to the sender. ADDED 3/2/2022, effective with MECH*1.0*1
Medicom Class 3 product Document Only
DATE ACTIVATED 2009/05/22