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:

-r

Displays approximate values of the allocated size and the size in use, shared memory identifiers, and user type.

Output format

[Figure]

  1. Displayed when the -d option is specified or has not been specified.
  2. Displayed when -d stt or -d all is specified.
  3. Displayed when -d dyn or -d all is specified.
  4. 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 IDDescriptionOutput destination
KFCA00110-IHelp messageStandard output
KFCA00111-EOption flag specification is invalid.Standard error output
KFCA00112-ENo OpenTP1 execution environment.Standard error output
KFCA00113-EOpenTP1 shared memory cannot be referenced.Standard error output
KFCA00114-ERetrieval of utilization status failed, because shared memory is destroyed.Standard error output
KFCA00123-EThere 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.