RAMAG EXAM ORDER

TITLEVALUE
NAMERAMAG EXAM ORDER
DESCRIPTIONThe RAMAG EXAM ORDER remote procedure requests a Radiology exam for the
patient and returns the IEN of the new order in the RAD/NUC MED ORDERS
file (#75.1). It also sends all required notifications..
TAGORDER
ROUTINERAMAGRP1
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERRADFN
DESCRIPTIONPatient IEN (DFN).
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERRAMLC
DESCRIPTIONIEN of the imaging location in the IMAGING LOCATIONS file (#79.1).
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERRAPROC
DESCRIPTIONRadiology procedure and optional modifiers
^01: Procedure IEN in the RAD/NUC MED PROCEDURES file (#71)
^02: Optional procedure modifiers (IENs in
... the PROCEDURE MODIFIERS file (#71.2))
^nn:
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER4
INPUT PARAMETERREQDTE
DESCRIPTIONDesired date for the exam in HL7 format (TS): YYYYMMDD. If time is
provided, it is ignored. The date must be exact.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER5
INPUT PARAMETERRACAT
DESCRIPTIONExam category: internal value of the CATEGORY OF EXAM field (4) of the
RAD/NUC MED ORDERS file (#75.1).
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER6
INPUT PARAMETERREQLOC
DESCRIPTIONIEN of the requesting location in the HOSPITAL LOCATION file (#44).
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER7
INPUT PARAMETERREQPHYS
DESCRIPTIONIEN of the requesting physician in the NEW PERSON file (#200).
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER8
INPUT PARAMETERREASON
DESCRIPTIONReason for study. See the REASON FOR STUDY field (1.1) of the RAD/NUC MED
ORDERS file (#75.1) for details.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER9
INPUT PARAMETERRAMSC
DESCRIPTIONItems of this list define miscellaneous/optional order 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:

CLINHIST^{Seq#}^{Line of clinical history}
Text for the CLINICAL HISTORY FOR EXAM field (400)
of the file #75.1

ISOLPROC^^{n|y}
Value for the ISOLATION PROCEDURES field (24)
of the file #75.1

PREGNANT^^{n|u|y}
Value for the PREGNANT field (13) of the file #75.1

PREOPDT^^{Internal date value}
Date and time for the PRE-OP SCHEDULED DATE/TIME
field (12) of the file #75.1 in HL7 format (TS):
YYYYMMDD[HHMM[+/-ZZZZ]]. If seconds are provided,
they are ignored. The date must be exact.

REQNATURE^^{e|i|p|s|v|w}
Value for the NATURE OF (NEW) ORDER ACTIVITY field (26)
of the file #75.1

REQURG^^{1|2|9}
Value for the REQUEST URGENCY field (6)
of the file #75.1

TRANSPMODE^^{a|p|s|w}
Value for the MODE OF TRANSPORT field (19)
of the file #75.1

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

Example:

with RPCBroker.Param[8] do
begin
PType := list;
Mult[1] := 'PREGNANT^^y';
Mult[2] := 'PREOPDT^^200001041400';
Mult[3] := 'CLINHIST^1^Clinical history line #1';
Mult[4] := 'CLINHIST^2^Clinical history line #2';
Mult[5] := 'CLINHIST^3^Clinical history line #3';
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, the Results[0] contains IEN of the new order in the RAD/NUC MED
ORDERS file (#75.1).
AVAILABILITYAGREEMENT
INACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED