RAMAG ORDER CANCEL (2738)    REMOTE PROCEDURE (8994)

The RAMAG ORDER CANCEL remote procedure cancels/holds the Radiology order
and sends all required notifications.
 
NOTE: 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.

• RAOIFN
  PARAMETER TYPE:   LITERAL
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  IEN of the order in the RAD/NUC MED ORDERS file (#75.1).
  

• RAREASON
  PARAMETER TYPE:   LITERAL
  REQUIRED:   YES
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  Cancel/hold reason: either IEN of a record of the RAD/NUC MED REASON file
   
   * 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.
  (#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.
  

• RAMSC
  PARAMETER TYPE:   LIST
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

  Items of this list define miscellaneous/optional parameters. Each record
  The following parameters 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. See the comments preceding
  the $$ORDCANC^RAMAG04 for more details.
   
  Examples:
  has 3 or more pieces separated by '^':
   
    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;
   
    ^01: Parameter name
    ^02: Index (for multiples and word-processing values)
    ^03: Value1
    ^04: Value2
    ...
   
  

A negative value of the first '^'-piece of the Results[0] indicates that
  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
 
an error occurred during the execution of the remote procedure. In this
Error descriptors are returned in reverse chronological order (most recent
first).
 
Otherwise, 0 is returned in the Results[0].
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