DSIV DDR UPDATE SUBFILE (3352)    REMOTE PROCEDURE (8994)

Name Value
NAME DSIV DDR UPDATE SUBFILE
TAG UPDATE1
ROUTINE DSIVDDR0
RETURN VALUE TYPE ARRAY
AVAILABILITY AGREEMENT
DESCRIPTION
 This will add a new record to a multiple in a file.   The multiple can be
 at any level as long as the IENS is properly defined.  Additional fields
 can filed with the record.
INPUT PARAMETER
  • FILE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   20
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
     This is the number of the subfile to which a new record is to be added
    
  • IENS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   50
    REQUIRED:   NO
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
     This is the standard Fileman DBS parameter for calling UPDATE^DIE when
     adding a record to a multiple in a file.  If IENS is not passed or is
     passed as <null>, then this will add the record at the top level of the
     file.
    
  • DATA
    PARAMETER TYPE:   LIST
    MAXIMUM DATA LENGTH:   250
    REQUIRED:   YES
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
     This is a list of fields and their internal values to be filed with the
     new record.  Obviously the .01 field should have a value to be filed.  
     The format of the DATA array: DATA(field#)=value
     
     On the GUI side this would be:  Param.List['field#'] := value
    
RETURN PARAMETER DESCRIPTION
 If the record is successfully created, return -1^new subfile record 
number Else, return -1^message