OpenTP1 Version 7 Operation
rtsedit (Edit and output RTS log files)
Format
rtsedit {[-m]|[-e item-ID[,item-ID]...[-q]] [-t[start-time][,end-time]] [-u editing-unit[-s server-name][-v service-name]] [-i editing-interval] [-o output-destination-file-name[-l number-of-lines]]} RTS-log-file-name[[RTS-log-file-name]...] |
Function
The rtsedit command gets real-time statistics from an RTS log file, edits the statistics, and outputs the result to a file or the standard output in CSV format.
Options
-m
Outputs management information about the RTS log file specified in the command argument to the standard output.
When you specify the -m option, you cannot specify other options.
-e item-ID~<unsigned integer> ((1000-2147483647))
Specifies the ID of the item to be edited.
For details about item IDs, see E.5 Real-time statistics.
-q
Outputs hyphens (-) for the number of items, maximum value, minimum value, and average in a time slot that has no real-time statistics for the item ID specified in the -e option.
This option is valid only when the -e option is specified.
If you do not specify this option, no hyphens (-) are output for the time slots that have no real-time statistics.
-t [start-time][,end-time]
Specifies the period for which data is to be edited. For start-time, specify the time at which editing of the target real-time statistics is to start. For end-time, specify the time at which editing of the target real-time statistics is to end.
For start-time, you can specify a time from 00:00:00 on January 1, 1970, to the current time of the current year, month, and day.
You must specify either a start time or an end time, or both. If you omit the start time, the command outputs real-time statistics from the start of the RTS log file until the specified end time. If you omit the end time, the command outputs real-time statistics from the specified start time until the end of the RTS log file.
Specify the start time and the end time in the hhmmss ([MMDD[YYYY]]) format.
If you omit the -t option, all the information in the specified file is edited and output.
-u editing-unit~<all>
Specifies the unit of editing.
-s server-name~<string of 1-8 characters>
Specifies the name of the server, port number, logical terminal, or first acquisition target whose real-time statistics you wish to edit.
The specification of the -s option is valid when svc is specified in the -u option.
-v service-name~<string of 1-63 characters>
Specifies the name of the service, port number, logical terminal, or second acquisition target whose real-time statistics you wish to edit.
The specification of the -v option is valid when svc is specified in the -u option.
The following table shows the combinations of the -u, -s, and -v options, and the statistics edited as a result.
Table 13-7 Combinations of rtsedit command options and the statistics to be edited
Specification of -u option | Specification of -s option | Specification of -v option | Real-time statistics to be edited |
---|---|---|---|
sys | -- | -- | System-wide statistics |
service | Server name | Service name | Statistics for the specified server and service |
Not specified | Statistics for the specified server | ||
Port number# | IP address# | Statistics for the node for which the specified service information is referenced | |
Logical terminal name# | Not specified# | Statistics for the specified logical terminal | |
Not specified | Service name | Statistics for the specified service | |
Service group name# | Statistics for the specified service group | ||
Not specified | All non-system-wide statistics | ||
all | -- | -- | All statistics |
-i editing-interval~<unsigned integer> ((10-31536000))
Specifies in seconds the interval for editing statistics and outputting them to a CSV file.
If you do not specify the -i option, the system assumes the output interval specified when real-time statistics are acquired in an RTS log file (value specified in the rts_trcput_interval operand in the real-time statistics service definition) as the value of the -i option.
If you do not specify the -i option and specify multiple RTS log files in the command argument, the system assumes the value of the -i option to be the largest interval among those for outputting real-time statistics to an RTS log file.
The following table lists example valid intervals for outputting edited real-time statistics to a CSV file.
Table 13-8 Examples of valid intervals for outputting edited real-time statistics to a CSV file
Example | Interval for outputting real-time statistics to an RTS log file (seconds) | Value specified for -i option | Valid interval for outputting edited real-time statistics to CSV file (seconds) | ||
---|---|---|---|---|---|
RTS log file 1 | RTS log file 2 | RTS log file 3 | |||
1 | 600 | 300 | 200 | 1000 | 1000 |
2 | 600 | 300 | 200 | 100 | 100 |
3 | 100 | 200 | 300 | Not specified | 300 |
To check the interval for outputting real-time statistics to an RTS log file, execute the rtsedit command with the -m option specified.
-o output-destination-file-name~<path name of 1-65 characters>
Specifies the name of a file in CSV format to which the edited real-time statistics are to be output.
If you do not specify this option, the command outputs the edited real-time statistics to the standard output.
-l number-of-lines~<unsigned integer> ((1024-65535))
Specifies the number of lines to be output to one file (file in CSV format specified in the -o option).
The range for generation numbers of CSV-format files is from 1 to 999999. When all the lines specified in the -l option have been output, the generation number for a CSV-format file is incremented by one, and output continues. When real-time statistics are output to a file with generation number 999999, the command ends the output processing.
The specification of the -l option is valid only when the -o option is specified.
If you do not specify the -l option, the command does not update the generation numbers of CSV-format files and outputs all of the data to one file.
Command argument
RTS-log-file-name~<path name of 1-65 characters>
Specifies the name of a RTS log file.
Output format
(1) When the -m option is specified (standard output)
(2) When the -m option is not specified (CSV format)
Output messages
Message ID | Description | Output destination |
---|---|---|
KFCA32714-E | Processing cannot continue due to insufficient process memory. | Standard error output |
KFCA32719-E | The command was used incorrectly. | Standard error output |
KFCA32720-E | The value specified in a command option is invalid. | Standard error output |
KFCA32721-E | The value specified in a command argument is invalid. | Standard error output |
KFCA32725-E | An error occurred during file operations. | Standard error output |
KFCA32726-E | The specified file already exists. | Standard error output |
KFCA32727-E | The specified file is not an RTS log file. | Standard error output |
KFCA32728-E | The combination of version and revision of the RTS log file is incorrect. | Standard error output |
KFCA32729-E | The command terminated because all the generations of output files were used. | Standard error output |
KFCA32730-E | Invalid data was detected while an RTS log file was being accessed. | Standard error output |
KFCA32731-E | The specified file does not exist. | Standard error output |
KFCA32735-I | Help message | Standard output |
KFCA32744-E | The user is not authorized to access the file. | Standard error output |
KFCA32745-E | The specified file name is incorrect. | Standard error output |
KFCA32759-E | Editing is not possible because the contents of the RTS log file already exist. | Standard error output |
Notes
Figure 13-1 Relationship between RTS log files and specified options
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.