D_SETKEY

SUMMARY
   d_setkey(FIELD,value[,dbn])
   long FIELD;
   char *value;
   int dbn;

ARGUMENTS

   FIELD     Field type of the key field for which the value is to be stored

   value     Pointer to the value of the field to be stored.

   dbn       (optional) The number of the database containing the record.

DESCRIPTION
   This function must be called for each key field in a record that will
   subsequently be created by a call to d_makenew. This establishes the data
   content of all key fields defined in the record so that the system can
   create those keys when d_makenew is called. Optional and compound key
   fields cannot be processed by d_setkey.

CURRENCY CHANGES
   None.

RETURN CODES

   -5      S_INVKEY        Invalid field type. You either did not pas a field
                           type or you passed a field type which is notin the
                           current record.

   -17     S_NOTKEY        FIELD is not key field.

EXAMPLE
     /* create a new info record */
     d_setkey(ID_CODE,"db022");
     d_makenew(INFO);
     ..