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

 +---------------------------------------------------------------+
 | 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  |

• 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.
  

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".