tkadmin set ringbuffer size

目的

リング・バッファーのサイズを設定します。

概要

tkadmin set ringbuffer size  -server server_name size

引数

-server server_name: コマンドによって影響されるサーバーを指定します。これはサーバーが構成されたときに指定された名前であることが必要です。
size: 新しいサイズをバイト単位で指定します。使用可能なスペースを最大限に利用するには、この値をリング・バッファーのセグメント・サイズの倍数にする必要があります。

説明

tkadmin set ringbuffer size コマンドは、リング・バッファー・サイズを設定して、その現行サイズと新しいサイズ、およびそのセグメント・サイズを、標準出力ストリームで表示します。デフォルトのリング・バッファー・サイズは 262144 バイト (256 KB) です。

リング・バッファー内のセグメントの最初の数は、8 と定められています。各セグメントは、リング・バッファーの合計サイズの 8 分の 1 です。リング・バッファーのサイズは (したがってセグメント数も) 増やすことができますが、最初のバッファー・サイズである 64 KB よりも少なくすることはできません。セグメント・サイズは 8192 バイトに固定されています。使用可能なスペースを最大限に利用するには、リング・バッファー・サイズをセグメント・サイズの倍数にする必要があります。リング・バッファーの合計サイズと現行のセグメント・サイズを表示するには、tkadmin show ringbuffer size コマンドを使用します。

CICS_TK_TRACE_RING_SIZE 環境変数を使用して、リング・バッファーのサイズを変更することもできます。この環境変数を使用すると、変更が有効になるのは、次回のサーバー始動時です。 tkadmin set ringbuffer size コマンドを使用すると、変更はただちに有効になります。

例

次のコマンドは、リング・バッファー・サイズを 327680 バイトに設定し、このリング・バッファーの現行の設定と新しい設定を表示します。その結果、リング・バッファーのサイズが 327680 (32768* 10) になることに注意してください。セグメント・サイズの倍数ではないサイズを指定した場合、セグメント・サイズの次の倍数が使用されます。

% tkadmin set ringbuffer size 300000
        Present Ring Buffer Size: 262144
        Present Ring Buffer Section Size: 32768
        Requested RingBuffer Size: 300000
        Resulting RingBuffer Size: 327680