List From 構文の節とオプション

Endevor
LIST FROM ステートメントについて、SCL ステートメントの節とオプションと共に説明します。
この SCL ステートメントには、以下の節とオプションがあります。
LIST ELEMENT
element-name
リストするエレメントを示します。必要な構文をコーディングし、適切なエレメント名を入力します。エレメント名に名前マスクを使用することもできます。
THROUGH (THRU)
element-name
LIST ELEMENT 節にコーディングされているエレメントから始まり、このステートメントで指定されているエレメントまでの範囲のエレメントをリストすることを示します。エレメント名には名前マスクを使用できます。THROUGH 節をコーディングする場合、(TO 節に) メンバ名を入力することはできません。
FROM ENVIRONMENT
env-name
SYSTEM
system-name
SUBSYSTEM
subs-name
TYPE
type-name
STAGE
stage-id
STAGE NUMBER
stage-no
FROM 節は、リストされるエレメントのロケーションを示します。
Endevor
は、アクション内の FROM 節と先行する SET FROM 節を使用して、そのアクションの「from」条件を決定します。
  • アクション内の FROM 節は、そのアクションに先行する SET FROM 節の値を上書きします。
  • SET FROM 節に FROM 節に含まれていない値が含まれている場合、
    Endevor
    はそれらの値を使用します。
環境、システム、サブシステム、タイプ、ステージを指定する必要があります。環境名は明示的に指定する必要があります。名前マスクは、システム、サブシステム、タイプ、およびステージで使用できます。ステージの指定には、以下のいずれかを使用できます。
  • STAGE ID - 英数字のステージ識別子を 1 つ入力します。
  • STAGE NUMBER -
    1
    または
    2
    を入力します。
TO
TO 節は、エレメントがリストされる場所を示します。
Endevor
は、アクション内の TO 節と先行する SET TO 節を使用して、そのアクションの「to」条件を決定します。
  • アクション内の TO 節は、そのアクションに先行する SET TO 節の値を上書きします。
  • SET TO 節に TO 節に含まれていない値が含まれている場合、
    Endevor
    はそれらの値を使用します。
TO SYSOUT-
SYSOUT はデフォルトの TO ロケーションです。TO 節を指定せず、SET TO 情報がコーディングされていない場合、
Endevor
は実行レポートにアクション カードを書き込みます。実行レポートは、LIST 要求の直後に表示され、編集できません。
TO FILE (DDNAME)
dd-name
または DSNAME
dataset- name
ファイル名 (DDname) またはデータ セット名を指定することにより、実行レポートと外部データ セットにアクション カードを書き込むよう
Endevor
に指示します。FILE または DDNAME を入力する場合は、適切な JCL をコーディングします。このオプションは、アクション カードを編集する場合に使用します。
TO MEMBER
member-name
メンバ名を入力します。この節は、順次ファイルを指定しない場合にのみ有効です。
  • TO SYSOUT オプションをコーディングした場合、
    Endevor
    はメンバ指定を無視します。
  • 順次のファイル (DDname) またはデータ セット名を使用してメンバ名をコーディングすると、アクションは失敗します。
PDS を使用していて、メンバ名を指定しない場合、
Endevor
によって TEMPNAME という一時名が割り当てられます。一時的な命名機能を使用する場合は、同じ外部データ セットに複数のリスト要求をコーディングしないでください。
PDS を使用していて、1 つの SET ステートメントに 1 つのメンバ名のみを含む複数の List ステートメントがある場合、すべてのリストが同じメンバ名になり、最初の LIST 結果のみが使用可能になります。
WHERE
WHERE 節を使用して、エレメントの選択条件をさらに限定します。
Endevor
は、アクション内の WHERE 節と先行する SET WHERE 節を使用して、そのアクションの「where」条件を決定します。
  • アクション内の WHERE 節は、そのアクションに先行する SET WHERE 節の値を上書きします。
  • SET WHERE 節に WHERE 節に含まれていない値が含まれている場合、
    Endevor
    はそれらの値を使用します。
