jnlmcst (Output MCF uptime statistics)

-e edit-type~<<all>>

Specifies the type of editing.

let: Edits and outputs MCF uptime statistics on a logical terminal name basis.

uap: Edits and outputs MCF uptime statistics on an application name basis.

all: Edits and outputs all MCF uptime statistics.

-l line~((12-256))<<24>>

Specifies the number of output lines per page.

-i time-interval

Specifies the time interval (in hours or minutes) at which MCF uptime statistics are edited and output.

h[HH]: Information is output at intervals of hours (01HH24). If this option is omitted, information is output at intervals of one hour.

m[MM]: Information is output at intervals of one minute (01MM09) or 10 minutes (10MM30). If this option is omitted, information is output at intervals of 10 minutes.

If both the hour-based and minute-based intervals are specified, an error occurs. If the -i option is omitted, information is output at intervals of one hour.

-t [begin][,end]

Specifies the output range of MCF 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 (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).

If the -t option is omitted, all information in the specified file is edited and output.

-m logical-terminal-name~<1-10 alphanumeric characters>

Specifies the name of a logical terminal subject to editing. If this option is omitted, all logical terminals are subject to editing. The option is applicable only when let is specified in the -e option.

-a application-name~<1-10 alphanumeric characters>

Specifies the name of an application subject to editing. If this option is omitted, all applications are subject to editing. The option is applicable only when uap is specified in the -e option.

-o journal-collection-mode

Specifies a journal collection mode. Multiple modes can be specified.

c: Outputs MCF uptime statistics in transaction test mode whose attribute is commit or in MCF nontransaction test mode.

r: Outputs MCF uptime statistics in transaction test mode whose attribute is rollback.

s: Outputs MCF uptime statistics in other than online test mode.

If this option is omitted, MCF uptime statistics in all journal collection modes are output.

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

[Figure]

jnlmcst -e let specified

[Figure]

#: If uap is specified in the -e option, application names are displayed. If all is specified, all MCF information is displayed.

aa...aa: Name of the specified file

bb...bb: File creation date and time

cc...cc: Start time specified in the -t option ('*' is output if this option is omitted)

dd...dd: End time specified in the -t option ('*' is output if this option is omitted)

ee...ee: output interval specified in the -i option ('1 hour' is output if this option is omitted); The output time interval and unit are displayed as follows:; 1-hour interval => 1 hour; 1-minute interval => 1 minute

ff...ff: Node identifier

gg...gg: Logical terminal name

xx...xx: Statistics (1-10 decimal digits); If the minimum, maximum, average or total overflows, '*' is output.; The average is rounded to the nearest whole number. '-' is output as the total size of receive messages.

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
KFCA02670-I	Help message	Standard output, standard error output
KFCA02671-E	A parameter in the jnlmcst command is invalid or its value exceeds the limit.	Standard error output
KFCA02672-E	The combination of options in the jnlmcst command is invalid.	Standard error output
KFCA02673-E	An option in the jnlmcst command is specified incorrectly.	Standard error output
KFCA02674-E	A file name in the jnlmcst command is specified incorrectly.	Standard error output

If the output range of MCF 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 edited.
If no journal record corresponds to the jnlmcst command, processing terminates.
If the output range of MCF uptime statistics 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 jnlmcst command is entered is assumed; therefore, if the output range does not fit within the current day, either the month and day or the month, day, and year must be specified.
The editing and output start time for MCF uptime statistics depends on whether or not the start time is specified in the -t option. If the start time is specified, information is output from the time zone in which the specified start time is included. If the start time is not specified, information is output from the time zone including the IJ, GJ, OJ, and AJ record time at the beginning of the applicable file. The term "time zone" means the time interval divided by the value specified in the -i option on the basis of the start time (hh: 00).
If the output end time for MCF uptime statistics is specified, information is output until the time zone including the specified end time.
When output, the edited average is rounded to one decimal place.
'-' is output as the total size of receive messages.
If the minimum, maximum, average or total overflows, '*' is output.
If no file name is specified, the standard input is assumed. Therefore, the input file must be specified by piping, redirecting, etc.
When the -t option is specified and there are many portions matching the specified range in the specified file, all of them are displayed.
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.