STATUSプログラムは、1つ以上のディメンション、ディメンション・サロゲートまたは値セットのステータス、あるいはアナリティック・ワークスペースのすべてのディメンションのステータスを現行の出力ファイルに送信するプログラムです。
1つ以上のディメンション、ディメンション・サロゲート、値セット名を指定する場合、Oracle OLAPはそれらのオブジェクトのみのステータスを生成します。AWキーワードを使用してアタッチされているアナリティック・ワークスペースの名前を指定すると、Oracle OLAPはそのアナリティック・ワークスペースのすべてのディメンションのステータスを生成します。引数を指定しない場合、STATUSは、現行アナリティック・ワークスペースにあるすべてのディメンション(ディメンション・サロゲートおよび値セットではない)の現行のステータスを生成します。ただし、STATUSは、STATUS
NAME
を指定しないかぎり、NAMEディメンションのステータスを表示しません。
ヒント: 表示する幅または位置を制御する場合は、STATUSではなくSTATLISTを使用します。 |
戻り値
TEXT
構文
STATUS name...| AW [workspace-name]
引数
アナリティック・ワークスペースのディメンションまたは値セットの名前。変数、計算式、リレーション、名前付きコンポジットなど、ディメンション化されたアナリティック・ワークスペース・オブジェクトの名前を指定することもできます。この場合、ディメンションが名前のないコンポジットに含まれないかぎり、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
.」というメッセージを返します。
例