WHERE CCID OF
ccid
指定された CCID のいずれかに一致するエレメントにリストを制限します。このフィールドでは名前マスクを使用できます。
CURRENT
MCF (マスタ制御ファイル) の CCID フィールドを検索して、指定された CCID を見つけるように
Endevor
に指示します。デフォルト。
ALL
マスタ制御ファイルと SOURCE DELTA レベルを検索して、指定された CCID を見つけるように
Endevor
に指示します。ACM がある場合、
Endevor
は COMPONENT LIST DELTA レベルも検索して、指定された CCID を見つけます。エレメントがソースなしの場合、エレメントのソース ファイルとデルタ ファイルが存在しないため、ソース エレメントのデルタ レベル CCID チェックは実行されません。
RETRIEVE
マスタ制御ファイルの RETRIEVE CCID フィールド内の CCID を使用するように
Endevor
に指示します。
複数の CCID で識別されるエレメントを選択するには、CCID をかっこで囲み、カンマで区切って複数の CCID を指定できます。CCID は、必要に応じて複数行に拡張できます。
以下の例は、この節の使用方法を示しています。
Example 1: WHERE CCID OF CURRENT (PROJ001, PROJ002, PROJ004) Example 2: WHERE CCID OF ALL (PROJ00V)
WHERE GENERATE
エレメントが生成された日付と、オプションで時刻 (任意) に基づいてエレメントを選択できます。
WHERE GENERATE FAILED-
Generate プロセッサが失敗したエレメントのみをリストするように
Endevor
に指示します。
WHERE GENERATE DATE
mm/dd/yy
[TIME
hh:mm
]-
この日付、およびタイムスタンプ (任意) のエレメントのみをリストするように
Endevor
に指示します。
WHERE GENERATE FROM DATE
mm/dd/yy
[TIME
hh:mm
] -
指定された日付、およびタイムスタンプ (任意) 以降のすべてのエレメントをリストするように
Endevor
に指示します。
WHERE GENERATE THROUGH DATE
mm/dd/yy
[TIME
hh:mm
]-
指定された日付、およびタイムスタンプ (任意) 以前のすべてのエレメントをリストするように
Endevor
に指示します。
WHERE GENERATE FROM DATE
mm/dd/yy
[TIME
hh:mm
] THROUGH DATE
mm/dd/yy
[TIME
hh:mm
]-
指定された範囲内の日付、およびタイムスタンプ (任意) のエレメントのみをリストするように
Endevor
に指示します。時刻を入力する場合は、日付も一緒に入力します。
WHERE TEXT
text spec
-
指定された 1 ~ 70 文字のテキスト文字列を 1 つ以上含む (または含まない) エレメントのみにリストを制限します。すべての「WHERE TEXT」フィルタは、ソースなしエレメントではバイパスされます。以下に例を示します。
  • この例では、
    Endevor
    はテキスト文字列 WO9-LINKAGE を含むすべてのエレメントをリストします。
    WHERE TEXT 'WO9-LINKAGE'
  • この例では、
    Endevor
    はエレメント ソースの列 8 ~ 40 の間にテキスト文字列 COPY COPY005 と COPY COPY010 を含むすべてのエレメントをリストします。
    WHERE TEXT ((EQ 'COPY COPY005' COLUMN 8 40) AND EQ 'COPY COPY010' COLUMN 8 40))
  • この例では、
    Endevor
    はエレメント ソースの列 8 ~ 15 の間にテキスト文字列 REMARKS を含まないすべてのエレメントをリストします。
    WHERE TEXT DOES NOT CONTAIN 'REMARKS' COLUMN 8 15
  • この例では、
    Endevor
    はテキスト文字列 M605SUB または M607SUB を含み、テキスト文字列 M606SUB を含まないすべてのエレメントをリストします。
    WHERE TEXT (('M605SUB' OR 'M607SUB') AND DOES NOT CONTAIN 'M606SUB')
