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.