Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Reference Manual

## recover-transactions(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | SEE ALSO

#### NAME

recover transactions– manually recovers pending transactions

#### SYNOPSIS

`recover-transactions` ––user user ––passwordfile filename [––host localhost] [––port port_number] [––secure=false] [––terse=false] [––echo=false] [––interactive=true] [––delegatedrecovery=false] [––transactionlogdir tx_log_dir ] [––recoveryserverid recovery_server_id] recovery_server_name

#### DESCRIPTION

The function of this command is to manually recover pending transactions. This is used in remote mode only.

#### OPTIONS

`–u` `––user`

  The authorized domain application server administrative username.

`–w` `––password`

  The `––password` option is deprecated. Use `––passwordfile` instead.

`––passwordfile`

  The name of the file containing the domain application server password. The passwordfile should contain either of the following entries: AS_ADMIN_PASSWORD=password or AS_ADMIN_MAPPEDPASSWORD=password. If this option is not called directly, you will be prompted for it before the requested action is completed.

`–H`.`––host`

  The machine name where the the domain application server is running.

`–p`.`––port`

  The port number of the domain application server listening for administration requests.

`–s`.`––secure`

  If set to true, this command uses SSL/TLS to communicate with the domain application server.

`–t`.`––terse`

  Indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. The default is false.

`–e`.`––echo`

  Setting this option to true will echo the command line statement on the standard output. The default is false.

`–I`.`––interactive`

  If this option is set to true (default), only the required password options are prompted.

`––delegatedrecovery`

  When the delegated-recovery is set to false (the default), transaction recovery is done at the running server. When the delegated-recovery is set to true, another server performs the recovery for the failed server. If the command is set to true and there is no server-related data, the DAS does the delegated recovery.

`––transactionlogdir`

  When a server fails it writes the location in its transaction log. This option is required if the –delegetedrecovery option is set to true. If the failed server's transaction logs are copied to some other location to make it available to the surrogate recovery server, this option should be used. If the failed server's transaction-service, tx-log-dir is modified to reflect a new location, then this option is not required.

`––recoveryserverid`

  This option is the server identification id or token for the failed server. This option is required if the –delegaterecovery option is set to true. This option is not necessary if the recovery_server_name operand can giv a hint of the recovery_server_id. The recoveryserverid option is not only used in recovery but it is also used in the creation of the XIDand later used to recognize the XIDs that belong to this server.

#### OPERANDS

recovery_server_name

  This is the name of the server that failed. It is this server that is losting the transaction that will be recovered.

#### EXAMPLES

##### Example 1 Using recover-transactions

    asadmin>recover-transactions serverid1
    Transaction recovered.

#### EXIT STATUS

0

  command executed successfully

1

  error in executing the command

#### SEE ALSO

none

J2EE SDK 1.4 Last Revised 22 Dec 2004

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | SEE ALSO

- © 2010, Oracle Corporation and/or its affiliates