OpenTP1 Version 7 Operation
jnlmcst (Output MCF uptime statistics)
Format
jnlmcst [-e edit-type] [-l line] [-i time-interval] [-t [begin] [, end] [-m logical-terminal-name] [-a application-name] [-o journal-collection-mode [journal-collection-mode] ...] [file-name] |
Function
The jnlmcst command collects MCF uptime statistics from specified unload journal files or global archive journal files, then edits and outputs it to the standard output. The information to be output includes MCF uptime statistics with respect to receiving and sending messages.
Options
-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.
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 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#
#: 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.
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:
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. If this command argument is omitted, standard input is assumed.
Output format
jnlmcst -e let 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 |
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 |
Notes
Examples
In this example, the command edits the MCF uptime statistics from 17:30:00.0 on May 29, 2003 to the end of an unload journal file, and outputs them:
Unload journal file: sysjnl001
jnlmcst -e all -t 17300005292003 /tp1/jnl/sysjnl001 |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.