MAG DICOM CHECK AE TITLE (2505) REMOTE PROCEDURE (8994)

Name	Value
NAME	MAG DICOM CHECK AE TITLE
TAG	AETITLE
ROUTINE	MAGVRS52
RETURN VALUE TYPE	ARRAY
AVAILABILITY	RESTRICTED
INACTIVE	ACTIVE
WORD WRAP ON	FALSE
VERSION	4
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. \| +---------------------------------------------------------------+ This Remote Procedure checks whether an Application Entity is specified on a DICOM Gateway that has the specified name. \| 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	TITLE PARAMETER TYPE: LITERAL MAXIMUM DATA LENGTH: 16 REQUIRED: YES SEQUENCE NUMBER: 1 DESCRIPTION: The value of this parameter is a string. This string is constrained by the definition in the DICOM Standard for the "title" of an Application Entity, that is: non-empty and at most 16 characters in length. SERVICE PARAMETER TYPE: LITERAL MAXIMUM DATA LENGTH: 20 REQUIRED: YES SEQUENCE NUMBER: 2 DESCRIPTION: The value of this parameter is a string. This string identifies a DICOM DIMSE Service. The procedure will validate that the specified Application Entity is permitted to perform the service specified in this parameter. ROLE PARAMETER TYPE: LITERAL MAXIMUM DATA LENGTH: 3 REQUIRED: YES SEQUENCE NUMBER: 3 DESCRIPTION: The value of this parameter is a string. This string should be equal to either "SCU" (Service Class User) or "SCP" (Service Class Provider). The procedure will validate that the specified Application Entity is permitted to operate in the specified role. LOCATION PARAMETER TYPE: LITERAL MAXIMUM DATA LENGTH: 6 REQUIRED: YES SEQUENCE NUMBER: 2 DESCRIPTION: The value of this parameter is a string. This string should be equal to a value from the INSTITUTION File (#4). This is needed to return the appropriate AETitle.
RETURN PARAMETER DESCRIPTION	The return parameter is an array. When the supplied title is valid, the first element of the return array will be a "0" followed by the AE NAME, REMOTE AE TITLE, LOCAL AE TITLE, LOCATION, IP ADDRESS, PORT NUMBER, a list of the associated DICOM SERVICES and DICOM ROLES. When the supplied title is not found or the inputs are invalid, a negative integer error code and an error message will be returned in the first element of the array. only one element, which can have the values: -1,No AE Title specified -2,No entry for AE Title "xxx".