getDataSet function

Gets the handle to the newly created DataSetMessage.

Syntax

FUNCTION getDataSet (INPUT name, INPUT schemaLocation, 
    INPUT fieldtypeMapping) RETURNS HANDLE.

Applies to

Message objects

Notes

  • The handle parameter must be a declared handle. Any previous value of the handle parameter will be lost.
  • The schema parameters specify the schema information and are passed directly to the READ-XML method. Specifying an Unknown value (?) for any of the schema parameters will result in the use of the default value for that parameter.
  • The DataSet is created from reading the DataSetMessage and using the READ-XML method.
  • The name parameter is the name of the widget-pool to be used when creating the DataSet. (For more information on widget pools, see the CREATE-DATASET entry in OpenEdge Development: ABL Reference.) A value of "?" will result in the use of the default pool.

See also

createDataSetMessage procedure, setDataSet procedure, getDataSet function

For an example, see the DataSetMessage.