DSIV FM FILER (3360)    REMOTE PROCEDURE (8994)

This invokes the Fileman filer to update records for an existing entry.
This will allow you to update any field at the level of the FILE including
word processing fields.  It does not allow for updating different levels
of the file.  If you wish to update a subfile, then you will have to make
multiple calls to this RPC for each file or subfile.

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

  This is the file (or subfile) number for record which you wish to update
  

• IENS
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   50
  REQUIRED:   YES
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  This is the standard Fileman IENS for calling the Fileman DBS APIs.  The
  format of iens is as follows (must have trailing commas):
     record#, - to update a record at the top level of a file
   
     sub1,ifn1, - to update multiple record sub1 in the file for record ifn1
     sub2,sub1,ifn1 - update a multiple within a multiple within a file
  

• FLAG
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   1
  REQUIRED:   NO
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

  This parameter is optional.  If passed it must be equal to "T"
  FLAG="T" indicates that you wish transaction processing to occur.  That
  is, all of the fields must successfully be updated or none of them are
  updated.  Without this flag, Fileman will update those fields that he 
  can.
  

• INPUT
  PARAMETER TYPE:   LIST
  MAXIMUM DATA LENGTH:   250
  REQUIRED:   YES
  SEQUENCE NUMBER:   4
  DESCRIPTION:   

   This list contains the fields to be updated in the file (or subfile).
          processing
            p2 = I - value is in Fileman internal format
            p2 = E - value is on external format
            p2 = W or WA - this field is a word processing field
                 see notes below for additional details for this
   
     p3 - required - this is the value to be entered for this field#
   
   Notes on word process fields
   ----------------------------
   The format of INPUT(x) = p1^p2^p3  where
     if INPUT(x) = field#^W^@ then delete any existing text for this record
     if INPUT(x) = field#^W^text then this will first remove any existing
                   text that may exist.  It will then add the new text
     if INPUT(x) = field#^WA^text then this will not delete the existing
                   text but will append the new text to the existing text if
                   there is any
   
     For the same field# all lines of the array must have the same value for
     the second piece.  That is, all must be W or WA.  You cannot have some
     as W and some as WA.  Each field# can have its own type.  Field 1 could
   
     be W and field 2 could be WA.
      x - the subscript of INPUT can be anything, numeric, string
   
     p1 - required - this is the field number at the level in the file
   
     p2 - optional - default value is "I" - this flag indicates the type
          value being passed in, internal format, external format, word
  

 If no problems are encountered filing data, then return LIST[1] := 1^
 Else return LIST[1] := -1^general error message
             LIST[2...n] := additional specific error messages