LISTNAMESプログラムは、アナリティック・ワークスペース内のオブジェクトの名前をリストするレポートを生成するプログラムです。リストの対象を特定の型のオブジェクトに制限し、各オブジェクト型の名前をアルファベット順にリストできます。
パラメータ
リストする対象のオブジェクトがあるアタッチしたワークスペースの名前を指定します。ワークスペース名を指定しない場合、LISTNAMESは現行のワークスペースのオブジェクトをリストします。アナリティック・ワークスペース名のかわりに'*'
(アスタリスク)を引数として使用すると、アタッチした各ワークスペースのレポートが個別に生成されます。
名前をリストする1つ以上のオブジェクトの型(AGGMAP、COMPOSITE、DIMENSION、FORMULA、MODEL、OPTION、PROGRAM、RELATION、VALUESET、VARIABLEおよびWORKSHEET)を指定します。どのオブジェクト型でも、DIMENSIONS
などのように、末尾にSを付加できます。これらのオブジェクト型の順序は任意に指定できます。ALL(デフォルト)を指定すると、これらすべての型のオブジェクトの名前がリストされます。
SORTED(デフォルト、省略形はSORT)を指定すると、オブジェクト名がアルファベット順にソートされます。UNSORTED(省略形はUNSORT)を指定すると、オブジェクト名はアルファベット順にソートされません。
アナリティック・ワークスペースの定義の名前と指定したテキスト・パターンを比較して、一致する名前をリストします。対応する文字が一致すると、定義名はテキスト・パターンに類似していると判断されます。リテラルな一致に加えて、LIKEでは文字列の複数の文字に一致するワイルドカード文字を使用できます。パターン内のアンダースコア(_
)文字は、任意の1文字に一致します。パターン内のパーセント(%
)記号は、任意の数(ゼロ個も含む)の文字に一致します。
使用上の注意
NAMEディメンション
NAMEは、アナリティック・ワークスペース内のオブジェクトのリストの編成に使用される特殊なディメンションです。この値は、現行のワークスペースに定義されているオブジェクトの名前です。
NAMEディメンションの値は明示的に変更できません。この値を変更するには、DEFINE、DELETE、MOVEまたはRENAMEのいずれかの文を実行します。また、現行のワークスペース以外のアナリティック・ワークスペースのNAMEディメンションを指定するために修飾オブジェクト名を使用することはできません。
例10-33 ディメンションのリスト表示
アナリティック・ワークスペースのすべてのディメンションをリスト表示するとします。最初に、LIMITコマンドおよびOBJファンクションを使用して、NAMEディメンションのステータスを制限します。次に、STATUS文を使用して、ディメンションのリストを生成します。OBJ(TYPE)
によって返される値は常に大文字なので、それに合せるためにLIMIT文に'dimension'
ではなく'DIMENSION'
を使用する必要があります。次の文
LIMIT NAME TO OBJ(TYPE) EQ 'DIMENSION' STATUS NAME
によって、次の出力が生成されます。
The current status of NAME is: PRODUCT, DISTRICT, DIVISION, LINE, REGION, MARKETLEVEL, MARKET, MONTH, YEAR, QUARTER
例10-34 リレーションのリスト表示
アナリティック・ワークスペースのすべてのリレーションの定義を参照するとします。LIMITコマンドおよびOBJファンクションを使用して、その名前を選択します。次に、DESCRIBEコマンドを使用して、その定義のリストを生成します。次の文
LIMIT NAME TO OBJ(TYPE) EQ 'RELATION' DESCRIBE
によって、次の出力が生成されます。
DEFINE REGION.DISTRICT RELATION REGION <DISTRICT> LD REGION for each DISTRICT DEFINE DIVISION.PRODUCT RELATION DIVISION <PRODUCT> LD DIVISION for each PRODUCT DEFINE MLV.MARKET RELATION MARKETLEVEL <MARKET> DEFINE MARKET.MARKET RELATION MARKET <MARKET> LD Self-relation for the Market Dimension
例
例10-35 DEMOワークスペース・オブジェクトのリスト
この例では、現行のワークスペースのディメンション、変数およびリレーションをリストします。次の文
LISTNAMES dimension variable relation
DEMOワークスペースに関する次の出力が生成されます。
10 DIMENSIONs 18 VARIABLEs 4 RELATIONs ---------------- ---------------- ---------------- DISTRICT ACTUAL DIVISION.PRODUCT DIVISION ADVERTISING MARKET.MARKET LINE BUDGET MLV.MARKET MARKET DEMOVER REGION.DISTRICT MARKETLEVEL EXPENSE MONTH FCST PRODUCT INDUSTRY.SALES QUARTER NAME.LINE REGION NAME.PRODUCT YEAR NATIONAL.SALES PRICE PRODUCT.MEMO SALES SALES.FORECAST SALES.PLAN SHARE UNITS UNITS.M