DSIC DDVG XLATE DATA2IDX (1593)    REMOTE PROCEDURE (8994)

Name Value
NAME DSIC DDVG XLATE DATA2IDX
TAG XLATE2
ROUTINE DSICDDR4
RETURN VALUE TYPE ARRAY
AVAILABILITY AGREEMENT
DESCRIPTION
Will take an external value and perform a FILEMAN lookup. 
 
Restrictions are:
1.  The external value must be resolvable to a unique entry.
2.  There must be an index on the field that contains the value.
INPUT PARAMETER
  • FILE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   20
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    This is the file (or subfile) number upon which the lookup will be done
    
  • IENS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   50
    REQUIRED:   NO
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    This is the standard IENS parameter when FIND1^DIC is invoked.  It is 
    only needed if the lookup is on a multiple instead of the parent file.
    
  • VALUE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   250
    REQUIRED:   YES
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    This is the value in external format used for the lookup.
    lookup.
    
RETURN PARAMETER DESCRIPTION
If the lookup is successful, return 1^internal file number
If the lookup is unsuccessful, return 1^<null>
If the lookup encountered an error, return -1^message