OpenTP1 Version 7 Description

[Contents][Glossary][Index][Back][Next]

3.9.3 Journal maintenance facilities

The journal maintenance facilities are for editing the journal data copied to an unload journal file. For example, you can merge multiple unload journal files into one. The commands are:

jnlcopy
For duplicating journals.

jnlcolc
For integrating file recovery journals.

jnledit
For editing journals.

jnlrput
For outputting unloaded-journals file records.

This section explains these commands.

Organization of this subsection
(1) Duplicating journals
(2) Integrating file recovery journals
(3) Editing journals
(4) Outputting unloaded-journals file records

(1) Duplicating journals

You can use the jnlcopy command to duplicate journals. The command provides a record duplicating facility and a merge facility.

The record duplicating facility outputs a specified range of unloaded-journals file information to the standard output. Information is output in units of records and the output range is specified in jnlcopy as the date the journal was obtained.

Also, an unloaded-journals file for each type of journal can be copied by specifying the journal type (e.g., AJ or BJ) in the jnlcopy command.

The merge facility merges multiple unloaded-journals files into one file. Only those unloaded-journals files that are output to the same online system and have consecutive generation numbers can be merged.

The facilities provided by the jnlcopy command are referred to as the journal duplicating facilities

(2) Integrating file recovery journals

You can use the jnlcolc command to extract only the data necessary for DAM FRC or TAM FRC from the unloaded-journals files, and output the data to the standard output. The data necessary for file recovery in the unloaded-journals files are integrated into a file at one time. This file is called an integrated journal file.

A DAM or TAM file in which an error occurred is recovered from the backup file and unloaded-journals files. OpenTP1 itself integrates the unloaded-journals files and performs the recovery. At file recovery, if the newest integrated journal file created by the user is available, the recovery time can be reduced.

An unloaded-journals file includes history information that is used to recover undetermined transactions. This history information is stored in an inheritance file different from the integrated journal so that the information can be inherited at the next journal integration. The data necessary for file recovery is integrated at the next journal integration from the inheritance file and unloaded-journals files.

The facilities provided by the jnlcolc command are referred to as the file recovery journal integrating facilities.

(3) Editing journals

You can use the jnledit command to output the contents of unloaded-journals files to the standard output in a listing for each file. Information about attributes of one specified journal can also be output.

You can extract required data from all the journals by specifying, in the jnledit command, the range of data in journal records or journal blocks. Journal records can be checked as hexadecimal numbers or as hexadecimal numbers and characters.

You can output unedited user journal records contained in an unloaded-journals file to the standard output.

The facilities provided by the jnledit command are referred to as the journal editing facilities.

For details about the journal editing facilities, see the manual OpenTP1 Operation.

(4) Outputting unloaded-journals file records

You can use the jnlrput command to output unloaded-journals file records. The records can be output to the standard output as they are without editing the user journal record information or CPU use time information of the transaction branch in the unloaded-journals file.

The information to be output can be selected by specifying the items such as the range, journal type, and journal collection mode.