dcshmls [-d {stt|dyn|all}] [-r]

The dcshmls command outputs the utilization status of shared memory to the standard output during OpenTP1 operation.

-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.

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

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

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.