Print Element 構文の節とオプション

Endevor
PRINT ELEMENT ステートメントの節とオプションについて説明します。
この SCL ステートメントには、以下の節とオプションがあります。
PRINT ELEMENT
element-name
プリントするエレメントの名前を最大 10 文字で指定します。名前マスクは、(LEVEL 節で) レベルを指定しない限り使用できます。
THROUGH (THRU)
element-name
PRINT ELEMENT ステートメントにコーディングされているエレメントから始まり、このステートメントで指定されているエレメントまでの範囲のエレメントをプリントする必要があることを示します。どちらの名前にも名前マスクを使用できます。THROUGH 節を入力する場合、LEVEL 節は入力できません。
VERSION version LEVEL
level
プリントするバージョンとレベル番号を示します。バージョン レベルを指定する場合は、完全なエレメント名をコーディングします。指定可能なバージョン番号は、
1 ~ 99
です。指定可能なレベル番号は、
00 ~ 99
です。デフォルトでは、現在のバージョン レベルの情報がプリントされます。VERSION および LEVEL を同時に指定する必要があります。この節を入力する場合、THROUGH 節は入力できません。
FROM ENVIRONMENT
env-name
SYSTEM
sys-name
SUBSYSTEM
subsys-name
TYPE
type-name
STAGE
stage-no
FROM 節は、プリントされるエレメントのロケーションを示します。
Endevor
は、アクション内の FROM 節と先行する SET FROM 節を使用して、そのアクションの「from」条件を決定します。
  • アクション内の FROM 節は、そのアクションに先行する SET FROM 節の値を上書きします。
  • SET FROM 節に FROM 節に含まれていない値が含まれている場合、
    Endevor
    はそれらの値を使用します。
SET FROM ステートメントの詳細については、「SCL ステートメント」を参照してください。
環境、システム、サブシステム、タイプ、およびステージ番号 (
1
または
2
) を指定する必要があります。環境名は明示的に指定する必要があります。名前マスクは、システム、サブシステム、タイプ、およびステージ番号で使用できます。
TO C1PRINT | C1PRTVB | FILE
dd-name
| DDNAME
dd-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
      をコーディングします。
  • C1PRTVB
    121 文字を超えるレコードを持つエレメントを
    内部
    プリント キューまたはファイルにプリントします。事前に 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)
  • FILE
    dd-name
    | DDNAME
    dd-name
    Endevor
    外部
    のロケーション (ライブラリ、順次ファイル、または 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 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 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 キーワードを使用するには、
Endevor
Automated Configuration
オプションが必要です。
Endevor
はコンポーネント リストに使用可能な限り多くの情報をプリントします。たとえば、COMPONENTS CHANGES を記述したが、出力コンポーネント セクションに変更がない場合、そのセクションは関連リストに表示されません。
この節には、以下のオプションを 1 つのみ指定できます。BROWSE がデフォルトです。
BROWSE
各行が追加されたレベルを示す、現在のエレメントまたはコンポーネント リスト ソースをプリントします。特定のレベルを指定すると、
Endevor
は、そのレベルのソースをプリントします。デフォルトです。
CHANGES
指定したレベルでエレメントまたはコンポーネント リストに行われたすべての変更、挿入、および削除の内容がプリントされます。LEVEL 節でレベルを指定しない場合、現在のレベルのエレメントの変更内容が表示されます。
HISTORY
エレメントまたはコンポーネント リスト ソース内に存在していたすべての行をプリントし、その行が追加、変更、または削除されたレベルが付加されます。LEVEL 節にレベルを指定すると、
Endevor
はそのレベルの履歴をプリントします。
SUMMARY
指定したエレメントまたはコンポーネント リストの各レベルのデータのサマリ行をプリントします。そのレベルに対応する情報(挿入数や削除数など)が含まれます。
MASTER
選択したエレメントに保存されているマスタ制御ファイル情報と、そのエレメントまたはコンポーネントに関連する現在のデータである BROWSE データ (最後のプロセッサ、プロセッサのリターン コード、現在のバージョンまたはレベルなど) をプリントします。MASTER オプションを指定して COMPONENTS をコーディングすると、
Endevor
はエレメントの MASTER 情報とコンポーネントの BROWSE データをプリントします。
BROWSE、CHANGES、HISTORY、SUMMARY、および MASTER のプリント出力は、それらの対応するオンライン パネルと同じ情報を提供します。
エレメント BROWSE、CHANGE、HISTORY、および SUMMARY オプションは、ソースなしエレメントではサポートされていません。これらのオプションが検出されると、アクションはスキップされ、情報メッセージがアクション ログに書き込まれます。MASTER オプションは、ソース付きエレメントとソースなしエレメントの両方でサポートされています。
ELEMENT LISTING COMPONENT LIST TEXT STRING
text-string
エレメントに関連付けられた出力リストがプリントされます。
Endevor
Automated Configuration オプション
が必要です。キーワード ELEMENT の指定はオプションです。LISTING オプションのデフォルト値は、LIST です。デフォルト値を使用する場合は、COMPONENT LIST TEXT STRING text-string を指定
しない
でください。キーワード 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 の値を変更して、テキスト文字列を変更することもできます。
LISTING オプションをコーディングする場合、以下のオプションはコーディングしないでください。
  • 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 アクションは、他のアクションがタイプ シーケンス順で処理される前に、最初に処理されます。