LMCP REPAIR — VMS 5.4
Selects records within a log file so that transactions can be
repaired by having their transaction states changed. Once the
transaction records have been selected, REPAIR subcommands can be
used to change the transaction states.
Use of the REPAIR command requires the SYSPRV privilege.
Format
REPAIR filespec [qualifier...]
Additional information available:
ParameterQualifiersDescriptionExampleREPAIR Subcommands
Parameter
filespec Specifies the file specification of the log file containing the transaction records to be repaired.
Qualifiers
Additional information available:
/LOGID
/LOGID=log_identifier
Specifies the log identifier, in hexadecimal format, associated
with a specific resource manager. The /LOGID qualifier can only be
used in conjunction with the /RM qualifier.
/RM
/RM=rm_identifier
Selects the transactions to be repaired according to the resource
manager participating in the transaction. The argument supplied
for the rm_identifier can be either the ASCII character string
for the resource manager name, or its hexadecimal equivalent. When
specifying a hexadecimal string, you must prefix the characters %X
to the hexadecimal string.
If a partial resource manager name is supplied as the argument for
the rm_identifier, LMCP selects all resource managers whose names
begin with the supplied string.
/STATE
/STATE=transaction_state
Selects the transactions to be repaired according to their
transaction states. A value of either PREPARED or COMMITTED can
be supplied as an argument to the /STATE qualifier. If the /STATE
qualifier is not supplied, all active transactions (both PREPARED
and COMMITTED) are selected.
/TID
/TID=transaction_id
Selects the transactions to be repaired according to the
transaction identifier. The argument supplied for the transaction_
id must be a hexadecimal character string.
Description
The REPAIR command allows you to manually modify active transaction records in a log file. When you enter the REPAIR command, LMCP enters the REPAIR command mode, in which REPAIR subcommands can be invoked interactively. The LMCP> prompt is replaced by the REPAIR> prompt. For a description of the REPAIR subcommands, see the REPAIR SUBCOMMANDS section.
Example
LMCP> REPAIR SYSTEM$ORANGE/STATE=PREPARED/RM=LOGL This command selects all PREPARED transaction records in the log file SYSTEM$ORANGE. It specifies that only records with all participating resource managers with names beginning with "LOGL."
REPAIR Subcommands
Entering the REPAIR command produces a listing of the log file's contents, as selected by the optional REPAIR command qualifiers. Each transaction record is displayed sequentially, so that you can modify its characteristics. After each record in the filtered log file is displayed, the REPAIR> prompt returns. You can then enter REPAIR subcommands to change the transaction states of specific records. You must enter a NEXT subcommand to advance to the next sequential record in the file. To return to the LMCP> prompt, you must exit the REPAIR command mode by entering the EXIT subcommand or by pressing CTRL/Z.
Additional information available:
ABORT
Changes the state of a transaction from PREPARED to ABORTED.
Format
ABORT
COMMIT
Changes the state of a transaction from PREPARED to COMMITTED.
Format
COMMIT
EXIT
Exits the REPAIR command mode and returns the LMCP> prompt.
Format
EXIT
FORGET
Specifies that a transaction with a state of COMMITTED should be
forgotten, that is, the committed transaction record is removed
from the log file.
Format
FORGET
NEXT
Advances to the next record in a transaction log.
Format
NEXT