The dcreport command edits the system statistics collected into shared memory, and outputs them to the standard output in real time.

This command is available when set statistics=Y is specified in the system common definition. If you use the dcstats command to output system statistics to a journal file, the dcreport command can output the system statistics to the standard output regardless of the specification in the system common definition.

For the IDs of statistics to be output, see the ID for edition by dcreport columns in Table E-1 and Table E-2.

-l

Outputs system statistics to the standard output and the message log.

-n

Suppresses the output of system statistics to the standard output.

-c

Outputs system statistics to the standard output in CSV format.

If you specify both -l and -c simultaneously, system statistics are output to the message log using the normal format.

-r

Outputs system statistics and resets the accumulated values.

[start-ID[end-ID]] ~<unsigned integer>((1-213))

Specify the range of IDs of the statistics to be output. For details about the IDs used for statistics, see the ID for edition by dcreport columns in Table E-1 and Table E-2.

When you specify only a start ID, the command outputs all the system statistics after the start ID.

When you specify a start ID and an end ID, the command outputs the system statistics from the start ID up to the end ID.

If you omit this option, the command outputs all the system statistics.

When you specify both a start ID and an end ID, make sure that the end ID is equal to or greater than the start ID.

(1) Standard output

----------------------------------------------------
id     count       average     max         min
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
aaa   bbbbbbbbbb   cccccccccc   dddddddddd   eeeeeeeeee

aaa

ID of the statistics (decimal number of 3 digits)

bbbbbbbbbb

Count (decimal number of 10 digits)

cccccccccc

Average (decimal number of 10 digits)

dddddddddd

Maximum (decimal number of 10 digits)

eeeeeeeeee

Minimum (decimal number of 10 digits)

When all the output options (count, average, maximum, and minimum) are not acquired for a desired item, 0000000000 is output for the count and ---------- is output for the average, max, and min.

If only the count is acquired for an item, ---------- is output for the average, max, and min.

If an overflow occurs since the count or other acquired values are accumulated excessively, ********** is output for the count and average. In this case, the max and min are output.

(2)-c option specified (output format for the standard output (CSV format))

aaa,bb...bb,cc...cc,dd...dd,ee...ee

aaa

ID of the statistics (decimal number of up to 3 digits)

bb...bb

Count (decimal number of up to 10 digits)

cc...cc

Average (decimal number of up to 10 digits)

dd...dd

Maximum (decimal number of up to 10 digits)

ee...ee

Minimum (decimal number of up to 10 digits)

When all the output options (count, average, maximum, and minimum) are acquired for a desired item, 0 is output for the count and - is output for the average, max, and min.

When only the count is acquired for an item, - is output for the average, max, and min.

If an overflow occurs since the count or other acquired values are accumulated excessively, * is output for the count and average. In this case, max and min are output.

(3)-l option specified (output format for the log file)

KFCA01890-I statistics:ID=aaa, number of events=bb...bb, average=cc...cc, max=dd...dd, min=ee...ee

aaa

ID of the statistics (decimal number of up to 3 digits)

bb...bb

Number of events (decimal number of up to 10 digits)

cc...cc

Average (decimal number of up to 10 digits)

dd...dd

Maximum (decimal number of up to 10 digits)

ee...ee

Minimum (decimal number of up to 10 digits)

When all the output options (number of events, average, maximum, minimum) are not acquired for a desired item, no information is output.

When only the number of events is acquired for an item, - is output for the average, max, and min.

If an overflow occurs since the count or other acquired values are accumulated excessively, * is output for the number of events and average. In this case, the max and min are output.

The accumulated values are not reset even if the -r option is specified while the dcstats command is outputting system statistics to a journal file.