STATLISTファンクションは、ディメンションまたはディメンション・サロゲートの現行のステータス・リストの全値のリスト、あるいは値セットの全値のリストを返します。リストは、指定された幅に書式設定できます。STATLISTファンクションを採用しているSTATUSコマンドでは、ディメンションのステータスがまとめて表示されます。表示する幅または位置を制御する場合は、STATUSではなくSTATLISTを使用します。
戻り値
STATLISTは、ディメンション値またはディメンション・サロゲート値自体(たとえば、Jan95
)、あるいはデフォルトのステータス・リストでの値の位置を示す数値(たとえば、6
)のいずれかを含むTEXT値のリストを返します。
戻り値は、Jan96
TO
Jun96
などのように、value TO valueという形式になります。デフォルトのステータスが有効の場合は、ALL
が表示されます。現行のステータス・リストまたは値セットが空の場合は、NULL
が表示されます。
パラメータ
値がディメンション、ディメンション・サロゲートまたは値セットの名前であるテキスト式。
表8-14「STATLISTのキーワード」に示すキーワード。このキーワードによって、現行のステータス・リストの値を表示する形式を指定できます。
リストの幅を文字数で指定するINTEGER
式(オプション)。幅を指定しない場合、STATLISTではLSIZEオプションの現行の値が使用されます。LSIZEのデフォルト値は80
です。
例
例8-111 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-112 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