STATUS

STATUSプログラムは、1つ以上のディメンション、ディメンション・サロゲートまたは値セットのステータス、あるいはアナリティック・ワークスペースのすべてのディメンションのステータスを現行の出力ファイルに送信するプログラムです。

1つ以上のディメンション、ディメンション・サロゲート、値セット名を指定する場合、Oracle OLAPはそれらのオブジェクトのみのステータスを生成します。AWキーワードを使用してアタッチされているアナリティック・ワークスペースの名前を指定すると、Oracle OLAPはそのアナリティック・ワークスペースのすべてのディメンションのステータスを生成します。引数を指定しない場合、STATUSは、現行アナリティック・ワークスペースにあるすべてのディメンション(ディメンション・サロゲートおよび値セットではない)の現行のステータスを生成します。ただし、STATUSは、STATUS NAMEを指定しないかぎり、NAMEディメンションのステータスを表示しません。

ヒント:

表示する幅または位置を制御する場合は、STATUSではなくSTATLISTを使用します。

戻り値

TEXT

構文

STATUS name... | AW [workspace-name]

パラメータ

name: アナリティック・ワークスペースのディメンションまたは値セットの名前。変数、計算式、リレーション、名前付きコンポジットなど、ディメンション化されたアナリティック・ワークスペース・オブジェクトの名前を指定することもできます。この場合、ディメンションが名前のないコンポジットに含まれないかぎり、nameの各ディメンションのステータスが生成されます。
AW [workspace-name]: workspace-nameに含まれるすべてのディメンションのステータスをSTATUSが生成するように指定します。workspace-nameは、アナリティック・ワークスペースの名前です。

使用上の注意

STATUSの出力

ディメンションのすべての値が現行のステータスまたは値セットに元の順序で存在する場合、STATUSはALLを表示します。元の順序で3つ以上の値が並んでいる場合、STATUSはvalue-1 TO value-nのように省略します。ただし、NAMEディメンションの場合、STATUSは3つ以上の値が並んでいても省略しません。

オブジェクトに値がない場合のSTATUS

ディメンション、ディメンション・サロゲートまたは値セットに値がない場合(たとえば、定義したばかりのオブジェクトでまだ値を入力していないなど)、STATUSはそのディメンション、ディメンション・サロゲートまたは値セットに対してNULLを返します。オブジェクトが定義されていないアナリティック・ワークスペースの場合、STATUSは「There are no dimensions in your current analytic workspace.」というメッセージを返します。

例

例10-150 ディメンションの現行のステータスの検出

STATUSを使用して、ディメンションmonthおよびdistrictの現行のステータスを生成します。

次の文

STATUS month district

によって、次の出力が生成されます。

The current status of MONTH is:
Jan95 TO Dec96
The current status of DISTRICT is:
Boston, Chicago, Denver

例10-151 変数のディメンションのステータスの検出

STATUSを使用して、変数salesのすべてのディメンションの現行のステータスを生成します。

次の文

STATUS sales

によって、次の出力が生成されます。

The current status of MONTH is:
Jan95 TO Dec96
The current status of PRODUCT is:
ALL
The current status of DISTRICT is:
Boston, Chicago, Denver