OpenTP1 Version 7 Operation
jnlrput (Output records of unload journal files or global archive unload journal files)
Format
jnlrput [-t [start-time] [, end-time] [-e] [-f] [-l] [-c key] [-u transaction-global-identifier [,transaction-branch-identifier]] [-o journal-collection-mode [journal-collection-mode] ...] [-j journal-type [journal-type] ...] [-q _trn] [-q _rpc] [-d user's-extraction-condition(s)] [-x] [file-name (file-name] ...] |
Function
The jnlrput command outputs to the standard output user journal record information within the specified unload journal file or global archive unload journal file, CPU usage time information for a transaction branch, and statistics about response.
Options
-t [start-time][,end-time]
Specifies the output range of uptime statistics in terms of journal output begin and end times.
In "begin", specify the output start time. In "end", specify the output end time.
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 output range is from the beginning of the unload journal file to the specified end time. When the end time is omitted, the output range is from the specified start time to the end of the unload journal file.
The begin and end times are expressed in the format hhmmss[MMDD[YYYY]]:
hh: Hour (01 hh 23); cannot be omitted
mm: Minute (00 mm 59); cannot be omitted
ss: Second (00 ss 59); cannot be omitted
MM: Month (01 MM 12); can be omitted#
DD: Day (01 DD 31); can be omitted#
YYYY: Year (4-digit year from 1970); can be omitted#
-e
Outputs only commit-determined user journal records (UJ).
When this option is not specified, all user journal records (UJ) are output.
-f
Outputs commit-determined user journal records from the first file. Also, checks whether the journal file's block numbers are sequential ones in ascending order, beginning with 1. If an error is found, processing terminates.
The -f option is valid only when the -e option is specified.
If this option is not specified, system assumes inheritance from the previous record output process, checking whether the block numbers are sequential ones in ascending order, beginning with the last block number + 1. If an error is found, processing terminates.
-l
Outputs commit-determined user journal records from the last file. Then the inheritance file is deleted.
The -l option is valid only when the -e option is specified.
If this option is not specified, system assumes inheritance to the next record output process, creating an inheritance file.
-c key~((001-999))<<001>>
Specifies part of the name of an inheritance file. Actually, OpenTP1 creates a file named jnlrput*** (*** = the value specified in this option), which in turn becomes the name of the inheritance file.
-u transaction-global-identifier [,transaction-branch-identifier~<33 alphanumeric characters, special characters, and hexadecimal digits>
Specifies the contents to be edited by specifying the transaction identifier. The transaction identifier must be in "transaction-global-identifier, transaction-branch-identifier." If this option is omitted, all transaction IDs are 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 output.
-j~<<u>>
Specifies the record type that identifies the contents to be output. Following are the values to be specified as record type and the contents to be output.
Record type | Value to be specified | Contents | Remarks |
---|---|---|---|
SJ | s | System statistics# | Statistical journal |
AJ | a | Send completion information | |
IJ | I | Input queue registration information | |
OJ | o | Messages in the output queue | |
MJ | m | Message journal | |
GJ | g | Receive information | |
UJ | u | User's own information | User journal |
-q _trn
Outputs the information about the CPU usage time by a transaction branch within the specified file.
Specification of this option is valid only with "s" (system statistics) specified in the -j option.
-q _rpc
Outputs the response statistics within the specified file.
Specification of this option is valid only with "s" (system statistics) is specified in the -j option.
-d user's-extraction-conditions
Specifies the conditions of extracting the user journal records (UJ). When this option is specified, the journal records are compared to the comparison data and the journal records that satisfy the conditions specified with comparison symbols. The number of characters in the specified extraction conditions must not exceed 255.
The following shows the description format of extraction conditions:
comparison-position,[comparison-symbol],[comparison-format],comparison-data [,comparison-position,[comparison-symbol],[comparison- format],comparison-data] |
Up to two extraction conditions can be specified.
When more than one extraction condition is specified, the journal records that satisfy all the conditions are extracted.
comparison-position~<hexadecimal>((0 to 7faf8))
Specifies the position of the comparison data to be compared to the user journal records. Specify the position from the beginning of the UAP journal. For UJ code, specify "CODE".
comparison-symbol~<<eq>>
Specifies a comparison symbol as the comparison condition for the data to be compared to the user journal records.
comparison-format~<<x>>
Specifies the format of the data to be compared. The user journal records are compared to the comparison data, based on the format specified by the comparison format.
comparison-data
Specifies the data to be compared. When specifying the comparison data in hexadecimal format, specify the data with 0 to 9 and a to f (or A to F) in even number of digits.
When specifying the UJ code, use a 2-, 4-, 6-, or 8-digit hexadecimal number.
A comma (,), space, and metacharacters of the shell cannot be specified.
-x
Outputs only the user journal records (UJ) that are out of the scope transaction.
If you omit the -x option, all the user journal records (UJ) are output.
Command arguments
file-name~<path name>
Specifies the name of an unload journal file or global archive unload journal file. If the multinode facility is used, the name of the file sorted and merged by the jnlsort command must be specified.
The -e option allows more than one file to be specified. When more than one is specified, a space must be placed between files. You can specify a maximum of 256 files.
If this command argument is omitted, standard input is assumed.
The following shows the possible combinations of command arguments and options that can be specified:
Output format
(1) Output format of all the journal records when UJ is output
(2) Detailed output format of each information item
The output format of 1. to 12., is defined by dcjup.h.
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 |
KFCA02605-E | An error occurred while the inheritance file was being accessed. | Standard error output |
KFCA02606-E | The inheritance file is invalid. | Standard error output |
KFCA02607-E | The relationship between the inheritance file and the unload journal file is invalid. | Standard error output |
KFCA02622-W | The target record to be output does not exist. | Standard error output |
KFCA02680-I | Help message | Standard output, standard error output |
KFCA02681-E | A parameter in the jnlrput command is invalid or its value exceeds the limit. | Standard error output |
KFCA02682-E | The combination of options in the jnlrput command is invalid. | Standard error output |
KFCA02683-E | An option in the jnlrput command is specified incorrectly. | Standard error output |
KFCA02684-E | A file name in the jnlrput command is specified incorrectly. | Standard error output |
KFCA02685-E | The record to be extracted that is specified in the jnlrput command is invalid. | Standard error output |
Notes
Examples
jnlrput -j s -q_trn/tpl/jnl/sysjnl001 |
jnlrput -e -f -l /tpl/jnl/sysjnl001 /tpl/jnl/sysjnl002 /tpl/jnl/sysjnl003 |
<First> jnlrput -e -f /tpl/jnl/sysjnl001 /tpl/jnl/sysjnl002 <Second> jnlrput -e /tpl/jnl/sysjnl003 <Third> jnlrput -e -l /tpl/jnl/sysjnl004 |
jnlrput -t 00000001012003,23595912312003 -j s /tp1/jnl/sysjnl001 |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.