The following table shows the details of the system's statistics.
Table E-1 Details of the system's statistics
Types of statistics | Event (obtained value) | Details | ID for edition by dcreport# |
---|---|---|---|
RPC information | RPC call (response time) | Length of time between sending a request from the client to the server in dc_rpc_call and dc_rpc_call_to, and receiving a response from the server. This value is obtained when dc_rpc_call and dc_rpc_call_to are successful.
| 1 |
User service execution (execution time) | Length of time from the start of execution of a service function requested by dc_rpc_call and dc_rpc_call_to, until the service function issues a return value. This value is obtained in dc_rpc_mainloop. <Number of occurrences> Number of times dc_rpc_call and dc_rpc_call_to are issued | 2 | |
RPC timeout | Timeout errors during RPC response wait processing. <Number of occurrences> Timeout error count | 3 | |
RPC failures | Internal failures during RPC processing. <Number of occurrences> Number of above failures | 4 | |
Schedule information | Schedule waits (queue length) | The number of remaining service requests in the schedule queue of the user server (SPP). When the queue length is lengthy, increase the number of resident processes specified by the parallel_count clause in the user service definition. If there is any nonresident process, decrease the specification of the balance_count clause to make it easier to start the nonresident process. When the queue length is small, decrease the number of resident processes specified by the parallel_count clause in the user service definition, if necessary. If there is any nonresident process, increase the specification of the balance_count clause to make it harder to start the nonresident process. When there is difference between the average and the minimum value of the queue length, adjust the ratio of resident processes to nonresident processes specified in the balance_count clause, as well as the maximum number of processes. <Number of occurrences> Number of times the client made service requests (dc_rpc_call()) to the user server | 11 |
Schedule (message size) | The length of the service request message received by the user server (SPP). The message length includes 512 bytes of control information added by the system. It is preferable to specify a maximum message size in the message_buflen clause in the user service definition. The following shows the range of preferable specifications for the message_store_buflen clause in the user service definition: Message size (average) x queue length (max.) ![]() ![]() <Number of occurrences> Number of times the client made service requests (dc_rpc_call) to the user server. | 12 | |
Size of the currently used buffer pool for storing messages | The length of the buffer pool currently used by the user server (SPP) for storing messages, or shared by the scheduling buffer group, i.e., a group of user servers, to which the SPP belongs. <Number of occurrences> Number of times the client made service requests (dc_rpc_call) to the user server | 13 | |
Message size that could not be scheduled due to an insufficient buffer pool for storing messages | Of the service requests to the user server (SPP), the length of the service request messages that could not be scheduled due to an insufficient buffer pool for storing messages. <Number of occurrences> Number of times the user server failed to schedule service requests (dc_rpc_call) from the client due to an insufficient buffer pool for storing messages. | 14 | |
Lock information | Lock acquisition (wait time) | The time from the beginning of a lock wait status until the wait status is released. The lock here means an internal lock by dc_lck_get, or an internal lock of the lock service issued by DAM, TAM, and MQA. <Number of occurrences> Number of times the lock wait occurred | 21 |
Lock wait (queue length) | Queue length when lock wait occurred. <Number of occurrences> Number of times the lock wait occurred | 22 | |
Deadlock | Number of deadlocks that occurred. <Number of occurrences> Same as above | 23 | |
DAM information | Read (input length) | Input length of the DAM file data in the unit used for issuing dc_dam_read. <Number of occurrences> Number of times the dc_dam_read was issued | 31 |
Read errors | Errors that occurred in the dc_dam_read interface part with the OS. Errors such as an invalid API argument are not counted. <Number of time occurrences> Count of above error | 32 | |
Write (output length) | Output length of the DAM file data in the unit used for issuing dc_dam_write or dc_dam_rewrite. <Number of occurrences> Number of times the dc_dam_write or dc_dam_rewrite was issued | 33 | |
Write errors | Output errors during actual input/output operations with a disk. Errors such as an invalid API argument are not counted. <Number of occurrences> Count of above error | 34 | |
Use of update buffer (update size) | Amount of recovery journal (FJ) Tune the size and number of journal files by calculating the amount of a journal for using DAM. <Number of occurrences> Number of times the recovery journal (FJ) was obtained. | 35 | |
The first DAM API issued in a transaction branch (total number of transaction branches) | The number of transactions using DAM. The maximum value of this information is used as the peak number of transactions using DAM. To obtain an optimum memory (amount of dynamic shared memory for TP1/Server Base), specify the maximum value of this information for dam_tran_process_count in the DAM service definition. <Number of occurrences> Not collected. | 36 | |
Request for allocating a shared memory cache block | Number of times the DAM file data block that is allocated in the resource manager's shared memory pool was allocated. <Number of occurrences> Number of events | 38 | |
Shared memory allocation (shared memory pool usage ratio) | The periodically-obtained usage ratio of the resource manager shared memory pool. We recommend that you specify the size of the shared memory for the resource manager (dam_cache_size in the DAM service definition) based on this value. If the UAP frequently drops because the maximum value approaches 100%, increase the value of dam_cache_size. <Number of occurrences> Number of transactions that updated the DAM file specified with deferred update divided by 10 | 39 | |
Process information | UAP abnormal termination | Abnormal terminations of UAP processes. <Number of occurrences> Sum of the UAP processes which terminated abnormally | 41 |
Abnormal termination of system server | Abnormal terminations of system service processes. <Number of occurrences> Sum of the system servers which terminated abnormally | 42 | |
Process generation (total number of processes) | Sum of the number of system service processes and UAP processes started in the OpenTP1 system at specified intervals. <Number of occurrences> Not collected | 43 | |
TAM information | TAM file real updating (number of written bytes) | Number of data bytes (total value) actually updated in the TAM file during online operation. To calculate the average number of bytes updated for one occurrence, use the following formula:
Total number of data updates for the TAM file. Timer-start, cpd, or tamhold triggers the real update of the TAM file. | 51 |
Commits, rollbacks (record reference count) | The number of records referenced by one transaction. Since the TAM server outputs this value as statistics during commit processing, the number of occurrences is counted up no matter whether or not the dc_tam_read is issued. Therefore, a system that does not issue the dc_tam_read counts up the number of occurrences while the maximum value, minimum value and average remain zero. <Number of occurrences> Number of commits or rollbacks for TAM. | 55 | |
Commits, rollbacks (record update count) | The number of records updated by one transaction. Since the TAM server outputs this value as statistics during commit processing, the number of occurrences is counted up no matter whether or not the dc_tam_write is issued. Therefore, a system that does not issue the dc_tam_write counts up the number of occurrences while the maximum value, minimum value and average remain zero. <Number of occurrences> Number of commits or rollbacks for TAM. | 56 | |
Transaction information | Commits | Transactions determined to be committed. <Number of occurrences> The number of transactions determined to be committed | 61 |
Rollbacks | Transactions determined to be rolled back. <Number of occurrences> The number of transactions determined to be rolled back | 62 | |
Name information | Cache hits | The number of times the service information set in the service information cache area is referenced at the node. The service information cache area means the area for setting service information of the server started at a different node as for the name service. Service information means the address information needed for RPC with the server. This information is set when a client requests reference to service information while the name service of the same node as for the client does not have the service information. <Number of occurrences> Number of times above information was referenced | 71 |
Local hits | The number of times the service information set in the service information local area is referenced in the node. The service information local area means the area for setting service information of the server started at the same node as for the name service. Starting the server sets the service information. <Number of occurrences> Number of times above information was referenced | 72 | |
Lookup | The number of times the reference to service information is requested in the node. This data is counted up even if neither the service information local area nor the service information cache area stores service information. <Number of occurrences> Number of times the reference to service information is requested | 73 | |
Checkpoint dump information | Checkpoint dump collection (collection interval) | Checkpoint trigger interval. This means the time interval between a previous checkpoint and the current checkpoint. Since a checkpoint occurs depending on output count of a regular journal block, the frequency is evaluated by time. <Number of occurrences> Number of checkpoint dumps triggered | 81 |
Checkpoint dump validation (collection time) | The time between triggering and validating the checkpoint dump collection. This means the time that elapsed before completing validation of checkpoint dump after an event triggers checkpoint dump and each system server starts dump processing. <Number of occurrences> Number of checkpoint dumps triggered | 82 | |
Message queue information | Read message (input length) | The message length read from the queue file. <Number of occurrences> Read message length | 91 |
Write message (output length) | The message length written to the queue file. <Number of occurrences> Written message length | 92 | |
Read errors | FIL server errors during input from the physical file (abnormal cases). <Number of occurrences> Count of above error | 93 | |
Write errors | FIL server errors during output to the physical file (abnormal cases). <Number of occurrences> Count of above error | 94 | |
Waits for an available buffer | The number of times the necessary input/output buffers became insufficient due to too many requests concentrated on the queue file. Use this value to check the number of input/output buffers in the queue service definition. <Number of occurrences> Number of events | 95 | |
Real reads | Input count from the physical file when there is no message in the input/output buffer. To reduce this value, increase the number of input/output buffers in the queue service definition. <Number of occurrences> Count of above input | 96 | |
Real writes | Output count to the physical file. Compare this value with the number of write messages shown above to see how many write requests were input and/or output in batches. To reduce the input/output count, increase the number of input/output buffers in the queue service definition. The output count to the physical file should be zero when the deferred write facility is in use, because any output to the physical file is counted as the deferred writing (real write count). <Number of occurrences> Count of above output | 97 | |
Deferred writing (real write count) | Output count to the physical file by deferred writing when the deferred write facility is being used. <Number of occurrences> Count of above output | 99 | |
Deferred writing for each physical file (number of records written in deferred mode) | The value obtained for tuning the number of input/output buffers (quegrp -n option) in the message queue service definition. <Number of occurrences> Number of records written in deferred mode | 151 | |
Deferred writing for each physical file (messages written in deferred mode) | The value obtained for tuning the number of input/output buffers (quegrp -n option) in the message queue service definition. <Number of occurrences> Percentage of messages written in deferred mode | 152 | |
Journal information | Buffer full | The number of journal buffers for a system is twice of the number of parallel disk accesses, plus 1. One of these buffers is the current buffer. Buffer full means the condition that an attempt to buffer the journal record to the current buffer failed due to insufficient buffer area available. <Number of occurrences> Number of events | 102 |
Waits for available buffer | The condition of journal records waiting to be buffered because all journal buffers are full or in the process of being output. <Number of occurrences> Number of events | 103 | |
Journal output (block length) | Data length of a journal block Use this value to obtain the amount of the journal that occurred in the specified unit of time. <Number of occurrences> Journal block output count | 104 | |
Journal output (data length of the non-bus section) | OpenTP1 internal information. <Number of occurrences> Number of events | 105 | |
Input/output waits (number of waiting buffers) | The number of buffers waiting for output upon completion of journal output. The actual value times 100 is obtained to prevent the average value from being rounded. <Number of occurrences> Completed journal output count | 107 | |
Write | System's internal output count that includes both the journal data and file control information during a journal swap. <Number of occurrences> Count of above output | 108 | |
Write errors | Errors when data is written to a journal file. <Number of occurrences> Count of above error | 109 | |
Swap (swap time) | The overhead time when journal files are swapped. <Number of occurrences> Journal file was swapping count | 110 | |
Journal input (data length) | Length of data input from a journal file. <Number of occurrences> Count of data input from the journal file | 111 | |
Read | The count for system's internal input that includes both the journal data and file control information during journal swap. <Number of occurrences> Above input count | 113 | |
Read errors | Errors when data is read from a journal file. <Number of occurrences> Count of above error | 114 | |
MCF information | Message input to the memory queue | Writing of messages to the memory queue on the OpenTP1 node. <Number of occurrences> Message write count shown above | 121 |
Message input to the disk queue | Writing of messages to the disk queue on the OpenTP1 node. <Number of occurrences> Message write count shown above | 122 | |
Message output from the memory queue | Retrieving messages from the memory queue in the OpenTP1 node. <Number of occurrences> Message retrieval count shown above | 123 | |
Message output from the disk queue | Retrieving messages from the disk queue in the OpenTP1 node. <Number of occurrences> Message retrieval count shown above | 124 | |
Disconnects due to a connection error | Connection errors in the OpenTP1 node. <Number of occurrences> Count of above error | 125 | |
Shared memory control information | Size of static shared memory used | Total size of static shared memory blocks being used after static shared memory blocks have been allocated or released. <Number of occurrences> Number of statistics journals collected during the editing period + number of times the function for allocating or releasing static shared memory was issued | 131 |
Maximum size of the required amount of static shared memory | Maximum size of the static shared memory blocks in use. This information is obtained after the allocation or release of blocks if the previous pool size has been updated. The pool size is the total size of the shared memory in use, and includes empty areas in the pool created by releasing allocated shared memory. Accordingly, specify a value larger than this size in static_shmpool_size of the system environment definition. <Number of occurrences> Same as the size of static shared memory in use (if the previous pool size has been updated) | 132 | |
Size of dynamic shared memory used | Total size of the dynamic shared memory blocks being used after dynamic shared memory blocks have been allocated or released. <Number of occurrences> Number of statistics journals collected during the editing period + number of times the function for allocating or releasing dynamic shared memory was issued | 133 | |
Maximum size of the required amount of dynamic shared memory | Maximum size of the dynamic shared memory blocks in use. This information is obtained after allocation or release of blocks if the previous pool size has been updated. Specify a value larger than this size in dynamic_shmpool_size of the system environment definition. <Number of occurrences> Same as the size of dynamic shared memory in use (if the previous pool size has been updated) | 134 | |
MQA service information | Get message (input length) | The length of the message that was read from the queue by the application and MQT server. <Number of occurrences> Number of times the AP and MQT server retrieved messages from the queue | 161 |
Put message (output length) | The length of the message that was entered into the queue by the application and MQT server. <Number of occurrences> Number of times the AP and MQT server entered messages to the queue | 162 | |
Read errors | I/O errors during input of messages from a file. <Number of occurrences> Count of above error | 163 | |
Write errors | I/O errors during output of messages to a file. <Number of occurrences> Count of above error | 164 | |
Waits for an available buffer | The number of times the buffers became insufficient. Increase the number of input/output buffers if this value is counted. <Number of occurrences> Number of events | 165 | |
Real reads | I/O for reading messages from the file. If this value is counted, increase the number of input/output buffers to reduce I/O for receiving messages. <Number of occurrences> Number of events | 166 | |
Real writes | I/Os for writing messages to a file. <Number of occurrences> Number of events | 167 | |
Write request time | Processing time for writing messages to a file (I/O time + time for processing of request to the MQAI/O process). <Number of occurrences> Number of requests for writing messages to the file | 169 | |
Number of messages activated at one trigger | Number of messages left in the queue when a trigger was generated. <Number of occurrences> Trigger message generation count | 170 | |
Wait time for starting message transfer | The time between issuing MQPUT and startup of message transfer. <Number of occurrences> Number of messages transferred | 171 | |
Wait time for message arrival | The time between issuing MQPUT and completion of message transfer. <Number of occurrences> Number of messages transferred | 172 | |
IST service information | Input length | Information about the input length of the IST table data in the unit used for issuing dc_ist_read. <Number of occurrences> Number of times the dc_ist_read was issued | 191 |
Output length | Information about the output length of the IST table data in the unit used for issuing dc_ist_write. <Number of occurrences> Number of times the dc_ist_write was issued | 192 | |
Number of updates from other nodes | Number of update messages received prompting the local node to apply the IST table update operations performed at other nodes. <Number of occurrences> Number of events | 193 | |
Number of updates to other nodes | Number of times the local node updated the IST table and notified other nodes of the updating. <Number of occurrences> Number of events | 194 | |
XATMI service information | XATMI call (response time) | The time between sending a service request from the client and receiving a response during OSI TP communication using the XATMI interface.
Number of times the tpcall or tpacall was issued. Those that returned by error before sending a service request are not counted. | 211 |
XATMI user service execution time | The time from the beginning of execution of a service function at the server during OSI TP communication using the XATMI interface until the service function issues return. <Number of occurrences> Number of times the user service was executed. | 212 | |
XATMI service failure count | Number of failures in OSI TP communication using the XATMI interface
Number of above failures. | 213 |
The following table lists the items to be edited in the system statistics.
The Unit in the table is the number of times an event occurred or the unit of the obtained value if there is one. If a particular event did not occur (the number of occurrences is 0), the edited values are meaningless.
Table E-2 Items to be edited in system statistics
Statistics type | Edited contents | Unit | Editing in units of user servers | ID for edition by dcreport#1 | ||||
---|---|---|---|---|---|---|---|---|
Event (obtained value) | Number | Edited values | ||||||
Avg | Max | Min | ||||||
RPC information | RPC calls (response times) | Y | Y | Y | Y | Micro- seconds | Y | 1 |
Execution of user service (execution times) | Y | Y | Y | Y | Micro- seconds | Y | 2 | |
RPC overtimes | Y | N | N | N | Number of events | Y | 3 | |
RPC errors | Y | N | N | N | Number of events | Y | 4 | |
Scheduling information | Schedule wait (wait queue length) | Y | Y | Y | Y | Requests | Y | 11 |
Schedule (message size) | Y | Y | Y | Y | Bytes | Y | 12 | |
Size of the currently used buffer pool for storing messages | Y | Y | Y | Y | Bytes | Y | 13 | |
Message size that could not be scheduled due to insufficient buffer pool for storing messages | Y | Y | Y | Y | Bytes | Y | 14 | |
Lock information | Lock acquisition (wait time) | Y | Y | Y | Y | Milli- seconds | N | 21 |
Lock wait (wait queue length) | Y | Y | Y | Y | Requests | N | 22 | |
Deadlocks | Y | N | N | N | Number of events | N | 23 | |
DAM information | read (input length) | Y | Y | Y | Y | Bytes | Y | 31 |
read errors | Y | N | N | N | Number of events | Y | 32 | |
write (output length) | Y | Y | Y | Y | Bytes | Y | 33 | |
write errors | Y | N | N | N | Number of events | Y | 34 | |
Use of update buffer (update size) | Y | Y | Y | Y | Bytes | Y | 35 | |
First DAM API issued in a transaction branch (total number of transaction branches) | #2 | Y | Y | Y | Transaction branches | Y | 36 | |
Shared memory cache block allocation request | Y | N | N | N | Number of events | Y | 38 | |
Shared memory allocation (shared memory utilization rate)#3 | Y | Y | Y | Y | % | N | 39 | |
Process information | UAP abnormal terminations | Y | N | N | N | Number of events | N | 41 |
System server abnormal terminations | Y | N | N | N | Number of events | N | 42 | |
Process generations (total number of processes) | #2 | Y | Y | Y | Processes | N | 43 | |
TAM information | TAM file real updating (number of written bytes) | Y | Y | Y | Y | Bytes | N | 51 |
Commits, rollbacks (number of record referencing operations) | Y | Y | Y | Y | Number of events | Y | 55 | |
Commits, rollbacks (number of record updating operations) | Y | Y | Y | Y | Number of events | Y | 56 | |
Transaction information | Commits | Y | N | N | N | Number of events | Y | 61 |
Rollbacks | Y | N | N | N | Number of events | Y | 62 | |
Name information | Cache hits | Y | N | N | N | Number of events | Y | 71 |
Local hits | Y | N | N | N | Number of events | Y | 72 | |
lookup | Y | N | N | N | Number of events | Y | 73 | |
Checkpoint dump information | Collection of checkpoint dump (collection interval) | Y | Y | Y | Y | Milli- seconds | N | 81 |
Validation of checkpoint dump (collection time) | Y | Y | Y | Y | Milli- seconds | N | 82 | |
Message queue information | Read message (input length) | Y | Y | Y | Y | Bytes | N | 91 |
Write message (output length) | Y | Y | Y | Y | Bytes | N | 92 | |
Read errors | Y | N | N | N | Number of events | N | 93 | |
Write errors | Y | N | N | N | Number of events | N | 94 | |
Waits for an available buffer | Y | N | N | N | Number of events | N | 95 | |
Real reads | Y | N | N | N | Number of events | N | 96 | |
Real writes | Y | N | N | N | Number of events | N | 97 | |
Deferred writing (real write count) | Y | Y | Y | Y | Times | N | 99 | |
Deferred writing for each physical file (number of records that were written in deferred mode) | Y | Y | Y | Y | Number of records | N | 151 | |
Deferred writing for each physical file (percentage of messages that were written in deferred mode) | Y | Y | Y | Y | % | N | 152 | |
Journal information | Buffer full occurrences | Y | N | N | N | Number of events | Y | 102 |
Waits for an available buffer | Y | N | N | N | Number of events | Y | 103 | |
Journal output (block length) | Y | Y | Y | Y | Bytes | N | 104 | |
Journal output (data length of non-bus section)#4 | Y | Y | Y | Y | Bytes | N | 105 | |
Input/output waits (Number of waiting buffer faces) | Y | Y | Y | Y | Number of events | N | 107 | |
write | Y | N | N | N | Number of events | N | 108 | |
Write errors | Y | N | N | N | Number of events | N | 109 | |
Swap (swap time) | Y | Y | Y | Y | Micro- seconds | N | 110 | |
Journal input (data length) | Y | Y | Y | Y | Bytes | N | 111 | |
read | Y | N | N | N | Number of events | N | 113 | |
Read errors | Y | N | N | N | Number of events | N | 114 | |
MCF information | Message inputs to memory queue | Y | N | N | N | Number of events | N | 121 |
Message inputs to disk queue | Y | N | N | N | Number of events | N | 122 | |
Message outputs from memory queue | Y | N | N | N | Number of events | N | 123 | |
Message outputs from disk queue | Y | N | N | N | Number of events | N | 124 | |
Disconnects due to a connection error | Y | N | N | N | Number of events | N | 125 | |
Shared memory control information | Size of static shared memory used | Y | Y | Y | Y | Bytes | Y | 131 |
Maximum static shared memory size requirement | Y | Y | Y | Y | Bytes | Y | 132 | |
Size of dynamic shared memory used | Y | Y | Y | Y | Bytes | Y | 133 | |
Maximum dynamic shared memory size requirement | Y | Y | Y | Y | Bytes | Y | 134 | |
MQA service information | Get message (input length) | Y | Y | Y | Y | Bytes | Y | 161 |
Put message (output length) | Y | Y | Y | Y | Bytes | Y | 162 | |
Read errors | Y | -- | -- | -- | Number of events | Y | 163 | |
Write errors | Y | -- | -- | -- | Number of events | Y | 164 | |
Waits for an available buffer | Y | -- | -- | -- | Number of events | Y | 165 | |
Real reads | Y | -- | -- | -- | Number of events | Y | 166 | |
Real writes | Y | -- | -- | -- | Number of events | Y | 167 | |
Write request time | Y | Y | Y | Y | Micro- seconds | Y | 169 | |
Number of messages activated at one trigger | Y | Y | Y | Y | Number of events | Y | 170 | |
Time of wait for message transfer start | Y | Y | Y | Y | Milli- seconds | Y | 171 | |
Time of wait for message arrival | Y | Y | Y | Y | Milli- seconds | Y | 172 | |
IST service information | Input length | Y | Y | Y | Y | Bytes | Y | 191 |
Output length | Y | Y | Y | Y | Bytes | Y | 192 | |
Number of updates from other nodes | Y | N | N | N | Number of events | N | 193 | |
Number of updates to other nodes | Y | N | N | N | Number of events | N | 194 | |
XATMI service information | XATMI call response time | Y | Y | Y | Y | Micro- seconds | Y | 211 |
XATMI user service execution time | Y | Y | Y | Y | Micro- seconds | Y | 212 | |
XATMI service error count | Y | N | N | N | Number of events | Y | 213 |