DSIC DDR FINDER (1585)    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 Programmers 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^MOUSE,MICKEY^000000001
2^MOUSE,MINNIE^000000002
 
but if FIELD=".09^.01", you would see:
 
1^000000001^MOUSE,MICKEY
2^000000002^MOUSE,MINNIE
 
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: