List From 構文の節とオプション
Endevor
LIST FROM ステートメントについて、SCL ステートメントの節とオプションと共に説明します。この SCL ステートメントには、以下の節とオプションがあります。
- LIST ELEMENTelement-name
- リストするエレメントを示します。必要な構文をコーディングし、適切なエレメント名を入力します。エレメント名に名前マスクを使用することもできます。
- THROUGH (THRU)element-name
- LIST ELEMENT 節にコーディングされているエレメントから始まり、このステートメントで指定されているエレメントまでの範囲のエレメントをリストすることを示します。エレメント名には名前マスクを使用できます。THROUGH 節をコーディングする場合、(TO 節に) メンバ名を入力することはできません。
- FROM ENVIRONMENTenv-nameSYSTEMsystem-nameSUBSYSTEMsubs-nameTYPEtype-nameSTAGEstage-idSTAGE NUMBERstage-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または DSNAMEdataset- name
- ファイル名 (DDname) またはデータ セット名を指定することにより、実行レポートと外部データ セットにアクション カードを書き込むようEndevorに指示します。FILE または DDNAME を入力する場合は、適切な JCL をコーディングします。このオプションは、アクション カードを編集する場合に使用します。
- TO MEMBERmember-name
- メンバ名を入力します。この節は、順次ファイルを指定しない場合にのみ有効です。
- TO SYSOUT オプションをコーディングした場合、Endevorはメンバ指定を無視します。
- 順次のファイル (DDname) またはデータ セット名を使用してメンバ名をコーディングすると、アクションは失敗します。
Endevorによって TEMPNAME という一時名が割り当てられます。一時的な命名機能を使用する場合は、同じ外部データ セットに複数のリスト要求をコーディングしないでください。- PDS を使用していて、1 つの SET ステートメントに 1 つのメンバ名のみを含む複数の List ステートメントがある場合、すべてのリストが同じメンバ名になり、最初の LIST 結果のみが使用可能になります。
- WHERE
- WHERE 節を使用して、エレメントの選択条件をさらに限定します。Endevorは、アクション内の WHERE 節と先行する SET WHERE 節を使用して、そのアクションの「where」条件を決定します。
- アクション内の WHERE 節は、そのアクションに先行する SET WHERE 節の値を上書きします。
- SET WHERE 節に WHERE 節に含まれていない値が含まれている場合、Endevorはそれらの値を使用します。
- WHERE CCID OFccid
- 指定された 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 DATEmm/dd/yy[TIMEhh:mm]-
- この日付、およびタイムスタンプ (任意) のエレメントのみをリストするようにEndevorに指示します。
- WHERE GENERATE FROM DATEmm/dd/yy[TIMEhh:mm] -
- 指定された日付、およびタイムスタンプ (任意) 以降のすべてのエレメントをリストするようにEndevorに指示します。
- WHERE GENERATE THROUGH DATEmm/dd/yy[TIMEhh:mm]-
- 指定された日付、およびタイムスタンプ (任意) 以前のすべてのエレメントをリストするようにEndevorに指示します。
- WHERE GENERATE FROM DATEmm/dd/yy[TIMEhh:mm] THROUGH DATEmm/dd/yy[TIMEhh:mm]-
- 指定された範囲内の日付、およびタイムスタンプ (任意) のエレメントのみをリストするようにEndevorに指示します。時刻を入力する場合は、日付も一緒に入力します。
- WHERE TEXTtext 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 [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 節にコーディングされたコンポーネント名から始まり、この節で指定されるコンポーネントまでのすべてのコンポーネントが含まれます。ワイルドカードをコンポーネント名の指定に使用できます。
- ENVIRONMENTenv name
- 指定された環境にあるコンポーネントを含むエレメントをリストするようにEndevorに指示します。環境名を指定する場合は、以下も指定する必要があります。
- SYSTEM-1 to 8 characters SUBSYSTEM-1 to 8 characters TYPE-1 to 8 characters STAGE NUMBER-either1or2
- VERSIONversion
- 特定のバージョン番号のコンポーネントを含むエレメントをリストするようにEndevorに指示します。指定可能な値は 00 ~ 99 です。コンポーネントのバージョン番号は、関連付けられているエレメントのバージョン番号と異なる場合があります。
- LEVELlevel-
- 特定のレベル番号のコンポーネントを含むエレメントをリストするように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 節がコーディングされていない場合、またはコンポーネント リストが存在しない場合 (EndevorACM がインストールされていない場合) のデフォルトです。アクションに対して WHERE COMPONENTS SPEC 節がコーディングされている場合、デフォルトは ACTUAL です。
- NONE
- エレメントの現在のバージョンとレベルをリストしないようにEndevorに指示します。
- ACTUAL
- ACM 情報を使用して作成する場合、マスタ制御ファイルに記録されているエレメントの現在のレベルではなく、LIST アクション ステートメントのコンポーネント リストに記録されているコンポーネントのレベルを含めるようにEndevorに指示します。これは、アクションに対して WHERE COMPONENTS SPEC 節がコーディングされている場合のデフォルトです。
ソース レベルから作成する場合は、WHERE 節に一致するソース レベルの VERSION と LEVEL を使用してアクション ステートメントを作成してください。
- BUILD WITH COMPONENTS
- 指定したエレメントに関連付けられたすべての入力コンポーネントごとにアクション カードを生成する必要があることを示します。BUILD WITH COMPONENTS はEndevorACM 製品にのみ関連し、WHERE ACM 節 (このセクションで前述) と一緒に使用する必要があります。
- OPTIONS
- アクション要求をさらに指定できます。
- REPLACE MEMBER
- TO 節に PDS およびメンバ名を指定すると、そのメンバが存在する場合、リスト要求は失敗します。TO ロケーション ライブラリ内の既存のメンバを置き換える場合は、REPLACE MEMBER オプションを使用します。
- DETAIL REPORT
- デフォルトでは、実行レポートには、指定した選択条件に一致するエレメントのみがEndevorによってリストされます。DETAIL REPORT オプションを選択すると、一致が見つかったかどうかにかかわらず、検索されたすべてのエレメントがレポートにリストされます。
- SHOW TEXT [ PLUSnLINES ]
- 指定されたテキスト文字列を含むソース コードの行と、そのテキスト文字列の前後の指定された数のコードの行をプリントできます。
- SHOW TEXT オプションを使用する場合は、WHERE TEXT 節をコーディングします。そうしないと、構文エラーが発生します。
- SEARCH または NOSEARCH
- マップ上のエレメントのすべてのオカレンスを検索してリストするようにEndevorに指示します。デフォルトは NOSEARCH です。NOSEARCH をコーディングすると、Endevorのリストが現在の環境に制限されます。