3.6.2　コマンドログ

〈この項の構成〉

(1)　コマンドログの出力形式

OpenTP1の運用コマンドを実行した場合に，コマンド実行時刻，終了時刻などの情報を$DCDIR/spool/cmdlogのcmdlog1，およびcmdlog2に出力します。cmdlog1，およびcmdlog2は，1MBを超えた時点でラップアラウンドします。

cmdlog1，およびcmdlog2はviエディタなどで参照できます。コマンドログにはコマンドの開始時刻，終了時刻が出力されるので，コマンドの実行に必要な所要時間の測定などができます。

出力する情報は次のとおりです。

> AAAA BBBB C  DDDD/DD/DD EE:EE:EE.EEEEEE FFFFFFFF : GGGGGGGG : HHHHHHH

>：コマンドログの1行の始まりを示すコマンドログレコード開始識別子です。
AAAA：実行したコマンドのプロセスIDを半角数字で出力します。
BBBB：コマンド実行者のユーザIDを出力します。
C：プロセス内のメッセージ通番を出力します（実行したコマンドプロセスが出力したコマンドログ情報の通番です）。半角数字で0〜65535まで出力します。65535を超えた場合は0に戻ります。
DDDD/DD/DD：コマンドログに出力した年月日を，YYYY/MM/DDの形式で半角数字で出力します。
EE:EE:EE.EEEEEE：コマンドログに出力した時刻を，HH:MM:SS.mmmmmmの形式で半角数字で出力します。なお，mmmmmmはマイクロ秒を示します。
FFFFFFFF：コマンド実行時のコマンドライン情報を出力します。OpenTP1内部で実行するコマンドが出力されることがあります。
GGGGGGGG：次の識別情報を出力します。

start：コマンド開始時の情報を示します。

end：コマンド終了時の情報を示します。

info：コマンド実行中の保守情報を示します。
HHHHHHH：コマンドの保守情報を出力します。

MCFの運用コマンドのコマンドログを取得するかどうかは，環境変数DCMCFCMDLOGで設定できます。コマンドログの取得有無はコマンドによって異なります。環境変数の設定による，コマンドログの取得の違いについて次の表に示します。

（凡例）

○：取得します。

×：取得しません。

注※1

-wオプションを指定した場合だけ，取得します。

環境変数の設定手順について説明します。

手動で運用コマンドを実行する場合

OpenTP1管理者のログイン環境に環境変数DCMCFCMDLOGを設定してください。
UAPで運用コマンドを実行する場合

OpenTP1のUAPからdc_adm_call_command関数を発行して運用コマンドを実行する場合は，該当のUAPのユーザサービス定義またはユーザサービスデフォルト定義にputenv形式で環境変数DCMCFCMDLOGを設定してください。

COBOLおよびDMLインタフェースを使用してコマンドを実行する場合も同様です。

MCFの運用コマンドのコマンドログ取得についての注意事項を次に示します。

UAPやシェルファイルを使用して同時に大量のコマンドを実行する場合は，コマンドログ出力がボトルネックになって性能劣化したり，コマンド履歴の情報が失われたりするおそれがあります。この場合は，コマンドログを取得しないように環境変数DCMCFCMDLOGを設定してください。
運用コマンドの実行でエラーが発生した場合，環境変数DCMCFCMDLOGの設定に関係なくコマンドログを取得することがあります。