| Programming Guide | |
Unconditionally discards the changes to the screen
int sm_tm_command ("FORCE_CLOSE [tableViewName[tableViewScope] ]");
tableViewName- The name of a table view in the current transaction. This parameter is case sensitive.
If
tableViewNameis specified, the command is applied according to thetableViewScopeparameter. Since the entire table view tree might not be included, this is known as a partial command, andsm_tm_commandsetsTM_FULLto0.If
tableViewNameis not specified, the command is applied for each table/server view, starting with the root table view. This is known as a full command, andsm_tm_commandsetsTM_FULLto 1.tableViewScope- One of the following parameters, which must be preceded by a table view name.
TV_AND_BELOWwhich applies the command to the specified table view and all table views below it on the tree. If no parameter is specified, the transaction manager acts as thoughTV_AND_BELOWwas supplied.
BELOW_TVwhich applies the command to the table views below the specified table view.
TV_ONLYwhich applies the command to the specified table view only.
SV_ONLYwhich applies the command only to the table views of the specified server view.
FORCE_CLOSEunconditionally discards the changes to the screen without a query message. If a table view is not specified, it sets the transaction mode to initial.Push buttons and menu selections for the
FORCE_CLOSEcommand can choose to set the class property toclose_button. By default,close_buttonis active in all but initial mode.
The
FORCE_CLOSEcommand is useful afterSELECT,NEWorCOPYin order to discard changes.
The following requests can be generated by the
FORCE_CLOSEcommand to discard changes that have been made to the screen.
Table 8-23 Table 22. Slice event processing for the FORCE_CLOSE command.