7.6.2 プログラムからの連動実行による方法
カウント情報の取得対象プログラムからコマンドを実行しカウント情報を取得する方法です。
(1) カウント情報の表示の手順
プログラムからの連動実行で,プログラムのカウント情報を表示するときの作業の流れを説明します。
-
コンパイラオプションを指定して,プログラムをコンパイルする。
-CVInfコンパイラオプションを必ず指定してください。
-
連動実行の環境変数を指定する。
環境変数CBLTDEXECを指定します。形式は次のとおりです。
- 形式
各オプションの詳細および注意事項については,「(2) 環境変数の指定」を参照してください。
-
カウント情報の取得またはプログラムの実行に必要な環境変数を設定する。
カウント情報の取得に必要な環境変数は,「6.1.1 カバレージ機能の入出力構成と使用するファイル」の「(3) 使用する環境変数の指定」を参照してください。プログラムの実行に必要な環境変数については,マニュアル「COBOL2002 使用の手引 手引編」を参照してください。
-
カウント情報の取得対象の実行可能ファイルを実行する。
カウント情報が取得されます。
-
実行結果を実行結果出力ファイルで確認する。取得したカウント情報はカウント情報リストファイルをテキストエディタ(viやFSEDなど)で開いて確認する。
(2) 環境変数の指定
連動実行するための環境変数は,次のとおりです。その他の環境変数は,「7.6.1 コマンドによる方法」の「(3) 環境変数の指定」を参照してください。
- 形式
-
- -Output
-
カウント情報リストファイル名を指定します。ファイルの拡張子は,「.cnl」でなければなりません。指定しなかった場合は,カレントディレクトリに,実行可能ファイルに拡張子「.cnl」を付けた名前で出力されます。
- -OutFile
-
カウントの実行結果およびトラブルシュート情報※を出力するファイル名を指定します。ファイルの拡張子は,「.cno」でなければなりません。指定しなかった場合は,実行可能ファイルに拡張子「.cno」を付けた名前でカレントディレクトリに出力します。
注※
当社保守員が調査するときに使用する情報です。共用ライブラリのカウント情報が表示されないなど,連動実行が動作しない場合には,当社保守員に連絡してください。
- -Add
-
実行結果出力ファイルに追加書きで結果を出力します。指定しなかった場合,同名の実行結果出力ファイルがあった場合は,上書きされます。
- -Library
-
カウント情報取得の対象とする共用ライブラリファイル名を指定します。
- -Execute
-
カウント情報取得の対象とするプログラムを起動するための実行可能ファイル名を指定します。
- 注意事項
-
-
AIX(32)の場合
環境変数PATHに,/opt/HILNGcbl2k/bin:/usr/binを含めて指定する必要があります。
-
Linux(x86)の場合
環境変数PATHに,/opt/HILNGcbl2k/bin:/usr/bin:/binを含めて指定する必要があります。
-
AIX(64)の場合
環境変数PATHに,/opt/HILNGcbl2k64/bin:/usr/binを含めて指定する必要があります。
-
Linux(x64)の場合
環境変数PATHに,/opt/HILNGcbl2k64/bin:/usr/bin:/binを含めて指定する必要があります。
-
カレントディレクトリは,プログラムが実行されたディレクトリです。
-
CNの文字とオプションの間は空白またはタブで区切ってください。
-
カウント情報リストファイル名・実行結果出力ファイル名・共用ライブラリ名・実行可能ファイル名は,カレントディレクトリからの相対パスが指定されたものとします。カレントディレクトリが認識できないときは,絶対パス名で指定する必要があります。
-
環境変数CBLTDEXECに指定した実行可能ファイル名と,COBOL2002カバレージを起動した実行可能ファイルが一致する必要があります。
-
プログラムを起動するときのパスの名称は,次の点に注意して指定します。これらに反したパスの名称が指定された場合,カバレージの動作は保証しません。
・環境変数CBLTDEXECに指定した実行可能ファイル名と,プログラムを起動するときの実行可能ファイル名は,絶対パス名で指定します。相対パス名で指定した場合,またはパスプレフィクスを指定しなかった場合は,実行可能ファイル名だけが一致しているかどうかを確認します。
・プログラムを起動するときパス名は,60バイト以下とします。60バイトを超えたときは,61バイト以降が切り捨てられ,60バイトまでをパス名とみなします。
・パスを除いた実行可能ファイル名の長さは,14バイト以下とします。14バイトを超えたときは15バイト以降が切り捨てられ,14バイトまでが実行可能ファイル名とみなされます。
-
プログラムに渡す引数は,プログラムの起動時に指定します。環境変数CBLTDEXECには指定できません。
-
カウント情報の表示のプログラム情報ファイルを次の順序で検索します。検索した結果,見つからないときは,プログラム情報ファイルに該当するプログラムはカウント情報表示の対象となりません。
1.環境変数CBLPIDIRで指定したディレクトリ
2.実行可能ファイルに含まれるプログラムは,実行可能ファイルのあるディレクトリ
共用ライブラリファイルに含まれるプログラムは,共用ライブラリファイルのあるディレクトリ
3.カレントディレクトリ
-
プログラムが-CVInfコンパイラオプションでコンパイルされていない場合,カウント情報の表示の対象となりません。
-
カウント情報の表示の対象となるプログラム情報ファイルが一つもない場合は,カウント情報の表示のためのプログラムを実行しません。カウント情報リストファイルも出力しません。
-
環境変数CBLLSLIB,環境変数CBLLPATH,および環境変数LD_LIBRARY_PATHについては,「6.4.2 共用ライブラリ」を参照してください。
-
環境変数CBLTDEXECに空白またはタブを含むパス名を指定できません。
-
拡張子が「.cno」ではないファイルを実行結果出力ファイル名に指定した場合は,エラーになり連動実行は開始しません。
-
(3) 実行結果出力ファイルにメッセージを出力できないときの処理
実行結果出力ファイルにメッセージを出力できない場合のメッセージの出力方法については,「7.2.2 プログラムからの連動実行による方法」の「(3) 実行結果出力ファイルにメッセージを出力できないときの処理」を参照してください。