MAGV RAD EXAM REGISTER (3148)    REMOTE PROCEDURE (8994)

Name Value
NAME MAGV RAD EXAM REGISTER
TAG XMREGSTR
ROUTINE MAGVIM05
RETURN VALUE TYPE ARRAY
AVAILABILITY RESTRICTED
WORD WRAP ON TRUE
DESCRIPTION
Wraps a call to the RAMAG EXAM REGISTER remote procedure, and re-formats
the output for the DICOM Importer II application. Returns the IEN of
the new case in the RAD/NUC MED PATIENT file (#70), or an array
of error messages.
INPUT PARAMETER
  • RAOIFN
    PARAMETER TYPE:   LITERAL
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    IEN of the order in the RAD/NUC MED ORDERS file (#75.1).
    
  • EXMDTE
    PARAMETER TYPE:   LITERAL
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    Date and time of the exam in HL7 format (TS): YYYYMMDDHHMM[+/-ZZZZ]. If 
    seconds are provided, they are ignored. The date must be exact and the 
    time is required.
    
  • RAMSC
    PARAMETER TYPE:   LIST
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    Items of this list define miscellaneous/optional exam parameters. Each
    The following parameters are supported by this remote procedure:
     
      BEDSECT^^{IEN #42.4}
        Internal value for the BEDSECTION field (19) of
        the EXAMINATIONS multiple (sub-file #70.03).
     
      EXAMCAT^^{C|E|I|O|R|S}
        Value for the CATEGORY OF EXAM field (4) of the
        EXAMINATIONS multiple (sub-file #70.03).
     
    record has 3 or more pieces separated by '^':
      FLAGS^^{flags}
        Flags that control the execution (can be combined):
     
        A  If this flag is provided, then the registration 
           entry point adds the new case to the existing
           ones with the same date/time instead of 
           returning the error code -28.
     
           If the existing date/time record stores an exam 
           set and the "D" flag is not provided, then the
     
           error code -54 is returned.
     
        D  If there is an existing case with the same 
           date/time, then the time of the new case is
           incremented by 1 minute until an unused date/time
           is found.
     
           If the "A" flag is also provided, then time 
           increments also stop when a non-examset
           date/time record is found.
      ^01: Parameter name
     
           If the date is also changed during the time 
           modification, then the case is not registered and
           the error code -29 is returned.
     
      PRINCLIN^^{IEN #44}
        Internal value for the PRINCIPAL CLINIC field (8) of
        the EXAMINATIONS multiple (sub-file #70.03).
     
      RAPROC^{Seq#}^{IEN #71}^{IEN #71.2}^{IEN #71.2}^...
      ^02: Index (for multiples and word-processing values)
        Radiology procedure and optional modifiers.
     
      SERVICE^^{IEN #49}
        Internal value for the SERVICE field (7) of
        the EXAMINATIONS multiple (sub-file #70.03).
     
      SINGLERPT^^{0|1}
        If this parameter is defined and not 0, then all
        cases should be associated with the same order
        and they will share the same report. See the
      ^03: Value1
        MEMBER OF SET (25) and IMAGING ORDER (11) fields
        of the sub-file #70.03 for more details.
     
      TECHCOMM^^{text}
        Value for the TECHNOLOGIST COMMENT field (4) of the
        ACTIVITY LOG multiple (sub-file #70.07). 
     
      WARD^^{IEN #42}
        Internal value for the WARD field (6) of
        the EXAMINATIONS multiple (sub-file #70.03).
      ^04: Value2
     
    Records can be added to the list in any order. See the comments preceding
    the $$REGISTER^RAMAG03 for more details.
     
    Example:
     
      with RPCBroker.Param[2] do
        begin
          PType := list;
          Mult[1] := 'BEDSECT^^12';
      ...
          Mult[2] := 'SERVICE^^43';
          Mult[3] := 'WARD^^456';
          Mult[4] := 'EXAMCAT^^I';
        end;
     
    
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, number of registered examinations is returned in the Results[0]
and identifiers of the examinations are returned in the subsequent
elements of the array. 
 
  Results[0]            Number of registered examinations 
 
  Results[i]            Exam/case identifiers
case, the second piece of the Results[0] will contain number of the error
                          ^01: IEN of the patient in the file #70
                          ^02: IEN in the REGISTERED EXAMS multiple
                          ^03: IEN in the EXAMINATIONS multiple
                          ^04: Case number
                          ^05: Accession number
                                SSS-MMDDYY-NNNNN  if RA*5*47 is installed;
                                    MMDDYY-NNNNN  otherwise.
                          ^06: Actual date and time of the case (value of
                               the EXAM DATE field) in HL7 format (TS):
                               YYYYMMDD[HHMM[+/-ZZZZ]]
descriptors returned in the subsequent nodes of the Results array.
 
  Results[0]            Result descriptor
                          ^01: The last error code
                          ^02: Number of error descriptors