OpenTP1 Version 7 Operation
To change the targets for the acquisition of statistics and the items to be acquired while the real-time statistics service is running, use the rtsstats command. To use the command, the real-time statistics service (RTSSUP) and the extended feature of the real-time statistics service (RTSSPP) must have been started.
The following figure shows an example of adding items to be acquired for a target for which real-time statistics are already being acquired.
Figure 3-46 Example of adding items to be acquired
- Specify the rtsstats command as follows and execute it:
rtsstats -a -u svc -s server-1 -v service-1 -e ID2 -f file-1
|
- RTSSPP adds item ID2 specified in the -e option and adds item ID3 by using file-1 specified in the -f option.
See the following for details on how to change the settings of targets and the items to be acquired while the real-time statistics service is running.
- Organization of this subsection
- (1) Adding a target
- (2) Adding an item to be acquired
- (3) Deleting a target
- (4) Deleting an item to be acquired
- (5) Notes
(1) Adding a target
To add a target, execute the rtsstats command with the -a option specified.
If the number of targets exceeds the value specified in the rts_service_max operand in the real-time statistics service definition, the rtsstats command terminates with a KFCA32742-E message. Because statistics for the entire system are not included in the targets, they can be added even though the number of targets has reached the maximum value.
When you specify srv for the -u option, acquisition of the following statistics is added for the server specified in the -s option:
- Statistics for the entire server
- Statistics for each service provided by the server
- Statistics for processing other than services (such as the main function)
Therefore, you will specify two or more targets than the number of services provided by the server. If you specify a system server or SUP which does not run any services, the overall statistics for the server are acquired.
Use either of the following methods to specify the items to be acquired for the target to be added:
- Specify an item ID in the -e option of the rtsstats command.
The item with the specified item ID is added.
- Specify the name of the definition file for the items to be acquired in real time in the -f option of the rtsstats command.
All the items for which Y is specified in the specified definition for the items to be acquired in real time are added.
If the number of items to be acquired exceeds the value specified in the rts_item_max operand in the real-time statistics service definition, the rtsstats command terminates with a KFCA32743-E message.
(2) Adding an item to be acquired
To add an item to be acquired for the target for which real-time statistics are already being acquired, specify the item to be added in the -a option in the rtsstats command and execute the command the same way as if you were adding a target.
(3) Deleting a target
To delete a target, execute the rtsstats command with the -d option specified. Do not specify the -e and -f options at this time.
(4) Deleting an item to be acquired
To delete an item to be acquired for the target for which real-time statistics are already being acquired, specify the item in the -d option and execute the rtsstats command.
Specify the item to be deleted in the -e or -f option. When you specify the -e option, the item with the specified item ID will be deleted. When you specify the -f option, all the items will be deleted except for the items for which Y is specified in the specified definition for the items to be acquired in real time.
- You can use the rtsstats command to change targets and the items to be acquired only while the real-time statistics service is running. When you stop the real-time statistics service normally, the changes you made using the rtsstats command will be discarded the next time the real-time statistics service is started and the targets and the items to be acquired that are specified in the rtsput definition command for the real-time statistics service are set again.
- When you specify srv in the -u option of the rtsstats command and execute the command, the name of each service provided by the specified server is acquired from the service operand in the user service definition of that server. Therefore, the user service definition file must be stored in the directory specified in the DCCONFPATH or DCUAPCONFPATH environment variable.
If the user service definition file is not stored in the correct directory, the rtsstats command will not work. If the service operand is not specified in the user service definition file, the real-time statistics service acquires real-time statistics on a server-by-server basis.
- If you add or remove services from the service operand in the user service definition after the rtsstats command is executed with srv specified for the -u option, their status as targets of the real-time statistics service does not change. To add or remove acquisition targets after you start the real-time statistics service, execute the rtsstats command again.
Services added or deleted by the facility for dynamic loading of service functions after the rtsstats command is executed are also not added or removed as targets of the real-time statistics service until you execute the rtsstats command again.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.