jnlstts (Output uptime statistics)

-e edit-item~<<all>>

Specifies the item to be edited:

sys: Output system statistics

trn: Output transaction statistics

rsp: Output statistics about response

dly: Output statistics about communication delay

all: Both of the above

-u edit-unit~<<srv>>

Specifies the unit of editing:

srv: Edit in units of server names.; If srv is specified, it is assumed that a server name has been specified in the -s option.

svc: Edit in units of service names.; If svc is specified, it is assumed that a service name has been specified in the -s option.

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:

h[HH]: Output at an interval of the specified number of hours (01 HH 24) (when specification of HH is omitted, the output interval is one hour).

m[MM]: Output at an interval of the specified number of minutes (01 MM 09) or tens of minutes (10 MM 30) (when specification of MM is omitted, the output interval is 10 minutes).

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 [Figure] hh 23); cannot be omitted

mm: Minute (00 [Figure] mm 59); cannot be omitted

ss: Second (00 [Figure] ss 59): cannot be omitted

MM: Month (01 [Figure] MM 12); can be omitted^#

DD: Day (01 [Figure] DD 31); can be omitted^#

YYYY: Year (4-digit year from 1970); can be omitted^#

#: If the year is omitted from the begin or end time, the specified month, day, and time of the current year are assumed. If the year, month, and day are omitted, the current year, month, and day, and the specified time are assumed. You cannot omit only the month and day, or the month or the day. Doing so causes an option error. If you want to omit the month or the day, then omit the year, the month, and the day (all three).

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
sys	--	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.

--: Cannot be specified: Following are the combinations of options that can be specified by the jnlstts command:

#1: If svc is specified in the -u option, it is assumed that a service name has been specified in the -s option.

#2: If srv is specified in the -u option, it is assumed that a server name has been specified in the -s option.

(1) System statistics

The output format is as follows:

[Figure]

The output format is as follows when the -c option is specified (CSV format):

[Figure]

1: Statistics about each collected component are edited and displayed for each specified server name.

2 through 8: Displayed on a single line each.

aa...aa: File name

bb...bb: File creation date and time

cc...cc: Start time specified with the -t option (when the -t option is omitted, * is displayed)

dd...dd: End time specified with the -t option (when the -t option is omitted, * is displayed)

ee...ee: Node identifier

ffffffff: Server name; When displayed, SYSTEM means the entire system statistics.

gg...gg: Edit start time for system statistics

hh...hh: Edit end time for system statistics

xx...xx: Statistics (decimal number of 10 digits or less. If the number of events or the average value overflows, * is displayed. If there is no edited data for the maximum value, the minimum value, or the average value, - is displayed.)

vv-rr: Version number-revision number

yyyy: Page

