MPIF DNL ADD UPD (2529)    REMOTE PROCEDURE (8994)

This RPC has been established to allow the remote creation of records 
into the MPI DO NOT LINK (#985.26) file.

• SOURCEID
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   50
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  The field is the ID of the record you want to add to the DO NOT LINK list.
  The field format will be the fully qualified SourceID:
    SourceID~AssigningLocation~AssigningAuthority~SourceType
   For example: 123~500~USVHA~PI
  

• DNLEVENT
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   30
  REQUIRED:   YES
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

  This is the event that triggered this entry to get created.  The events 
  are MPI Resolve Mismatch, User input, TOOLKIT Resolve Duplicate, 
  and KERNEL VERIFIED NOT A DUPLICATE.
  

• DNLIDENTIFYINGLOCATION
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   5
  REQUIRED:   YES
  SEQUENCE NUMBER:   4
  DESCRIPTION:   

  This field contains the station# of the person that identified/triggered 
  the DO NOT LINK request to be added.
  

• INACT
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   1
  SEQUENCE NUMBER:   6
  DESCRIPTION:   

  This field will be used to pass whether the user/application wants the pair
  to be inactivated.  If you want the pair to be inactivated pass a Y for
  yes, otherwise leave blank.
  

• DNLSOURCEID
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   50
  REQUIRED:   YES
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  The field contains the corresponding ID of the record you want to add to
  the DO NOT LINK list.  The field format will be the fully qualified
  SourceID:
   SourceID~AssigningLocation~AssigningAuthority~SourceType
    For example: 123~500~USVHA~PI
  

• DNLIDENTIFIEDBY
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   60
  REQUIRED:   YES
  SEQUENCE NUMBER:   5
  DESCRIPTION:   

  This is the person that identified the DO NOT LINK record.
  

• DNLEVENT
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   30
  REQUIRED:   YES
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

  This is the event that triggered this entry to get created.  The events 
  are MPI Resolve Mismatch, User input, TOOLKIT Resolve Duplicate, and
  KERNEL VERIFIED NOT A DUPLICATE.
  

• DNLSOURCEID
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   50
  REQUIRED:   YES
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  The field contains the corresponding ID of the record you want to add to
  the DO NOT LINK list.  The field format will be the fully qualified
  SourceID:
  SourceID~AssigningLocation~AssigningAuthority~SourceType
   For example: 123~500~USVHA~PI
  

• INACT
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   1
  SEQUENCE NUMBER:   6
  DESCRIPTION:   

  This field will be used to pass whether the user/application wants the 
  pair to be inactivated.  If you want the pair to be inactivated pass a Y
  for yes, otherwise leave blank.
  

• DNLIDENTIFIEDBY
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   60
  REQUIRED:   YES
  SEQUENCE NUMBER:   5
  DESCRIPTION:   

  This is the person that identified the DO NOT LINK record.
  

This RPC will return a positive (1) or negative response (-1) in 
      or
    1^SUCCESSFUL
RETURN(1), in the following format: result^text result
 
Example output:
   -1^Missing SourceID passed, missing ID"
   -1^Missing SourceID passed, missing Assigning Location
   -1^Missing SourceID passed, missing Assigning Authority
   -1^Missing SourceID passed, missing Id Type
   -1^error text