Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameter

Qualifiers

Description

Example

REPAIR Subcommands

/LOGID

/RM

/STATE

/TID

ABORT

COMMIT

EXIT

FORGET

NEXT

LMCP REPAIR — VMS 5.5

   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/RM/STATE/TID

/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:

ABORTCOMMITEXITFORGETNEXT

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

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026