OpenTP1 Version 7 Operation

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

jnlsort (Sort and merge unload journal files or global archive unload journal files chronologically)

Format

jnlsort [-n node-identifier][-g]
        [-i [begin-journal-server-run-ID]]
                                [, end-journal-server-run-ID]]
        [file-name [file-name] ...]

Function

The jnlsort command sorts and merges the contents, block to block, of the specified unload journal file or global archive unload journal file chronologically. The result of processing is output to the standard output in the form of a global archive unload journal file.

Options

-n node-identifier~<4 alphanumeric characters and symbols)

Sorts and merges only the journal blocks having the specified node identifier.

The node identifier must begin with an alphabetic character, followed by alphanumeric characters. If this option is omitted, the file is not sorted and merged on a node identifier basis.

-g

Specify this option only to merge journal blocks, not to sort them.

When multiple unload journal files and global archive unload journal files are specified, the files are merged in ascending order of run ID (generation number if the files are executed during the same online operation). Note that journal blocks are not sorted. When you specify this option, work files are not created.

-i [begin-journal-server-run-ID][, end-journal-server-run-ID] ~<1-8 hexadecimal digits>((0-ffffffff))

Sorts and merges only the journal blocks having the specified journal server run ID.

If the -i option is specified, either a begin or end journal server run ID must be specified. If both are specified, the begin journal server run ID must be equal to or smaller than the end journal server run ID.

If the begin journal server run ID is omitted, the journal blocks ranging from 0 to the specified end journal server run ID are sorted and merged.

If the end journal server run ID is omitted, the journal blocks ranging from the specified begin journal server run ID to ffffffff are sorted and merged.

When this option is omitted, journal blocks are not sorted and merged on a journal server run ID basis.

Command arguments

file-name~<path name>

Specifies the name of an unload journal file and a global archive unload journal file. You can specify a maximum of 256 files.

When this command argument is omitted, the standard input is input. Specify this command argument when the -n option is omitted.

The combinations of options and command arguments that can be specified are shown below:

Option -n -g -i Unload journal file Global archive unload journal file
-n
--
Y Y Y Y
-g Y
--
Y Y Y
-i Y Y
--
Y Y
Unload journal file Y Y Y
--
Y
Global archive unload journal file Y Y Y Y
--

Y: Can be specified

Output messages

Message ID Description Output destination
KFCA02600-E An error occurred while the unload journal file was being accessed. Standard error output
KFCA02601-E The unload journal file is invalid. Standard error output
KFCA02602-E The journal block is invalid. Standard error output
KFCA02603-E The journal record is invalid. Standard error output
KFCA02604-E Memory cannot be allocated. Standard error output
KFCA02690-I Help message Standard output, standard error output
KFCA02691-E A parameter in the jnlsort command is invalid or its value exceeds the limit. Standard error output
KFCA02692-E The combination of options in the jnlsort command is invalid. Standard error output
KFCA02693-E An option in the jnlsort command is specified incorrectly. Standard error output
KFCA02694-E A file name in the jnlsort command is specified incorrectly. Standard error output
KFCA02695-E An access error occurred in the work file to be used by the jnlsort command. Standard error output
KFCA02696-E The target block for the jnlsort command does not exist. Standard error output

Notes