OpenTP1 Version 7 Operation
dcshmls (Display utilization status of common memory)
Format
dcshmls [-d {stt|dyn|all}] [-r]
|
Function
The dcshmls command outputs the utilization status of shared memory to the standard output during OpenTP1 operation.
Options
-d {stt|dyn|all}
Specifies the shared memory whose utilization status is to be displayed.
- stt
- Detailed utilization status of static shared memory
- dyn
- Detailed utilization status of dynamic shared memory
- all
- Detailed utilization status of static and dynamic shared memories
If this option is not specified, the following information is displayed:
- Shared memory pool type
- Size of shared memory pool
- Total size of shared memory in current use
- Current utilization percentage of shared memory
- Maximum size of shared memory
-r
Displays approximate values of the allocated size and the size in use, shared memory identifiers, and user type.
Output format
- Displayed when the -d option is specified or has not been specified.
- Displayed when -d stt or -d all is specified.
- Displayed when -d dyn or -d all is specified.
- Displayed when the -r option is specified.
- aa...aa
- Shared memory pool type
- static: Static common memory
- dynamic: Dynamic common memory
- bbbbbbbb
- Size of shared memory pool (hexadecimal)
- cccccccc
- Total size of shared memory in current use (hexadecimal)
- dd
- Current utilization percentage (%) of shared memory (fractions rounded down)
- eeeeeeee
- Maximum size of shared memory (hexadecimal)
- fff
- Type of service using static shared memory blocks (3 characters) (internal information)
- gg
- "class" value for static shared memory block management (hexadecimal) (internal information)
- hhhhhhhh
- Location of the static shared memory blocks from the beginning of the static shared memory pool (hexadecimal)
- iiiiiiii
- Size of static shared memory blocks (hexadecimal)
- jjjjjjjj
- "subclass" value for static shared memory block management (hexadecimal) (internal information)
- kk...kk
- Process ID of the process for which dynamic shared memory blocks
- llllllll
- Location from the beginning of shared memory pool of dynamic shared memory blocks (hexadecimal)
- mmmmmmmm
- Location from the beginning of dynamic memory pool of dynamic shared memory blocks (hexadecimal)
- nnnnnnnn
- Size of dynamic shared memory blocks (hexadecimal)
- oo...oo
- Type of dynamic shared memory blocks
- EMPTY: Unused
- USE: In use
- pp...pp
- Shared memory identifier
- qqqqqqqq
- Size of shared memory pool which OS is requested to allocate (hexadecimal)
- The size of the shared memory pool that the OS is requested to allocate is as follows:
- size-of-shared-memory-pool-OS-is-requested-to-allocate = size-of-shared-memory-pool-for-OpenTP1-control + size-of-static-shared-memory-pool + size-of-dynamic-shared-memory-pool
- rrrrrrrr
- Approximate size of shared memory in current use (hexadecimal)
- For the shared memory of TP1/Server Base, this indicates the size from the beginning of the shared memory pool for controlling OpenTP1 to the maximum usage level in the static shared memory pool being used as the shared memory. The shared memory of TP1/Server Base consists of (from the smallest address) the shared memory pool for controlling OpenTP1, the dynamic shared memory pool, and the static shared memory pool. Therefore, the value of rrrrrrrr is determined by adding the maximum usage size of the static shared memory pool to the size of the shared memory pool for controlling OpenTP1 and the size of the dynamic shared memory pool.
- ss...s
- Type of source requesting shared memory pool allocation
- btn: TP1/Server Base
- dam: TP1/FS/Direct Access
- tam: TP1/FS/Table Access
- ism: ISAM
- mXX: MQA (where XX is a hexadecimal number between 00 and ff)
- ist: TP1/Shared Table Access
- rts: Real-time statistics service
Output messages
Message ID |
Description |
Output destination |
KFCA00110-I |
Help message |
Standard output |
KFCA00111-E |
Option flag specification is invalid. |
Standard error output |
KFCA00112-E |
No OpenTP1 execution environment. |
Standard error output |
KFCA00113-E |
OpenTP1 shared memory cannot be referenced. |
Standard error output |
KFCA00114-E |
Retrieval of utilization status failed, because shared memory is destroyed. |
Standard error output |
KFCA00123-E |
There is a shared memory block whose usage status cannot be checked. |
Standard error output |
Note
To minimize the influence of the information output by this command on processing performance, the command references information without locking. Therefore, depending on the timing, the correct information may not be obtained. If OpenTP1 outputs message KFCA00123-W, re-execute the command. If the same message appears after executing the command again, the shared memory may be damaged. In this case, use dcstop -df to forcibly stop the system. Then, record the contents of message KFCA00123-W, save the core file and the shared memory dump, and contact the maintenance personnel.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.