Nonstop Database, HiRDB Version 9 Command Reference

[Contents][Index][Back][Next]

2.61 pdls [-d mem] (Display server shared memory status)

Organization of this section
(1) Function
(2) Format
(3) Option
(4) Notes
(5) Output format

(1) Function

Displays information about the shared server memory. The command displays the size of the shared memory being used in each unit corresponding to the host.

(2) Format

 
 pdls -d mem [{-x host-name[,host-name]...|-u unit-identifier[,unit-identifier]...}]
 

(3) Option

(a) -x host-name[,host-name]...

Specifies the names of hosts whose information is to be displayed. If you specify multiple host names, there must be no spaces before or after a delimiter comma.

(b) -u unit-identifier[,unit-identifier]...

Specifies units whose information is to be displayed. If you specify multiple unit names, there must be no spaces before or after a delimiter comma.

(4) Notes

  1. Return code 0 for the pdls -d mem command indicates normal termination, and return code 8 indicates abnormal termination.

(5) Output format

 
 HOSTNAME : aa...a(bbccdd)
     SHM-ID  GET-SIZE  ACT-SIZE SHM-OWNER          POOL-ID
     ee...e    ff...f    gg...g    hh...h           ii...i
        :         :         :         :                :
 

Explanation

aa...a
Host name (up to 32 characters).

bbccdd
Time of pdls command execution (hour:minute:second).

ee...e
Identifier of shared memory segment (10 decimal digits).
If the value exceeds 6 digits, the subsequent display items will be shifted to the right by the number of excess digits.

ff...f
Allocation size (up to 10 decimal digits) (bytes)
If the value exceeds 9 digits, the subsequent display items will be shifted to the right by the number of excess digits.

gg...g
Amount of space being used (up to 10 decimal digits) (bytes)
If the value exceeds 9 digits, the subsequent display items will be shifted to the right by the number of excess digits.

hh...h
Attribute of the process that uses shared memory (up to 8 characters).
Type of shared memory Value of hh...h
Shared memory for unit controller MANAGER
Shared memory for global buffer When the standby-less system switchover (effects distributed) facility is applicable to the unit Unit name enclosed in parentheses
When the standby-less system switchover (effects distributed) facility is not applicable to the unit Name of server using this shared memory
Shared memory for in-memory data buffer Name of server using this shared memory
Shared memory for utility UTILITY
Shared memory for security audit information buffer AUDDEF

ii...i
Pool identifier (up to 16 characters).
Type of shared memory Value of ii...i
Shared memory for unit controller Not displayed
Shared memory for global buffer When the standby-less system switchover (effects distributed) facility is applicable to the unit Sequence number in the unit
When the standby-less system switchover (effects distributed) facility is not applicable to the unit Sequence number in the server that uses this memory
Shared memory for in-memory data buffer Sequence number in the server that uses this memory#
Shared memory for utility Unique character string
Shared memory for security audit information buffer None

Note
The same value (allocation size) is always displayed for ff...f (allocation size) and gg...g (size being used).

#
Sequence numbers are assigned sequentially in ascending order beginning with the minimum value shown in the table below:
Condition Minimum value
Whether the facility for dynamically changing global buffer is used pd_max_add_dbbuff_no pd_max_add_dbbuff_shm_no
Used
pd_dbbuff_modify = Y
Specified Specified a + 17
Omitted a + 1
Omitted Specified a + 17
Omitted 1017
Not used
pd_dbbuff_modify = N
-- -- 17

Legend:
--: Not applicable
a: Value of pd_max_add_dbbuff_shm_no
For the default value of the pd_max_add_dbbuff_shm_no operand, see the manual HiRDB Version 9 System Definition.