NAME

tkadmin force transaction - forces the outcomes of prepared transactions

SYNOPSIS

tkadmin force transaction -server servername tid [-commitdesired] [-finish]

ARGUMENTS

-server servername Specifies the server affected by the command. The server name is the name that is registered with the DCE Directory Service. If the server name is not specified in the command line, it is retrieved from an environment variable, ENCINA_TK_SERVER. 

tid Identifies the transaction. 

[-commitdesired] Forces the transaction to commit. Otherwise, the transaction is forced to abort. 

[-finish] Forces the transaction to finish regardless of whether or not its outcome has been reported to all participating applications. 

DESCRIPTION

The tkadmin force transaction command forces the outcome of the prepared transaction, tid. Forcing a transaction to commit or abort releases the locks held by that transaction. If the -commitdesired option is used, the transaction is committed; otherwise, the transaction is aborted. (The output of the tkadmin list transactions command shows the states of unresolved transactions.) If the -finish option is used, the transaction is forced to finish even though the outcome has not been reported to all participating applications (normally a requirement of a transaction’s completion). This option is useful if one of the participating applications is no longer available. 

CAUTIONS

You must force transactions with caution. Inconsistencies can be introduced into server data by forcing a transaction to the wrong outcome (for instance, forcing it to commit when it would have aborted).  If the true outcome of the transaction is unclear, it is safer for you to force the transaction to abort. 

EXAMPLES

The following command forces transaction 2000 to commit:

% tkadmin force transaction 2000 -commitdesired

PRIVILEGE REQUIRED

Encina Monitor administer (a) permission to the application server

Encina RQS administer (a) permission to the RQS server

Encina SFS administer (A) permission to the SFS server

RELATED INFORMATION

tkadmin list transactions

tkadmin abort transaction

  —  March 1997