| GENERAL DESCRIPTION |
The RAMAG ORDER CANCEL remote procedure cancels/holds
the Radiology order and sends all required notifications.
Input Parameters
================
RAOIFN IEN of the order in the RAD/NUC MED ORDERS file (#75.1).
RAREASON Cancel/hold reason: 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).
The referenced record must have the appropriate type
(see TYPE OF REASON field (2) of the file #75.2):
* If the reason record has the CANCEL REQUEST (1)
type, then the 'HOLDESC' (see the RAMSC parameter)
is ignored and the order is canceled.
* If the reason record is of the HOLD REQUEST (3)
type, then the order is put on hold. If the
'HOLDESC' parameter is defined, the text is stored
into the HOLD DESCRIPTION field.
* If the record is of the GENERAL REQUEST type (9),
then the new order status is determined by the
'HOLDESC' parameter. If it is defined, then the
order is put on hold; otherwise, the order is
canceled.
[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.
Records can be added to the list in any order.
Examples:
with RPCBroker.Param[2] do
begin
PType := list;
Mult[1] := 'HOLDESC^1^Hold description line #1';
Mult[2] := '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
=====
If there are active cases in the RAD/NUC MED PATIENT file (#70) associated
with an order, this remote procedure neither cancels nor holds the order and
returns the error code -42.
See comments in the source code of the RAMAG04 routine and description of the
RAMAG ORDER CANCEL remote procedure for additional and/or most recent details.
|
