Nonstop Database, HiRDB Version 9 Command Reference

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

2.66 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

(a) In HP-UX, Solaris, and Linux
 
 HOSTNAME : aa...a(bbccdd)
     SHM-ID  GET-SIZE  ACT-SIZE SHM-OWNER          POOL-ID
     ee...e    ff...f    gg...g    hh...h           ii...i
        :         :         :         :                :
 
(b) In AIX (32-bit mode)
 
 HOSTNAME : aa...a(bbccdd)
     SHM-ID   GET-SIZE   ACT-SIZE SHM-OWNER        POOL-ID
     ee...e     ff...f     gg...g    hh...h         ii...i
        :          :          :         :              :
  
(c) In AIX (64-bit mode)
 
 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 in a system other than AIX, 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, or up to 20 decimal digits for AIX in the 64-bit mode) (bytes)
If the value exceeds 9 digits in a system other than AIX, 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, or up to 20 decimal digits for AIX in the 64-bit mode) (bytes)
If the value exceeds 9 digits in a system other than AIX, 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 + 513
Omitted a + 1
Omitted Specified a + 513
Omitted 1,513
Not used
pd_dbbuff_modify = N
-- -- 513

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.