Data Form and Data Table: _setDataset

Data Form and Data Table: _setDataset

Sets the data set (table) being accessed by the object

Delegated to: Data Set Data Model class

Syntax
Details

Syntax

CALL SEND (object-id, '_setDataset', name<, mode<, locking<, option-1<,...option-n>>>>);

Argument Type Description

name
C specifies the name of the new data set (table). The name may include data set options.

mode
C specifies the open mode: 'BROWSE' or 'EDIT'. The default is 'BROWSE'.

locking
C specifies the locking level: 'RECORD' or 'MEMBER'. The default is 'RECORD'.

option-1<,...option-n> C specifies any additional _setDataset method options:

'BRONLY' prevents editing of the table

'NOADD' prevents the user from adding new rows to the table

'NODELETE' prevents the user from deleting rows in the table

Argument	Type	Description
name	C	specifies the name of the new data set (table). The name may include data set options.
mode	C	specifies the open mode: 'BROWSE' or 'EDIT'. The default is 'BROWSE'.
locking	C	specifies the locking level: 'RECORD' or 'MEMBER'. The default is 'RECORD'.
option-1<,...option-n>	C	specifies any additional _setDataset method options:
		'BRONLY'	prevents editing of the table
		'NOADD'	prevents the user from adding new rows to the table
		'NODELETE'	prevents the user from deleting rows in the table

Details

The _setDataset method removes all computed columns defined using the _addComputedColumn method. Recursive calls to _setDataset are not allowed.

Note:

The _setDataset method cannot be called from the model's SCL entry.
If you use a data form and the columns in the new table (data set) are different from the previous table (data set), you may need to call _refillUsingAttributes on the data form in order to see the columns.
Passing a value of ' ' (a blank enclosed in quotes) as the name of the data set (table) will close the current data set (table).

Chapter Contents
Previous
Next
Top of Page