Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
User Commandsrecover-transactions(1)


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.4Go To TopLast Changed 22 Dec 2004