rtsstats{-a [-r]|-d } {-u sys| -u srv -s server-name| -u svc -s server-name -v service-name| -u obj [-o acquisition-target-name-1][-b acquisition-target-name-2]} [-e item-ID[,item-ID]...] [-f name-of-definition-file-for-items-to-be-acquired-in-real-time]

The rtsstats command changes the targets for the acquisition of real-time statistics and the items to be acquired.

-a

Adds the targets of real-time statistics acquisition and the items to be acquired.

-r

When you add an item to be acquired for the specified target for real-time statistics acquisition, this option deletes all existing items and adds the new item.

If you do not specify the -r option, existing items remain and the new item is added.

-d

Deletes the targets of real-time statistics acquisition and the acquired items.

-u {sys|srv|svc|obj}

Specifies the type of the new target of real-time statistics acquisition.

sys

Specifies the entire system as the target of real-time statistics acquisition.

When sys is specified, the value of the rts_service_max operand in the real-time statistics service definition is not affected.

srv

Specifies a server as the target of real-time statistics acquisition.

The following statistics are acquired when you add a user server name as the target in the -s option:

• Statistics for the specified server
• Statistics for all the services specified in the service operand of the user service definition for the specified user server
• Statistics for processing that is not related to services

This causes the number of targets for which statistics are to be acquired to be the number of services specified in the service operand plus 2.

If you specify the name of a server that has no services, such as the system server or an SUP, the command acquires statistics for only the specified server.

svc

Specifies a service of a user server as the target of real-time statistics acquisition.

obj

When you specify this option, also use the -o and -b options to specify an object as the target about which statistics are acquired.

For details on the combination of the target objects and options, see the explanation of the -o and -b options.

-s server-name~<Alphanumeric string of 1-8 characters beginning with an alphabetic character>

Specifies the name of the target server.

When srv or svc is specified in the -u option, always specify the -s option. When sys or obj is specified in the -u option, the -s option cannot be specified.

-v service-name~<identifier of 1-31 characters>

Specifies the name of the target service.

When svc is specified in the -u option, always specify the -v option. When sys, srv, or obj is specified in the -u option, the -v option cannot be specified.

-o acquisition-target-name-1~<1-8 characters>

-b acquisition-target-name-2~<1-63 characters>

Specifies the name of the target object when you specify obj in the -u option.

The following table shows the objects you can specify in the -o and -b options as targets. When obj is specified in the -u option, specify arguments in the -o and -b options according to the table.

Table 13-10 Arguments of the -o and -b options in the rtsstats command, and the object determined from the specified arguments

Argument of the -o option	Argument of the -b option	Object determined from the arguments
Port number#	IP address#	Node for which the specified service information is referenced
Logical terminal name	Not specified	Specified logical terminal
Not specified	Service group name	Specified service group name

#

Specify the port number and IP address of a node specified in the all_node operand of the system common definition or in the domain definition file.

When sys, srv, or svc is specified in the -u option, the -o or -b option cannot be specified.

-e item-ID~<decimal number from 1000 to 9999>

Specifies the item ID of the item to be added or deleted.

You can specify a maximum of 64 item IDs. For details about item IDs, see E.5 Real-time statistics.

-f name-of-definition-file-for-items-to-be-acquired-in-real-time~<identifier of 1-8 characters>

Specifies the name of the definition file for the items to be acquired in real time that contains the item to be added or deleted.

If you want to add items, this option adds the items for which you have specified Y in the specified definition file for the items to be acquired in real time.

If you want to delete items, this option deletes all items except for the items for which you have specified Y in the specified definition file for the items to be acquired in real time.

Message ID	Description	Output destination
KFCA32712-E	The combination of version and revision 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
KFCA32724-E	The specified target for the acquisition of real-time statistics is not registered.	Standard error output
KFCA32737-I	Help message	Standard output
KFCA32742-E	No more targets can be added because the number of registered targets for real-time statistics acquisition is already at the maximum.	Standard error output
KFCA32743-E	No more items can be added because the number of registered items to be acquired as real-time statistics is already at the maximum.	Standard error output
KFCA32752-E	Processing cannot be executed because the extended feature of the real-time statistics service has not started.	Standard error output
KFCA32754-E	An error occurred when the RPC was executed.	Standard error output
KFCA32755-E	A timeout error occurred during the wait for a response from the extended feature of the real-time statistics service.	Standard error output
KFCA32756-E	Processing cannot be executed because the area for storing service requests for the extended feature of the real-time statistics service is insufficient.	Standard error output
KFCA32758-E	An error occurred during the analysis of the specified definition file.	Standard error output
KFCA32760-E	The number of arguments specified in the command option is invalid.	Standard error output

• The rtsstats command can be used only if the extended feature of the real-time statistics service (RTSSPP) has been started.
• The maximum number of targets for acquiring real-time statistics that you can add using the rtsstats command is the value specified in the rts_service_max operand in the real-time statistics service definition. You cannot change the value specified in the rts_service_max operand while the service is online.
• The maximum number of items that can be acquired for one target is the value specified in the rts_item_max operand in the real-time statistics service definition. You cannot change the value specified in the rts_item_max operand while the service is online.
• If you omit the -e and -f options when the -a option is specified, only the area for storing real-time statistics is secured. The items to be acquired are not set. In this case, the number of targets for real-time statistics acquisition increases by one.
• When you specify the -e or -f option when the -d option is specified, the area for storing real-time statistics is not released even if all the items to be acquired have been deleted.
  If you want to release the area for storing real-time statistics and decrease the number of targets, execute the rtsstats command with the -d option specified but without the -e and -f options specified.
  
• In the rts_item_max operand in the real-time statistics service definition, specify a value that also covers the number of items to be acquired by the dc_rts_utrace_put function. You need to include the number of items to be acquired by the dc_rts_utrace_put function because you cannot use the rtsstats command to add or delete the items for this function.
• When you use the rtsstats command to change targets or the items to be acquired, the change is applied to all the generations in the shared memory for the real-time statistics service, including the generations that already completed the acquisition of real-time statistics.
• When you execute the rtsstats command to change multiple targets (services) with srv specified in the -u option, the number of targets (services) or items to be acquired may reach the maximum value for the specified server. Although a KFCA32742-E message or a KFCA32743-E message is output, in this case, processing continues for other targets (services) that can be successfully changed.
  When the number of targets (services) or the number of items to be acquired reaches the maximum value and no more targets (services) or items to be acquired can be registered for some servers, the error message only displays the first server where an error occurred. For details about the targets (services) or the acquisition items that cannot be registered, use the rtsls command to check the configuration of shared memory.
  
• When you specify svc for the -u option, the command does not check whether the server name specified in the -s option or the service name specified in the -v option actually exists. When obj is specified in the -u option, whether the values specified in the -o and -b options are valid is not checked. If unnecessary acquisition targets have been registered, execute the rtsls command to check their configuration, and delete them by executing the rtsstats command with the -d option specified.
• If you add or remove services from the service operand in the user service definition after the rtsstats command is executed, their status as targets for statistics acquisition does not change even if the srv argument is specified for the -u option. To add or remove such services as targets for statistics acquisition, execute the rtsstats command again.
  Services added or deleted using the facility for dynamic loading of service functions after the rtsstats command is executed are also not automatically added or removed as targets of the real-time statistics service. To add or remove such services as targets for statistics acquisition, execute the rtsstats command again.