Programming Guide



CHANGE

Switches to another transaction

int sm_tm_command ("CHANGE transactionName");

Arguments

transactionName
The name of a valid transaction manager transaction.

Description

CHANGE switches to another transaction, making it the current transaction. To use this command, you must specify the transaction name. If the transaction does not exist, the previous transaction remains active. In cases where you move between two screens, the command is automatically issued as part of Panther's screen processing.

To get the current transaction name, call sm_tm_pinquire(TM_TRAN_NAME).

To specify a new transaction, use the START command. Any transaction begun with an explicit call to the START command must also be closed by an explicit call to the FINISH command.

Events

There are no request events generated by the CHANGE command.

Example

Refer to the START command.