Utility Statements › FIX ARCHIVE › Usage

Usage

How to submit the FIX ARCHIVE statement

You submit the FIX ARCHIVE statement to CA IDMS/DB only through the batch command facility. You must run the batch command facility in local mode.

How CA IDMS/DB rewrites a tape journal file

When rewriting a tape journal file, CA IDMS/DB:

• Writes an end-of-file marker on the output tape
• Writes ABRT checkpoints for all run units active at the time of the abnormal termination
• Prints checkpoints and program statistics for run units whose activity is recorded in the journal file
• Identifies quiesce points for use in a rollback or rollforward operation
• Writes additional checkpoint records to the output tape
  • For incomplete distributed transactions whose state is InDoubt at the time of the abnormal termination, additional distributed and local checkpoint records will be written to the output file to complete the transaction if a matching manual recovery control input file entry is provided.
  • For local (that is, non-distributed) transactions still active at the time of the abnormal termination, an ABRT checkpoint record will be added to the output file.

Multivolume journal files

The FIX ARCHIVE statement must process all unarchived volumes of a tape journal file in a single run.

Archived journal files

In most cases, you do not have to run the FIX ARCHIVE utility statement against archived journal files. Here are some exceptions:

• To identify incomplete distributed transactions whose state is InDoubt at the end of the input file. (PRINT JOURNAL can also be used for this purpose.)
• To complete transactions by writing additional checkpoint records to the output file.
  • For incomplete distributed transactions whose state is InDoubt at the end of the input file, additional distributed and local checkpoint records will be written to the output file if a matching manual recovery control input file entry is provided.
  • For local (that is, non-distributed) transactions still active at the time of the abnormal termination, an ABRT checkpoint record will be written.
• To merge multiple journal tapes onto one tape for certain rollback and rollforward operations that require multiple journal tapes to be one contiguous file

FIX ARCHIVE and Distributed Transactions

FIX ARCHIVE reports on distributed transactions and supports the use of input and output manual recovery control files. The input manual recovery control file is used to complete InDoubt distributed transactions. If an output manual recovery control file is included in the JCL, an entry will be written for each incomplete distributed transaction encountered. For more information, see JCL Considerations and the "Common Facilities for Distributed Transactions" appendix.

Note: For considerations associated with distributed transactions during recovery operations, see the CA IDMS Database Administration Guide.