IOOPTIONS property
Applies To
Window.
Description
Sets/Gets the file I/O options for the window. File I/O operations, as well as concurrency window locking are tracked here.
Usage
previooptions = Set_Property (windowname, "IOOPTIONS", newiooptions)
curriooptions = Get_Property (windowname, "IOOPTIONS")
Parameters
IOOPTIONS contains the following fields:
| Field | Parameter |
|---|---|
| Field 1 | Value - Description 0 - Pessimistic locking (currently the only supported option). |
| Field 2 | For Pessimistic locking, specifies a lock type. Value - Description 0 - Exclusive. 1 - Shared. 2 - No lock. |
| Field 3 | Specifies whether file coordinated locking is used. Value - Description 0 - Non-file coord locks. 1 - File coord locks. |
| Field 4 | Value - Description 1 - Self locks OK. |
| Field 5 | Not applicable |
| Field 6 | Clear form options. Value - Description 0 - Clear on write. 1 - Do not clear on write. |
| Field 7 | Specifies whether transactions are committed after committing DataSets. Value - Description 0 - Commit transaction after committing DataSets. 1 - Do not commit transaction after committing DataSets. |
| Field 8 | Specifies whether transactions are rolled back after DataSet commit fails. Value - Description 0 - Rollback transaction if DataSet commit fails. 1 - Do not rollback transaction if DataSet commit fails. |
| Field 9 | Specifies whether the form will automatically rollback transactions during CLEAR processing. Value - Description 0 - Do not roll back transactions during CLEAR processing for DataSet bound forms. 1 - Automatically roll back transactions during CLEAR processing for DataSet bound forms. |
| Field 10 | Specifies when required field processing is enforced. Value - Description 0 - allow users to tab off of or otherwise leave empty required fields and check all required fields before saving. 1 - Check all required fields only before saving, allowing the user to tab off of or otherwise leave empty required fields. |
| Field 11 | Specifies whether QBF events force a Read event. Value - Description 0 - Do not force READ event on QBF events. 1 - READ event is triggered by QBF events. |
Inputs
To set a certain field, issue a Get_Property to get the IOOPTIONS first, replace with the intended modified field and call the Set_Property with the complete @FM-delimited structure.
Outputs
For Set_Property: It returns the IOOPTIONS for the window when Set_Property was called.
For Get_Property: It returns the current IOOPTIONS for the window.