OpenTP1 Version 7 Operation
jnledit (Edit and output unload journal files or global archive unload journal files)
Format
jnledit [-e edit-type] [-t[begin][,end]] [-j record-type[record-type..]] [-s server-name] [-v service-name] [-u transaction-global-identifier [, transaction-branch-identifier]] [-o journal-collection-mode [journal collection mode]...] [-m logical-terminal-name [, logical-terminal-name...] [-w characters] [-l lines] [-c] [file-name [file-name]...] |
Function
The jnledit command edits the information in the specified unload journal file or global archive unload journal file, and outputs it to the standard output.
Options
-e edit-type~<<f>>
Specifies the editing type:
-t [begin][,end]
Specifies the editing range in terms of the journal block output begin and end times. In "begin", specify the edit start time. In "end", specify the edit end time. When r is specified for the -e option, journal record output times must be specified; when b is specified, journal block output times must be specified.
For begin, specify a time between 00:00:00 on January 1, 1970 and the current year, month, day, and time.
The start time and end time cannot both be omitted. When the start time is omitted, the editing range is from the beginning of the file to the specified end time. When the end time is omitted, the editing range is from the specified start time to the end of the file.
The begin and end times are expressed in the format hhmmss[MMDD[YYYY]]:
If the -t option is omitted, all information in the specified file is edited and output.
-j record-type
Specifies the type of journal records to be edited.
Following are the specification values for the record types:
Record type | Specification | Description | Remarks |
---|---|---|---|
PJ | p | Transaction commit processing startup information | Synchronous point journal |
HJ | h | Transaction temporary synchronous point information | |
BJ | b | Transaction rollback information | |
TJ | t | Transaction synchronous point processing termination information | |
DJ | d | Heuristic decision information | |
FJ | f | DAM file update information | Recovery journal |
CJ | c | Update information for a table subject to recovery | |
XJ | x | System service-specific recovery information | |
SJ | s | System statistics | Statistical journal |
AJ | a | Send completion information | |
IJ | I | Messages cataloged into the input queue | |
OJ | o | Messages cataloged into the output queue | |
MJ | m | Message journal | |
GJ | g | Receive information | |
UJ | u | User-specific information | User journal |
When this option is omitted, all journal record types become subject to editing.
-s server-name~<1-8 alphanumeric characters>
Specifies the name of a server whose contents are to be edited.
When this option is omitted, all servers are subject to editing.
-v service-name~<1-31 alphanumeric characters>
Specifies the name of a service whose contents are to be edited.
When this option is omitted, all services become subject to editing.
-u transaction-global-identifier [, transaction-branch-identifier]~<33 alphanumeric characters, special character, and hexadecimal digits>
Specifies the transaction identifier of a transaction whose contents are to be edited. The transaction identifier must be specified in the format "transaction-global-identifier, transaction-branch-identifier".
When specification of a transaction identifier is omitted, all transaction identifiers become subject to editing.
-o journal-collection-mode
Specifies a journal collection mode. Multiple modes can be specified.
If this option is omitted, journals in all journal collection modes are edited and output.
-m logical-terminal-name~<1-16 alphanumeric characters>
Specifies the name of the logical terminal for which the information is to be edited and output. This option takes effect when the record type is a, g, i, m, or o.
When this option is omitted, edited data is output for all the logical terminals.
-w characters~<unsigned integer> ((80-132)) <<80>>
Specifies the number of characters per line.
-l lines~<unsigned integer> ((12-256)) <<24>>
Specifies the number of output lines per page.
-c
Specifies that editing is to be in both hexadecimal and character formats.
When this option is omitted, information is edited in hexadecimal format only.
Command arguments
unload-journal-file-name~<path name>
Specifies the name of an unload journal file or global archive unload journal file.
Multiple file names can be specified only when f is specified in the -e option. You can specify a maximum of 256 files.
When this command argument is omitted, the standard input is assumed.
Following are the valid and invalid combinations of options:
Output format
(1)-c option specified
(2) jnledit -e f 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 |
KFCA02640-I | Help message | Standard output, standard error output |
KFCA02641-E | A parameter in the jnledit command is invalid or its value exceeds the limit. | Standard error output |
KFCA02642-E | The combination of options in the jnledit command is invalid. | Standard error output |
KFCA02643-E | An option in the jnledit command is specified incorrectly. | Standard error output |
KFCA02644-E | A file name in the jnledit command is specified incorrectly. | Standard error output |
Notes
Examples
In this example, the command outputs information from the beginning of an unload journal file up to 17:30:00.999999 on May 29, 1993 in hexadecimal and character formats in units of records:
Unload journal file: sysjnl001
jnledit -e r -t ,17300005291993 -c /OpenTP1/jnl/sysjnl001 |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.