DM_setFldWeight

This method activates a weight info that exists in a DM_LogicalDataSpec value by linking it to a field contained in the DM_LogicalDataSpec value.

Parameters

logData

A value of type DM_LogicalDataSpec

fldName

A value of type VARCHAR(128) that is already contained in logData

weight

A value of type VARCHAR(128) that is already containd in logData

Return Value

The return value is of type DM_LogicalDataSpec

• If fldName is NULL, the value logData is returned.
• If logData does not contain fldName, the following error occurs:

  IDM1201E: A field with the name "Variable1" is not available.

• If logData does not contain weight, the following error occurs:

  IDM1290E: The weight information "Variable1" is not defined.

• If fldName is of type DM_Numerical , the following error occurs:

  IDM1204E: The field "Variable1" is not categorical.

• If weight is NULL, the value logData is returned. A weight info for the specified field has not been set.
• If none of the conditions above apply the value logData is returned. The weight info of the field fldName is set to the value of weight