IBM AIX Continuous Availability Features - IBM Redbooks
IBM AIX Continuous Availability Features - IBM Redbooks
IBM AIX Continuous Availability Features - IBM Redbooks
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
Note: Executing errctrl with the –P flag will apply the changes for future reboots as well.<br />
There was no support for the -P flag in prior <strong>AIX</strong> versions.<br />
To display the current RTEC level for xmalloc and its subcomponents, execute the following<br />
command:<br />
errctrl -c alloc -q -r<br />
Example 3-44 RTEC level for alloc and its subcomponent<br />
# errctrl -c alloc -q -r<br />
---------------------------------------------+-------+-------+-------+--------<br />
| Have |ErrChk |LowSev |MedSev<br />
Component name | alias | /level| Disp | Disp<br />
---------------------------------------------+-------+-------+-------+-------alloc<br />
.heap0 | NO | ON /0 | 48 | 64<br />
.xmdbg | NO | ON /9 | 64 | 80<br />
Example 3-44 shows the RTEC level for alloc and its subcomponents. Note that alloc.xmdbg<br />
is set to errorcheckmaximum (which is explained in more detail in 3.9.3, “Run-time error<br />
checking (RTEC) levels for XMDBG (alloc.xmdbg)” on page 127). In this example,<br />
alloc.heap0 has no error checking enabled.<br />
To display the current RTEC level for any subcomponent of xmalloc, execute:<br />
errctrl -c alloc. -q -r<br />
For example, the command errctrl -c alloc.xmdbg -q -r will show the RTEC level for<br />
alloc.xmdbg.<br />
3.9.3 Run-time error checking (RTEC) levels for XMDBG (alloc.xmdbg)<br />
The probability of taking each option will be determined by the debug level set for the<br />
alloc.xmalloc component. However, there is also a way to tune individual probabilities to<br />
desired levels. For further information about forcing individual tunables, refer to 3.9.4,<br />
“XMDBG tunables affected by error check level” on page 131.<br />
Error checking characteristics can be changed for xmalloc subsystem with<br />
component-specific tunables. All options can be configured at run time by using the errctrl<br />
command.<br />
Minimal Error Checking Level<br />
When the error-checking level is set to minimal (level 1), the checks and techniques used by<br />
xmalloc are applied at fairly low frequencies. It can be set to minimal by executing:<br />
errctrl -c alloc.xmdbg errcheckminimal<br />
The frequency of various xmalloc debug tunables can be viewed by using the kdb<br />
subcommand xm –Q. Example 3-45 on page 128 shows the frequencies for various tunables.<br />
Minimal checking is the default checking level on version 5. The frequency that appears next<br />
to each tunable is proportional to the frequency base (1024). From the example, you can see<br />
that the Ruin All Data technique will be applied 5 times out of every 1024 (0x400) calls to<br />
xmalloc() (about 0.5% of every 1024 xmalloc() calls). Also, 16 byte allocations will be<br />
promoted about 10 times out of every 1024 calls to xmalloc(), which is about 1% of the time.<br />
Chapter 3. <strong>AIX</strong> advanced continuous availability tools and features 127