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 領域を含みます
PCBHELP	無効な SSA のトレースにヘルプテキストを含みます (AJ DL/I 状態コード)
`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、および入出力領域を示します。

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