Print Element 構文の節とオプション
Endevor
PRINT ELEMENT ステートメントの節とオプションについて説明します。この SCL ステートメントには、以下の節とオプションがあります。
- PRINT ELEMENTelement-name
- プリントするエレメントの名前を最大 10 文字で指定します。名前マスクは、(LEVEL 節で) レベルを指定しない限り使用できます。
- THROUGH (THRU)element-name
- PRINT ELEMENT ステートメントにコーディングされているエレメントから始まり、このステートメントで指定されているエレメントまでの範囲のエレメントをプリントする必要があることを示します。どちらの名前にも名前マスクを使用できます。THROUGH 節を入力する場合、LEVEL 節は入力できません。
- VERSION version LEVELlevel
- プリントするバージョンとレベル番号を示します。バージョン レベルを指定する場合は、完全なエレメント名をコーディングします。指定可能なバージョン番号は、1 ~ 99です。指定可能なレベル番号は、00 ~ 99です。デフォルトでは、現在のバージョン レベルの情報がプリントされます。VERSION および LEVEL を同時に指定する必要があります。この節を入力する場合、THROUGH 節は入力できません。
- FROM ENVIRONMENTenv-nameSYSTEMsys-nameSUBSYSTEMsubsys-nameTYPEtype-nameSTAGEstage-no
- FROM 節は、プリントされるエレメントのロケーションを示します。Endevorは、アクション内の FROM 節と先行する SET FROM 節を使用して、そのアクションの「from」条件を決定します。
- アクション内の FROM 節は、そのアクションに先行する SET FROM 節の値を上書きします。
- SET FROM 節に FROM 節に含まれていない値が含まれている場合、Endevorはそれらの値を使用します。
- SET FROM ステートメントの詳細については、「SCL ステートメント」を参照してください。
- 環境、システム、サブシステム、タイプ、およびステージ番号 (1または2) を指定する必要があります。環境名は明示的に指定する必要があります。名前マスクは、システム、サブシステム、タイプ、およびステージ番号で使用できます。
- TO C1PRINT | C1PRTVB | FILEdd-name| DDNAMEdd-name
- TO 節は、エレメントがプリントされる場所を示します。
- アクション内の TO 節は、そのアクションに先行する SET TO 節の値を上書きします。SET TO ステートメントの詳細については、「SET TO 構文」を参照してください。
- PRINT アクションの TO 節に情報を入力しない場合、先行する SET TO ステートメントの情報が使用されます。
- SET TO 節に TO 節に含まれていない値が含まれている場合、Endevorはそれらの値を使用します。
- PRINT アクションの TO 節に情報を入力せず、SET TO 節も入力しなかった場合、デフォルトは C1PRINT です。
- C1PRINT内部プリント キューまたはファイルにプリントします。C1PRINT には適切な JCL が必要です。121 文字を超えるレコードを含むエレメントをプリントする場合、C1PRINT を使用すると出力が切り捨てられる可能性があります。この問題を回避するには、C1PRTVB ddname を使用します。以下に例を示します。
- 出力をキューに送信するには、//C1PRINT DD SYSOUT=*を使用します。
- 出力を既存のファイルに送信するには、//C1PRINT DD DISP=SHR,DSN=をコーディングします。filename
- C1PRTVB121 文字を超えるレコードを持つエレメントを内部プリント キューまたはファイルにプリントします。事前に C1PRTVB データ セットを適切に割り当てておく必要があります。C1PRTVB の推奨 DCB は、LRECL=27994,BLKSIZE=0,RECFM=VB です。ただし、レコードのレコード サイズが 27978 より長い場合は、レコード長を長くしてください。出力ファイルに十分な長さの LRECL をコーディングする必要があります。LRECL サイズは、エレメントの最長レコードより少なくとも 16 バイト長くする必要があります。たとえば、以下のようにデータ セットを割り当てます。//C1PRTVB DD DISP=(,CATLG),DSN=my.C1PRTVB, // SPACE=(TRK,(5,5)),UNIT=SYSDA, // DCB=(RECFM=VB,LRECL=27994,BLKSIZE=0)
- FILEdd-name| DDNAMEdd-nameEndevorの外部のロケーション (ライブラリ、順次ファイル、または PDS など) にプリントします。ファイル名または DDname を入力するときは、適切な JCL がコーディングされていることを確認します。ddname 値は、必須の固定レコード形式と 133 の LRECL を持つ順次ファイルを指定できます。これらの指定が定義されていない場合、PRINT アクションは失敗します。121 文字を超えるレコードを含むエレメントをプリントする場合、このデータ セットを使用すると出力が切り捨てられる可能性があります。これを回避するには、C1PRTVB ddname を使用します。区分データ セット (PDS、PDS/E) も、DD ステートメント内にメンバ名をコーディングする必要があります。PDS ライブラリを使用している場合、1 つのジョブ ステップ内の同じ区分データ セットに使用できるメンバは 1 つだけです。PDS/E ライブラリの使用は制限されません。例: //PDSLIB DD DISP=SHR,DSN=PDS.LIBRARY(MEMBER)
- WHERE
- WHERE 節を使用して、エレメントの選択条件をさらに限定します。Endevorは、アクション内の WHERE 節と先行する SET WHERE 節を使用して、そのアクションの「where」条件を決定します。
- アクション内の WHERE 節は、そのアクションに先行する SET WHERE 節の値を上書きします。
- SET WHERE 節に WHERE 節に含まれていない値が含まれている場合、Endevorはそれらの値を使用します。
- SET WHERE ステートメントの詳細については、「SCL ステートメント」を参照してください。
- 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 PROCESSOR GROUPグループ名
- 指定されたプロセッサ グループに従ってエレメントを選択できます。プロセッサ グループ名を指定している場合は、名前マスクを使用できます。
- 複数のプロセッサ グループで識別されるエレメントを選択するには、プロセッサ グループをかっこで囲み、カンマで区切ることで、複数の異なるプロセッサ グループ セレクタを指定します。プロセッサ グループは、必要に応じて複数行に拡張できます。
- 以下の例は、この節の使用方法を示しています。
- Example 1: WHERE PROCESSOR GROUP (COBVS, COBII) Example 2: WHERE PROCESSOR GROUP (COBV
- OPTIONS
- アクション要求をさらに指定できます。
- NOCC
- 出力の各ページでヘッダのデフォルトのプリントを抑制します。PRINT ELEMENT MASTER の出力では、出力の 1 列目のその他の改行文字は空白スペースに置換されます。
- ELEMENT | COMPONENTS BROWSE | CHANGES | HISTORY | SUMMARY | MASTER
- エレメントまたはコンポーネント情報をプリントします。
- ELEMENT
- 指定したエレメントのすべての情報をプリントしますが、関連するコンポーネントはプリントしません。デフォルトです。
- COMPONENTS
- 指定したエレメントのすべてのコンポーネント情報をプリントします。COMPONENTS キーワードを使用するには、オプションが必要です。EndevorAutomated Configuration
- Endevorはコンポーネント リストに使用可能な限り多くの情報をプリントします。たとえば、COMPONENTS CHANGES を記述したが、出力コンポーネント セクションに変更がない場合、そのセクションは関連リストに表示されません。
- この節には、以下のオプションを 1 つのみ指定できます。BROWSE がデフォルトです。
- BROWSE
- 各行が追加されたレベルを示す、現在のエレメントまたはコンポーネント リスト ソースをプリントします。特定のレベルを指定すると、Endevorは、そのレベルのソースをプリントします。デフォルトです。
- CHANGES
- 指定したレベルでエレメントまたはコンポーネント リストに行われたすべての変更、挿入、および削除の内容がプリントされます。LEVEL 節でレベルを指定しない場合、現在のレベルのエレメントの変更内容が表示されます。
- HISTORY
- エレメントまたはコンポーネント リスト ソース内に存在していたすべての行をプリントし、その行が追加、変更、または削除されたレベルが付加されます。LEVEL 節にレベルを指定すると、Endevorはそのレベルの履歴をプリントします。
- SUMMARY
- 指定したエレメントまたはコンポーネント リストの各レベルのデータのサマリ行をプリントします。そのレベルに対応する情報(挿入数や削除数など)が含まれます。
- MASTER
- 選択したエレメントに保存されているマスタ制御ファイル情報と、そのエレメントまたはコンポーネントに関連する現在のデータである BROWSE データ (最後のプロセッサ、プロセッサのリターン コード、現在のバージョンまたはレベルなど) をプリントします。MASTER オプションを指定して COMPONENTS をコーディングすると、Endevorはエレメントの MASTER 情報とコンポーネントの BROWSE データをプリントします。
- エレメント BROWSE、CHANGE、HISTORY、および SUMMARY オプションは、ソースなしエレメントではサポートされていません。これらのオプションが検出されると、アクションはスキップされ、情報メッセージがアクション ログに書き込まれます。MASTER オプションは、ソース付きエレメントとソースなしエレメントの両方でサポートされています。
- ELEMENT LISTING COMPONENT LIST TEXT STRINGtext-string
- エレメントに関連付けられた出力リストがプリントされます。が必要です。キーワード ELEMENT の指定はオプションです。LISTING オプションのデフォルト値は、LIST です。デフォルト値を使用する場合は、COMPONENT LIST TEXT STRING text-string を指定EndevorAutomated Configuration オプションしないでください。キーワード COMPONENT LIST TEXT STRING を使用してテキスト文字列を指定するか、サイト全体のコンポーネント リストの文字列 ID を定義する C1DEFLTS パラメータ COMPLISTWD= を変更して、デフォルトを上書きできます。
- COMPONENT LIST TEXT STRINGテキスト文字列
- プリントするリスト データ セットを識別するために使用される 1 ~ 8 文字のテキスト文字列を指定します。
- プリントされる出力リスト ファイルを識別するために、LISTING オプション値は、すべてのコンポーネント出力データ セットの内容と照合されます。出力リスト ライブラリを検索するために、すべてのコンポーネント出力データ セットで特定の文字列が検索されます。この文字列を含む最初に見つかったデータ セットが、ターゲット リスト データ セットになります。すべてのコンポーネント出力データ セットは、以下の順序で一致が検索されます。
- COMPONENT LIST TEXT STRING キーワードで指定するテキスト文字列。このオプションを使用しなかった場合、または文字列が見つからない場合は、
- C1DEFLTS テーブル内の COMPLISTWD= パラメータ。このパラメータのデフォルト値は LIST です。デフォルト値は C1DEFLTS テーブルで変更できます。また、ユーザ デフォルト パネルで LISTING DATASET STRING の値を変更して、テキスト文字列を変更することもできます。
- NOCC -- NOCC をコーディングすると、構文エラーが発生します。
- COMPONENTS
- BROWSE
- CHANGE
- HISTORY
- SUMMARY
- MASTER
- SEARCH または NOSEARCH
- SEARCH オプションは、Endevorにマップ上のエレメントのすべてのオカレンスを検索してプリントするように指示します。
- NOSEARCH をコーディングすると、Endevorの検索を現在の環境に制限します。
- デフォルト:NOSEARCH。
- ALL または FIRST
- Endevorが SEARCH オプションを使用して見つけたエレメントのすべてのオカレンスをプリントするか、そのエレメントの最初のオカレンスのみをプリントするかを指定します。
- デフォルト:ALL
- EXPLODE
- 指定されたエレメントの ACMQ ファイル(ACMROOT および ACMXREF)から抽出される入力コンポーネント情報をプリントします。
- Explode を指定すると、エレメントの Print アクションが実行するリストの一番上にジャンプします。したがって、Explode オプションを使用する Print アクションは、他のアクションがタイプ シーケンス順で処理される前に、最初に処理されます。