OpenTP1 Version 7 Operation
jnlstts (Output uptime statistics)
Format
jnlstts [-e edit-item] [-u edit-unit] [-l lines] [-c] [-i interval] [-t [begin][,end]] [{-s server-name|-s service-name}] [file-name] |
Function
The jnlstts command collects statistics from a specified unload journal file or global archive unload journal file. This command edits the statistics and outputs it to the standard output.
The following information is output:
Options
-e edit-item~<<all>>
Specifies the item to be edited:
-u edit-unit~<<srv>>
Specifies the unit of editing:
This option is applicable only when trn or all is specified for the -e option.
-l lines~<unsigned integer>((12~256))<<24>>
Specifies the number of output lines per page.
-c
Displays the edited results of uptime statistics, in CSV format.
-i interval
Specifies in hours or minutes the interval at which uptime statistics are to be edited and output:
If intervals in both hours and minutes are specified, an error occurs.
When the -i option is omitted, the output interval is one hour.
-t [begin][,end]
Specifies the uptime statistics output range in terms of the journal block 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 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 file.
The begin and end times are expressed in the format hhmmss[MMDD[YYYY]]:
hh: Hour (00 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#
When the -t option is omitted, all information in the specified file is edited and output.
-s server-name~<1-8 alphanumeric characters>
Specifies the name of a server that is to be subject to editing.
If sys is specified in the -e option and no server name is specified, the statistics for all servers are output. If srv is specified in the -u option, it is assumed that a server name has been specified in the -s option. If sys is specified in the -e option and SYSTEM as the server name, the statistics for the entire system are output.
-s service-name~<1-31 alphanumeric characters>
Specifies the name of the service whose statistics are to be edited and output. If trn is specified in the -e option, svc in the -u option and no service name is specified, the statistics for all services are output. If svc is specified in the -u option, it is assumed that a service name has been specified in the -s option.
Following are the combinations of the -e, -u, and -s options:
-e option | -u option | -s option | Output information | Remarks |
---|---|---|---|---|
sys | -- | Server name | System statistics for specified server | None |
SYSTEM | Statistics for entire system | |||
trn | srv | Server name | Transaction statistics for specified server | |
svc | Service name | Transaction statistics for specified service | ||
Omitted | Server name | Transaction statistics for specified server | ||
rsp | -- | Service name | Statistics about response for specified service | |
dly | -- | -- | All statistics about communication delay | |
all | srv | Server name | All statistics for specified server | All data will be output for statistics about response or communication delay. |
svc | Service name | All statistics for specified service | All data will be output for statistics about the system or communication delay. | |
Omitted | Server name | All statistics for specified server | All data will be output for statistics about response or communication delay. |
Command arguments
file-name~<path name>
Specifies the name of an unload journal file or global archive unload journal file.
When the multinode facility is used, the name of the file sorted and merged by the jnlsort command must be specified.
When this command argument is omitted, the standard input is assumed.
Output format
(1) System statistics
The output format is as follows:
The output format is as follows when the -c option is specified (CSV format):
(2) Transaction statistics (editing in units of service names)
When srv is specified in the -u option or the -u option is omitted, statistics are edited in units of server names. When svc is specified in the -u option, statistics are edited in units of service names.
The output format is as follows:
The output format is as follows when the -c option is specified (CSV format):
(3) Statistics about response
The output format is as follows:
The output format is as follows when the -c option is specified (CSV format):
(4) Statistics about communication delay
The output format is as follows:
The output format is as follows when the -c option is specified (CSV format):
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 |
KFCA02660-I | Help message | Standard output, standard error output |
KFCA02661-E | A parameter in the jnlstts command is invalid or its value exceeds the limit. | Standard error output |
KFCA02662-E | The combination of options in the jnlstts command is invalid. | Standard error output |
KFCA02663-E | An option in the jnlstts command is specified incorrectly. | Standard error output |
KFCA02664-E | A file name in the jnlstts command is specified incorrectly. | Standard error output |
KFCA02665-E | Statistics cannot be output because the value specified for the -l option in the jnlstts command is too small. | Standard error output |
Notes
Start time specified with -t option | Time of SJ output to unload journal file | Interval specified with -i option | Output start time frame | Remarks | |
---|---|---|---|---|---|
Example 1 | 09:00:00 | 09:10:00 | 10 minutes | 9:00-9:10 | The time frame corresponding to 9:00-9:10 is from 09:00:00 to 09:09:59, but no SJ is included in this time frame; therefore, SJ will be output in the next time frame. |
Example 2 | 09:00:00 | 08:50:00 | 7 minutes | 9:00-9:07 | SJ was output before the start time specified with the -t option; the SJ is therefore not subject to output and no SJ can be output by executing the jnlstts command. |
Example 3 | Not specified | 09:05:34 | 4 minutes | 9:04-9:08 | SJ from 09:04:00 to 09:07:59 is output. |
Example 4 | Not specified | 09:37:00 | 30 minutes | 9:30-10:00 | SJ from 09:30:00 to 09:59:59 is output. |
Example 5 | 09:29:59 | 09:30:00 | 30 minutes | 9:00-9:30 | The time frame corresponding to 9:00-9:30 is from 09:00:00 to 09:29:59, but no SJ is included in this time frame; therefore, SJ will be output in the next time frame. |
Examples
In this example, the command edits system statistics from the beginning of an unload journal file up to 17:30:00.999999 on May 29, 1993, and outputs them every 30 minutes:
Unload journal file: sysjnl001
jnlstts -e sys -i m30 -t ,17300005291993 /OpenTP1/jnl/sysjnl001 |
In this example, the last time period is from 17:30 to 18:00. However, system statistics from 17:30:00.0 on May 29, 1993 up to 17:30:00.999999 on May 29, 1993 are output.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.