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 memoryValue of hh...h
Shared memory for unit controllerMANAGER
Shared memory for global bufferWhen the standby-less system switchover (effects distributed) facility is applicable to the unitUnit name enclosed in parentheses
When the standby-less system switchover (effects distributed) facility is not applicable to the unitName of server using this shared memory
Shared memory for in-memory data bufferName of server using this shared memory
Shared memory for utilityUTILITY
Shared memory for security audit information bufferAUDDEF
ii...i
Pool identifier (up to 16 characters).
Type of shared memoryValue of ii...i
Shared memory for unit controllerNot displayed
Shared memory for global bufferWhen the standby-less system switchover (effects distributed) facility is applicable to the unitSequence number in the unit
When the standby-less system switchover (effects distributed) facility is not applicable to the unitSequence number in the server that uses this memory
Shared memory for in-memory data bufferSequence number in the server that uses this memory#
Shared memory for utilityUnique character string
Shared memory for security audit information bufferNone
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:
ConditionMinimum value
Whether the facility for dynamically changing global buffer is usedpd_max_add_dbbuff_nopd_max_add_dbbuff_shm_no
Used
pd_dbbuff_modify = Y
SpecifiedSpecifieda + 513
Omitteda + 1
OmittedSpecifieda + 513
Omitted1,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.