(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:

[Figure]

#1: When svc is specified in the -u option, a service name is output.

#2: When svc is specified in the -u option, a user server name is output.

The output format is as follows when the -c option is specified (CSV format):

[Figure]

1: This information is displayed for each service name.; When svc is specified in the-u option, this information is repeatedly displayed for each server name.

2 through 17: Displayed on a single line each.

aa...aa: File name

bb...bb: File creation date and time

cc...cc: start time specified with the -t option (when the -t option is omitted, * is displayed)

dd...dd: End time specified with the -t option (when the -t option is omitted, * is displayed)

ee...ee: Node identifier

ffffffff: User server name; When svc is specified in the -u option, a service name is output.

gg...gg: Edit start time for transaction statistics

hh...hh: Edit end time for transaction statistics

iiiiiiii: Service name (if there is no service name, * is displayed); When svc is specified in the -u option, a user server name is output.

xx...xx: Statistics (displayed by counting fractions of .5 and over of the average as a unit and disregarding the rest. If the maximum, minimum, or average overflows, * is set.)

vv-rr: Version number-revision number

yyyy: Page

(3) Statistics about response

The output format is as follows:

[Figure]

The output format is as follows when the -c option is specified (CSV format):

[Figure]

#: The service execution time and the service wait time of the MHP are not acquired.

1: This information is displayed for each service name.

2 through 6: Displayed on a single line each.

aa...aa: File name

bb...bb: File creation date and time

cc...cc: Start time specified with the -t option (when the -t option is omitted, * is displayed)

dd...dd: End time specified with the -t option (when the -t option is omitted, * is displayed)

ee...ee: Node identifier

ff...ff: Service group name

gg...gg: Edit start time for statistics about response

hh...hh: Edit end time for statistics about response

ii...ii: Service name

xx...xx: Statistics (decimal number of 10 digits or less. The average is determined by counting fractions of .5 and over as a unit and disregarding fractions under. If the maximum, minimum, or average overflows, * is set. If there is no edited data, - is set.)

vv-rr: Version number-revision number

yyyy: Page

(4) Statistics about communication delay

The output format is as follows:

[Figure]

The output format is as follows when the -c option is specified (CSV format):

[Figure]

1: This information is displayed for each send destination node identifier.

2 through 4: Displayed on a single line each.

aa...aa: File name

bb...bb: File creation date and time

cc...cc: Start time specified with the -t option (when the -t option is omitted, * is displayed)

dd...dd: End time specified with the -t option (when the -t option is omitted, * is displayed)

ee...ee: Node identifier

ff...ff: Send destination node identifier

gg...gg: Edit start time for statistics about communication delay

hh...hh: Edit end time for statistics about communication delay

xx...xx: Statistics (decimal number of 10 digits or less. The average is determined by counting fractions of .5 and over as a unit and disregarding fractions under. If the maximum, minimum, or average overflows, * is set.)

vv-rr: Version number-revision number

yyyy: Page

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

If the output range of uptime statistics is specified and no journal record corresponds to the specified begin or end time, the journal records between the begin and end positions are to be output.
If the uptime statistics output range is specified in terms of time and the start time value is greater than the end time value, the month and day or the month, day, and year must be specified so that the end time is after the start time. If the requisite information is omitted, an error occurs. If the date is omitted, the date the jnlstts command is entered is assumed; therefore, if the editing range does not fit within the current day, either the month and day or the month, day, and year must be specified.

The time at which editing and output of uptime statistics begins depends on whether or not a start time is specified with the -t option. If a start time is specified with the -t option, output begins within the time frame that begins at the specified start time. If no start time is specified, output begins within the time frame that begins when the first SJ record for a subject file is created. A time frame is a span of time obtained by dividing the time into intervals of the interval length specified with the -i option on the basis of the start time (hh: 00).
The following shows the relationships between the specifications of the -t and -i options of the jnlstts command and the time at which uptime statistics (SJ) are output to the unload journal file:

	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.

If an end time for uptime statistics output is specified, information is output up to the time frame that includes the specified end time. For example, if 09:00:00 is specified as the end time with the -t option and 30 minutes is specified as the interval with the -i option, the final time frame is 9:00-9:30, but the uptime statistics at 09:00:00 are actually output.
In the system statistics, the first decimal place is rounded down for the edited average value.
In the transaction statistics, the first decimal place is rounded off for the edited average value.
Even if an overflow occurs in the number of events or the average value and * is displayed, the maximum and minimum values are guaranteed.
If there is no data in a specified collection and editing time frame, "No applicable data" is displayed for that time frame.
When no file name is specified, the standard input is assumed. Therefore, the input file must be specified by piping, redirecting, etc.
In the response statistics, if statistics about response time collection failure are only collected, zeros are output for all data.
For the -t option, if you specify a value beyond 2038 as the year of the output end time, in some cases CPU load and memory usage may increase to the extent that it takes some time for the command to terminate.
If, for example, the user clock is reset backward by the OS's time synchronization function, and the data for the acquired edit time period shows negative values, '*' is output for the maximum value, the minimum value, and the average value for the time period.
The memory requirements for the jnlstts command vary depending on the operation statistics items to be edited, the output range, and the time interval. Use the following formulas to estimate the memory requirements (in bytes):

Legend:

: Decimal values are truncated.

A: Server count. Service count when svc is specified for the -u option.

B: Service group count

#1

Value specified in the jnl_max_datasize operand of the system journal service definition.

#2

Value obtained by dividing the time period from the edit start time to the edit termination time, specified by -t, by the time interval specified by the -i option. Time periods containing no data are not counted.

#3

Service count when svc is specified for the -u option.

#4

Server count of each service when svc is specified for the -u option.