MAG FIELD VALIDATE (2893)    REMOTE PROCEDURE (8994)

Name Value
NAME MAG FIELD VALIDATE
TAG DVAL
ROUTINE MAGQBUT4
RETURN VALUE TYPE SINGLE VALUE
AVAILABILITY RESTRICTED
INACTIVE ACTIVE
DESCRIPTION
This provides an interface with the VA Fileman Database Server (DBS)
API for the single field validator: VAL^DIE.
INPUT PARAMETER
  • FILE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   99
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    This is the file number that contains the attribute to be validated.
    
  • IENS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   99
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    This is the record number or place holder of the entry being validated.
    
  • FIELD
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   99
    REQUIRED:   YES
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    This is the number of the file attribute to be validated.
    
  • FLAGS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   99
    REQUIRED:   NO
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    This is the option set of parameters defined for the VAL^DIE
     
    U Don't perform key validation. Without this flag, the data in VALUE is
    checked to ensure that no duplicate keys are created and that key field 
    values are not deleted.
    E External value is returned in RESULT(0).
     
    F FDA node is set for valid data in array identified by FDA_ROOT.
     
    H Help (single ?) is returned if VALUE is not valid.
     
    R Record identified by IENS is verified to exist and to be editable. Do
    not  include "R" if there are placeholders in the IENS.
    
  • VALUE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   99
    REQUIRED:   YES
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    This is the value to be validated.
    
RETURN PARAMETER DESCRIPTION
It returns the resolved external value or -1 followed by the carat 
710 The field is uneditable.
712 An inappropriate deletion of a field's value is being attempted.
740 A duplicate key is produced by a field's new value.
742 A value for a field in a key is being deleted.
1610 Help was improperly requested.
delimiter and one of the following error messages:
 
120 Error occurred during execution of a FileMan hook.
299 Ambiguous value. (Variable Pointer data type only.)
405 The file is uneditable.
520 The field's data type or INPUT transform is inappropriate.
602 The entry cannot be edited.
701 Value is invalid.