BTS トレース

BTS トレース機能は、IMS アプリケーションによって発行される DL/I API 呼び出しとパラメーターをログに記録します。BTS トレースは JCL から有効にします。JCL SSTM サポートを有効にすると、BTS トレース機能を使用して IMS トランザクション、CICS トランザクション、およびバッチプログラムを CRUN からトレースできます。

BTS トレースの有効化

BTS トレースは、JCL から次の DD 指定を使用して有効にします。

IMSTRACE

BTS トレースの出力データセットを定義します。SYSOUT=* は BTS 出力をジョブに向けます。また DCB=(RECFM=LSEQ,LRECL=80,DSORG=PS) を指定することで、出力をデータファイルに向けることもできます。

BTSCONFG

BTS トレース出力オプションの制御を有効にします。次のキーワードを含みます。

`SSA`	セグメント検索引数を含みます (もしあれば)
PCB	PCB 領域を含みます
`IOAREA`	入力出力バッファーを含みます
STATS	呼び出し統計を含みます
`TIMES`	パフォーマンス測定の呼び出しタイミングを含みます
DIAG	診断の詳細情報を含みます
`LISTFILE`	指定された出力データセットの他に、BTS-`nnn`.LST という名前の圧縮ファイルに BTS トレース出力を書き込みます。ファイル名の `nnn` は 10 進値のプロセス ID です。

これらの指定は現在のジョブステップのみに適用され、IMSCONFG.DAT 構成ファイルに保存されている BTS トレースフラグをオーバーライドします。

例

サンプル JCL

このサンプル JCL では、DEMO001B という IVP プログラムで BTS トレースを有効にします。

//S01       EXEC PGM=DFSRRC00,REGION=4M,
//          PARM='BMP,DEMO001B,DEMO001T,,,,,,,,,CDLI,,N,N'
//REPORT1   DD SYSOUT=*
//IMSERR    DD SYSOUT=*
//PRINTDD   DD SYSOUT=*
//SYSOUT    DD SYSOUT=*
//SYSPRINT  DD SYSOUT=*
//IMSTRACE  DD SYSOUT=*
//BTSCONFG  DD *
SSA
PCB
IOAREA
/*
//

サンプル BTS 出力

このサンプル BTS 出力は DEMO001B プログラムによるもので、DL/I 呼び出し関数、SSA、PCB、および I/O 領域を示します。

CBLTDLI:  ~~~~~~~~----+----1----+----2----+----3----+----4----+----5
CBLTDLI:  CALL   :GN
CBLTDLI:          4422
CBLTDLI:          7E00
CBLTDLI:  SSAS   : NONE
CBLTDLI:  PCB-003:DEMO03DD01  AP  ....DEMOHDRS...(............TEST
CBLTDLI:          44443344332245220000444444550002000000000000545522
CBLTDLI:          45DF034401001000000045DF84230008000200000000453400
CBLTDLI:
CBLTDLI:          22222222222222222222222222
CBLTDLI:          00000000000000000000000000
CBLTDLI:  IO AREA:........TEST                            Element Ta
CBLTDLI:          00000000545522222222222222222222222222224666667256
CBLTDLI:          00000000453400000000000000000000000000005C5D5E4041
CBLTDLI:          ble - Metals
CBLTDLI:          66622246766722222222222222222222222222222222222222
CBLTDLI:          2C50D0D541C300000000000000000000000000000000000000
CBLTDLI:                              ......N          .`0.
CBLTDLI:          22222222222222222222000000422222222220631222
CBLTDLI:          000000000000000000001C5C0CE0000000000000F000
CBLTDLI:  ~~~~~~~~----+----1----+----2----+----3----+----4----+----5
CBLTDLI:  CALL   :GN
CBLTDLI:          4422
CBLTDLI:          7E00
CBLTDLI:  SSAS   : NONE
CBLTDLI:  PCB-003:DEMO03DD02  AP  ....DEMOELES...F............TEST
CBLTDLI:          44443344332245220000444444450004000000000000545522
CBLTDLI:          45DF034402001000000045DF5C530006000200000000453400
CBLTDLI:                                    ..........Ag
CBLTDLI:          22222222222222222222222222000000000046222222222222
CBLTDLI:          00000000000000000000000000000000000017000000000000
CBLTDLI:
CBLTDLI:          222222
CBLTDLI:          000000
CBLTDLI:  IO AREA:..........Ag                  Silver
CBLTDLI:          00000000004622222222222222222256676722222222222222
CBLTDLI:          00000000001700000000000000000039C65200000000000000
CBLTDLI:
CBLTDLI:          22222222222222222222222222222222222222222222222222
CBLTDLI:          00000000000000000000000000000000000000000000000000
CBLTDLI:                    (    1 line(s) same as above )
CBLTDLI:                       ........
CBLTDLI:          22222222222220000000022222222222222222222222222222
CBLTDLI:          00000000000000000000C00000000000000000000000000000
CBLTDLI:
CBLTDLI:          222222222222222222222222
CBLTDLI:          000000000000000000000000