RAMAG EXAM ORDER (2736)    REMOTE PROCEDURE (8994)

The 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..

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

  Patient IEN (DFN).
  

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

  IEN of the imaging location in the IMAGING LOCATIONS file (#79.1).
  

• RAPROC
  PARAMETER TYPE:   LITERAL
  REQUIRED:   YES
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

  Radiology 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:
  

• REQDTE
  PARAMETER TYPE:   LITERAL
  REQUIRED:   YES
  SEQUENCE NUMBER:   4
  DESCRIPTION:   

  Desired date for the exam in HL7 format (TS): YYYYMMDD. If time is 
  provided, it is ignored. The date must be exact.
  

• RACAT
  PARAMETER TYPE:   LITERAL
  REQUIRED:   YES
  SEQUENCE NUMBER:   5
  DESCRIPTION:   

  Exam category: internal value of the CATEGORY OF EXAM field (4) of the 
  RAD/NUC MED ORDERS file (#75.1).
  

• REQLOC
  PARAMETER TYPE:   LITERAL
  REQUIRED:   YES
  SEQUENCE NUMBER:   6
  DESCRIPTION:   

  IEN of the requesting location in the HOSPITAL LOCATION file (#44).
  

• REQPHYS
  PARAMETER TYPE:   LITERAL
  REQUIRED:   YES
  SEQUENCE NUMBER:   7
  DESCRIPTION:   

  IEN of the requesting physician in the NEW PERSON file (#200).
  

• REASON
  PARAMETER TYPE:   LITERAL
  REQUIRED:   YES
  SEQUENCE NUMBER:   8
  DESCRIPTION:   

  Reason for study. See the REASON FOR STUDY field (1.1) of the RAD/NUC MED 
  ORDERS file (#75.1) for details.
  

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

  Items of this list define miscellaneous/optional order parameters. Each
  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
   
  record has 3 or more pieces separated by '^':
    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
    ^01: Parameter name
   
  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';
    ^02: Index (for multiples and word-processing values)
        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;
    ^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, the Results[0] contains IEN of the new order in the RAD/NUC MED
ORDERS file (#75.1).
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