MAG GET DICOM FMT PATIENT NAME (4202)    REMOTE PROCEDURE (8994)

Name Value
NAME MAG GET DICOM FMT PATIENT NAME
TAG DCMNAME
ROUTINE MAGDRPC1
RETURN VALUE TYPE SINGLE VALUE
AVAILABILITY PUBLIC
INACTIVE ACTIVE
DESCRIPTION
  +---------------------------------------------------------------+
  | a medical device.  As such, it may not be changed in any way. |
  | Modifications to this software may result in an adulterated   |
  | medical device under 21CFR820, the use of which is considered |
  | to be a violation of US Federal Statutes.                     |
  +---------------------------------------------------------------+
Return a DICOM formatted patient name (family^given^middle^prefix^suffix).
  | Property of the US Government.                                |
  | No permission to copy or redistribute this software is given. |
  | Use of unreleased versions of this software requires the user |
  | to execute a written test agreement with the VistA Imaging    |
  | Development Office of the Department of Veterans Affairs,     |
  | telephone (301) 734-0100.                                     |
  |                                                               |
  | The Food and Drug Administration classifies this software as  |
INPUT PARAMETER
  • DFN
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
     The value of this parameter is a pointer to ^DPT().
     This pointer identifies the patient for whom information
     is being requested.
    
  • DELIM
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   10
    REQUIRED:   NO
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    The user may specify an optional delimeter to separate name components.
    The "^" is the default delimiter if no delimeter is specified.
    
RETURN PARAMETER DESCRIPTION
 When an error occurs during the processing of this RPC,
 the following error messages may be returned:
     "-1,No Patient Identified"
     "-2,No patient found with DFN=<dfn>"
Otherwise the patient name components are return in DICOM format:
family name^given name^middle name^prefix^suffix 
Note: The prefix and suffix are in reversed order in HL7.