Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.Opens in a new tab

For information on migrating to InterSystems IRISOpens in a new tab, see Why Migrate to InterSystems IRIS?

zfheap

$ZF ヒープのサイズと構成。

Synopsis

[config]    zfheap=a,b

説明

$ZF ヒープは、$ZF を使用したコールアウト関数の出力パラメータに使用されます。詳細は、"Caché コールアウト・ゲートウェイの使用法" の “Caché コールアウト・ライブラリの作成” の章を参照してください。

コンマで区切られた 2 つの値によって、$ZF ヒープを構成します。値の意味は、左から右の順に以下のとおりです。

  • zfstrsz は、$ZF ヒープで 1 つの文字列パラメータに対して Caché が使用を許可する文字数です。このために実際に必要なバイト数は、使用している文字が 8 ビット文字か、Unicode (2 バイト文字) か、UNIX® 上の 4 バイト文字かに応じて異なります。 範囲は 0 - 32767 です。値 - 0 を指定すると、zfstrsz の適切な値が Caché で自動的に決定されます。既定値は 32767 文字です。

  • zfheapsz は、Caché があらゆる目的で $ZF ヒープに割り当てるバイト数です。$ZF ヒープは、$ZF のすべての入力および出力パラメータ用に仮想メモリに割り当てられるバイトの合計バイト数です。最初の値で使用可能にした文字列用の領域もこの中に含まれます。バイト数は 0 ~ 270336 の範囲で設定します。 既定値は 0 です。値 0 を指定すると、zfstrsz の値に基づいて、zfheapsz の適切な値が Caché で自動的に計算されます。

zfstrsz に基づいて zfheapsz を計算する式は、以下のとおりです。

zfheapsz = (1 文字あたりのバイト数 * zfstrsz) + 2050

例えば、zfstrsz の値が既定の 32767 だとします。

  • Unicode を使用している場合、1 文字は 2 バイトです。したがって、zfheapsz の値は 67584 (= 2 * 32767 + 2050) バイトになります。

  • UNIX® では、1 文字は 4 バイトです。したがって、zfheapsz の値は 133118 (= 4 * 32767 + 2050) バイトになります。

このパラメータは 0,0 に設定することをお勧めします。

zfheap=32767,67584

値の範囲

上記のとおり。

管理ポータル

[システム管理] > [構成] > [追加設定] > [メモリ詳細] ページで、以下の操作を行います。

  • zfstrsz については、[ZFString] の行の [編集] を選択します。文字単位の数値を入力します。

  • zfheapsz については、[ZFSize] の行の [編集] を選択します。バイト単位の数値を入力します。

FeedbackOpens in a new tab