OpenTP1 Version 7 Operation
Real-time statistics are acquired in the shared memory for the real-time statistics service.
To acquire real-time statistics, you can specify the execution environment in the definition or use the API to specify a segment. This subsection describes how to specify the execution environment in the definition. For details about using the API to specify a segment, see the manual OpenTP1 Programming Guide.
The following figure illustrates acquisition of real-time statistics by specifying the execution environment in the definition.
Figure 3-43 Acquiring real-time statistics
- The real-time statistics service analyzes the definition file for the real-time statistics service and the definition file for the items to be acquired in real time.
- The real-time statistics service sets an area for storing real-time statistics in the shared memory for the service.
- Real-time statistics regarding the target UAP are acquired in the set storage area based on the definition.
- Organization of this subsection
- (1) Specifying a target
- (2) Specifying the items to be acquired
- (3) Specifying an acquisition interval
- (4) Notes
(1) Specifying a target
You can specify a target from which you want the real-time statistics service to acquire statistics. To specify a target, use the rtsput definition command in the real-time statistics service definition. The maximum number of targets that can be specified in the rtsput definition command is the value specified in the rts_service_max operand in the real-time statistics service definition. For details about the targets for the acquisition of statistics, see E.5 Real-time statistics.
The following table shows the combinations of the values that can be specified for the options in the rtsput definition command and the targets for the acquisition of statistics.
Table 3-48 Values specified for the options in the rtsput definition command and acquisition targets
Value specified for the options in the rtsput definition command |
Acquisition target |
-u sys |
Statistics of the entire system#1 |
-u srv -s server-name |
Statistics of the specified server#2 |
-u svc -s server-name -v service-name |
Statistics of the specified service |
-u obj -o port-number -b IP-address |
Statistics for the specified port number and IP address |
- #1
- Statistics can be acquired regardless of the number of targets specified in the rts_service_max operand.
- #2
- The following types of statistics are acquired for the specified server:
- 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 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.
You do not need to start the server specified as the target for acquiring real-time statistics before you start the real-time statistics service. Real-time statistics can be acquired in the following cases as well:
- When the target server is started after the real-time statistics service has started
- When the target server is stopped and then restarted while the real-time statistics service is running
(2) Specifying the items to be acquired
You can specify the types of real-time statistics to be acquired for each target. 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.
Use either of the following methods to specify the items to be acquired:
- Specify the item ID of the information item to be acquired in the -e option of the rtsput definition command.
For details about item IDs, see E.5 Real-time statistics.
- Specify the definition file for the items to be acquired in real time in the -f option of the rtsput definition command.
For details about how to specify the definition of the items to be acquired in real time, see the manual OpenTP1 System Definition.
(3) Specifying an acquisition interval
Specify the interval for acquiring real-time statistics in the rts_trcput_interval operand in the real-time statistics service definition.
The following figure illustrates an acquisition interval.
Figure 3-44 Interval for acquiring real-time statistics
The shared memory for the real-time statistics service contains areas for storing real-time statistics.
- The real-time statistics service acquires statistics and edits them in the same storage area until the time specified in the rts_trcput_interval operand expires.
- When the specified length of time expires, the storage area is switched.
- When Y is specified in the rts_log_file operand in the real-time statistics service definition, the real-time statistics that have already been edited in the storage area are output to an RTS log file.
For details about how to output statistics to an RTS log file, see 3.16.4(2) Outputting real-time statistics to an RTS log file.
You can use the rts_trcput_interval operand in the real-time statistics service definition to change the interval for acquiring statistics when the real-time statistics service is started normally. For details about when the specification in the definition is applied, see 3.16.2(6) Operation of the real-time statistics service.
- You can acquire real-time statistics only from servers that provide OpenTP1 system services and from UAPs that are started by using the dcsvstart command.
- You can acquire real-time statistics service by service only for UAPs. One exception is SUPs and those UAPs that use the XATMI interface. You cannot acquire real-time statistics from those UAPs service by service.
- When you specify srv in the -u option of the rtsput definition command, the names of the services provided by the specified server are acquired from the service operand in the user service definition of that server.
Therefore, the directory specified in the DCCONFPATH or DCUAPCONFPATH environment variable must contain the user service definition file.
If the user service definition file is not stored in the correct directory, the real-time statistics service will not start. 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 user service definition after the real-time statistics service is started, their status as targets of the real-time statistics service does not change. This applies even if the srv argument is specified for the -u option of the rtsput definition command. To change targets after you start the real-time statistics service, use the rtsstats command or restart the real-time statistics service (RTSSUP).
Services added or deleted using the facility for the dynamic loading of service functions after the real-time statistics service is started are also not automatically added or removed as targets of the real-time statistics service. To change targets after you start the real-time statistics service, use the rtsstats command or restart the real-time statistics service (RTSSUP).
For details about changing targets by using the rtsstats command, see 3.16.5 Changing the settings of targets and the items to be acquired in real time.
- The real-time statistics service may not be able to acquire real-time statistics for the entire system or for UAPs that use a multi-server if multiple processes are concurrently performing write processing. The reason is that the real-time statistics service does not lock servers and UAPs to acquire statistics.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.