VIAB GETSURR (3640)    REMOTE PROCEDURE (8994)

This RPC returns information about a user's surrogate, including start and
end date/times if they are specified.

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

  This is the user internal entry number (IEN) in the NEW PERSON file.
  

The value returned is of the form
                  S USER=124
                  D GETSURR^VIABRPC(.RESULT,USER) 
                
               might yield a value of RESULT containing 
                
                 2327^DOE,JOHN^3160229.1630^3181006.0800 
                  RESULT=ien^NAME^FM_STARTDATE^FM_ENDDATE 
      
     where ien is the internal entry number of the SURROGATE in 
     the NEW PERSON file, NAME is the contents of the .01 field for
     the SURROGATE, FM_STARTDATE is the starting date/time for the
     SURROGATE in internal Filemanager format, and FM_ENDDATE is
     the ending date/time for the SURROGATE in internal Filemanager
     format.