STATLIST

STATLISTファンクションは、ディメンションまたはディメンション・サロゲートの現行のステータス・リストの全値のリスト、あるいは値セットの全値のリストを返します。リストは、指定された幅に書式設定できます。STATLISTファンクションを採用しているSTATUSコマンドでは、ディメンションのステータスがまとめて表示されます。表示する幅または位置を制御する場合は、STATUSではなくSTATLISTを使用します。

戻り値

STATLISTは、ディメンション値またはディメンション・サロゲート値自体（たとえば、Jan95）、あるいはデフォルトのステータス・リストでの値の位置を示す数値（たとえば、6）のいずれかを含むTEXT値のリストを返します。

戻り値は、Jan96 TO Jun96などのように、value TO valueという形式になります。デフォルトのステータスが有効の場合は、ALLが表示されます。現行のステータス・リストまたは値セットが空の場合は、NULLが表示されます。

構文

STATLIST(dimension [keyword] [width])

引数

dimension

値がディメンション、ディメンション・サロゲートまたは値セットの名前であるテキスト式。

keyword

表8-7「STATLISTのキーワード」に示すキーワード。このキーワードによって、現行のステータス・リストの値を表示する形式を指定できます。

表8-7 STATLISTのキーワード

キーワード	説明
INTEGER	STATLISTがディメンションの現行のステータスにある値のリストを返す際、そのディメンションのデフォルトのステータス・リストでの位置を示す`INTEGER`として返すように指定。
TEXT	（デフォルト）STATLISTがディメンションの現行のステータスに含まれる値のリストを返す際、その値の値名として返すように指定。

width

リストの幅を文字数で指定するINTEGER式（オプション）。幅を指定しない場合、STATLISTではLSIZEオプションの現行の値が使用されます。LSIZEのデフォルト値は80です。

例

例8-109 ROWによるステータス・リストの作成

この例は、売上総額が$3,000,000を超える月をリストします。

次の文を実行します。

LIMIT month TO TOTAL(sales, month) GE 3000000
ROW W 40 'Months with total sales over $3,000,000: '-
   W 40 STATLIST(month, 40)

生成される出力は次のとおりです。

Months with total sales over $3,000,000: Jun95 TO Sep95, May96 TO Sep96

例8-110 SHOWによるステータス・リストの作成

次のSTATLIST文は、ディメンション値を20文字幅に書式設定します。

LIMIT month TO 'Jan95' 'Mar95' 'May95' 'Jul96' 'Sep96' 'Nov96'
SHOW STATLIST(month 20)

この文によって生成される出力は、次のとおりです。

Jan95, Mar95, May95,
Jul96, Sep96, Nov96

次の文は、ディメンションの位置をリストします。

SHOW STATLIST(month INTEGER 20)

出力は次のとおりです。

1, 3, 5, 19, 21, 23