sm_tm_continuation_validity

Programming Guide

Checks to see if the CONTINUE events are permitted for the current table view
#include <tmusubs.h>
int sm_tm_continuation_validity(int report);

report
Controls whether an error message is generated. If this parameter is non-zero, the message is generated.

Returns

· TM_OK if the TM_CONTINUE_UP, TM_CONTINUE_TOP, TM_CONTINUE_DOWN, and TM_CONTINUE_BOTTOM events are permitted.

· TM_FAILURE if these events are not permitted. If report is non-zero, an error message is also generated.

Description

This function is used in the standard transaction models for two-tier applications as part of the transaction manager processing for the SELECT and VIEW commands. It checks the value of the fetch_directions property for the current table view to see if the TM_CONTINUE_UP, TM_CONTINUE_TOP, TM_CONTINUE_DOWN, and TM_CONTINUE_BOTTOM events are permitted.
If the fetch_directions property is specified as Down only-all modes (PV_CONT_NEVER), only TM_CONTINUE fetches additional data. TM_CONTINUE_DOWN is not permitted.
If the fetch_directions property is specified as Up/Down-view mode (PV_CONT_VIEW_ONLY), the TM_CONTINUE_UP, TM_CONTINUE_TOP, TM_CONTINUE_DOWN, and TM_CONTINUE_BOTTOM events are allowed in addition to TM_CONTINUE if the current transaction mode is view.
If the fetch_directions property is specified as Up/Down-all modes (PV_CONT_ALWAYS), the TM_CONTINUE_UP, TM_CONTINUE_TOP, TM_CONTINUE_DOWN, and TM_CONTINUE_BOTTOM events are allowed in addition to TM_CONTINUE in view and update mode. Data must be re-fetched in order for updates to be displayed from the continuation file used with these events.
If the table view's fetch_directions property is specified as default (PV_CONT_DEFAULT), the screen's Fetch Directions property is consulted. If the screen's Fetch Directions property is specified as default, this is the equivalent of Down only-all modes.