RAMAG EXAM ORDER (2736)    REMOTE PROCEDURE (8994)

Name Value
NAME RAMAG EXAM ORDER
TAG ORDER
ROUTINE RAMAGRP1
RETURN VALUE TYPE ARRAY
AVAILABILITY AGREEMENT
WORD WRAP ON TRUE
DESCRIPTION
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..
INPUT PARAMETER
  • 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
      ...
     
    
RETURN PARAMETER DESCRIPTION
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