RAMAG EXAM REGISTER

TITLEVALUE
NAMERAMAG EXAM REGISTER
DESCRIPTIONThe RAMAG EXAM REGISTER remote procedure registers the exam and returns
identifiers of the new case(s) in the RAD/NUC MED PATIENT file (#70). It
also sends all required notifications.
TAGREGISTER
ROUTINERAMAGRP1
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERRAOIFN
DESCRIPTIONIEN of the order in the RAD/NUC MED ORDERS file (#75.1).
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETEREXMDTE
DESCRIPTIONDate and time of the exam in HL7 format (TS): YYYYMMDDHHMM[+/-ZZZZ]. If
seconds are provided, they are ignored. The date must be exact and the
time is required.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERRAMSC
DESCRIPTIONItems of this list define miscellaneous/optional exam parameters. Each
record has 3 or more pieces separated by '^':

^01: Parameter name
^02: Index (for multiples and word-processing values)
^03: Value1
^04: Value2
...

The following parameters are supported by this remote procedure:

BEDSECT^^{IEN #42.4}
Internal value for the BEDSECTION field (19) of
the EXAMINATIONS multiple (sub-file #70.03).

EXAMCAT^^{C|E|I|O|R|S}
Value for the CATEGORY OF EXAM field (4) of the
EXAMINATIONS multiple (sub-file #70.03).

FLAGS^^{flags}
Flags that control the execution (can be combined):

A If this flag is provided, then the registration
entry point adds the new case to the existing
ones with the same date/time instead of
returning the error code -28.

If the existing date/time record stores an exam
set and the "D" flag is not provided, then the
error code -54 is returned.

D If there is an existing case with the same
date/time, then the time of the new case is
incremented by 1 minute until an unused date/time
is found.

If the "A" flag is also provided, then time
increments also stop when a non-examset
date/time record is found.

If the date is also changed during the time
modification, then the case is not registered and
the error code -29 is returned.

PRINCLIN^^{IEN #44}
Internal value for the PRINCIPAL CLINIC field (8) of
the EXAMINATIONS multiple (sub-file #70.03).

RAPROC^{Seq#}^{IEN #71}^{IEN #71.2}^{IEN #71.2}^...
Radiology procedure and optional modifiers.

SERVICE^^{IEN #49}
Internal value for the SERVICE field (7) of
the EXAMINATIONS multiple (sub-file #70.03).

SINGLERPT^^{0|1}
If this parameter is defined and not 0, then all
cases should be associated with the same order
and they will share the same report. See the
MEMBER OF SET (25) and IMAGING ORDER (11) fields
of the sub-file #70.03 for more details.

TECHCOMM^^{text}
Value for the TECHNOLOGIST COMMENT field (4) of the
ACTIVITY LOG multiple (sub-file #70.07).

WARD^^{IEN #42}
Internal value for the WARD field (6) of
the EXAMINATIONS multiple (sub-file #70.03).

Records can be added to the list in any order. See the comments preceding
the $$REGISTER^RAMAG03 for more details.

Example:

with RPCBroker.Param[2] do
begin
PType := list;
Mult[1] := 'BEDSECT^^12';
Mult[2] := 'SERVICE^^43';
Mult[3] := 'WARD^^456';
Mult[4] := 'EXAMCAT^^I';
end;
PARAMETER TYPELIST
REQUIRED
MAXIMUM DATA LENGTH
RETURN VALUE TYPEARRAY
RETURN PARAMETER DESCRIPTIONA negative value of the first '^'-piece of the Results[0] indicates that
an error occurred during the execution of the remote procedure. In this
case, the second piece of the Results[0] will contain number of the error
descriptors returned in the subsequent nodes of the Results array.

Results[0] Result descriptor
^01: The last error code
^02: Number of error descriptors

Results[i] Error descriptor
^01: Error code
^02: Message
^03: Error location
^04: Error type

Results[j] Line of the additional info
^01: "" (empty)
^02: Text

Error descriptors are returned in reverse chronological order (most recent
first).

Otherwise, number of registered examinations is returned in the Results[0]
and identifiers of the examinations are returned in the subsequent
elements of the array.

Results[0] Number of registered examinations

Results[i] Exam/case identifiers
^01: IEN of the patient in the file #70
^02: IEN in the REGISTERED EXAMS multiple
^03: IEN in the EXAMINATIONS multiple
^04: Case number
^05: Accession number
SSS-MMDDYY-NNNNN if RA*5*47 is installed;
MMDDYY-NNNNN otherwise.
^06: Actual date and time of the case (value of
the EXAM DATE field) in HL7 format (TS):
YYYYMMDD[HHMM[+/-ZZZZ]]
AVAILABILITYAGREEMENT
INACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED