rtsls [-c][-n generation-number][-m][-l] [-e item-ID[,item-ID]... | -u output-unit[-s server-name][-v service-name]]

The rtsls command outputs, to the standard output, management information and real-time statistics of the real-time statistics service. This data was collected in the shared memory used for the real-time statistics service.

For details about the real-time statistics that are output, see E.5 Real-time statistics.

-c

Outputs real-time statistics in CSV format to the standard output.

-n generation-number~<unsigned integer> ((1-3))

Specifies the generation number of the shared memory for the RTS service that contains the real-time statistics to be output.

If you do not specify the -n option, the command outputs the real-time statistics to the shared memory with a generation number that indicates that statistics have already been acquired in the shared memory.

-m

Outputs the management information for the real-time statistics service to the standard output.

-l

Outputs a list of the names of services from which real-time statistics are acquired and the relevant item IDs.

-e item-ID~<unsigned integer> ((1000-2147483647))

Specifies an item ID for the real-time statistics to be output.

For details about item IDs, see E.5 Real-time statistics.

-u output-unit~<all>

Specifies the output unit.

sys

Outputs the acquired real-time system-wide statistics.

svc

Outputs the acquired real-time statistics for each server or service.

all

Outputs all the real-time statistics (system-wide, all servers, and all services).

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

The specification of the -s option is valid only 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 output.

The specification of the -v option is valid only when svc is specified in the -u option.

The following table shows the combinations of the -u, -s, and -v options, and the output targets.

Table 13-9 Combinations of rtsls command options and the statistics to be output

Specification of -u option	Specification of -s option	Specification of -v option	Real-time statistics to be output
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

Legend:

--: Cannot be specified.

#

Indicates a specification for editing the statistics of an acquisition target that is registered by specifying obj for the -u option in the rtsput definition command or the rtsstats command of the real-time statistics service definition.

If you specify neither the -e option or the -u option, the system assumes that all is specified for the -u option.

(1) When the -m option is specified

The output format is as follows:

The output format is as follows when the -m and -c options are specified (CSV format):

aaaa

OpenTP1 node identifier

bbbbbbbb

Identifier of the shared memory for the real-time statistics service (decimal)

cccccccccc

Number of the shared memory for the real-time statistics service (decimal)

ddddd

Status of the real-time statistics service

START

The service is running.

eeee

Maximum number of services for which statistics can be acquired (decimal)

The maximum number of services for which statistics can be acquired is displayed. This number is the value specified in the rts_service_max operand in the real-time statistics service definition.

ffff

Number of services from which statistics are currently being acquired (decimal)

gggg

Number of unused services (decimal)

The value obtained by subtracting the number of services from which statistics are currently being acquired from the maximum number of services for which statistics can be acquired (specified in the rts_service_max operand in the real-time statistics service definition) is displayed.

hhhh

Maximum number of items to be acquired (decimal)

The maximum number of items to be acquired is displayed. This number is the value specified in the rts_item_max operand in the real-time statistics service definition.

iiiiii

Acquisition interval (decimal)

jjj

Whether swap messages are output

YES

Swap messages are output.

NO

Swap messages are not output.

kk

Generation number of the area in the shared memory for the real-time statistics service from which the statistics are acquired (decimal)

ll

Number of generations of the area in the shared memory for the real-time statistics service from which statistics are currently being acquired (decimal)

mmmm/mm/mm mm:mm:mm

Time at which the acquisition of statistics started

Hyphens (-) are displayed when the acquisition of statistics has not started.

nnnn/nn/nn nn:nn:nn

Time at which the acquisition of statistics ended

Hyphens (-) are displayed when the acquisition of statistics has not ended.

ooo

Whether the real-time statistics are output to an RTS log file

YES

The real-time statistics are output to an RTS log file.

NO

The real-time statistics are not output to an RTS log file.

ppppppp

Size of the RTS log file (decimal)

qq

Number of RTS log file generations

rr

Generation number of the RTS log file to which statistics are currently being output (decimal)

ss....ss

RTS log file name

(2) When the -l option is specified

The output format is as follows:

The output format is as follows when the -l and -c options are specified (CSV format):

1. Title of the data

2. Displayed repeatedly for the number of servers or services from which real-time statistics are acquired

aaaa

OpenTP1 node identifier

bb....bb

Server name

When the server name is _SYSTEM and the service name is , the target statistics are system-wide statistics. If ---- appears in this field, the real-time statistics were acquired without specifying a first acquisition target.

cc....cc

Service name

When **** is displayed, the target statistics are the real-time statistics acquired from each applicable unit of processing other than services. When is displayed, the target statistics are the real-time statistics acquired from each server. If ---- appears in this field, the real-time statistics were acquired without specifying a second acquisition target.

