| Programming Guide | |
Traverses the transaction tree in select order
int sm_tm_command ("WALK_SELECT [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_FULLto 0.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.
WALK_SELECTperforms a traversal of the transaction tree, starting with the root table/server view, unless another table/server view is specified. If a table view's transaction event function contains processing for theTM_WALK_SELECTrequest event, it is executed.
A
TM_WALK_SELECTrequest event is generated by theWALK_SELECTcommand, but no processing is associated with this event in the transaction models.