トレース・ファイル名の形式

APPLTRACEFILENAME キーワード設定を指定するには、JCL DD ステートメント形式または z/OS® UNIX 環境の HFS 形式のいずれかを使用できます。

トレース・ファイル名の JCL DD ステートメント形式

JCL DD ステートメント形式は、主に、z/OS 事前割り振り順次データ・セットへ 書き込む場合に使用します。

DD ステートメントに z/OS UNIX HFS ファイルを指定することも できます。JCL DD ステートメント形式は、APPLTRACEFILENAME="DD:ddname" です。ddname 値は、ジョブまたは TSO ログオン・プロシージャーで指定される DD ステートメントの名前です。

例: キーワードの設定値が APPLTRACEFILENAME="DD:APPLDD" で あると仮定します。 ジョブまたは TSO ログオン・プロシージャーで、次の JCL DD ステートメントを 使用して、z/OS トレース・データ・セットを指定できます。

  • 事前割り振り順次データ・セット USER01.MYTRACE へ書き込みます。
    //APPLDD   DD      DISP=SHR,DSN=USER01.MYTRACE
  • ディレクトリー /usr/db2 の UNIX HFS ファイル MYTRACE へ書き込みます。
    //APPLDD        DD      PATH='/usr/db2/MYTRACE'
  • ファイル所有者がトレース・ファイルを読み取り (SIRUSR)、トレース・ファイルに書き込む (SIWUSR) 許可 を指定して、ディレクトリー /usr/db2 に UNIX HFS ファイル MYTRACE を割り振る場合の DD ステートメント は以下のとおりです。
    //APPLDD     DD  PATH='/usr/db2/MYTRACE',
                 PATHOPTS=(ORDWR,OCREAT,OTRUNC),
                 PATHMODE=(SIRUSR,SIWUSR)

トレース・ファイル名の z/OS UNIX 環境の HFS 形式

z/OS UNIX 環境の HFS 形式は、HFS ファイルに書き込む場合にのみ使用されます。

z/OS UNIX HFS ファイル名の形式は、APPLTRACEFILENAME=hfs_filename です。hfs_filename 値には、HFS ファイルのパスとファイル名を指定し ます。HFS ファイルは、事前割り振りする必要はありません。 指定されたディレクトリーにファイル名が存在しない場合は、そのファイルが動的に割り振られます。

例 次のステートメントは、APPLTRACEFILENAME キーワードを 使用して、z/OS UNIX 環境 HFS トレース・ファイルを指定します。

  • 完全修飾ディレクトリー /usr/db2 に APPLTRC1 という名前の HFS ファイルを作成して、 そこに書き込みます。
    APPLTRACEFILENAME=/usr/db2/APPLTRC1
  • アプリケーションの現行作業ディレクトリーに APPLTRC1 という名前の HFS ファイルを作成 して、そこに書き込みます。
    APPLTRACEFILENAME=./APPLTRC1
  • 現行作業ディレクトリーの親ディレクトリーに、APPLTRC1 という名前の HFS ファイルを作成し て、そこに書き込みます。
    APPLTRACEFILENAME=../APPLTRC1