dddd

Number of items in the real-time statistics that are currently being acquired (decimal)

eeee

Number of unused items (decimal)

The value obtained by subtracting the number of items in the real-time statistics that are currently being acquired from the maximum number of items to be acquired (specified in the rts_item_max operand in the real-time statistics service definition) is displayed.

ffffffffff

Item ID in the real-time statistics that are currently being acquired (decimal)

(3) When the -e option is specified

The output format is as follows:

The output format is as follows when the -e and -c options are specified (CSV format):

1. Title of the data

2. Displayed repeatedly for the number of servers or services from which real-time statistics are acquired for each item ID

aaaa

OpenTP1 node identifier

bbbb/bb/bb bb:bb:bb

Time at which the acquisition of statistics started

cccc/cc/cc cc:cc:cc

Time at which the acquisition of statistics ended

dd....dd

Server name

When the server name is _SYSTEM and the service name is , the target statistics are system-wide statistics. If ---- appears in this field, the real-time statistics were acquired without specifying a first acquisition target.

ee....ee

Service name

When **** is displayed, the target statistics are the real-time statistics acquired from each applicable unit of processing other than services. When is displayed, the target statistics are the real-time statistics acquired from each server. If ---- appears in this field, the real-time statistics were acquired without specifying a second acquisition target.

fff

Type of real-time statistics

gg....gg

Item name

This is output only for CSV format.

hhhhhhhhhh

Item ID (decimal)

iiiiiiiiii

Number of statistics items that are generated (decimal)

**** is displayed if an overflow error occurs.

jjjjjjjjjj

Maximum value in the statistics (decimal)

Hyphens (-) are displayed if there are no data values. **** is displayed if an overflow error occurs.

kkkkkkkkkk

Minimum value in the statistics (decimal)

Hyphens (-) are displayed if there are no data values. **** is displayed if an overflow error occurs.

llllllllll

Average value in the statistics (decimal)

Hyphens (-) are displayed if there are no data values. **** is displayed if an overflow error occurs.

mm....mm

Unit of the real-time statistics

n

Generation number of the area in the shared memory for the RTS service from which statistics are acquired

(4) When the -u option is specified

The output format is as follows:

The output format is as follows when the -u and -c options are specified (CSV format):

1. Title of the data

2. Displayed repeatedly for the number of servers or services from which real-time statistics are acquired

3. Displayed repeatedly for the number of real-time statistics items that are acquired from servers or services

aaaa

OpenTP1 node identifier

bbbb/bb/bb bb:bb:bb

Time at which the acquisition of statistics starts

cccc/cc/cc cc:cc:cc

Time at which the acquisition of statistics ends

dd....dd

Server name

When the server name is _SYSTEM and the service name is , the target statistics are system-wide statistics. If ---- appears in this field, the real-time statistics were acquired without specifying a first acquisition target.

ee....ee

Service name

When **** is displayed, the target statistics are the real-time statistics acquired from each applicable unit of processing other than services. When is displayed, the target statistics are the real-time statistics that are acquired from each server. If ---- appears in this field, the real-time statistics were acquired without specifying a second acquisition target.

fff

Type of real-time statistics

gg....gg

Item name

This is output only for CSV format.

hhhhhhhhhh

Item ID (decimal)

iiiiiiiiii

Number of statistics items that are generated (decimal)

**** is displayed if an overflow error occurs.

jjjjjjjjjj

Maximum value in the statistics (decimal)

Hyphens (-) are displayed if there are no data values. **** is displayed if an overflow error occurs.

kkkkkkkkkk

Minimum value in the statistics (decimal)

Hyphens (-) are displayed if there are no data values. **** is displayed if an overflow error occurs.

llllllllll

Average value in the statistics (decimal)

Hyphens (-) are displayed if there are no data values. **** is displayed if an overflow error occurs.

mm....mm

Unit of the real-time statistics

n

Generation number of the area in the shared memory for the RTS service from which statistics are acquired

Message ID	Description	Output destination
KFCA32712-E	The version and revision combination of the real-time statistics service is incorrect.	Standard error output
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
KFCA32722-E	Processing cannot be executed because shared memory is not available.	Standard error output
KFCA32723-E	Processing cannot be executed because the real-time statistics service has not started.	Standard error output
KFCA32736-I	Help message	Standard output

• Real-time statistics are not output if the acquisition of real-time statistics from the shared memory with the generation number specified in the -n option has not started.
• If the acquisition of real-time statistics from the shared memory with the generation number specified in the -n option has not ended, the command outputs the real-time statistics collected between the specified start time for acquiring statistics and the execution of the rtsls command.