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")
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 commited 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 | Do not 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.