SCMC GET NEW PERSON (3401)    REMOTE PROCEDURE (8994)

This RPC provides the functionality to query the New Person (#200) file.
The calling application may query the New Person (#200) file by using 
either the VPID or IEN of the requested entry or part or all of a last
name. Other optional parameters may be passed to the call as additional
filters.

• VPID
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   20
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  VPID (VA Person ID) for the requested user.  (Required for lookup by 
  VPID.  Either VPID, DUZ, or Last Name are required.)
  

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

  All or part of a last name.  (Required for lookup by Last Name. Either
  VPID, DUZ, or Last Name are required.)
  

• FIRST NAME
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   30
  REQUIRED:   NO
  SEQUENCE NUMBER:   4
  DESCRIPTION:   

  Optional parameter set to null or the full or partial first name.
  

• SSN
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   9
  REQUIRED:   NO
  SEQUENCE NUMBER:   5
  DESCRIPTION:   

  Value set to null or contains the 9 digits of the Social Security Number.
  

• PROVIDER
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   1
  REQUIRED:   NO
  SEQUENCE NUMBER:   6
  DESCRIPTION:   

  Optional input parameter set to null or "P".  If set to "P", screens for
  providers (person with active user class).
  

• STATION
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   10
  REQUIRED:   NO
  SEQUENCE NUMBER:   7
  DESCRIPTION:   

  Optional parameter set to null or station number.
  

• NUMBER OF ENTRIES
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   2
  REQUIRED:   NO
  SEQUENCE NUMBER:   8
  DESCRIPTION:   

  ***Parameter no longer used***
  Optional parameter set to maximum number of entries to be
  returned.  Defaults to "*" (all entries).
  

• DATE
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   8
  REQUIRED:   NO
  SEQUENCE NUMBER:   9
  DESCRIPTION:   

  Optional parameter contains the date (HL7 format - yyyymmdd) used to
  determine if person class is active.  Defaults to current date.
  

• DUZ
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   20
  REQUIRED:   YES
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  File 200 IEN (Required for lookup by DUZ.  Either VPID, DUZ, or Last Name
  are required.)
  

An array with the following nodes:
^TMP($J,"SCMCQRY",1) - 1 if found, 0 if not found
^TMP($J,"SCMCQRY",n,0) - VPID^IEN^Last Name~First Name~Middle 
Name^SSN^DOB^SEX^Phone^Pager^
^TMP($J,"SCMCQRY",n,1) - Provider Type^   (Person Class)
^TMP($J,"SCMCQRY",n,2) - Provider Classification^
^TMP($J,"SCMCQRY",n,3) - Provider Area of Specialization^
^TMP($J,"SCMCQRY",n,4) - VA CODE^^Specialty Code^
^TMP($J,"SCMCQRY",n,5) - return code^status^date^| ("|" = end of record)