WHERE TEXT EQUAL 節は、WHERE ACM 節と一緒に使用することはできません。
WHERE [ACM]
comp spec
-
指定されたコンポーネント名を含むコンポーネント リストにリストを制限します。ワイルドカードをコンポーネント名の指定に使用できます。
WHERE INPUT COMPONENT
これがデフォルトです。エントリに一致する入力コンポーネントと関連入力コンポーネントをリストするように
Endevor
に指示します。
WHERE RELATED INPUT COMPONENT
エントリに一致する関連入力コンポーネントのみをリストするように
Endevor
に指示します。
WHERE OUTPUT COMPONENT
条件に一致する出力コンポーネントおよび関連出力コンポーネントをリストするように
Endevor
に指示します。
WHERE RELATED OUTPUT COMPONENT
エントリに一致する関連出力コンポーネントのみをリストするように
Endevor
に指示します。
WHERE PROCESSOR COMPONENT
条件に一致するプロセッサ コンポーネントのみをリストするように
Endevor
に指示します。
WHERE ALL COMPONENT
3 種類のすべてのコンポーネント内の一致をリストするように
Endevor
に指示します。
WHERE RELATED OBJECT COMPONENT-
エントリに一致するオブジェクトのみをリストするように
Endevor
に指示します。
WHERE RELATED COMMENT COMPONENT
エントリに一致するコメントをリストするように
Endevor
に指示します。この値は、プロセッサ ステップで CONRELE ユーティリティによってコンポーネント リストに追加されたコメントにのみ適用されます。
以下の節を使用すると、コンポーネントをさらに指定できます。
THROUGH (THRU)
comp-name
コンポーネント名の特定の範囲に含まれるエレメントをリストするように
Endevor
に指示します。この範囲には、WHERE COMPONENTS 節にコーディングされたコンポーネント名から始まり、この節で指定されるコンポーネントまでのすべてのコンポーネントが含まれます。ワイルドカードをコンポーネント名の指定に使用できます。
ENVIRONMENT
env name
指定された環境にあるコンポーネントを含むエレメントをリストするように
Endevor
に指示します。環境名を指定する場合は、以下も指定する必要があります。
SYSTEM-1 to 8 characters SUBSYSTEM-1 to 8 characters TYPE-1 to 8 characters STAGE NUMBER-either
1
or
2
VERSION
version
特定のバージョン番号のコンポーネントを含むエレメントをリストするように
Endevor
に指示します。指定可能な値は 00 ~ 99 です。コンポーネントのバージョン番号は、関連付けられているエレメントのバージョン番号と異なる場合があります。
LEVEL
level
-
特定のレベル番号のコンポーネントを含むエレメントをリストするように
Endevor
に指示します。指定可能な値は 00 ~ 99 です。コンポーネントのレベル番号は、関連付けられているエレメントのレベル番号と異なる場合があります。
FILE (DDNAME)
dd-name
-
以下の条件のエレメントをリストするように
Endevor
に指示します。
入力コンポーネントは、指定された DDname から生成されています。
出力コンポーネントは、指定された DDname に書き込まれています。
コンポーネントは、指定の DDname によって指定され、関連付けられたプロセッサ ステップによって生成されています。
DSNAME data set name-
以下の条件のエレメントをリストするように
Endevor
に指示します。
入力コンポーネントは、指定されたデータ セットから生成されています。
出力コンポーネントは、指定されたデータ セットに書き込まれています。
コンポーネントは、指定のデータ セットによって指定され、関連付けられたプロセッサ ステップによって生成されています。
WHERE ACM comp spec {AND/OR} comp spec
複合コンポーネントの選択条件を指定できます。オプションの説明については、前のセクションを参照してください。WHERE ACM 節は、WHERE TEXT 節と一緒に使用することはできません。
WHERE PROCESSOR GROUP グループ名
この節を使用すると、指定されたプロセッサ グループに従ってエレメントを選択できます。プロセッサ グループ名を指定している場合は、名前マスクを使用できます。
複数のプロセッサ グループで識別されるエレメントを選択するには、プロセッサ グループをかっこで囲み、カンマで区切ることで、複数の異なるプロセッサ グループ セレクタを指定します。プロセッサ グループは、必要に応じて複数行に拡張できます。
以下の例は、この節の使用方法を示しています。
Example 1: WHERE PROCESSOR GROUP (COBVS, COBII) Example 2: WHERE PROCESSOR GROUP (COBV)
BUILD
LIST によって生成された各アクション ステートメントに適用される特定の情報を示します。この節のデータは、LIST 要求の結果として生じる SCL ステートメントの作成に役立ちます (WITH COMPONENTS を入力すると、追加の SCL ステートメントが作成されます)。LIST を使用してコピーバック付きの生成要求を作成することはできません。これは、エレメントが FROM ステージに存在する場合にのみ、LIST でそのエレメントのアクションを作成できるためです。
BUILD 情報を入力しない場合、
Endevor
によって、適切な情報が含まれている SET BUILD 節が検索されます。SET BUILD 節がコーディングされていない場合、BUILD ACTION のデフォルトは &&ACTION になり、BUILD LEVEL のデフォルトは CURRENT になります。
WITH COMPONENTS 節は、BUILD 節内ではオプションです。ここでも SET BUILD ステートメントでも指定されていない場合、コンポーネント情報はリストに表示されません。
BUILD ACTION
指定されたエレメントの LIST アクション構文に表示されるアクションを決定します。特定のアクション名を入力します。または、後でこのエレメントに対して特定のアクションが指定されることを示す &&ACTION を入力します。このアクションは、手動で入力することも、SET ACTION ステートメントを使用して入力することもできます。
BUILD LEVEL
指定したエレメントのバージョンおよびレベルを LIST 要求で生成されたアクション カードに表示するかどうかを示します。
CURRENT
エレメントの現在のバージョンとレベルを LIST アクションに含めるように
Endevor
に指示します。これは、アクションに対して WHERE COMPONENTS SPEC 節がコーディングされていない場合、またはコンポーネント リストが存在しない場合 (
Endevor
ACM がインストールされていない場合) のデフォルトです。アクションに対して WHERE COMPONENTS SPEC 節がコーディングされている場合、デフォルトは ACTUAL です。
NONE
エレメントの現在のバージョンとレベルをリストしないように
Endevor
に指示します。
ACTUAL
ACM 情報を使用して作成する場合、マスタ制御ファイルに記録されているエレメントの現在のレベルではなく、LIST アクション ステートメントのコンポーネント リストに記録されているコンポーネントのレベルを含めるように
Endevor
に指示します。これは、アクションに対して WHERE COMPONENTS SPEC 節がコーディングされている場合のデフォルトです。
ソース レベルから作成する場合は、WHERE 節に一致するソース レベルの VERSION と LEVEL を使用してアクション ステートメントを作成してください。
BUILD WITH COMPONENTS
指定したエレメントに関連付けられたすべての入力コンポーネントごとにアクション カードを生成する必要があることを示します。BUILD WITH COMPONENTS は
Endevor
ACM 製品にのみ関連し、WHERE ACM 節 (このセクションで前述) と一緒に使用する必要があります。
OPTIONS
アクション要求をさらに指定できます。
REPLACE MEMBER
TO 節に PDS およびメンバ名を指定すると、そのメンバが存在する場合、リスト要求は失敗します。TO ロケーション ライブラリ内の既存のメンバを置き換える場合は、REPLACE MEMBER オプションを使用します。
DETAIL REPORT
デフォルトでは、実行レポートには、指定した選択条件に一致するエレメントのみが
Endevor
によってリストされます。DETAIL REPORT オプションを選択すると、一致が見つかったかどうかにかかわらず、検索されたすべてのエレメントがレポートにリストされます。
SHOW TEXT [ PLUS
n
LINES ]
指定されたテキスト文字列を含むソース コードの行と、そのテキスト文字列の前後の指定された数のコードの行をプリントできます。
SHOW TEXT オプションを使用する場合は、WHERE TEXT 節をコーディングします。そうしないと、構文エラーが発生します。
SEARCH または NOSEARCH
マップ上のエレメントのすべてのオカレンスを検索してリストするように
Endevor
に指示します。デフォルトは NOSEARCH です。NOSEARCH をコーディングすると、
Endevor
のリストが現在の環境に制限されます。