| GENERAL DESCRIPTION |
The RAMAG EXAM CANCEL remote procedure cancels the
Radiology exam(s) and sends all required notifications.
If all exams that reference the same order/request are canceled, this
function can also cancel/hold the order (if the appropriate parameters are
provided).
Input Parameters
================
RAEXAM String of exam/case identifiers separated by '^'
^01: IEN of the patient in the RAD/NUC MED
PATIENT file (#70)
^02: IEN in the REGISTERED EXAMS multiple
(sub-file #70.02)
^03: IEN in the EXAMINATIONS multiple
(sub-file #70.03)
RAREASON Reason for cancelation: either IEN of a record of
the RAD/NUC MED REASON file (#75.2) or a valid
synonym (see SYNONYM field (3) of the file #75.2).
The referenced record must have the 'CANCEL REQUEST'
or 'GENERAL REQUEST' type (see TYPE OF REASON field
(2) of the file #75.2).
[RAFLAGS] Flags that control execution (can be combined):
A Cancel all related exams/cases (those that
reference the same order).
O Cancel/hold the related order after successful
exam cancelation.
The order will be canceled or put on hold only
if there are no more active cases associated
with it.
Otherwise, the error code -42 will be returned.
Use the "A" flag to cancel all related exams
and guarantee the order cancelation.
[RAMSC] Items 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)
^03: Value1
^04: Value2
...
The following records are supported by this remote
procedure:
HOLDESC^{Seq#}^{Line of hold description}
Text for the HOLD DESCRIPTION field (25)
of the file #75.1.
ORDRSN^^{Cancel/hold reason for related order}
Either IEN of a record of the RAD/NUC MED
REASON file (#75.2) or a valid synonym
(see SYNONYM field (3) of that file).
If this parameter is not defined or empty,
the value of the RAREASON parameter is
assumed.
Records can be added to the list in any order.
If the RAFLAGS parameter contains the 'O' flag,
the 'ORDRSN' and 'HOLDESC' parameters determine
whether the related order is canceled or put on
hold. Otherwise, they are ignored.
* If the reason record referenced by the 'ORDRSN'
has the CANCEL REQUEST (1) type, then the 'HOLDESC'
is ignored and the order is canceled.
* If the record referenced by the 'ORDRSN' is of
the HOLD REQUEST (3) type, then the order is put
on hold. If the 'HOLDESC' is defined, the text is
stored into the HOLD DESCRIPTION field.
* If the record referenced by the 'ORDRSN' is of
the GENERAL REQUEST type (9), then the action
performed on the order is determined by the
'HOLDESC'. If it is defined, then the order is
put hold; otherwise, the order is canceled.
Examples:
with RPCBroker.Param[2] do
begin
PType := list;
Mult[1] := 'ORDRSN^^OHR';
Mult[2] := 'HOLDESC^1^Hold description line #1';
Mult[3] := 'HOLDESC^2^Hold description line #2';
end;
Results
=======
A 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, 0 is returned in the Results[0].
Notes
=====
See comments in the source code of the RAMAG05 routine and description of the
RAMAG EXAM CANCEL remote procedure for additional and/or most recent details.
|
