DSIV DDR FINDER (3355)    REMOTE PROCEDURE (8994)

Call FIND^DIC to get a list of matches on the file for the input value

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

  This is the number of the file in which you wish to search.
  

• IENS
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   30
  REQUIRED:   NO
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  This is the IENS through which you wish to search for the value VALUE. If 
  you are searching the top level of a file, this should be null. See the 
  FileMan Programmer's Manual for instructions on constructing IENS strings.
  

• FIELD
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   250
  REQUIRED:   YES
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

   This is an ^ (or ";") delimited list of fields that you wish returned 
  from each entry that matches the lookup conditions that you have 
  specified.
  

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

  This is the maximum number of entries to be returned. Defaults to all 
  entries matching the lookup value VALUE.
  

• INDEX
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   50
  REQUIRED:   NO
  SEQUENCE NUMBER:   6
  DESCRIPTION:   

  If you wish to do the lookup on specific indexes, then enter that here. 
  The index string must be compliant with the FileMan documentation.
  

• VALUE
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   100
  REQUIRED:   YES
  SEQUENCE NUMBER:   5
  DESCRIPTION:   

  Enter a value that will be used by FileMan for the lookup. This call does 
  not support the .VALUE syntax allowed by FIND^DIC.
  

• SCREEN
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   250
  REQUIRED:   NO
  SEQUENCE NUMBER:   7
  DESCRIPTION:   

  If you wish to use the DIC("S") equivalent then enter it here.
  

• FLAGS
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   20
  REQUIRED:   NO
  SEQUENCE NUMBER:   8
  DESCRIPTION:   

  This is the FileMan FLAGS parameter used in the FILE^DIC API.
  

 Returns an array in the following format:
 
 1^CPRSPATIENT,FIRSTNAME1^000000001
 2^CPRSPATIENT,FIRSTNAME2^000000002
 
 but if FIELD=".09^.01", you would see:
 
 1^000000001^CPRSPATIENT,FIRSTNAME1
 2^000000002^CPRSPATIENT,FIRSTNAME2
 
 Array[0]=Number of entries found^Number of entries requested^Any more
 entries to return?
 
 Array[1]-[n]=IEN^Values of fields requested in VEJDVAL (in order)
 
 For instance: if FILE=2 (the PATIENT file) and FIELD=".01^.09"
 (name and SSAN respectively), then a sample return may look like: