COBOL2002 Professional製品 導入ガイド

解説・手引・操作書

4010-1J-815

前書き

対象製品

P-2636-7354 COBOL2002 Developer Professional 05-00（適用OS：Windows 10(x64)，Windows 11，Windows Server 2019，Windows Server 2022）

P-2936-7354 COBOL2002 Developer Professional(64) 05-00（適用OS：Windows 10(x64)，Windows 11，Windows Server 2019，Windows Server 2022）

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

マイクロソフト製品のスクリーンショットの使用について

マイクロソフトの許可を得て使用しています。

発行

2025年2月　4010-1J-815

著作権

All Rights Reserved. Copyright (C) 2025, Hitachi, Ltd.

変更内容

変更内容（4010-1J-815）　COBOL2002 Developer Professional 05-00，COBOL2002 Developer Professional(64) 05-00

追加・変更内容

変更個所

［PAD表示］画面の画面タイトルにプログラム名を表示するように改善した。

1.4

［解析生成オプション設定］画面の［生成ドキュメント］タブから，［対象ブラウザ指定］を削除した。

1.4

32ビット版のODBCデータソースの説明を変更した。

これに伴い，「コマンドの実行で注意すること」で，組み込みデータベース状態表示コマンド（eals）実行時の注意事項の説明を変更した。

3.4，6.，付録A

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルは，次に示すCOBOL2002 Professional製品の特長と，製品をお使いになるためのセットアップ手順について説明したものです。

P-2636-7354 COBOL2002 Developer Professional

P-2936-7354 COBOL2002 Developer Professional(64)

このマニュアルでは，上記の製品を総称して，COBOL2002 Developer Professionalと表記します。

対象読者

COBOL2002 Professional製品の導入を検討されている方，セットアップおよびシステムを運用するCOBOLプログラマーの方を対象とします。また，次に示す内容を理解されていることを前提としています。

Windowsの基本的な操作方法

COBOL2002のプログラミングの概要

このマニュアルで使用する記号

このマニュアルで使用する記号を次のように定義しています。

記号

意味

［　　］

メニュータイトル，メニュー項目，ボタン，キー，およびアイコンの名称を示します。

例：［ファイル］メニュー

　　［OK］ボタン

　　［Enter］キー など

［　　］−［　　］

前のメニューを選択し，続けて後ろの項目を選択することを示します。

例：［ファイル］−［開く］

　　［ファイル］メニューから［開く］を選択することを示します。

［　　］＋［　　］

+ の前のキーを押したまま，後ろのキーを押すことを示します。

例：［Ctrl］+［C］キー

　　［Ctrl］キーを押したまま［C］キーを押すことを示します。

　△

半角の空白を入れること，またはスペースキーを指定された数だけ押すことを示します。

斜体

インストール先フォルダなど可変の個所を示します。

〔 〕

省略できることを示します。

例：INCLUDE 〔サブシステム名〕

　　サブシステム名は省略できることを示します。

｛　｝

この記号で囲まれている複数の項目のうちから1つを選択することを示します。項目が縦に複数行にわたって記述されている場合は，そのうちの1行分を選択します。

｜

横に並べられた複数の項目に対して項目間の区切りを示し，「または」を意味します。

...

記述が省略されていることを意味します。

この記号の直前に示された項目を繰り返して複数個指定できます。

下線

括弧で囲まれた複数の項目のうち1項目に対して使用され，括弧内のすべてを省略したときにシステムが仮定する標準値を意味します。

用語の定義

このマニュアルで使用する用語の定義を次に示します。

パス名とパスプレフィクス

パス名とパスプレフィクスは，次のとおりです。

絶対パス名

ドライブ名で始まるパス名。

　ドライブ名¥フォルダ名¥ … ¥ファイル名

相対パス名

カレントフォルダからの相対のパス名。

・カレントフォルダの1階層上位のフォルダを経由する場合

　..¥フォルダ名¥フォルダ名¥ … ¥ファイル名

・カレントフォルダ下のフォルダを経由する場合

　フォルダ名¥フォルダ名¥ … ¥ファイル名

絶対パスプレフィクス

ドライブ名で始まるパスプレフィクス。

相対パスプレフィクス

カレントフォルダからの相対のパスプレフィクス。

1　これからのCOBOL開発環境

COBOL2002 Developer Professionalの特長について説明します。

1.1　COBOL2002 Developer Professionalとは

COBOL2002 Developer Professionalは，COBOLプログラムを資産として利活用していくプログラム開発者をサポートする製品です。

COBOLは，その高い生産性で，これまでさまざまな分野で事務処理用のプログラム開発言語として使われてきました。現在でも，基幹処理で稼働している大量のプログラム資産があります。これらのプログラム資産の開発と保守を強力にサポートするのが，COBOL2002 Developer Professionalです。

COBOL2002 Developer Professionalは，これまで実績があるプログラム開発環境であるCOBOL2002 Net Developerの機能に，プログラム開発・保守を支援するツール群であるCOBOL2002 Professional Tool Kitを加えた製品です。

COBOL2002 Developer Professionalを導入すれば，COBOLプログラムで構築したシステムの開発効率の向上に寄与できます。プログラム資産が豊富にある大規模な開発環境であれば，よりその効果を発揮します。

それでは，どのようなメリットがあるかを紹介します。

1.1.1　COBOLプログラム資産の有効活用

COBOL2002 Developer Professionalを適用すると，COBOLプログラム資産を有効活用できます。

現状の課題

長年使用しているプログラムは，現在の業務に適合するように時間を掛けて改良しているケースがほとんどです。COBOLプログラムそのものが，多くのSE/プログラマーのノウハウを凝縮した貴重な資産です。この資産を再利用すれば，すでに稼働実績があるプログラムを流用できるため，再プログラミングやプログラムテスト工数の抑制につながり，システム開発の効率を向上できます。

COBOL2002 Developer Professionalなら

COBOLプログラム開発の統合ツール（開発マネージャ）に加え，COBOLソースファイルを解析するツール（COBOLソース解析）も使用できます。解析結果から，プログラム間の呼び出し関係がわかり，システム開発で拡張が必要な処理を判断できます。既存のシステムの保守やリエンジニアリング，大幅なシステム改編を伴う大規模開発にも役立ちます。

1.1.2　COBOLプログラムの棚卸しの支援

COBOL2002 Developer Professionalを適用すると，COBOLプログラムの棚卸しに対応できます。

現状の課題

既存システムのプログラムの修正では，そのプログラムの構造を把握することが重要です。しかし，プログラムのソースファイルがマスターデータになって，保守書がないことがあります。保守書がある場合でも，日々のプログラムの改変に保守書のメンテナンスが追い付かないで，実体のプログラムと不一致になることもあります。そのため，棚卸しするときに現在動作しているプログラムの処理を正しく把握できない問題が起こりがちです。

COBOL2002 Developer Professionalなら

COBOLソース解析を使用して，プログラムのCOBOLソースファイルをそのまま解析できるので，保守書がない状態でも，処理がわからないプログラムの構造を把握し保守できます。COBOLソース解析の解析結果から，必要な処理と不要な処理を見分けて，テストが必要かどうかを判断できます。

1.1.3　COBOLプログラムの影響波及の調査

COBOL2002 Developer Professionalを適用すると，COBOLプログラムを修正する影響がどのように波及するかを調査できます。

現状の課題

COBOLプログラムのほとんどは，ほかのプログラムの業務処理を呼び出す構造になっています。システムを改変するため，あるデータを修正する場合，修正の影響がどこまで波及するかを調査する必要があります。しかし，長年にわたって保守されてきたシステムでは，処理の途中で別名の定義に置き換わっていることもあるため，プログラムに熟知していても追跡は困難です。データ形式が厳密であるCOBOLでは，けた数を増やすだけでも演算結果のデータ長に影響するため，慎重に対応しなければなりません。

COBOL2002 Developer Professionalなら

データ影響波及分析を使用して，システム全体のプログラム処理の解析結果から，データの修正がどのプログラムに影響するか（影響波及）を追跡し調査できます。手作業や目視に比べ，プログラムを調査する工数を大幅に低減できます。さらに，調査結果をエビデンスとして残せるので，開発プロジェクト内でのプログラム修正作業にも活用できます。

1.1.4　COBOLプログラムの単体テストの効率化

COBOL2002 Developer Professionalを適用すると，COBOLプログラムのテスト工程の効率を向上できます。

現状の課題

プログラム開発のテストは，最も工数が掛かり，かつ重要な工程です。特に単体テストの品質は，後工程の統合テストに影響します。ただし，新規開発では，開発中にプログラムの動作を確認しようとしても，ほかの処理が未作成のため，すぐにテストができないことがあります。COBOL2002では単体テストをサポートしていますが，コマンド入力での作業であり，テスト条件や実行結果は手作業での管理が必要でした。

COBOL2002 Developer Professionalなら

単体テスト支援を使用して，単体テストのテスト項目をテストケースとして設定し，テストプロジェクトとして保存できます。また，単体テストに必要なダミーの主プログラムや副プログラム，ファイルが自動的に設定されます。開発作業中の単体テストの負担を軽減できるので，統合テストのバグ率の低減につながり，プログラム開発の効率が上がります。

1.1.5　チーム開発のサポート

COBOL2002 Developer Professionalを適用すると，構成管理ツールと連携できるため，チーム開発のデータ管理をサポートできます。

現状の課題

チーム開発では，複数のプログラマーが同時に開発に従事します。複数のメンバーが同じファイルを更新するため，ソースファイルの共有やバージョン管理が必要です。これらの作業には構成管理ツールを使用することがあります。しかし，構成管理ツールはプログラム開発用の製品とは別製品であるため，ソースファイルをローカルに保存してから構成管理ツールのコマンドを実行する手間が掛かります。また，ローカルに保存したデータをサーバに格納する場合に，誤操作でほかのメンバーが更新したデータを上書きしてしまうことも考えられます。

COBOL2002 Developer Professionalなら

開発マネージャのツリービューウィンドウから構成管理ツールを使用して，共有するファイルのサーバへのチェックイン，最新ファイルのチェックアウトができます。ツリービューウィンドウに表示されているソースファイルのアイコンを選んで操作できるので，プロジェクトの階層構造や目的のファイル名を確認して操作できます。また，スタートメニューから構成管理ツールを起動する手間も省けます。

連携するときは，各種の構成管理ツールの操作を事前に設定しておきます。設定しておくと，開発マネージャのメニューで構成管理ツールの操作（チェックイン，チェックアウト）ができます。

参考

構成管理ツールは，COBOL2002では提供しません。別途用意してください。

構成管理ツールと連携する場合の条件，設定方法および実行できる操作については，マニュアル「COBOL2002 操作ガイド」を参照してください。

1.1.6　外部ツールでのソースプログラムの操作

COBOL2002 Developer Professionalを適用すると，開発マネージャで外部ツールと連携できるため，プログラム開発の利便性を向上できます。

現状の課題

プログラム開発では，任意の外部ツールにソースファイルを読み込んで資料を作成することがあります。このとき，ソースファイルを格納しているフォルダを検索するため，開発マネージャでファイル間の関係とソースファイル名を確認してから対象のファイルを検索する手間が掛かります。また，複数のプロジェクトで同じ名前のソースファイルがある場合，誤って別のソースファイルを操作してしまうことも考えられます。

COBOL2002 Developer Professionalなら

開発マネージャのツリービューウィンドウから，外部ツールを操作できます。ツリービューウィンドウに表示されているソースファイルのアイコンを選んで外部ツールを開始できるので，プロジェクトの階層構造や目的のファイル名を確認して操作できます。また，スタートメニューから外部ツールを起動する手間も省けます。

外部ツールと連携するときは，外部ツールとツールの操作を事前に設定しておきます。設定するメニュー名は，任意に設定できます。また，登録した情報をパッケージ情報ファイルとして保存し，ほかのマシンにも移行できます。

参考

外部ツールは，COBOL2002では提供しません。別途用意してください。

外部ツールと連携する場合の条件，設定方法および実行できる操作については，マニュアル「COBOL2002 操作ガイド」を参照してください。

1.2　COBOL2002 Developer Professionalを構成する機能

COBOL2002 Developer Professionalは，COBOLプログラム開発環境とCOBOL2002 Professional Tool Kitから構成されます。

COBOLプログラム開発環境

COBOLプログラム開発環境は，各種の機能を備えたCOBOLプログラムの開発基盤です。COBOL2002 Net Developerの機能を提供しています。

COBOL2002 Developer ProfessionalのCOBOLプログラム開発環境は，COBOL2002 Net Developerの機能に加え，次に示す機能を使用できます。

構成管理ツールとの連携

共有するファイルのサーバへのチェックイン，最新ファイルのチェックアウトができます。

外部ツールとの連携

任意のツールでソースプログラムを操作できます。

プログラム作成支援ツール

Javaプログラム呼び出し機能を使用するCOBOLのソースコードを自動生成できます。

Javaプログラム呼び出し機能については，マニュアル「COBOL2002 Javaプログラム呼び出し機能ガイド」を参照してください。

COBOL2002 Professional Tool Kit

COBOL2002 Professional Tool Kitは，COBOLプログラムの開発を支援するツール群です。次に示す機能をサポートしています。

COBOLソース解析

COBOLプログラムの構造を解析し，ソース解析情報としてHTMLファイル形式とCSVファイル形式のデータを出力する機能です。

データ影響波及分析

COBOLプログラムのデータ項目に対する修正の影響が，どのプログラムに波及するかを解析する機能です。

単体テスト支援

COBOLプログラムの単体テストをテストケースとして設定し管理する機能です。

1.2.1　プログラム開発フェーズとCOBOL2002 Developer Professionalとの関係

COBOL2002 Developer Professionalの機能は，システム開発の次のフェーズで活用できます。

プログラム解析のフェーズ

COBOLソース解析で，プログラムの構造を解析し「見える化」できます。プログラムで使用している分岐条件の数など，複雑な処理がどのくらいあるかがわかるので，修正に必要な作業量の見積もりにも活用できます。

プログラム修正のフェーズ

データ影響波及分析で，プログラムのデータ項目を修正する場合，どのプログラムに影響が波及するかがわかります。データ項目に対する修正で影響がある文を追跡して，処理の修正が必要かどうかを調査できます。

プログラムテストのフェーズ

単体テスト支援で，COBOLソースファイルのテストケースとテスト結果をGUIで管理できます。複数のテストケースを設定し，プログラムを修正するたびに繰り返してテストを実行できるので，統合テスト前の単体テストの効率を向上できます。

1.3　COBOLプログラム開発環境

COBOL2002 Developer Professionalは，COBOL2002の機能を活用したプログラムの開発からテストおよびデバッグまでをサポートする製品です。COBOLコンパイラを始めとするCOBOLプログラム開発に必要な基本的な機能や，アプリケーションプログラムのテストに必要なテストデバッガ，カバレージなどの機能も使用できます。

COBOLプログラム開発環境の機能および使用方法についてはマニュアル「COBOL2002 ユーザーズガイド」，GUI画面の操作方法についてはマニュアル「COBOL2002 操作ガイド」を参照してください。

1.3.1　開発マネージャ

プログラムの開発では，コーディング，コンパイル，デバッグなどで，各種の機能を使用します。開発マネージャでは，これらの機能をまとめて操作できます。開発マネージャから操作できる機能を次に示します。

ビルド

COBOLコンパイラ/リンカを実行する機能です。

COBOLエディタ

COBOLプログラムを編集する機能です。

ODBCレコード定義生成

データベースのデータソースからCOBOLのレコード定義を生成する機能です。

画面定義

COBOLプログラムで使用する画面節のCOBOLソースを生成する機能です。

ファイル/レコード定義

COBOLプログラムで使用するファイル仕様およびレコード仕様のCOBOLソースを生成する機能です。

テストデバッガ

COBOLプログラムをデバッグする機能です。

カバレージ

COBOLプログラムのテスト進捗状況を管理する機能です。

実行支援

COBOLプログラムの実行環境を設定しプログラムを実行する機能です。

1.3.2　COBOLエディタ

COBOLエディタには，コーディングを補助する各種の機能があります。予約語，定数の色分け表示や一連番号の自動付与，構文チェックなど，COBOLの文法に対応した機能を使用できます。また，COBOLのすべての構文がテンプレートとして使用できるので，構文を一からコーディングする手間が省けます。さらに，コンパイラやテストデバッガでのエラー時にもエディタと連携し，効率良くソースを編集できます。

1.3.3　COBOLコンパイラ

COBOLコンパイラは，COBOL2002規格に対応しています。プログラムの目的に応じて，各種のコンパイラオプションを設定できます。コンパイラオプションおよび環境変数の設定では，GUIで指定内容を確認できます。

1.3.4　テストデバッガ

開発したプログラムのテストでは，メインプログラム，サブプログラム，ファイル単位での単体テストを実行できます。また，コマンドをバッチモードで実行すれば，大量のプログラムを自動的にテストできます。

1.4　COBOL2002 Professional Tool Kit − COBOLソース解析

COBOLソース解析とは，COBOLプログラムを解析し，プログラムの構造や関係などの解析情報を出力して，プログラムを「見える化」する機能です。

COBOLソース解析を使用すると，COBOLプログラムのソースファイルをそのまま解析できます。解析結果には，プログラムの入出力処理やサブルーチンコールが，プログラム同士でどのように関連しているかが表示されます。解析結果を参照して，COBOLエディタでプログラムをメンテナンスできます。

COBOLソース解析の操作方法については，マニュアル「COBOL2002 Professional Tool Kit COBOLソース解析ガイド」を参照してください。

注意事項

COBOLソース解析では，日立COBOL2002の仕様範囲のCOBOLプログラムを解析できます。COBOL2002の仕様範囲については，マニュアル「COBOL2002 Professional Tool Kit COBOLソース解析ガイド」を参照してください。

COBOLソース解析で解析できるのは，COBOL2002のCOBOLコンパイラでエラーにならないCOBOLプログラムです。

解析できる項目

COBOLプログラムの解析結果は，ソース解析情報として生成されます。解析できる項目の例を次に示します。

プログラム入出力/サブルーチンコールの一覧

COBOLプログラムのデータの入出力および呼び出し関係を一覧で表示します。各プログラム同士の関係がわかります。

使用中/未使用/未登録の登録集原文

登録集原文の使用状況と登録状況を一覧で表示します。登録集原文がどのプログラムから使用されているか，不足している登録集原文が何か，を判断できます。

ファイルの構造

ファイル管理記述項のASSIGN句で指定したファイル名（外部装置名，データ名，定数）を一覧またはツリー構造で表示します。ファイルの構造を可視化し，各テーブルの構造を把握できます。

デッドコード情報

プログラムの実行時に実行されることがない文，プログラムなど，実行結果に影響を与えないソースコードを表示します。デッドコードの候補から，テストが不要なプログラムの選定や，プログラムの処理の誤りを発見できます。

不整合引数の一覧

プログラム呼び出しの実引数と仮引数の整合性をチェックした結果を一覧で出力します。COBOLエディタを使用して，一覧の警告メッセージから不整合になっている実引数または仮引数のソースコードを確認できます。

ソースコードの実行順序情報

ソースコードのすべての実行順序をツリー形式で表示またはリスト出力します。ソースコードの実行順序情報を利用すると，実行経路の組み立てや，分岐先および呼出先を探すことなく，ソースコードリーディングを実施できます。

プログラムのPAD（問題解析図）

プログラムの制御構造（順次，選択，反復）をツリー形式で表示できます。制御構造が明確になるため，プログラムの処理手順が分かりやすくなり，処理の把握や問題点の検出に効果的です。

ソース解析情報の形式

ソース解析情報は，HTMLファイル形式とCSVファイル形式で出力されます。

HTMLファイル形式のソース解析情報は，Webブラウザで参照し，リンクをクリックして各項目を表示します。

CSVファイル形式のソース解析情報は，二次元マトリクス形式の表で出力されます。Excelで表として参照，または解析データとして任意のプログラムで加工して活用します。

ソース解析情報の参照方法

HTMLファイル形式のCOBOLプログラムの解析結果は，一覧表や階層図で見やすく表示されます。各項目の詳細を表示するときは，リンクをクリックします。リンクをクリックすると，ソース解析情報の表示を切り替えられます。

ソース解析情報の保存

COBOLプログラムの解析結果であるソース解析情報（HTMLファイル，CSVファイルおよびタグファイル）は，COBOLソース解析の画面に指定したフォルダに出力されます。ソース解析情報を保存するときは，そのフォルダを退避しておきます。退避したフォルダのソース解析情報は，あとで参照できます。

参考

COBOLソース解析の解析環境そのものを移行または複写できます。解析環境を移行または複写するときは，組み込みデータベースを操作します。組み込みデータベースの操作については，「4.　解析環境の操作」を参照してください。

1.5　COBOL2002 Professional Tool Kit − データ影響波及分析

データ影響波及分析とは，COBOLプログラムのデータ項目に対する修正（設定値や比較値の変更）が，システム全体にどう影響するかを調査できるようにする機能です。

データ影響波及分析では，プロジェクト内の影響波及を解析し，解析結果を影響波及元と影響波及先として画面に表示します。この情報から，画面の操作で影響波及先を追跡し，プログラムの修正が必要かどうかを検討できます。

データ影響波及分析の操作方法については，マニュアル「COBOL2002 Professional Tool Kit データ影響波及分析ガイド」を参照してください。

影響波及の分析対象

データ影響波及分析では，データ項目（変数）の修正の影響調査を対象としています。調査対象のデータ項目が定義されているデータ部（DATA DIVISION）の構造，手続き部（PROCEDURE DIVISION）でデータ項目を使用している命令文，その命令文の演算結果がどの変数に影響するかを順次追跡し，画面に表示します。

影響波及の分析と調査方法

データ影響波及分析で調査する前に，調査対象のプロジェクトの処理を開発マネージャの操作でデータベース（データ影響波及分析用データベース）に格納します。データベースには，プロジェクトのデータ項目が使用されているプログラムの処理に関する情報が格納されます。

変更するデータ項目が決まったら，COBOLエディタで表示するソースプログラム上でそのデータ項目を右クリックし，ポップアップメニューからデータ影響波及分析を起動します。プログラム編集の作業中に影響波及の調査もできます。調査対象のデータ項目は複数選択できるので，あるデータ項目を調査したあとで，別のデータ項目の影響波及を調査することもできます。

また，コマンドを利用すれば，調査対象に関係のある実行文とデータ項目を制御フローから抽出して影響調査したり，データベースの表や列，ファイルを含む影響波及を調査したりできます。さらに，データ項目間の影響2項関係をトレースする情報から，より複雑な影響波及を確認することもできます。

調査結果の保存

データ影響波及分析の調査結果は，エビデンスとしてCSVファイルに保存できます。データ影響波及分析の画面上に，データ項目ごとにメモを残せるので，作業結果をプロジェクトの取りまとめ者に報告するときにも使用できます。また，画面上の影響波及の関係を示す構造図は，その調査結果そのものを保存できるので，その日に完了しなかった調査も翌日に続けて実施できます。

参考

データ影響波及分析用データベースに格納した情報は，移行または複写できます。移行または複写するときは，組み込みデータベースを操作します。組み込みデータベースの操作については，「4.　解析環境の操作」を参照してください。

1.6　COBOL2002 Professional Tool Kit − 単体テスト支援

単体テスト支援とは，開発中のCOBOLプログラムの単体テストをGUIの操作で実行できるようにする機能です。

単体テスト支援を使用すると，単体テストをテストプロジェクトとして管理し，複数のテストをテストケースとして格納します。同じテストを繰り返し実行したり，一部を変更して別のテストケースとして実行したりできます。また，単体テストに必要なダミーの主プログラムや副プログラムもスタブとして生成するため，これらのソースファイルを用意する必要はありません。さらに，ファイルへの入出力処理に代わる操作（シミュレーション）もできます。

単体テスト支援は，大規模なシステム開発で，単体テストを効率良く実行する場合に有効です。

単体テスト支援の操作方法については，マニュアル「COBOL2002 Professional Tool Kit 単体テスト支援ガイド」を参照してください。

テストの実行方法

テスト対象のプログラムに含まれるデータ項目に対し，代入する値と，テスト結果として想定する正しい値を設定し，テストケースを作成します。その後，テストを実行します。テストを実行すると，これらの値を比較し，自動的に結果が判定されます。判定結果は，単体テスト支援が生成する結果レポートで確認できます。

テストケースの管理

プログラムテストでは，テストケースとテスト結果の保存が必要です。単体テスト支援では，テストプロジェクト単位でテストの実施内容を保存できるので，実行したテストケース，テストの結果レポート，およびカバレージレポートをエビデンスとして残せます。

さらに，単体テスト支援の画面で設定したテストケースの情報をCSVファイルにエクスポートし，その内容をほかの単体テスト支援にインポートできます。多数のテストデータの設定を外部ツールで効率良く作成/編集するときに使用できます。

1.7　COBOL2002 Developer Professionalの利用環境

COBOL2002 Developer Professionalの利用環境の説明です。

COBOL2002 Developer Professionalは，1台のWindowsマシンで実行できます。

1台のWindowsマシンで使用できるCOBOL2002 Developer Professionalの組み込みデータベースは1個です。1台のWindowsマシンで複数の組み込みデータベースは使用できません。

COBOL2002 Developer Professionalのインストール先および組み込みデータベースの作成先は，ローカルのWindowsマシンに限定されます。ネットワーク上のフォルダにインストールおよび組み込みデータベースの作成はできません。

ローカルのWindowsマシンに格納したCOBOLソースファイルだけでなく，LANで接続されたWindowsマシン上に格納したCOBOLソースファイルも解析できます。

複数のWindowsマシンを使って，同じ環境で開発する場合は，1台のWindowsマシンで環境を構築し，組み込みデータベースのバックアップを取得したあとで，別のWindowsマシンにリストアできます。同じ環境とは，インストール先および組み込みデータベースの作成フォルダが同じであることを示します。

Windows Serverの場合，COBOLソース解析を使用できるユーザーアカウントは1つです。ほかのユーザーが使用中にCOBOLソース解析を実行しようとすると，エラーになります。

Windows Serverで稼働しているCOBOL2002 Developer Professionalをターミナルサービス経由で使用する場合は，クライアント側のマシンにもCOBOL2002 Developer Professionalが必要です。

2　適用業務の例

COBOL2002 Developer Professionalを業務に活用する例について説明します。

2.1　既存のCOBOLプログラムを解析してCOBOLプログラムを開発する

保守書がない状態のCOBOLプログラムを修正するケースに，COBOL2002 Developer Professionalの機能であるCOBOLソース解析を適用する例です。

事例1

Aさんは，前任者からCOBOLプログラムの保守を引き継いだ。しかし，前任者はここ数年しか担当していなかった。在任期間中に変更があったモジュールについては保守書を作成したが，変更がなかったモジュールについては保守書を作成していなかった。システムは十数年前から稼働しているが，残っていたのは修正前のCOBOLソースファイルだけで，プログラムの処理を示す保守書はすでに失われて解析できない状態だった。

今般，システムの大幅な変更に伴い，COBOLプログラムも大幅な修正が必要になった。COBOLプログラムの呼び出し関係をCOBOLプログラムから調査するのは，人材不足の状況でありながら多大な工数が掛かってしまう。

このケースにCOBOLソース解析を適用すると，次のような効果があります。

COBOLソース解析では，COBOLソースファイルをそのまま解析できます。他人が作成したCOBOLプログラムを1行ずつ解析する負担を軽減できます。

保守書がなくても，ソース解析情報から，COBOLプログラムの呼び出し関係が妥当かどうか判断できます。

各種の分布情報の出力結果から，ファイルの変更がどのCOBOLプログラムの処理と関連するか，COBOLプログラムの修正要否の判別など，COBOLプログラムの処理を調査できます。

既存のCOBOLプログラムを解析してCOBOLプログラムを開発する例を次の図に示します。

図2‒1　既存のCOBOLプログラムを解析してCOBOLプログラムを開発する

2.2　COBOLプログラム開発作業にソース解析情報を活用する

大規模なシステムでCOBOLプログラムを修正するため，複数人のプログラマーで作業を推進するケースに，COBOL2002 Developer Professionalの機能であるCOBOLソース解析を適用する例です。

事例2

Bさんは，数千キロステップにも及ぶCOBOLアプリケーション開発チームを取りまとめることになった。30人のプログラマーでシステムを構築していたが，プログラマーごとにスキルが異なり，データの保守方法やデータ名の命名規則に個人差がある。さらに実際の業務では，モジュールごとの開発量および修正量の違いが大きく，スムーズな支援体制による効率向上が要求されていた。

このケースにCOBOLソース解析を適用すると，次のような効果があります。

作成者のスキルや経験に依存しないソース解析情報をCOBOLソースファイルから自動的に生成できます。保守書にありがちな内容の不一致，情報が最新でない，などの不具合がありません。

プログラム名，登録集名，ファイル名などシステム全体で共有する名称を一覧表示できるため，プログラムの命名規則の判断に役立ちます。

修正したCOBOLソースファイルを再解析すれば，最新のプログラム構造の情報がわかります。手作業で保守書をメンテナンスする手間が省けます。

COBOLプログラム開発作業にソース解析情報を活用する例を次の図に示します。

図2‒2　 COBOLプログラム開発作業にソース解析情報を活用する

2.3　デッドコード候補から使われていないソースコードを除外してテスト効率を上げる

大規模なシステムの棚卸しで，デッドコード候補から使われていないソースコードを除外してテスト効率を上げるケースに，COBOL2002 Developer Professionalの機能であるCOBOLソース解析を適用する例です。

事例3

Cさんは，数千キロステップにも及ぶ大量のCOBOLソースファイルを棚卸しし，これを流用した新規システムの開発を担当することになった。一連のプログラムには保守書はなく，また長い期間に改変を繰り返しているため，すでに使われていない古いプログラムも混在していると思われた。

大量のCOBOLソースファイルを棚卸しするには，「処理を理解する」「使われていないプログラムを洗い出す」「テストする」作業が必要で，処理を理解しないと使われていないプログラムが洗い出せない。当時の管理者不在の状況では処理の理解に多大な作業量が必要であるが，対応できる人員・期間ともに限りがあり，作業の推進が困難な状況だった。

このケースにCOBOLソース解析を適用すると，次のような効果があります。

大量のCOBOLソースファイルをバッチ処理で解析し，未使用のプログラム（内部または外部）を検出できます。この結果から，未使用のCOBOLプログラムを特定でき，その部分のプログラムテストの作業を低減できます。

本来は実行する必要があるプログラムに処理がわたっていないのは，プログラムの呼び出しが適正でない場合もあります。未使用のプログラムとしてよいかどうか，の判断にも使用できます。

デッドコード候補から使われていないソースコードを除外してテスト効率を上げる例を次の図に示します。

図2‒3　デッドコード候補から使われていないソースコードを除外してテスト効率を上げる

2.4　データ項目を変更する影響を調査する

複数のCOBOLソースファイルに影響するデータ項目（変数）を変更するケースに，COBOL2002 Developer Professionalの機能であるデータ影響波及分析を適用する例です。

事例4

Dさんは，税率の変更に伴い，COBOLプログラムで開発した大規模なシステムを修正することになった。COBOLソースファイルを検索し，税率を定義するデータ項目をそのまま使用している個所は特定できた。ただし，あるプログラムではデータ項目を別名参照し，また計算結果を別名で格納しているなど，計算結果をどこに格納するか追い切れない状況だった。

このケースにデータ影響波及分析を適用すると，次のような効果があります。

変更したいデータ項目が，どのCOBOLプログラムで使われているかをGUIの操作で追跡できます。データ項目が別名参照されている場合でも，COBOLプログラムを解析して判定するため，手作業で検索するよりも，プログラムの改変の影響をスムーズに把握できます。

データ影響波及分析では，サブシステムをわたってデータ項目の改変による影響を調査できます。システムが大規模な場合でも，改変の影響を調査できます。

データ項目を変更する影響を調査する例を次の図に示します。

図2‒4　データ項目を変更する影響を調査する

2.5　単体テストをタイムリーに実行する

複数人でのCOBOLプログラム開発で，テストデバッガの操作に慣れていないプログラマーが単体テストを実行するケースに，COBOL2002 Developer Professionalの機能である単体テスト支援を適用する例です。

事例5

Eさんは，複数のプログラマーで大規模なシステムを新規開発するプロジェクトを取りまとめることになった。開発するシステムは大量のCOBOLプログラムから構成されるので，各モジュールを並行して開発して工期を短縮したいと考えた。モジュールごとの開発では，開発したプログラム単位でテストするためにダミーの主プログラムや副プログラムが必要だが，プログラム開発に掛けられる工期が不足していた。統合テストでの手戻りを防ぐため，単体テストが必要だが，コマンドの入力では手間も掛かり，プログラマーの大きな負担となっていた。

このケースに単体テスト支援を適用すると，次のような効果があります。

単体テストをGUIの操作で実行できるため，テストしたい項目が可視化され，コマンドの入力よりも手早くテストできます。

テストケースを複数作成できるため，同じテストを繰り返す場合や，テストケースの一部を修正して再びテストを実行する場合に，効率良く実行できます。さらに，次回のエンハンス時にも同じ単体テストを実行できます。

テストケースの結果レポートとカバレージをGUI上に一覧で表示できるので，テスト結果の資料ごとに確認する手間が省けます。

単体テストを実行する例を次の図に示します。

図2‒5　単体テストを実行する

3　セットアップ

COBOL2002 Developer Professionalのインストールとセットアップの手順について説明します。

3.1　セットアップの手順

COBOL2002 Developer Professionalのインストールとセットアップの手順です。

COBOL2002 Developer Professionalのインストールを実行すると，構成する機能であるCOBOL2002 Net DeveloperとCOBOL2002 Professional Tool Kitのインストーラが起動します。

COBOL2002がインストール済みのWindowsにインストールするときの注意

すでにCOBOL2002の開発環境（COBOL2002 Net Developer）がインストールされているWindowsにCOBOL2002 Developer Professionalをインストールする場合は，既存のCOBOL2002をいったんアンインストールしてください。

すでにCOBOL2002 Developer ProfessionalがインストールされているWindowsに再インストールする場合も，いったんアンインストールしてください。

上書きインストールについては，COBOL2002 Developer Professionalのリリースノートを参照してください。

3.2　COBOL2002 Developer Professionalをインストールする

COBOL2002 Developer Professionalのインストール方法です。

ポイント

COBOL2002 Developer Professionalは複数の製品を統合しているため，インストーラを起動すると，統合している機能（COBOL2002 Net Developer，COBOL2002 Professional Tool Kit）が表示されます。COBOL2002 Net DeveloperとCOBOL2002 Professional Tool Kitの両方をインストールしてください。

以降の説明では，COBOL2002 Developer Professionalの標準的なインストール方法を説明します。インストールの注意については，リリースノートを参照してください。

3.2.1　インストール前の準備をする

COBOL2002 Developer Professionalは，次に示す領域を使用します。

COBOL2002 Net DeveloperとCOBOL2002 Professional Tool Kitをインストールする領域

COBOL2002 Professional Tool Kitで使用する組み込みデータベースの領域

作業の手順

インストール先のディスク容量に十分な空きがあるかどうかを確認します。

必要なディスク容量については，COBOL2002 Developer Professionalのリリースノートを参照してください。

COBOL2002 Professional Tool Kitで使用する組み込みデータベースを格納するドライブおよびフォルダを決定します。

組み込みデータベースには，COBOL2002 Professional Tool Kitで使用するデータを格納するため，運用を続けると容量が増加します。組み込みデータベースは，Windowsがインストールされているドライブとは別のドライブに作成することをお勧めします。

注意事項

製品のインストール先および組み込みデータベースの作成先には，ネットワークドライブを指定できません。

3.2.2　製品をインストールする

COBOL2002 Developer Professionalをインストールするときは，Windowsに管理者権限でサインインしてください。

インストーラを起動する前に，すべてのプログラムを終了させてください。インストール時のエラーの対処については，「5.1.1　セットアップで問題が起こったときの対処」を参照してください。

注意事項

以降の手順で示す，COBOL2002 Net DeveloperとCOBOL2002 Professional Tool Kitのインストール手順は，両方とも実行してください。［キャンセル］ボタンをクリックするなどで，どちらか片方だけをインストールすると，COBOL2002 Developer Professionalの機能を使えないことがあります。

作業の手順

インストールする製品の提供媒体からインストーラを起動します。

COBOL2002 Developer Professionalの統合製品のインストーラ画面が表示されます。

［OK］ボタンをクリックし，インストールを開始します。

COBOL2002 Net Developerのインストールウィザードの開始を示すダイアログが表示されます。

ダイアログの内容を確認し，［次へ］ボタンをクリックします。

［ユーザ情報］ダイアログが表示されます。

ユーザ名と会社名を変更する場合は，次の条件で指定してください。

ユーザ名：50文字以内

会社名：80文字以内

ユーザ名と会社名の入力を確認し，［次へ］ボタンをクリックします。

インストール先のフォルダを選択するダイアログが表示されます。

標準のインストール先を次に示します。

COBOL2002 Net Developerをインストールする場合

Windowsのインストール先ドライブ:¥Program Files (x86)¥Hitachi¥COBOL2002¥

COBOL2002 Net Developer(64)をインストールする場合

Windowsのインストール先ドライブ:¥Program Files¥Hitachi¥Cobol2002 64bit¥

インストール先のドライブやフォルダを変更するときは，［変更］ボタンをクリックし，変更後のインストール先フォルダを指定してください。

注意事項

変更後のインストール先フォルダは，ドライブ名（「A」〜「Z」，「a」〜「z」の1文字＋「:」）で始まり，「A」〜「Z」，「a」〜「z」，「0」〜「9」，「 」（空白），「_」（アンダスコア），「.」（ピリオド），「（」（左括弧），「）」（右括弧）とパスを区切る「¥」で構成される，189文字以内の半角文字列で指定してください。

ネットワークドライブには，インストールしないでください。

［OK］ボタンをクリックすると，インストール先のフォルダを選択するダイアログに戻ります。

インストールの準備が完了したことを示すダイアログに遷移します。

インストール先のフォルダを選択するダイアログの［次へ］ボタンをクリックすると，インストールの準備ができたことを示すダイアログが表示されます。

問題がなければ，［インストール］ボタンをクリックします。

インストールが開始されます。

注意事項

［キャンセル］ボタンをクリックすると，統合製品のインストーラが終了します。［キャンセル］ボタンをクリックした場合は，インストールを最初からやり直してください。

インストールが完了すると，完了したことを示すダイアログが表示されます。

［完了］ボタンをクリックします。

これでCOBOL2002 Net Developerのインストールは完了です。

注意事項

COBOL2002 Net Developerのインストールが完了すると，COBOL2002を使用する前に再サインインを促すダイアログが表示されますが，すぐにサインアウトしないでください。統合形名のインストーラがすべて終了してから，サインアウトし再サインインしてください。

続けて，COBOL2002 Professional Tool Kitのインストールが開始されます。

COBOL2002 Net Developerのインストールの完了後，そのまま待ちます。

COBOL2002 Professional Tool Kitのインストールウィザードの開始を示すダイアログが表示されます。

ダイアログの内容を確認し，［次へ］ボタンをクリックします。

［ユーザー情報］ダイアログが表示されます。

ユーザー名と所属を変更する場合は，次の条件で指定してください。

ユーザー名：50文字以内

所属：80文字以内

ユーザー名と所属の入力を確認し，［次へ］ボタンをクリックします。

インストール先のフォルダを選択するダイアログが表示されます。

標準のインストール先を次に示します。

COBOL2002 Professional Tool Kit(32)をインストールする場合

Windowsのインストール先ドライブ:¥Program Files (x86)¥Hitachi¥COBOL2002 Professional Tool Kit¥

COBOL2002 Professional Tool Kit(64)をインストールする場合

Windowsのインストール先ドライブ:¥Program Files¥Hitachi¥COBOL2002 Professional Tool Kit¥

インストール先のドライブやフォルダを変更するときは，［変更］ボタンをクリックし，変更後のインストール先フォルダを指定してください。

注意事項

変更後のインストール先フォルダは，ドライブ名（「A」〜「Z」，「a」〜「z」の1文字＋「:」）で始まり，「A」〜「Z」，「a」〜「z」，「0」〜「9」，「 」（空白），「_」（アンダスコア），「.」（ピリオド），「（」（左括弧），「）」（右括弧）とパスを区切る「¥」で構成される，189文字以内の半角文字列で指定してください。

ネットワークドライブには，インストールしないでください。

［OK］ボタンをクリックすると，インストール先のフォルダを選択するダイアログに戻ります。

インストールの準備が完了したことを示すダイアログに遷移します。

インストール先のフォルダを選択するダイアログの［次へ］ボタンをクリックすると，インストールの準備ができたことを示すダイアログが表示されます。

問題がなければ，［インストール］ボタンをクリックします。

インストールが開始されます。

インストールが完了すると，完了したことを示すダイアログが表示されます。

［完了］ボタンをクリックします。

これでCOBOL2002 Professional Tool Kitのインストールは完了です。

注意事項

COBOL2002 Professional Tool Kitのインストールが完了すると，COBOL2002 Professional Tool Kitを使用する前に再サインインを促すダイアログが表示されます。インストール後すぐにCOBOL2002 Developer Professionalを使用する場合は，COBOL2002 Professional Tool Kitの環境変数を有効にするため，いったんサインアウトし，再サインインしてください。

インストールが完了したら，続けて，組み込みデータベースを作成してください。

3.2.3　インストール後のメニュー構成

COBOL2002 Developer Professionalをインストールすると，Windowsのプログラム一覧に［COBOL2002］と［COBOL2002 Professional Tool Kit］メニューが追加されます。

メニューの並び順は，インストールしたWindowsによって異なることがあります。

［COBOL2002］メニュー

［COBOL2002］メニューの項目については，マニュアル「COBOL2002 操作ガイド」を参照してください。

［COBOL2002 Cosminexus連携機能］

［COBOLエディタ for COBOL2002］

［COBOLコマンドプロンプト for COBOL2002］

［ISAMユティリティ］

［ODBCレコード定義生成 for COBOL2002］

［カバレージ for COBOL2002］

［テストデバッガ for COBOL2002］

［ファイル・レコード定義 for COBOL2002］

［画面定義 for COBOL2002］

［開発マネージャ for COBOL2002］

［実行支援 for COBOL2002］

［COBOL2002 Professional Tool Kit］メニュー※

次に示すメニューがあります。

DBユティリティ

組み込みデータベースを操作するDBユティリティを起動するメニューです。

組み込みデータベースは，「3.3.2　セットアップコマンドを実行する」で示す手順を実行すると，使用できるようになります。

影響波及調査

データ影響波及分析の解析結果を調査するときに起動するメニューです。

単体テスト支援

単体テスト支援を起動するメニューです。

注※

COBOLソース解析の操作方法については，マニュアル「COBOL2002 Professional Tool Kit COBOLソース解析ガイド」を参照してください。

3.3　組み込みデータベースを作成する

組み込みデータベースを作成する手順です。

組み込みデータベースは，COBOLソース解析とデータ影響波及分析で使用します。

組み込みデータベースは，Windowsがインストールされているドライブとは別のドライブに作成することをお勧めします。

1台のWindowsマシンで使用できるCOBOLソース解析の組み込みデータベースは1個です。複数の組み込みデータベースは使用できません。

以降のコマンドの実行例では，入力するコマンド文字列は太字で示します。

3.3.1　DBユティリティを起動する

作業の手順

Windowsのプログラム一覧にある［COBOL2002 Professional Tool Kit］−［DBユティリティ］メニューを選びます。

DBユティリティが起動されます。

参考

DBユティリティのコマンドプロンプトには，ドライブからの絶対パス名が表示されます。

コマンドプロンプトを短くしたい場合は，Windowsのpromptコマンドを使用してください。

（例）

prompt [DBUtility] $G と入力すると，以降の行のコマンドプロンプトは「[DBUtility] > 」と表示されます。

元に戻すときは，promptコマンドをオプションなしで実行してください。なお，DBユティリティを終了させて再び起動すると，絶対パス名のコマンドプロンプトに戻ります。

3.3.2　セットアップコマンドを実行する

作業の手順

組み込みデータベースをセットアップするときは，easetupコマンドを実行します。

easetupコマンドでは，-pオプションに組み込みデータベースで使用するTCP/IPのポート番号を，-dオプションに組み込みデータベースのフォルダパスを指定します。

注意事項

TCP/IPのポート番号は，インストールするWindowsマシンで固有な数字を5001〜65535の範囲で指定してください。-pオプションを省略すると，20411が仮定されます。

組み込みデータベースのフォルダパス名は，ドライブ名（「A」〜「Z」，「a」〜「z」の1文字＋「:」）で始まり，「A〜Z」，「a」〜「z」，「0」〜「9」，「 」（空白），「_」（アンダスコア），「.」（ピリオド）とパスを区切る「¥」で構成される，110文字以内の半角文字列で指定してください。

空白文字または丸括弧を含むパス名は，前後を引用符（"）で囲んでください。囲んでいないと，別のオプションと認識されます。

ネットワークドライブへは，組み込みデータベースをセットアップしないでください。

COBOL2002 Professional製品の32ビット版/64ビット版の切り替えや最新のバージョンへの入れ替えで旧製品をアンインストールした際にeaunsetupコマンドを実行していないと，easetupコマンドがエラーになって実行できません。その場合はeaunsetupコマンドを実行して古いデータベースを削除してからeasetupコマンドを実行してください。

easetupコマンドで以前の環境をそのまま引き継いで使用できるようにセットアップすることはできません。以前の環境を引き継いで使用したい場合は，バックアップとリストアを使用してください。

TCP/IPのポート番号に20411を使用し，組み込みデータベースのフォルダパスにD:¥cba dbを指定したコマンドの実行例を次に示します。

> easetup -p 20411 -d "D:¥cba db"

組み込みデータベースのセットアップ処理実行中です。
組み込みデータベースのセットアップ処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

組み込みデータベースのセットアップ処理を完了しました。

>

easetupコマンドの実行後，「組み込みデータベースのセットアップ処理を完了しました。」のメッセージが出力されたら，組み込みデータベースの作成は完了です。

注意事項

組み込みデータベースのフォルダは，エクスプローラで直接変更しないでください。組み込みデータベースのバックアップおよびリストアは，DBユティリティのコマンド（eabackupコマンド，earstrコマンド）を使用してください。

3.3.3　組み込みデータベースの状態を確認する

作業の手順

作成した組み込みデータベースの状態を確認するため，ealsコマンドを実行します。

実行結果の稼働状況がONLINEであることを確認してください。

> eals

稼働状況 ONLINE
ポート番号 20411
データベース "D:¥cba db"

>

確認を完了したら，exitコマンドで［DBユティリティ］画面を終了してください。

3.4　手動でODBCデータソースを登録／変更する

組み込みデータベースのセットアップでは，次に示すODBCデータソースが自動でシステムDSNに登録されます。

COBOL2002ToolKitDB

COBOL2002 Professional Tool Kit(32)，およびCOBOL2002 Professional Tool Kit(64)の32bitツール用のODBCデータソースです。

COBOL2002ToolKitDB64

COBOL2002 Professional Tool Kit(64)の64bitツール用のODBCデータソースです。

セットアップ時に登録されたODBCデータソースの構成を変更する場合はODBCデータソースアドミニストレーターを使って変更します。また，「5.4　環境が壊れてしまったとき」の対処で再インストール後にセットアップを実施しない場合は，ODBCデータソースアドミニストレーターを使って手動でODBCデータソースを登録します。

注意事項

COBOL2002 Developer Professionalをアンインストールし，再インストールした場合，以前に設定したODBCデータソースは削除されます。再インストール後にセットアップを実施しない場合はODBCデータソースを手動で登録する必要があります。

手動でODBCデータソースを登録する場合の指定例を次に示します。

作業の手順

データソース（ODBC）の［ODBCデータソース アドミニストレーター］画面の［システムDSN］タブを表示します。

ODBCデータソース アドミニストレーターは，次の方法で起動します。

32ビットのODBCデータソースを登録／変更する場合

32bit版（WOW64版）のデータソース（ODBC）設定のexeファイル（Windowsのインストール先ドライブ:¥Windows¥SysWOW64¥odbcad32.exe）を実行します。

64ビットのODBCデータソースを登録／変更する場合

64bit版のデータソース（ODBC）設定のexeファイル（Windowsのインストール先ドライブ:¥Windows¥system32¥odbcad32.exe）を実行します。

ポイント

COBOL2002 Developer Professionalでは，ODBCデータソースはシステムDSNで指定します。

ユーザーDSNで指定すると，使用するユーザー（サインインアカウント）ごとにODBCデータソースを作成し直す必要があるため，お勧めしません。

［追加］ボタンをクリックし，［データソースの新規作成］画面で，データソースのドライバを選んで，［完了］ボタンをクリックします。

32ビットのODBCデータソースの場合：HiRDB ODBC3.0 Driver _CTA

64ビットのODBCデータソースの場合：HiRDB ODBC3.0 Driver _CT0

クリックすると，［HiRDB Driver Setup］画面が表示されます。

［HiRDB Driver Setup］画面に，次に示す値を指定します。

DSN：

ODBCデータソース名を指定します。

COBOL2002 Professional Tool Kitでは，次のどちらかを指定してください。ほかの名称を指定すると，COBOL2002 Professional Tool Kitは正常に使用できません。

・32ビットのODBCデータソースの場合：COBOL2002ToolKitDB

・64ビットのODBCデータソースの場合：COBOL2002ToolKitDB64

PDHOST：

ループバックアドレスを示すlocalhostまたは127.0.0.1を指定します。

PDNAMEPORT：

組み込みデータベースで使うTCP/IPのポート番号を5001〜65535 の範囲で指定します。

ここには，easetupコマンドの-pオプションに指定した値を指定します。easetupコマンドの-pオプションを省略した場合は，PDNAMEPORTには20411を指定します。

ここでは，easetupコマンドでデフォルト値を指定したことを仮定し，20411を指定します。

HiRDB Client environment definition file name：

組み込みデータベースに関するiniファイルのパスを指定します。

COBOL2002 Professional Tool Kitのインストール先フォルダをデフォルトのままとした場合は，次のパスを指定します。

COBOL2002 Professional Tool Kit(32)をインストールした場合

Windowsのインストール先ドライブ:¥Program Files (x86)¥Hitachi¥COBOL2002 Professional Tool Kit¥hirdb_e_CT0¥CONF¥emb¥HiRDB.ini

COBOL2002 Professional Tool Kit(64)をインストールした場合

Windowsのインストール先ドライブ:¥Program Files¥Hitachi¥COBOL2002 Professional Tool Kit¥hirdb_e_CT0¥CONF¥emb¥HiRDB.ini

［HiRDB Driver Setup］画面の指定例を次に示します。

ポイント

PDHOSTには，必ずループバックアドレス（localhostまたは127.0.0.1）を指定してください。

COBOL2002 Professional Tool Kitをデフォルト以外の場所にインストールした場合は，HiRDB Client environment definition file nameには，実際にインストールしたフォルダパスを次の形式で指定してください。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥hirdb_e_CT0¥CONF¥emb¥HiRDB.ini

［OK］ボタンをクリックして，［HiRDB Driver Setup］画面を閉じます。

［ODBCデータソース アドミニストレーター］画面の［システムDSN］タブにODBCデータソースが表示されます。

［ODBCデータソース アドミニストレーター］画面の［OK］ボタンをクリックし画面を閉じます。

これでODBCデータソースの作成は完了です。

3.5　COBOL2002 Developer Professionalをアンインストールする

COBOL2002 Developer Professionalをアンインストールする手順です。

COBOL2002 Developer Professionalのアンインストールは，ここで示す手順で実行してください。

3.5.1　アンインストール前の準備をする

現状の環境をアンインストール後も使用する場合は，COBOL2002 Developer Professionalをアンインストールする前に，組み込みデータベースのバックアップを取得してください。取得したバックアップデータを使えば，再インストール後のCOBOL2002 Developer Professionalの環境に復元（リストア）できます。

組み込みデータベースのバックアップとリストアについては，「4.6　組み込みデータベースのバックアップを取得する」を参照してください。

3.5.2　組み込みデータベースをアンセットアップする

COBOL2002 Developer Professionalをアンインストールする前に，組み込みデータベースをアンセットアップする手順です。

作業の手順

COBOL2002 Developer Professionalをアンインストールする前に，DBユティリティを起動し，eaunsetupコマンドでアンセットアップします。

> eaunsetup

組み込みデータベースのアンセットアップ処理実行中です。
組み込みデータベースのアンセットアップ処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

組み込みデータベースのアンセットアップ処理を完了しました。

>

eaunsetupコマンドの実行後，「組み込みデータベースのアンセットアップ処理を完了しました。」のメッセージが出力されたら，組み込みデータベースのアンセットアップは完了です。

3.5.3　製品をアンインストールする

COBOL2002 Developer Professionalをアンインストールする手順です。

作業の手順

組み込みデータベースのサービス（HiRDB/EmbeddedEdition _CT0）を停止します。

Windowsの［プログラムと機能］または［プログラムの追加と削除］でアンインストールします。

アンインストールすると，セットアップ時に登録されたデータソースおよび「3.4　手動でODBCデータソースを登録／変更する」で登録したデータソースは削除されます。

注意事項

組み込みデータベースのサービスを停止しないでアンインストールを実行すると，アンインストールに失敗します。この場合の対処については，「5.1.5　COBOL2002 Professional Tool Kitのアンインストール時に問題が起こったときの対処」を参照してください。

アンインストールすると，組み込みデータベースのフォルダ一式がWindowsマシンに残ったままになります。必要に応じて，エクスプローラで削除してください。

COBOL2002 Net DeveloperとCOBOL2002 Professional Tool Kitは，両方ともアンインストールしてください。

4　解析環境の操作

COBOLソース解析およびデータ影響波及分析の解析環境を操作する方法について説明します。

4.1　解析環境の操作の一覧

COBOL2002 Professional Tool Kitの機能（COBOLソース解析，データ影響波及分析）で使用する解析情報は，組み込みデータベースで一元管理しています。組み込みデータベースは，DBユティリティで作成および保守します。DB ユティリティは，Windowsのコマンドプロンプトと同様に，コマンドを入力して操作します。

DBユティリティで実行できる操作を次の表に示します。

表4‒1　DBユティリティで実行できる操作

操作

DBユティリティのコマンド

このマニュアルの参照先

COBOLソース解析の解析環境を保存して利用する※1

eaenvsave − 環境設定情報の保存

eaenvload − 環境設定情報の読み込み

4.2

ほかのマシンに解析環境を複製する

eabackup − 組み込みデータベースのバックアップ

earstr − 組み込みデータベースのリストア

4.3

ほかのマシンにデータ影響波及分析用データベースを配布する※2

eadiaexp − データ影響波及分析用データベースのエクスポート

eadiaimp − データ影響波及分析用データベースのインポート

4.4

組み込みデータベースを退避してほかのマシンへ移行する

eadbextr − 組み込みデータベースから移行データの退避

eadbload − 組み込みデータベースを移行データで回復

4.5

組み込みデータベースのバックアップを取得する

eabackup − 組み込みデータベースのバックアップ

earstr − 組み込みデータベースのリストア

4.6

組み込みデータベースをセットアップ/アンセットアップする

easetup − 組み込みデータベースのセットアップ

eaunsetup − 組み込みデータベースのアンセットアップ

3.3.2

3.5.2

組み込みデータベースの状態を表示する

eals − 組み込みデータベースの状態の表示

3.3.3

組み込みデータベースを再編成する

earorg − 組み込みデータベースの再編成

5.2

注※1

COBOLソース解析の環境設定情報が対象です。データ影響波及分析は対象外です。

注※2

データ影響波及分析用データベースが対象です。COBOLソース解析用データベースは対象外です。

注意事項

COBOL2002 Professional Tool Kit(32)とCOBOL2002 Professional Tool Kit(64)の間では，組み込みデータベースのデータを移行できません。

このため，次の場合は，移行元と移行先が同じWindowsマシンのときでも，eaunsetupコマンドで古い組み込みデータベースを削除したあと，easetupコマンドで新しくデータベースをセットアップして，COBOLソース解析およびデータ影響波及分析を実行してください。

COBOL2002 Professional Tool Kit(32)からCOBOL2002 Professional Tool Kit(64)に切り替える

COBOL2002 Professional Tool Kit(64)からCOBOL2002 Professional Tool Kit(32)に切り替える

関連項目

「6.　組み込みデータベースの保守用コマンド」

4.2　COBOLソース解析の解析環境を保存して利用する

COBOLソース解析の解析環境を保存して利用する手順です。

COBOLソース解析を使用するときには，解析対象プロジェクトを設定する画面でCOBOL資産のソースファイル一式を追加します。少数のファイルであれば追加に時間はそれほど掛かりませんが，10,000ファイル以上を一括して追加する場合は時間が掛かります。さらに，追加した状態を保存しておいて，再度同じCOBOLソースファイル一式を解析する場合があります。

このような場合は，COBOLソース解析で設定した解析環境（環境設定情報）を保存して利用できます。環境設定情報ごとに保存して，必要なときに同じ解析環境を使用，またはほかのWindowsマシンで使用できます。

取得対象の環境設定情報

COBOLソース解析の解析対象プロジェクトと，プロジェクトに含まれるCOBOLソースファイル一覧，解析生成オプション

取得対象でない環境設定情報

COBOLソース解析のソース解析情報（HTMLファイル，CSVファイル），COBOLソースファイル

データ影響波及分析の各種データ

図4‒1　環境設定情報の操作

作業の手順

eaenvsaveコマンドを実行して，環境設定情報を保存します。

コマンドに指定した環境設定情報ファイルの保存先に，環境設定情報が保存されます。

eaenvloadコマンドを実行して，環境設定情報を読み込みます。

コマンドに指定した環境設定情報ファイルの情報を基に，現在使用しているCOBOLソース解析に環境設定情報が反映されます。

注意事項

環境設定情報の読み込みを実行すると，それまで使用していたCOBOLソース解析用データベース内のデータはすべて削除されます。eaenvloadコマンドを実行するときは，組み込みデータベースのバックアップを事前に取得しておくことをお勧めします。

関連項目

「eaenvloadコマンド − COBOLソース解析の環境設定情報の読み込み」

「eaenvsaveコマンド − COBOLソース解析の環境設定情報の保存」

4.3　ほかのマシンに解析環境を複製する

バックアップとリストアを利用して，Windowsマシンの解析環境を別のWindowsマシンに複製できます。

複製するときは，Windowsマシンをネットワークで接続し，必要なファイルをネットワーク経由でコピーしたあとで，複製先のマシンでCOBOLソース解析およびデータ影響波及分析の環境を構築します。

COBOL2002 Developer Professionalのバージョンおよびリビジョンが異なる場合は，取得したバックアップはリストアに使用できません。

図4‒2　解析環境の複製

作業の手順

複製元のWindowsマシンでeabackupコマンドを実行して，組み込みデータベースのバックアップを取得します。

複製後のWindowsマシンで，COBOL2002 Developer Professionalのインストールおよびセットアップを実行します。

インストール先フォルダと組み込みデータベースのフォルダパスは，バックアップを取得したCOBOL2002 Developer Professionalの設定に合わせてください。インストール先フォルダと組み込みデータベースのフォルダパスは，ローカルマシンのドライブ下に設定してください。

複製後のWindowsマシンに，取得したバックアップファイルを格納します。

複製後のWindowsマシンでearstrコマンドを実行して，バックアップから組み込みデータベースをリストアします。

COBOLソース解析およびデータ影響波及分析の各種の設定が，バックアップを取得した時点の設定内容に復元されます。

バックアップを取得するときは，取得する対象として次のデータベースを選択できます。

COBOLソース解析用データベース

データ影響波及分析用データベース

組み込みデータベース（上記の両方）

リストアするときは，バックアップファイルが上記のどの範囲で取得されたかを確認してください。バックアップを取得した範囲は，バックアップのコマンド（eabackupコマンド）のログファイル（データベース退避情報ファイル）の内容で確認できます。

関連項目

「eabackupコマンド − 組み込みデータベースのバックアップ」

「earstrコマンド − 組み込みデータベースのリストア」

4.4　データ影響波及分析用データベースをエクスポート/インポートする

別のWindowsマシンにデータ影響波及分析用データベースを複製するために，組み込みデータベースからデータ影響波及分析のデータをエクスポートおよびインポートする手順です。影響波及を分析した結果をほかのマシンに配布し，配布先のマシンでCOBOLプログラムを変更するときに使用します。

配布先のマシンでは，COBOL2002 Developer Professionalがセットアップされていることが前提です。

図4‒3　データ影響波及分析用データベースをエクスポート/インポート

作業の手順

データ影響波及分析でCOBOLプログラムを解析したWindowsマシンでeadiaexpコマンドを実行して，データ影響波及分析用データベースをエクスポートします。

配布先のWindowsマシンに，エクスポートしたデータ影響波及分析用データベースを配布します。

配布先のWindowsマシンでeadiaimpコマンドを実行して，データ影響波及分析用データベースをインポートします。

データ影響波及分析の各種の設定が，エクスポートした設定内容に復元されます。eadiaexpコマンドでデータ影響波及分析用データベースをエクスポートした際に，データ領域番号を指定していた場合は，eadiaexpコマンドで指定した番号のデータ領域にインポートされます。データ影響波及分析用データベースのデータ領域については，マニュアル「COBOL2002 Professional Tool Kit データ影響波及分析ガイド」を参照してください。

注意事項

データ影響波及分析用データベースのインポートを実行すると，それまで使用していたデータ影響波及分析用データベース内のデータは，インポートしないデータ領域に格納されているデータも含めて，すべて削除されます。eadiaimpコマンドを実行するときは，組み込みデータベースのバックアップを事前に取得しておくことをお勧めします。

関連項目

「eadiaexpコマンド − データ影響波及分析用データベースのエクスポート」

「eadiaimpコマンド − データ影響波及分析用データベースのインポート」

4.5　組み込みデータベースを退避してほかのマシンへ移行する

別のWindowsマシンへ組み込みデータベースを移行するため，組み込みデータベースの情報を退避して回復する手順です。

図4‒4　組み込みデータベースを退避して別のWindowsマシンに回復

作業の手順

eadbextrコマンドで，移行元のWindowsマシンの組み込みデータベースから移行データを退避します。

easetupコマンドで，移行先のWindowsマシンの組み込みデータベースをセットアップします。

eadbloadコマンドで，移行元のWindowsマシンの組み込みデータベースから抽出した移行データを，移行先のWindowsマシンの組み込みデータベースに回復します。

関連項目

「eadbextrコマンド − 組み込みデータベースから移行データの退避」

「eadbloadコマンド − 組み込みデータベースを移行データで回復」

「easetupコマンド − 組み込みデータベースのセットアップ」

4.6　組み込みデータベースのバックアップを取得する

組み込みデータベースのトラブルに備え，バックアップを取得することをお勧めします。バックアップを取得した時点に組み込みデータベースを復元するときは，リストアを実行します。

バックアップ対象は，次に示す情報です。

COBOLプログラムの解析情報，COBOLソース解析の解析生成オプションなど，COBOLソース解析の設定内容

データ影響波及分析が出力したプロジェクトの解析情報

次に示す情報は，バックアップの対象外です。エクスプローラでバックアップを取得してください。

COBOLソース解析で生成したソース解析情報（HTMLファイル形式，CSVファイル形式），COBOLソースファイル

データ影響波及分析の調査状態保存ファイル，CSVファイル，タグファイル，COBOLソースファイル

COBOL2002 Developer Professionalのバージョンおよびリビジョンが異なる場合は，取得したバックアップはリストアに使用できません。

バックアップを取得するときは，取得する対象として次のデータベースを選択できます。

COBOLソース解析用データベース

データ影響波及分析用データベース

組み込みデータベース（上記の両方）

リストアするときは，バックアップファイルが上記のどの範囲で取得されたかを確認してください。バックアップを取得した範囲は，バックアップのコマンド（eabackupコマンド）のログファイル（データベース退避情報ファイル）の内容で確認できます。

図4‒5　組み込みデータベースのバックアップとリストア

作業の手順

組み込みデータベースのバックアップを取得するときは，DBユティリティでeabackupコマンドを実行します。

このとき，-bオプションでバックアップファイルのフォルダパス名を指定します。

組み込みデータベースをバックアップ取得時点の環境にリストアするときは，DBユティリティでearstrコマンドを実行します。

このとき，-bオプションでバックアップファイルのフォルダパス名を指定します。

リストア先の組み込みデータベースは，バックアップを取得したときと同じドライブの，同じフォルダパス名で作成してあることが前提です。

ポイント

復元できるのは，バックアップを取得した時点の環境です。トラブルが起こった時点への復旧はできません。

関連項目

「eabackupコマンド − 組み込みデータベースのバックアップ」

「earstrコマンド − 組み込みデータベースのリストア」

5　エラー時の対処

COBOL2002 Developer Professionalのセットアップおよび組み込みデータベースでエラーが起こった場合の対処方法について説明します。

5.1　エラーへの対処方法

COBOL2002 Developer Professionalのセットアップおよび組み込みデータベースでエラーが起こったときの対処です。

このマニュアルでは，セットアップと組み込みデータベースのトラブルシュートおよびエラーメッセージについて説明します。機能ごとのトラブルシュートおよびメッセージについては，次に示すマニュアルを参照してください。

「COBOL2002 操作ガイド」

「COBOL2002 ユーザーズガイド」

「COBOL2002 メッセージ」

「COBOL2002 Professional Tool Kit COBOLソース解析ガイド」

「COBOL2002 Professional Tool Kit データ影響波及分析ガイド」

「COBOL2002 Professional Tool Kit 単体テスト支援ガイド」

5.1.1　セットアップで問題が起こったときの対処

COBOL2002 Developer Professionalのセットアップで問題が起こったときの対処を次の表に示します。

表5‒1　COBOL2002 Developer Professionalのセットアップで問題が起こったときの対処

問題

対処

次に示すダイアログが表示され，インストールできない。

「インストールには管理者権限が必要です。」

管理者権限でインストールする必要があります。

管理者権限でWindowsにサインインし直して，インストールしてください。

次に示すダイアログが表示され，インストールが中断された。

「同じセットアップ識別子のデータベースのサービスが「停止」状態ではありません。」

同じWindowsマシンで以前COBOL2002 Developer Professionalをアンインストールしたときに，組み込みデータベースのアンセットアップを実行していないことが考えられます。

Windowsのコントロールパネルの［サービス］で，「HiRDB/EmbeddedEdition _CT0」を停止してください。その後，アンセットアップを実行してください。

組み込みデータベースを作成できない。

空き容量が不足していることを示すメッセージが表示される場合は，十分な空き容量があるドライブを指定してください。

想定しない場所に組み込みデータベースが作成された。

easetupコマンドの-dオプションの入力ミスが考えられます。

いったん組み込みデータベースをeaunsetupコマンドでアンセットアップしてください。その後，正しい組み込みデータベースのフォルダパス名でeasetupコマンドを実行してください。

組み込みデータベースは作成できたが，リストアが異常終了する。

リストアは，バックアップを取得したときと同じドライブの，同じフォルダパス名で組み込みデータベースを作成してあることが前提です。

いったん組み込みデータベースのアンセットアップを実行し，バックアップを取得したときと同じフォルダパスを指定してセットアップを実行してください。

関連項目

「5.5.2　DBユティリティのメッセージと対処」

「easetupコマンド − 組み込みデータベースのセットアップ」

「eaunsetupコマンド − 組み込みデータベースのアンセットアップ」

5.1.2　組み込みデータベースに問題が起こったときの対処

組み込みデータベースに問題が起こったときの対処を次の表に示します。

表5‒2　組み込みデータベースに問題が起こったときの対処

問題

対処

Windowsのイベントビューアに，容量が不足したことを示すメッセージが表示される。メッセージを次に示す。

KFPH00211-I，KFPH00212-I，KFPH22037-W，KFPH22038-W

組み込みデータベースを再編成し，空き容量を増やしてください。

再編成を実行しても問題が解消しない場合は，組み込みデータベースをいったんアンセットアップして，再セットアップを実行してください。その際，十分な空き容量があるドライブに組み込みデータベースを再作成してください。

動作が遅く感じられる。

データを格納する領域が断片化されていることが考えられます。組み込みデータベースを再編成し，空き容量を増やしてください。

「内部エラー：」で始まるメッセージが表示された。

内部エラーが起こっています。必要なファイルを不当に削除していないかどうか，またはフォルダのアクセス権が正しく設定されているかどうかを確認してください。

エラーの原因に心当たりがない場合は，ログファイルを退避して保守員に連絡してください。退避が必要なログファイルについては，「5.1.6　保守員に連絡するときに必要なファイルの格納場所」を参照してください。

コマンドを実行したら，ユーザーアカウント制御に関するエラーが複数回表示されて実行できない。

ユーザーアカウント制御（UAC）が有効な状態で，DBユティリティ コマンドプロンプトを管理者権限で実行していないことが考えられます。

DBユティリティ コマンドプロンプトを管理者として実行してから，コマンドを実行してください。

コマンドの実行中にキャンセルしたら，DBユティリティのコマンドが動作しなくなった。

ealsコマンドで組み込みデータベースの稼働状況を確認してください。稼働状況がONLINE以外の状態が続く場合は，Windowsを再起動してください。

Windowsを再起動しても稼働状況がONLINEに切り替わらない場合は，組み込みデータベースのセットアップに失敗している，または組み込みデータベースが壊れていることが考えられます。組み込みデータベースをアンセットアップしたあとに，再セットアップを実行してください。

組み込みデータベースのサービスが起動しない。

組み込みデータベースでウィルスチェックが実行されていることが原因として考えられます。

組み込みデータベースプログラム格納先フォルダ，および組み込みデータベース作成フォルダは，COBOLソース解析およびデータ影響波及分析の稼働時にはウィルスチェックを実行しないように設定を変更してください。

関連項目

「5.5.2　DBユティリティのメッセージと対処」

「ealsコマンド − 組み込みデータベースの状態の表示」

5.1.3　ウィルス対策ソフト実行時の注意

ウィルス対策ソフトの影響で，COBOLソース解析またはデータ影響波及分析が使用しているファイルおよびフォルダに対して排他制御によるロックが掛かり，次の現象が起こることがあります。

COBOLソース解析またはデータ影響波及分析が起動できない

COBOLソース解析およびデータ影響波及分析の起動時に参照する組み込みデータベースにロックが掛かり，起動に失敗することがあります。

定義を変更できない

COBOLソース解析の環境設定情報ファイルまたはデータ影響波及分析の調査状態保存ファイルにロックが掛かり，ファイルの変更に失敗することがあります。

ログが出力されない

COBOLソース解析のログファイルにロックが掛かり，ログが出力できなくなることがあります。

COBOLソース解析またはデータ影響波及分析の操作が異常終了する

COBOLソース解析またはデータ影響波及分析の操作で使用するファイルにロックが掛かり，異常終了することがあります。

COBOLソース解析またはデータ影響波及分析の稼働中にウィルスチェックを実行する場合は，次のフォルダを対象から外してください。

インストール時に指定したフォルダ下のCOBOL2002 Professional Tool Kitフォルダ

デフォルトのインストールフォルダのパス名を次に示します。

32bit版のWindowsにCOBOL2002 Professional Tool Kit(32)をインストールした場合，または64bit版のWindowsにCOBOL2002 Professional Tool Kit(64)をインストールした場合

C:¥Program Files¥Hitachi¥COBOL2002 Professional Tool Kit

64bit版のWindowsにCOBOL2002 Professional Tool Kit(32)をインストールした場合

C:¥Program Files (x86)¥Hitachi¥COBOL2002 Professional Tool Kit

組み込みデータベースを作成したフォルダ

セットアップコマンドを「easetup -p 20411 -d D:¥COBOL¥DB」と指定した場合は「D:¥COBOL¥DB」です。

また，COBOLソース解析またはデータ影響波及分析を開始する前に，上記のフォルダに対してのウィルスチェックが完了していることを確認してください。

関連項目

「easetupコマンド − 組み込みデータベースのセットアップ」

5.1.4　Windowsファイアウォールの例外リストへの登録

COBOL2002 Professional Tool Kitの初回起動時に［セキュリティの重要な警告］画面が表示されるのを回避する方法です。

Windowsファイアウォールを有効にしている環境では，COBOL2002 Professional Tool Kitの機能の初回起動時に［セキュリティの重要な警告］画面が表示されることがあります。この表示は，COBOL2002 Professional Tool Kitが使用するポート番号または実行可能プログラムをWindowsファイアウォールの例外リストに登録すると回避できます。次のどちらかを設定してください。

ポート番号を例外リストに登録

組み込みデータベースのセットアップ時に指定したポート番号（省略した場合は20411）を例外リストに登録します。

WindowsのコントロールパネルからWindowsファイアウォールを起動して，［例外］タブまたは受信の規則にポート番号を追加してください。

COBOL2002 Professional Tool Kitの実行ファイルを例外リストに登録

WindowsのコントロールパネルからWindowsファイアウォールを起動して，［例外］タブまたは受信の規則に，次に示す実行可能ファイルをすべて登録してください。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥bin¥cbldra.exe（データ影響波及分析）

COBOL2002 Professional Tool Kitのインストール先フォルダ¥bin¥cbldia.exe（データ影響波及分析）

COBOL2002 Professional Tool Kitのインストール先フォルダ¥bin¥cbldiaGUI.exe（データ影響波及分析）

COBOL2002 Professional Tool Kitのインストール先フォルダ¥bin¥cblcsa.exe（COBOLソース解析）

COBOL2002 Professional Tool Kitのインストール先フォルダ¥bin¥cblcsaSetOptions.exe（COBOLソース解析）

COBOL2002 Professional Tool Kitのインストール先フォルダ¥DBUtility¥bin¥eaexecsql.exe（DBユティリティ）

関連項目

「付録A　インストール先のフォルダ構成」

5.1.5　COBOL2002 Professional Tool Kitのアンインストール時に問題が起こったときの対処

COBOL2002 Professional Tool Kitを正しくアンインストールしていないと，アンインストールの実行時にCOBOL2002 Professional Tool Kitのインストール先フォルダ¥hirdb_e_CT0にunsetup.errファイルが作成され，アンインストールが中断されます。

注意事項

unsetup.errファイルが格納されたままだと，アンインストールは実行できません。unsetup.errファイルをテキストエディタで開いて，エラーコードを確認し対処を完了したら，unsetup.errファイルを削除してからアンインストールし直してください。

COBOL2002 Professional Tool Kitのアンインストール時に問題が起こったときの対処を次の表に示します。

表5‒3　COBOL2002 Professional Tool Kitのアンインストール時に問題が起こったときの対処

問題

対処

次に示すダイアログが表示され，アンインストールが中断された。

「インストール先フォルダ¥hirdb_e_CT0¥unsetup.errファイルを削除してからアンインストールを実行してください。」

unsetup.errファイルをテキストエディタで開いて，エラーコードを確認してください。その後，「表5-4　アンインストール時のエラーコードの一覧」を参照して対処してください。

次に示すダイアログが表示され，アンインストールが中断された。

「データベースのアンインストールに失敗しました。インストール先フォルダ¥hirdb_e_CT0¥unsetup.errのエラーコードを参照して，マニュアルに従って対策してください。」

unsetup.errファイルに書き込まれるエラーコードの一覧と対処を次の表に示します。

表5‒4　アンインストール時のエラーコードの一覧

エラーコード

対処

80

組み込みデータベースのアンセットアップを実行していないため，組み込みデータベースが停止していません。

unsetup.errファイルを削除し，組み込みデータベースをアンセットアップしてから，COBOL2002 Professional Tool Kitのアンインストールを再実行してください。

94

組み込みデータベースのサービス（HiRDB/EmbeddedEdition _CT0）が停止状態になっていません。

組み込みデータベースのサービスを停止させてください。その後，unsetup.errファイルを削除してから，COBOL2002 Professional Tool Kitのアンインストールを再実行してください。

9C

実行中のプロセスが残っていたため，一部のファイルが削除できません。

削除できなかったファイルは，Windowsを再起動すると削除されます。unsetup.errファイルを削除し，アンインストールを再実行したあとで，Windowsを再起動してください。

関連項目

「eaunsetupコマンド − 組み込みデータベースのアンセットアップ」

5.1.6　保守員に連絡するときに必要なファイルの格納場所

保守員に連絡するときに必要な情報の説明です。

(1)　Windowsのイベントログファイル

Windowsのイベントビューアから，アプリケーションのイベントログをエクスポートしてください。

(2)　DBユティリティのコマンドのログファイル

ログファイルを出力するDBユティリティのコマンドで，デフォルトでログファイルが格納されるフォルダを次に示します。保守員に連絡する際は，このフォルダに格納されたログファイルを提供してください。

コマンドオプションでログファイルの出力先を変更した場合は，コマンドオプションに指定したフォルダに格納されているログファイルを提供してください。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥logs

参考

デフォルトのインストール先にCOBOL2002 Professional Tool Kitをインストールした場合のフォルダパスを次に示します。

32bit版のWindowsにCOBOL2002 Professional Tool Kit(32)をインストールした場合，または64bit版のWindowsにCOBOL2002 Professional Tool Kit(64)をインストールした場合

Windowsのインストール先ドライブ:¥Program Files¥Hitachi¥COBOL2002 Professional Tool Kit¥logs

64bit版のWindowsにCOBOL2002 Professional Tool Kit(32)をインストールした場合

Windowsのインストール先ドライブ:¥Program Files (x86)¥Hitachi¥COBOL2002 Professional Tool Kit¥logs

(3)　組み込みデータベースのログファイル

次に示す場所に格納されている，組み込みデータベースのログファイルを提供してください。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥hirdb_e_CT0¥SPOOL

COBOL2002 Professional Tool Kitのインストール先フォルダ¥hirdb_e_CT0¥UXPLDIR¥spool

Windowsの環境変数TEMPで定義されているフォルダ¥pderr1.trc※

Windowsの環境変数TEMPで定義されているフォルダ¥pderr2.trc※

注※

データ影響波及分析では，実行時のカレントフォルダにpderr1.trcおよびpderr2.trcが出力されます。

関連項目

「eabackupコマンド − 組み込みデータベースのバックアップ」

「earstrコマンド − 組み込みデータベースのリストア」

「earorgコマンド − 組み込みデータベースの再編成」

5.2　組み込みデータベースの再編成

組み込みデータベースへの格納と削除を繰り返すと，データの格納領域が断片化され，実際の空き領域よりも残りの容量が下がることがあります。このような場合に，組み込みデータベースの格納効率を上げるため，データの格納領域を調整することを組み込みデータベースの再編成といいます。組み込みデータベースの再編成を実行すると，格納効率が上がります。

組み込みデータベースの再編成は，定期的に実行することをお勧めします。

図5‒1　組み込みデータベースの再編成

組み込みデータベースを再編成するときは，DBユティリティからearorgコマンドを実行します。

組み込みデータベースの再編成では，再編成する対象として次のデータベースを選択できます。

COBOLソース解析用データベース

データ影響波及分析用データベース

組み込みデータベース（上記の両方）

注意事項

再編成に掛かる時間は，組み込みデータベースの容量とデータ量に比例します。COBOLプログラムおよび解析データが多大である場合は，処理に時間が掛かることがあります。組み込みデータベースの再編成は，業務に支障がないタイミングで実行することをお勧めします。

関連項目

「earorgコマンド − 組み込みデータベースの再編成」

5.3　組み込みデータベースの回復方法

組み込みデータベースでエラーが起こったときの回復方法です。

5.3.1　組み込みデータベースの回復手順

組み込みデータベースを回復する手順です。

図5‒2　組み込みデータベースの回復手順

作業の手順

組み込みデータベースの状態を確認します。

状態を確認するコマンド（ealsコマンド）で，組み込みデータベースの稼働状況を確認します。稼働状況がONLINE以外の状態が続く場合は，組み込みデータベースが正しく稼働していません。

対策を判定します。

稼働状況と対処を次に示します。稼働状況がONLINE以外の場合は，次のように対処します。

稼働状況

対処

ONLINE

組み込みデータベースは稼働しています。対処は不要です。

STOP

サービス停止状態です。Windowsを再起動してください。

Windowsを再起動しても稼働状況がONLINEに切り替わらない場合は，組み込みデータベースのセットアップに失敗，または組み込みデータベースが壊れていることが考えられます。組み込みデータベースのアンセットアップ後に再セットアップを実行してください。

STARTING

開始処理中です。しばらく待っても状態が変わらない場合は，DBユティリティをいったん終了し，Windowsを再起動してください。

STOPPING

サービス停止処理中です。DBユティリティをいったん終了し，Windowsを再起動してください。

UNSETUP

組み込みデータベースがセットアップされていません。セットアップを実行してください。

Windowsを再起動してもエラーが解決しない場合は，COBOL2002 Developer Professionalを再インストールしてください。

なお，組み込みデータベースの容量不足が原因である場合は，組み込みデータベースをアンセットアップしたあとで，組み込みデータベースを作成するドライブの容量を増やしてください。手順については，「5.3.2　容量不足に伴う組み込みデータベースの再セットアップ」を参照してください。

組み込みデータベースのバックアップとアンセットアップを実行します。

現在の開発環境のバックアップを取得するため，組み込みデータベースのバックアップ（eabackupコマンド）を実行します。次に，DBユティリティから組み込みデータベースのアンセットアップ（eaunsetupコマンド）を実行します。

組み込みデータベースの再セットアップとリストアを実行します。

組み込みデータベースのセットアップ（easetupコマンド）を実行します。その後，組み込みデータベースのリストア（earstrコマンド）を実行します。

上記の手順で問題が解決しない場合は，手順3.の実行後に，COBOL2002 Professional Tool Kitをアンインストールし，インストールからやり直してください。

注意事項

アンインストールすると，組み込みデータベースのフォルダ一式がWindowsマシンに残ったままになります。エクスプローラで削除してください。

COBOLソース解析用データベースおよびデータ影響波及分析用データベースの最大値はそれぞれ64GBと128GBです。

COBOLソース解析またはデータ影響波及分析の実行中に最大値を超えると，データベースのエラーになります。

データ影響波及分析でエラーとなった場合は，現在使用中のデータ領域と異なるデータ領域に格納することで，エラーを回避できます。

データ影響波及分析で空いているデータ領域がない場合やCOBOLソース解析の場合は，earorgコマンドで組み込みデータベースを再編成するか，不要なプロジェクトやプロジェクト内のデータを削除して組み込みデータベースの容量を低減してください。

関連項目

「eabackupコマンド − 組み込みデータベースのバックアップ」

「ealsコマンド − 組み込みデータベースの状態の表示」

「earstrコマンド − 組み込みデータベースのリストア」

「eaunsetupコマンド − 組み込みデータベースのアンセットアップ」

5.3.2　容量不足に伴う組み込みデータベースの再セットアップ

組み込みデータベースの容量を増やす手順です。これまで使用していたCOBOLソース解析およびデータ影響波及分析の環境は引き継げます。

組み込みデータベースの再編成を実行しても容量が不足している場合は，いったん組み込みデータベースをアンセットアップし，その後，セットアップを再実行してください。

(1)　組み込みデータベースの容量不足の検知方法

組み込みデータベースのディスク容量が少なくなった場合，Windowsのイベントビューアに次に示す組み込みデータベースのメッセージが出力されます。

KFPH00211-I，KFPH00212-I，KFPH22037-W，KFPH22038-W

通常よりも操作が遅い場合，これらのメッセージが出力されているかどうか確認し，出力されている場合は，組み込みデータベースの再編成を実行してください。組み込みデータベースの再編成を実行しても改善されない場合は，組み込みデータベースを再セットアップしてください。

(2)　組み込みデータベースの再セットアップ

容量不足によって，組み込みデータベースを再セットアップする手順です。同じWindowsマシンで再セットアップするときは，ドライブと組み込みデータベースのフォルダパスの構成は同じになるようにしてください。

図5‒3　組み込みデータベースの再セットアップ

作業の手順

現在使用している組み込みデータベースのバックアップを取得します。

組み込みデータベースをアンセットアップします。

ハードディスクを増設し，組み込みデータベースを作成するディスクの容量を増やします。次に，増設したハードディスクに，前回組み込みデータベースとして使用していたドライブと同じドライブ名を定義します。

組み込みデータベースをセットアップします。

このとき，組み込みデータベースのフォルダパスは，バックアップを取得したときの組み込みデータベースのフォルダパスに合わせてください。

手順1.で作成したバックアップファイルを指定して，リストアを実行します。

関連項目

「5.5.2　DBユティリティのメッセージと対処」

5.3.3　ハードウェアの入れ替えに伴う環境の移行

移行元のWindowsマシンと移行先のWindowsマシンをネットワークで接続して，必要なファイルをネットワーク経由でコピーできます。

移行先のWindowsマシンの環境が異なる場合は，設定を修正してください。

同じディスク構成への移行

ハードウェアの入れ替えに伴い，現在のCOBOLソース解析とデータ影響波及分析の環境をそのまま移行するときは，バックアップとリストアを使用します。

移行元のWindowsマシンと移行先のWindowsマシンの製品バージョンと，組み込みデータベースの格納フォルダは同じにしてください。

作業の手順

移行先のWindowsマシンにCOBOL2002 Developer Professionalをセットアップします。

移行元のWindowsマシンでeabackupコマンドを実行してバックアップを取得し，出力したバックアップファイルを移行先のWindowsマシンにコピーします。

移行元のWindowsマシンでearstrコマンドを実行してリストアします。このとき，バックアップファイル名には手順2.でコピーしたファイルを指定します。

異なるディスク構成への移行

ハードウェアの入れ替えに伴い，現在のCOBOLソース解析とデータ影響波及分析の環境を別のディスクに移行するときは，データ移行用の退避と回復を使用します。

作業の手順

移行元のWindowsマシンのドライブにある組み込みデータベースから，eadbextrコマンドで移行データを抽出します。

移行先のWindowsマシンに組み込みデータベースがある場合（移行元のWindowsマシンと移行先のWindowsマシンが同じである場合，など）は，eaunsetupコマンドでアンセットアップします。

移行先のWindowsマシンのドライブにある組み込みデータベースをeasetupコマンドでセットアップします。

移行元のドライブの組み込みデータベースから抽出した移行データを，eadbloadコマンドで移行先ドライブの組み込みデータベースにロードします。

関連項目

「eabackupコマンド − 組み込みデータベースのバックアップ」

「earstrコマンド − 組み込みデータベースのリストア」

「eadbextrコマンド − 組み込みデータベースから移行データの退避」

「eadbloadコマンド − 組み込みデータベースを移行データで回復」

「easetupコマンド − 組み込みデータベースのセットアップ」

「eaunsetupコマンド − 組み込みデータベースのアンセットアップ」

5.3.4　組み込みデータベースの再作成

セットアップした組み込みデータベースを削除し，新しい組み込みデータベースを作成する手順です。これまで使用していたCOBOLソース解析およびデータ影響波及分析の環境は引き継げません。

組み込みデータベースの破壊によってバックアップを取得できないなど，組み込みデータベースに致命的な問題があった場合は，新しく組み込みデータベースを作成してください。

図5‒4　組み込みデータベースの再作成

作業の手順

eaunsetupコマンドで，組み込みデータベースをアンセットアップします。

easetupコマンドで，組み込みデータベースをセットアップします。

手順1.でアンセットアップした組み込みデータベースと同じフォルダパス名を指定しても，異なるフォルダパス名を指定してもかまいません。

関連項目

「easetupコマンド − 組み込みデータベースのセットアップ」

「eaunsetupコマンド − 組み込みデータベースのアンセットアップ」

5.3.5　組み込みデータベースの容量不足を回復したあとの業務

組み込みデータベースの容量不足が原因の場合，組み込みデータベースを格納するハードディスクを増設し，容量不足を回復したあとで，COBOLソース解析およびデータ影響波及分析を続行してください。

COBOLソース解析で，複数のCOBOLプログラムを一括して解析している場合に，組み込みデータベースの容量不足でエラーになったときは，ソース解析情報は途中まで生成できているため，COBOLソースファイルの登録数と解析環境は保持されます。解析を実行していないCOBOLプログラムを指定して，COBOLソース解析を実行してください。

5.4　環境が壊れてしまったとき

不当にファイルやフォルダを削除するなどの操作誤りが原因で，COBOLソース解析およびデータ影響波及分析のプログラムやフォルダが壊れてしまったときは，次の手順で環境を回復してください。

5.4.1　現在の組み込みデータベースをそのまま残す方法

組み込みデータベースのサービス「HiRDB/EmbeddedEdition _CT0」は実行しているが，組み込みデータベースの状態表示や再編成時にKEDL0096U-Eメッセージが出力される場合は，現在の組み込みデータベースをそのまま残し，COBOLソース解析およびデータ影響波及分析のプログラム環境を回復してください。

作業の手順

COBOL2002 Professional Tool Kitをアンインストールします。

組み込みデータベースのアンセットアップは実施しないでください。組み込みデータベースが削除され残せなくなります。

COBOL2002 Developer Professionalをインストールします。

COBOL2002 Professional Tool Kitは，前回のインストールと同じ場所にインストールしてください。組み込みデータベースのリストアまたはセットアップは実行しないでください。

ODBCデータソースを登録します。

「3.4　手動でODBCデータソースを登録／変更する」に示す方法でODBCデータソースを登録してください。

関連項目

「5.5.2　DBユティリティのメッセージと対処」

5.4.2　現在の組み込みデータベースが壊れてしまった場合の修復方法

現在の組み込みデータベースも壊れ，サービス「HiRDB/EmbeddedEdition _CT0」が実行できなくなった場合は，次に示す手順で組み込みデータベースを回復してください。

作業の手順

COBOL2002 Professional Tool Kitをアンインストールします。

COBOL2002 Developer Professionalをインストールします。

COBOL2002 Professional Tool Kitは，前回のインストールと同じ場所にインストールしてください。組み込みデータベースも，同じドライブで同じフォルダパスに作成してください。

バックアップデータがある場合は，リストアを実行します。

バックアップデータがない場合は，eaunsetupコマンドを実行したあとで，easetupコマンドを実行します。この場合，組み込みデータベースの内容は回復できませんので，すべてのCOBOLソースファイルを解析し直してください。

関連項目

「easetupコマンド − 組み込みデータベースのセットアップ」

「eaunsetupコマンド − 組み込みデータベースのアンセットアップ」

5.5　DBユティリティのメッセージ

DBユティリティの操作で出力されるメッセージの説明です。

コンパイラ，テストデバッガ，およびCOBOL2002の実行時のエラーメッセージ（KCCCで始まるメッセージ）については，マニュアル「COBOL2002 メッセージ」を参照してください。

COBOL2002 Professional Tool Kitの機能ごとのメッセージについては，次に示すマニュアルを参照してください。

「COBOL2002 Professional Tool Kit COBOLソース解析ガイド」

「COBOL2002 Professional Tool Kit データ影響波及分析ガイド」

「COBOL2002 Professional Tool Kit 単体テスト支援ガイド」

5.5.1　DBユティリティのメッセージの形式

DBユティリティのメッセージの形式です。

KEDLnnnnU-i メッセージテキスト

KEDL：COBOL2002 Professional Tool Kitのメッセージであることを示します。

nnnn：4けたの番号です。

U：DBユティリティのメッセージであることを示します。

i ：メッセージの重要度を示します。

E：エラーメッセージであることを示します。

W：警告メッセージであることを示します。

5.5.2　DBユティリティのメッセージと対処

DBユティリティから通知されるメッセージと対処の説明です。

メッセージテキストの先頭が「内部エラー：」と表示された場合は，内部エラーを示します。ログを格納したフォルダを保存し，保守員に連絡してください。退避が必要なログファイルについては，「5.1.6　保守員に連絡するときに必要なファイルの格納場所」を参照してください。

表5‒5　DBユティリティから通知されるメッセージと対処

メッセージID

メッセージテキスト

対処

KEDL0001U-E

aa...aaオプションの指定値が不正です。

aa...aaで示すオプションの指定値について次の点を見直したあとで，再実行してください。

オプションの指定値が正しいか。

オプションの指定値が重複して指定されていないか。

必須オプションが省略されていないか。

KEDL0002U-E

aa...aaオプションは指定できません。

aa...aaで示すオプションの指定値について次の点を見直したあとで，再実行してください。

指定できないオプションが指定されていないか。

オプションが重複して指定されていないか。

KEDL0003U-E

内部エラー：指定されたフォルダは，組み込みデータベース運用フォルダではありません。

保守員に連絡してください。

KEDL0004U-E

内部エラー：組み込みデータベース運用フォルダが指定されていません。

保守員に連絡してください。

KEDL0005U-E

指定したポート番号は，他のプログラムと重複しています。

ポート番号にほかの値を指定して，再実行してください。

KEDL0006U-E

内部エラー：内部ファイル（システム定義入力ファイル）の内容に誤りがあります。

保守員に連絡してください。

KEDL0007U-E

内部エラー：内部ファイルが存在しません。

組み込みデータベースのセットアップに必要なファイルが存在しません。

エラーの原因に心当たりがない場合は，保守員に連絡してください。

KEDL0008U-E

内部エラー：ファイルのオープンに失敗しました。

組み込みデータベースのセットアップに必要なファイルのオープンに失敗しました。

エラーの原因に心当たりがない場合は，保守員に連絡してください。

KEDL0009U-E

内部エラー：ファイルの生成に失敗しました。

組み込みデータベースのセットアップに必要なファイルを作成できません。

エラーの原因に心当たりがない場合は，保守員に連絡してください。

KEDL0010U-E

内部エラー：ファイルの読み込みに失敗しました。

組み込みデータベースのセットアップに必要なファイルの読み込みに失敗しました。

エラーの原因に心当たりがない場合は，保守員に連絡してください。

KEDL0011U-E

内部エラー：フォルダの作成に失敗しました。

組み込みデータベースのセットアップに必要なフォルダの作成に失敗しました。フォルダの権限が正しく設定されていないことが考えられます。

エラーの原因に心当たりがない場合は，保守員に連絡してください。

KEDL0012U-E

フォルダまたはドライブが，存在しないか書き込み不可であるため，ファイルを作成できません。

フォルダパスには，存在するドライブ下の，書き込みができるフォルダを指定してください。

KEDL0013U-E

ドライブの容量が不足しているため，組み込みデータベースを作成できません。

組み込みデータベースを作成するフォルダには，5.6GB以上の空き容量があるドライブのフォルダを指定してください。

KEDL0014U-E

内部エラー：ドライブの空き容量を超えたファイルを作成しようとしています。

保守員に連絡してください。

KEDL0015U-E

内部エラー：ファイルシステム領域用空き領域が不足しています。

保守員に連絡してください。

KEDL0016U-E

組み込みデータベース領域の作成でエラーが発生しました。

組み込みデータベースのセットアップに必要なファイルの生成に失敗しました。

組み込みデータベースを作成するフォルダの指定方法を確認し，再実行してください。

KEDL0017U-E

内部エラー：システムファイルの初期設定でエラーが発生しました。

保守員に連絡してください。

KEDL0018U-E

内部エラー：組み込みデータベースの起動または組み込みデータベースの初期設定でエラーが発生しました。

保守員に連絡してください。

KEDL0019U-E

内部エラー：組み込みデータベースの作成でエラーが発生しました。

保守員に連絡してください。

KEDL0020U-E

内部エラー：一時ファイルの作成に失敗しました。

組み込みデータベースのセットアップに必要な一時ファイルを作成できません。

保守員に連絡してください。

KEDL0021U-E

内部エラー：ファイルの書式が不正です。

組み込みデータベースのセットアップに必要なファイルの書式が不正です。ファイルを格納しているフォルダの権限に誤りがあることが考えられます。

エラーの原因に心当たりがない場合は，保守員に連絡してください。

KEDL0022U-E

内部エラー：組み込みデータベースを作成するフォルダの指定が不正です。

保守員に連絡してください。

KEDL0023U-E

内部エラー：テーブル定義ファイルに指定されているユーザ名の指定が不正です。

保守員に連絡してください。

KEDL0024U-E

組み込みデータベースのセットアップ環境がすでに存在します。

組み込みデータベースのセットアップが完了している状態でセットアップを実行するか，セットアップが途中で失敗している状態でセットアップを再実行すると，このエラーになることがあります。

データの保存が必要であれば，eabackupコマンドでバックアップを取得したあとで，eaunsetupコマンドでいったんアンセットアップし，easetupコマンドを再実行してください。

KEDL0025U-E

メモリ不足が発生しました。

次に示す操作を実行して，使用できるメモリに余裕を持たせてから再実行してください。

同時実行しているプロセス数を減らす。

スワップ領域を増やす。

実メモリを増設する。

KEDL0026U-E

内部エラー：データベース情報の作成処理でエラーが発生しました。

保守員に連絡してください。

KEDL0027U-E

内部エラー：内部オブジェクトの作成処理でエラーが発生しました。

保守員に連絡してください。

KEDL0028U-E

内部エラー：システム共通定義のpd_haオペランドに"use"が指定されていません。

保守員に連絡してください。

KEDL0029U-E

内部エラー：指定値が指定可能最大数を超えています。

保守員に連絡してください。

KEDL0030U-E

内部エラー：初期値ファイルの指定値が不正です。

保守員に連絡してください。

KEDL0031U-E

内部エラー：ファイルの削除に失敗しました。

保守員に連絡してください。

KEDL0032U-E

内部エラー：組み込みデータベースのセットアップ環境が存在しません。

保守員に連絡してください。

KEDL0033U-E

内部エラー：標準ホスト名が取得できません。

保守員に連絡してください。

KEDL0034U-E

内部エラー：OS 関数でエラーが発生しました。

保守員に連絡してください。

KEDL0035U-E

このコマンドはDBユティリティ以外からは実行できません。DBユティリティ上で実行してください。

コマンドをDBユティリティ以外から実行しようとしています。DBユティリティ上で実行してください。

KEDL0036U-E

組み込みデータベースを作成するフォルダの絶対パス名が長すぎます。110文字以下を指定してください。

フォルダの絶対パス名は，110文字以下で指定してください。

KEDL0037U-E

aa...aaファイルが存在しません。

aa...aaで示すファイルが存在しません。

ファイルパス名の指定値を見直したあとで，再実行してください。

KEDL0038U-E

内部エラー：再編成処理がスキップされたRDエリアがあります。

再編成に関連するエラーが発生しました。

組み込みデータベースの再編成を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0039U-E

再編成処理が異常終了しました。

再編成でエラーが発生しました。

組み込みデータベースの再編成を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0040U-E

内部エラー：バックアップ処理中にエラーが発生しましたが，一部バックアップされたRD エリアもあります。

バックアップに関連するエラーが発生しました。

バックアップされたデータが不完全であることが考えられるため，バックアップ処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0041U-E

バックアップ処理が異常終了しました。

バックアップでエラーが発生しました。バックアップ処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0042U-E

内部エラー：リストア処理は正常終了しましたが，リストア処理に関係のない警告レベルのエラーが発生しました。

データベースに関連するエラーが発生しました。

COBOLソース解析の［COBOLソース解析−ステップ1/3］画面で設定内容を確認し，リストアされたデータが不完全である場合は，リストア処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0043U-E

内部エラー：リストア処理中にエラーが発生しましたが，一部リストアされたRD エリアもあります。

リストアに関連するエラーが発生しました。

COBOLソース解析の［COBOLソース解析−ステップ1/3］画面で設定内容を確認し，リストアされたデータが不完全である場合は，リストア処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0044U-E

リストア処理が異常終了しました。

リストアでエラーが発生しました。リストア処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0045U-E

内部エラー：環境設定情報の保存処理がスキップされたテーブルがあります。

環境設定情報の保存に関連するエラーが発生しました。

メッセージ中のエラー詳細を基に原因を取り除き，再度，環境設定情報の保存処理を実行してください。エラー詳細については，「5.5.3　環境設定情報，組み込みデータベースの操作時のメッセージと対処」を参照してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0046U-E

環境設定情報の保存処理が異常終了しました。

環境設定情報の保存でエラーが発生しました。

メッセージ中のエラー詳細を基に原因を取り除き，再度，環境設定情報の保存処理を実行してください。エラー詳細については，「5.5.3　環境設定情報，組み込みデータベースの操作時のメッセージと対処」を参照してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0047U-E

内部エラー：環境設定情報の読み込み処理中にエラーが発生しましたが，一部環境設定情報の読み込まれたテーブルもあります。

環境設定情報の読み込みでエラーが発生しました。または，組み込みデータベースに関連するエラーが発生しました。

環境設定情報の読み込みデータが不完全な場合は，環境設定情報の読み込み処理を再実行してください。または，メッセージ中のエラー詳細を基に原因を取り除いてください。エラー詳細については，「5.5.3　環境設定情報，組み込みデータベースの操作時のメッセージと対処」を参照してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0048U-E

環境設定情報の読み込み処理が異常終了しました。

環境設定情報の読み込みでエラーが発生しました。

メッセージ中のエラー詳細を基に原因を取り除き，環境設定情報の読み込み処理を再実行してください。エラー詳細については，「5.5.3　環境設定情報，組み込みデータベースの操作時のメッセージと対処」を参照してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0050U-E

組み込みデータベースのリストア処理でエラーが発生しました。バックアップファイルに組み込みデータベースすべてのデータが含まれるかを確認してください。

組み込みデータベースのリストアでエラーが発生しました。

バックアップファイルがeabackupコマンドに-t allオプションを指定して作成されたかどうかを確認し，リストア処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0051U-E

COBOLソース解析用データベースのリストア処理でエラーが発生しました。バックアップファイルにCOBOLソース解析用データが含まれるかを確認してください。

COBOLソース解析用データベースのリストアでエラーが発生しました。

バックアップファイルがeabackupコマンドに-t cblcsaオプションを指定して作成されたかどうかを確認し，リストア処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0052U-E

データ影響波及分析用データベースのリストア処理でエラーが発生しました。バックアップファイルにデータ影響波及分析用データが含まれるかを確認してください。

データ影響波及分析用データベースのリストアでエラーが発生しました。

バックアップファイルがeabackupコマンドに-t cbldiaオプションを指定して作成されたかどうかを確認し，リストア処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0053U-E

内部エラー：データ影響波及分析用データベースのエクスポート処理がスキップされたテーブルがあります。

データ影響波及分析用データベースの退避でエラーが発生しました。

メッセージ中のエラー詳細を基に，「5.4　環境が壊れてしまったとき」の手順に従って原因を取り除いて，データ影響波及分析用データベースの退避処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0054U-E

データ影響波及分析用データベースのエクスポート処理が異常終了しました。

データ影響波及分析用データベースの退避でエラーが発生しました。

メッセージ中のエラー詳細を基に，「5.4　環境が壊れてしまったとき」の手順に従って原因を取り除いて，データ影響波及分析用データベースの退避処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0055U-E

内部エラー：データ影響波及分析用データベースのインポート処理中にエラーが発生しましたが，データ影響波及分析用データベースにインポートされたテーブルもあります。

データ影響波及分析用データベースのインポートでエラーが発生しました。または，組み込みデータベースに関連するエラーが発生しました。

データ影響波及分析用データベースのインポートデータが不完全の場合（「5.4　環境が壊れてしまったとき」参照）には，データ影響波及分析用データベースのインポート処理を再実行してください。または，組み込みデータベースのエラーを対策してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0056U-E

データ影響波及分析用データベースのインポート処理が異常終了しました。

データ影響波及分析用データベースのインポートでエラーが発生しました。

メッセージ中のエラー詳細を基に，「5.4　環境が壊れてしまったとき」の手順に従って原因を取り除いて，データ影響波及分析用データベースのインポート処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0057U-E

内部エラー：組み込みデータベースの退避処理がスキップされたテーブルがあります。

組み込みデータベースの退避でエラーが発生しました。

メッセージ中のエラー詳細を基に，「5.4　環境が壊れてしまったとき」の手順に従って原因を取り除いて，組み込みデータベースの退避処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0058U-E

組み込みデータベースの退避処理が異常終了しました。

組み込みデータベースの退避でエラーが発生しました。

メッセージ中のエラー詳細を基に，「5.4　環境が壊れてしまったとき」の手順に従って原因を取り除いて，組み込みデータベースの退避処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0059U-E

内部エラー：組み込みデータベースの回復処理中にエラーが発生しましたが，一部の退避情報が回復されたテーブルもあります。

組み込みデータベースの回復でエラーが発生しました。

メッセージ中のエラー詳細を基に，「5.4　環境が壊れてしまったとき」の手順に従って原因を取り除いて，組み込みデータベースの回復処理を再実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0060U-E

組み込みデータベースの回復処理が異常終了しました。

組み込みデータベースの回復でエラーが発生しました。

メッセージ中のエラー詳細を基に，「5.4　環境が壊れてしまったとき」の手順に従って原因を取り除いて，組み込みデータベースの回復処理を実行してください。

エラーが連続して発生する場合は，保守員に連絡してください。

KEDL0061U-E

現在の組み込みデータベースには移行できません。

古い組み込みデータベースが存在するため，移行データを回復できません。

古い組み込みデータベースをアンセットアップしたあとに，新しくデータベースをセットアップして，組み込みデータベースの回復処理を再実行してください。

KEDL0062U-E

指定されたファイルは読み込めませんでした。ファイルが正しいか確認してください。

ファイル: ***ファイルパス***

ファイル情報:

<Program Name> : ***プログラム名***

<Product id> : ***プロダクトID***

<Version> : ***バージョン***

<Command> : ***コマンド名***

<Create Time> : ***ファイル作成日時***

フォルダ名またはファイル名を指定するオプションに，入力対象でないフォルダまたはファイルを指定しています。

オプションの指定値には，対応するコマンドで指定したフォルダ名またはファイル名を指定してください。

なお，指定したフォルダまたはファイル内にファイル情報が存在しない場合は，ファイル情報は出力されません。

KEDL0064U-E

指定したフォルダに，ファイルまたはフォルダが存在するため，ファイルを作成できません。

指定したフォルダの下に，ファイルまたはフォルダが存在しています。

出力先フォルダには空のフォルダを指定してください。

KEDL0065U-E

aa...aaオプションとbb...bbオプションは同時に指定できません。

同時に指定できないオプションを同時に指定しています。

表示されているオプションのどちらかを削除してください。

KEDL0066U-E

aa...aaフォルダが存在しません。

指定したaa...aaフォルダが存在しません。

フォルダ名を見直して再実行してください。

KEDL0067U-E

指定したフォルダ名が長すぎます。

-dオプションに指定したフォルダ名が200文字を超えています。

指定するフォルダを変更してください。

KEDL0068U-E

ODBCデータソースの作成でエラーが発生しました。

ODBCデータソースの作成でエラーが発生しました。

メッセージ中のエラー詳細を基に原因を取り除き，「3.4　手動でODBCデータソースを登録／変更する」を実行してください。

KEDL0095U-E

組み込みデータベースが存在しません。組み込みデータベースをセットアップしてください。

データベースがありません。

easetupコマンドでデータベースをセットアップしてください。

KEDL0096U-E

COBOL2002 Professional Tool Kitの環境が壊れています。COBOL2002 Professional Tool Kitを再インストールしてください。

プログラムファイルがありません。

COBOL2002 Developer Professionalを再インストールしてください。

KEDL0097U-E

ネットワークドライブが指定されています。ローカルドライブを指定してください。

ネットワークドライブは使用できません。

コマンド引数にローカルドライブを指定して再実行してください。

KEDL0098U-E

内部エラーが発生しました。

出力ファイルのサイズが2GBを超えました。

出力ファイルのサイズが2GBを超える場合は，-dオプションを使用してください。それ以外の場合は保守員に連絡してください。

KEDL0099U-E

コマンドを実行する権限がありません。Administrator権限を持つユーザで再実行してください。

管理者権限でコマンドを再実行してください。

KEDL0100U-E

権限チェック時にエラーが発生しました。

保守員に連絡してください。

KEDL2022U-E

他のCOBOL2002 Professional Tool Kitのツールが組み込みデータベースを使用中です。

COBOLソース解析またはデータ影響波及分析を終了させたあとで，DBユティリティを起動してください。

KEDL2026U-E

他のユーザが組み込みデータベースを使用中です。

ほかのユーザーがCOBOLソース解析またはデータ影響波及分析を使い終わるまで待ってから，DBユティリティを起動してください。

KEDL2037A-E

組み込みデータベースはCOBOL2002 Professional Tool Kit VV-RRで作成されたデータベースではありません。DBユティリティコマンドで組み込みデータベースを初期化して，再度，環境を設定してください。

VV-RR：バージョン/リビジョンを示します。

組み込みデータベースを再作成してください。

5.5.3　環境設定情報，組み込みデータベースの操作時のメッセージと対処

環境設定情報および組み込みデータベースの操作で表示されるメッセージと対処の説明です。

ここでは，次に示す操作でのエラーについて説明します。

環境設定情報の保存/読み込み

組み込みデータベースの移行

データ影響波及分析用データベースのエクスポート/インポート

組み込みデータベースのリストア

以降で示すメッセージが表示された場合は，KEDLnnnnU-Eの後ろに出力されるメッセージを基に原因を取り除き，環境設定情報の保存/読み込みを再実行してください。エラーが連続して発生する場合は，保守員に連絡，または問い合わせ窓口に連絡してください。

(1)　対処が必要なエラーメッセージ

eaenvsaveコマンド（環境設定情報の保存）

KEDL0045U-E 内部エラー：環境設定情報の保存処理がスキップされたテーブルがあります。

KEDL0046U-E 環境設定情報の保存処理が異常終了しました。

eaenvloadコマンド（環境設定情報の読み込み）

KEDL0047U-E 内部エラー：環境設定情報の読み込み処理中にエラーが発生しましたが，一部環境設定情報の読み込まれたテーブルもあります。

KEDL0048U-E環境設定情報の読み込み処理が異常終了しました。

eadbextrコマンド（組み込みデータベースのデータ退避）

KEDL0057U-E 内部エラー：組み込みデータベースの退避処理がスキップされたテーブルがあります。

KEDL0058U-E組み込みデータベースの退避処理が異常終了しました。

eadbloadコマンド（組み込みデータベースのデータ回復）

KEDL0059U-E 内部エラー：組み込みデータベースの回復処理中にエラーが発生しましたが，一部の退避情報が回復されたテーブルもあります。

KEDL0060U-E組み込みデータベースの回復処理が異常終了しました。

eadiaexpコマンド（データ影響波及分析用データベースのエクスポート）

KEDL0053U-E 内部エラー：データ影響波及分析用データベースのエクスポート処理がスキップされたテーブルがあります。

KEDL0054U-Eデータ影響波及分析用データベースのエクスポート処理が異常終了しました。

eadiaimpコマンド（データ影響波及分析用データベースのインポート）

KEDL0055U-E 内部エラー：データ影響波及分析用データベースのインポート処理中にエラーが発生しましたが，データ影響波及分析用データベースにインポートされたテーブルもあります。

KEDL0056U-Eデータ影響波及分析用データベースのインポート処理が異常終了しました。

earstrコマンド（組み込みデータベースのリストア）

KEDL0050U-E 組み込みデータベースのリストア処理でエラーが発生しました。バックアップファイルに組み込みデータベースすべてのデータが含まれるかを確認してください。

KEDL0051U-E COBOLソース解析用データベースのリストア処理でエラーが発生しました。バックアップファイルにCOBOLソース解析用データが含まれるかを確認してください。

KEDL0052U-E データ影響波及分析用データベースのリストア処理でエラーが発生しました。バックアップファイルにデータ影響波及分析用データが含まれるかを確認してください。

(2)　KEDLnnnnU-Eの後ろに出力されるメッセージ一覧

KEDLnnnnU-Eの後ろに出力されるメッセージの一覧を次の表に示します。

表5‒6　KEDLnnnnU-Eの後ろに出力されるメッセージの一覧

メッセージID

メッセージテキスト

対処

KFPA11728-E

Error occurred in HiRDB, reason=aa....aa

組み込みデータベースまたはサーバーがエラーリターンしました。

aa....aa：エラーの原因を示す文字列

FALSE：リソースのロックに失敗しました。

NO SDS：使用できるサーバーがないか，ログ適用サイトに接続しようとしました。

SHUTDOWN：組み込みデータベースが停止処理中です。

組み込みデータベースが起動中と考えられます。しばらくしてから，コマンドを再実行してください。現象が改善しない場合は，Windowsを再起動してください。

KFPL15029-E

Table aa....aa. bb....bb not found in system

組み込みデータベースに一部のデータがありません。

aa....aa：認可識別子

bb....bb：表識別子

組み込みデータベースが壊れています。組み込みデータベースを再作成してください。

KFPL15225-E

Rollback called

エラーが発生したため，ロールバックしました。

環境設定情報ファイルの読み込み時にこのメッセージが表示された場合は，コマンドに指定した環境設定情報ファイルを確認したあとで，コマンドを再実行してください。

KFPL20000-E

Internal function (aa....aa) error occurred, code=bbbbb

組み込みデータベースの処理でエラーを検知しました。

aa....aa：エラーを検知した関数名

bbbbb：エラー詳細コード

KFPS01863-Eのあとにこのメッセージが表示された場合は，組み込みデータベースのサービス（HiRDB/EmbeddedEdition _CT0）を再起動してください。

KFPL24510-E

Error data detected, process stopped, error code=aa

環境設定情報の読み込み中にに入力データエラーを検知したため，処理が終了しました。

aa：論理エラー番号

環境設定情報ファイルの読み込み時にこのメッセージが表示された場合は，コマンドに指定した環境設定情報ファイルを確認したあとで，コマンドを再実行してください。入力する環境設定情報ファイルを変更した場合は，変更した内容に誤りがないかどうか確認してください。

KFPR16318-E

Backup data not found, RDAREA name="aa....aa"

指定されたバックアップファイルには，該当する組み込みデータベースのバックアップはありません。

aa....aa：バックアップデータがない組み込みデータベース

バックアップ時の処理結果であるデータベース退避情報ファイルを参照して，バックアップファイルが-t all/cblcsa/cbldiaのどのオプションを指定して作成されたのかを確認し，正しいオプションを指定してリストア処理を再実行してください。エラーが連続して発生する場合は，保守員に連絡してください。

KFPS01863-E

Hostname=aa....aa， unable to execute cc....cc command， unit state not bb....bb

aa....aaの状態がbb....bbではありません。このため，コマンドを実行できません。

aa....aa：コマンドを実行できなかったホスト名

bb....bb：組み込みデータベースの状態

OFFLINE：サービスが停止中

ONLINE：サービスが稼働中

cc....cc：入力したコマンド名

組み込みデータベースのサービスが起動していない場合は，組み込みデータベースのサービス（HiRDB/EmbeddedEdition _CT0）を起動してください。

関連項目

「6.　組み込みデータベースの保守用コマンド」

6　組み込みデータベースの保守用コマンド

組み込みデータベースを操作するコマンドの文法について説明します。

コマンドの一覧

DBユティリティで使用できるコマンドの一覧です。

表6‒1　DBユティリティで使用できるコマンド一覧

種類

コマンド名

機能

バックアップ/リストア

eabackup

組み込みデータベースのバックアップを取得します。

earstr

組み込みデータベースをリストアします。

状態の表示

eals

組み込みデータベースの状態を表示します。

再編成

earorg

組み込みデータベースを再編成します。

環境設定情報の操作※1

eaenvsave

環境設定情報を保存します。

eaenvload

保存している環境設定情報を読み込みます。

データ影響波及分析用データベースの操作※2

eadiaexp

データ影響波及分析用データベースをエクスポートします。

eadiaimp

データ影響波及分析用データベースをインポートします。

組み込みデータベースを退避/回復

eadbextr

組み込みデータベースから移行データを退避します。

eadbload

組み込みデータベースを移行データで回復します。

セットアップ関連

easetup

組み込みデータベースをセットアップします。

また，ODBCデータソースを作成します。

eaunsetup

組み込みデータベースをアンセットアップします。

注※1

COBOLソース解析の環境設定情報が対象です。データ影響波及分析は対象外です。

注※2

データ影響波及分析用データベースが対象です。COBOLソース解析用データベースは対象外です。

コマンドの実行で注意すること

DBユティリティのコマンドを実行するときは，次のことに注意してください。

入力する文字

入力する文字は，半角文字を使用してください。コマンド名やオプションに全角文字を指定すると，コマンド名やオプションとは認識されません。

半角カタカナは，セットアップ関連のコマンドでは使用できません。バックアップ/リストアのコマンドでは，半角カタカナは使用できます。

パス名，フォルダ名およびファイル名には，半角の英文字を使用してください。全角文字を指定した場合，動作は保証しません。

英大文字と英小文字は区別しません。

-hオプションを指定すると，コマンドのヘルプが表示されます。-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

パス，フォルダ，ファイルの指定

空白文字または丸括弧を含むパス名は，前後を引用符（"）で囲んでください。囲んでいないと，別のオプションと認識されます。

フォルダ名の文字列では，先頭に数字を指定できます。

ネットワークドライブのファイルは使用できません。パス，フォルダおよびファイルを指定するときは，ローカルドライブを使用してください。ネットワークドライブを指定した場合の動作は保証しません。

パス名は，ドライブ名（「A」〜「Z」，「a」〜「z」の1文字＋「:」）で始まり，「A」〜「Z」，「a」〜「z」，「0」〜「9」，「 」（空白），「_」（アンダスコア），「.」（ピリオド）とパスを区切る「¥」で構成される絶対パスで指定してください。

特に指定がないかぎり，ファイル名の長さは絶対パスを含めて255文字までです。

絶対パス名には，ローカルドライブに存在し，書き込みができるフォルダを指定してください。

エラーチェックのタイミングとメッセージ

有効なオプションでも，重複して指定するとエラーになります。

（例）

セットアップコマンドのヘルプを表示するeasetup -hをeasetup -h -hと指定すると，エラーメッセージが出力されます。

コマンドでエラーを検出した場合はそのエラーを出力し，それ以降のオプションが正しいかどうかはチェックしません。

（例）

正しいコマンド例：easetup -p 22200 -d D:¥temp¥DB

誤ったコマンド例：easetup -p -d

誤ったコマンド例を実行すると，最初に-pオプション値の不正を示すエラーが出力され，-dのオプション値の不正はチェックされません。

コマンドの実行

ユーザーアカウント制御（UAC）が有効な状態では，DBユティリティ コマンドプロンプトを管理者権限で実行してから，コマンドを実行してください。

処理に時間が掛かるコマンドは，実行の完了まで待つことを示すメッセージが表示されます。メッセージが消えてコマンドプロンプトが表示されるまで，コマンドの処理を中断させないでください。

しかたなく［Ctrl］+［C］キーなどで中断した場合は，コマンドを再実行してください。コマンドを再実行してもエラーが発生する場合は，Windowsを再起動してください。

DBユティリティは，二重に起動できません。また，COBOLソース解析と同時に使用できません。

DBユティリティのコマンドは，DBユティリティ以外から実行できません。DBユティリティ以外から実行するとエラーになります。

ただし，組み込みデータベース状態表示コマンド（eals）は，DBユティリティ以外から実行できます。

なお，DBユティリティ以外から組み込みデータベース状態表示コマンド（eals）を実行する場合，64ビットのコマンドプロンプト（Windowsのインストール先ドライブ:¥Windows¥System32¥cmd.exe）を使用してください。32ビット（WOW64版）のコマンドプロンプト（Windowsのインストール先ドライブ:¥Windows¥SysWOW64¥cmd.exe）での動作は保証されません。

DBユティリティを終了するときは，Windowsのexitコマンドを実行してください。

コマンドの掲載形式

以降，このマニュアルでは次に示す形式でコマンドを説明します。

形式

コマンドの入力形式を示します。〔 〕で囲まれたコマンド引数は省略できます。

2行目（-hオプションを指定）は，コマンドのヘルプを表示する形式を示します。

コマンド引数

コマンド引数を示します。

戻り値

コマンドの戻り値を示します。

注意

コマンドを実行するときの注意を示します。

実行例

コマンドの実行例を示します。入力するコマンド文字列は太字で示します。

eabackupコマンド − 組み込みデータベースのバックアップ

トラブル時に状態を回復するために，組み込みデータベースのバックアップを取得します。

eabackupコマンドは，コマンドを実行するWindowsマシン環境のバックアップの目的で使用してください。ほかのWindowsマシンに環境を複製する目的での使用は推奨しません。

eabackupコマンドでバックアップを取得する場合，COBOLソース解析用データベース，データ影響波及分析用データベース，またはその両方を指定できます。リストアするときは，取得したバックアップの範囲を確認してください。

バックアップの対象になる情報と，対象にならない情報を次に示します。

バックアップ対象

COBOLプログラムの解析情報，COBOLソース解析の解析生成オプションなど，COBOLソース解析の設定内容

データ影響波及分析が出力したプロジェクトの解析情報

バックアップ対象外

COBOLソース解析で生成したソース解析情報（HTMLファイル形式，CSVファイル形式），COBOLソースファイル

データ影響波及分析の調査状態保存ファイル，CSVファイル，タグファイル，COBOLソースファイル

形式

eabackup  〔-t ｛all｜cblcsa｜cbldia｝〕 -b バックアップファイル名 〔-p データベース退避情報ファイル名〕

eabackup  -h

コマンド引数

-t ｛all｜cblcsa｜cbldia｝

バックアップを取得する範囲を指定します。

all：組み込みデータベースすべて（デフォルト値）

cblcsa：COBOLソース解析用データベース

cbldia：データ影響波及分析用データベース

-b バックアップファイル名

バックアップを格納するファイル名をローカルドライブの絶対パスで指定します。

バックアップを取得した範囲を確認するときは，eabackupコマンドの処理結果であるデータベース退避情報ファイルと一緒に管理することをお勧めします。

-pオプションを省略すると，タイムスタンプ付きのファイル名で出力されるため，バックアップファイルの更新日時と対応を取れます。

-p データベース退避情報ファイル名

eabackupコマンドの処理結果を格納する，データベース退避情報ファイル名をローカルドライブの絶対パスで指定します。省略すると，次に示す形式でデータベース退避情報ファイルが格納されます。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥logs¥backup_yyyymmddhhmm.log

yyyymmddhhmm：バックアップを取得した西暦年，月，日，時刻を示します。

バックアップファイルの更新日時とデータベース退避情報ファイル名を対応づけられるため，-pオプションは省略することをお勧めします。

-h

コマンドのヘルプを表示するときに指定します。

-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

戻り値

戻り値

意味

0

正常終了しました。

8

一部のコピーに失敗，またはスキップしました。

12

コピーはすべて失敗しました。

上記以外

エラーが発生しました。エラーの内容はイベントログに出力されます。

エラーメッセージについては，「5.5　DBユティリティのメッセージ」を参照してください。

注意

バックアップファイル名およびログファイル名には，ローカルドライブのパス名を指定してください。ネットワークドライブのパス名を指定すると，エラーになります。

バックアップファイル名およびログファイル名に，存在しないフォルダのパス名，または書き込みができないフォルダのパス名を指定すると，エラーになります。

指定したバックアップファイルがすでにある場合は，上書きされます。このとき，上書きの確認メッセージは表示されません。

データベース退避情報ファイルの内容から，バックアップを取得した範囲を確認する方法を次に示します。

RDAREA NAME : TRD01：COBOLソース解析用データベースを示します。

RDAREA NAME : TRD02：データ影響波及分析用データベースを示します。

上記が両方ともある場合は，eabackup -t allコマンドでバックアップが取得されています。

RDAREA NAME : TRD01だけの場合は，eabackup -t cblcsaコマンドでバックアップが取得されています。

RDAREA NAME : TRD02だけの場合は，eabackup -t cbldiaコマンドでバックアップが取得されています。

実行例

バックアップファイル名：D:¥bkup01.bak

ログファイル名：D:¥bkuplog¥bkuplog01.log

> eabackup  -b D:¥bkup01.bak -p D:¥bkuplog¥bkuplog01.log

組み込みデータベースのバックアップ処理実行中です。
組み込みデータベースのバックアップ処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

組み込みデータベースのバックアップ処理を完了しました。
>

eadbextrコマンド − 組み込みデータベースから移行データの退避

組み込みデータベースのデータ移行のため，組み込みデータベースの情報を退避します。

退避する組み込みデータベースの情報は，COBOLソース解析の環境設定情報，COBOLソース解析の解析データ，およびデータ影響波及分析の解析データです。退避した情報は，eadbloadコマンドで回復できます。

形式

eadbextr ｛-d 移行データの退避先フォルダ名｜-f  移行データのファイル名｝ 〔-p 移行データ退避情報ファイル名〕

eadbextr  -h

コマンド引数

-d 移行データの退避先フォルダ名

組み込みデータベース内の移行データの退避先フォルダ名をローカルドライブの絶対パスで指定します。

-f 移行データのファイル名

組み込みデータベースの情報を格納する移行データのファイル名をローカルドライブの絶対パスで指定します。

移行データは1つのファイルにまとまって出力されます。移行データが2GBを超える場合，ファイルの作成に失敗します。easetupコマンドで指定した組み込みデータベースのフォルダ下の容量が2GBを超えている場合は，-fオプションではなく，-dオプションを指定することをお勧めします。

-p 移行データ退避情報ファイル名

eadbextrコマンドの処理結果を格納する，移行データ退避情報ファイル名をローカルドライブの絶対パスで指定します。省略すると，次に示す形式で移行データ退避情報ファイルが格納されます。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥logs¥dbextr_yyyymmddhhmm.log

yyyymmddhhmm：移行データを退避した西暦年，月，日，時刻を示します。

-h

コマンドのヘルプを表示するときに指定します。

-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

戻り値

戻り値

意味

0

正常終了しました。

4

一部のデータの退避をスキップしました。

8

データの退避はすべて失敗しました。

上記以外

エラーが発生しました。エラーの内容はイベントログに出力されます。

エラーメッセージについては，「5.5　DBユティリティのメッセージ」を参照してください。

注意

移行データの退避先フォルダ名，移行データのファイル名，および移行データ退避情報ファイル名には，ローカルドライブのパス名を指定してください。ネットワークドライブのパス名を指定すると，エラーになります。

移行データの退避先フォルダ名，移行データのファイル名，および移行データ退避情報ファイル名に，存在しないフォルダのパス名，または書き込みができないフォルダのパス名を指定すると，エラーになります。

指定した移行データの退避先フォルダ内にファイルやフォルダが存在する場合は，エラーになります。

指定した移行データのファイル名および移行データ退避情報ファイル名がすでにある場合は，上書きされます。このとき，上書きの確認メッセージは表示されません。

移行データの退避先フォルダ名は200文字以内で指定してください。200文字を超えると，エラーになります。

移行データの退避先フォルダ名にファイル名を指定した場合，または移行データのファイル名にフォルダ名を指定した場合，エラーになります。

-dオプションと-fオプションを同時に指定した場合は，エラーになります。

-dオプションで指定した移行データの退避先フォルダ下に出力されたファイルを削除，修正しないでください。別の場所に移動する場合はフォルダ単位で移動してください。

実行例

移行データのファイル名：D:¥extr01.bak

移行データ退避情報ファイル名：D:¥bkuplog¥extrlog01.log

> eadbextr  -f D:¥extr01.bak -p D:¥bkuplog¥extrlog01.log

組み込みデータベースの退避処理実行中です。
組み込みデータベースの退避処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

組み込みデータベースの退避処理を完了しました。
>

eadbloadコマンド − 組み込みデータベースを移行データで回復

組み込みデータベースのデータ移行のため，eadbextrコマンドで退避した移行データから，組み込みデータベースの情報を回復します。

回復先の組み込みデータベースのセットアップが完了していることが前提です。

旧バージョンの組み込みデータベースに回復しようとするとエラーになります。

形式

eadbload  ｛-d 移行データの退避先フォルダ名｜-f 移行データのファイル名｝ 〔-p 移行データ回復情報ファイル名〕

eadbload  -h

コマンド引数

-d 移行データの退避先フォルダ名

組み込みデータベースに回復する移行データの退避先フォルダ名をローカルドライブの絶対パスで指定します。

-f 移行データのファイル名

組み込みデータベースの情報を格納した移行データのファイル名をローカルドライブの絶対パスで指定します。

-p 移行データ回復情報ファイル名

eadbloadコマンドの処理結果を格納する，移行データ回復情報ファイル名をローカルドライブの絶対パスで指定します。省略すると，次に示す形式で移行データ回復情報ファイルが格納されます。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥logs¥dbload_yyyymmddhhmm.log

yyyymmddhhmm：移行データを回復した西暦年，月，日，時刻を示します。

-h

コマンドのヘルプを表示するときに指定します。

-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

戻り値

戻り値

意味

0

正常終了しました。

4

一部のデータの回復に失敗しました。

8

データの回復はすべて失敗しました。

上記以外

エラーが発生しました。エラーの内容はイベントログに出力されます。

エラーメッセージについては，「5.5　DBユティリティのメッセージ」を参照してください。

注意

移行データの退避先フォルダ名，移行データのファイル名，および移行データ回復情報ファイル名には，ローカルドライブのパス名を指定してください。ネットワークドライブのパス名を指定すると，エラーになります。

移行データの退避先フォルダ名，移行データのファイル名，および移行データ回復情報ファイル名に，存在しないフォルダのパス名，または書き込みができないフォルダのパス名を指定すると，エラーになります。

-fオプションに指定したファイルが移行データのファイルでない場合は，エラーになります。

指定した移行データ回復情報ファイル名がすでにある場合は，上書きされます。このとき，上書きの確認メッセージは表示されません。

移行データの退避先フォルダ名は200文字以内で指定してください。200文字を超えると，エラーになります。

移行データの退避先フォルダ名にファイル名を指定した場合，または移行データ回復情報ファイル名にフォルダ名を指定した場合，エラーになります。

-dオプションと-fオプションを同時に指定した場合は，エラーになります。

実行例

移行データのファイル名：D:¥extr01.bak

移行データ回復情報ファイル名：D:¥bkuplog¥dbload01.log

> eadbload  -f D:¥extr01.bak -p D:¥bkuplog¥dbload01.log

組み込みデータベースの回復処理実行中です。
組み込みデータベースの回復処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

組み込みデータベースの回復処理を完了しました。
>

eadiaexpコマンド − データ影響波及分析用データベースのエクスポート

別のWindowsマシンの環境にデータを複製するために，組み込みデータベースからデータ影響波及分析用データベースをエクスポートします。

エクスポートしたデータ影響波及分析用データベースの情報は，eadiaimpコマンドで組み込みデータベースにインポートできます。

形式

eadiaexp  ｛-d エクスポート先フォルダ名｜-m エクスポート先ファイル名｝ 〔-p ログファイル名〕 〔-a データ領域番号〔, データ領域番号〕...〕

eadiaexp  -h

コマンド引数

-d エクスポート先フォルダ名

データ影響波及分析用データベースのエクスポート先フォルダ名をローカルドライブの絶対パスで指定します。

-m エクスポート先ファイル名

データ影響波及分析用データベースのエクスポート先ファイル名をローカルドライブの絶対パスで指定します。

エクスポート先ファイルは1つのファイルにまとまって出力されます。エクスポート先ファイルが2GBを超える場合，エクスポート先ファイルの作成に失敗します。easetupコマンドで指定した組み込みデータベースのフォルダ下の容量が2GBを超えている場合は，-mオプションではなく，-dオプションを指定することをお勧めします。

-p ログファイル名

eadiaexpコマンドの処理結果を格納するログファイル名をローカルドライブの絶対パスで指定します。省略すると，次に示す形式でログファイルが格納されます。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥logs¥diaexp_yyyymmddhhmm.log

yyyymmddhhmm：エクスポート先ファイルをエクスポートした西暦年，月，日，時刻を示します。

-a データ領域番号〔, データ領域番号〕...

エクスポート対象のデータ領域番号を1から5の半角数字で指定します。複数指定する場合は，コンマ区切りで指定します。指定がない場合は，すべてのデータ領域がエクスポートの対象になります。

-h

コマンドのヘルプを表示するときに指定します。

-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

戻り値

戻り値

意味

0

正常終了しました。

4

一部のデータのエクスポートをスキップしました。

8

データ影響波及分析用データベースのエクスポートはすべて失敗しました。

上記以外

エラーが発生しました。エラーの内容はイベントログに出力されます。

エラーメッセージについては，「5.5　DBユティリティのメッセージ」を参照してください。

注意

エクスポート先フォルダ名，エクスポート先ファイル名，およびログファイル名には，ローカルドライブのパス名を指定してください。ネットワークドライブのパス名を指定すると，エラーになります。

エクスポート先フォルダ名，エクスポート先ファイル名，およびログファイル名に，存在しないフォルダのパス名，または書き込みができないフォルダのパス名を指定すると，エラーになります。

指定したエクスポート先フォルダ内にファイルやフォルダが存在する場合は，エラーになります。

指定したエクスポート先ファイル名およびログファイル名がすでにある場合は，上書きされます。このとき，上書きの確認メッセージは表示されません。

エクスポート先フォルダ名は200文字以内で指定してください。200文字を超えると，エラーになります。

エクスポート先フォルダ名にファイル名を指定した場合，またはエクスポートファイル名にフォルダ名を指定した場合，エラーになります。

-dオプションと-mオプションを同時に指定した場合は，エラーになります。

-dオプションで指定したエクスポート先フォルダ下に出力されたファイルを削除，修正しないでください。別の場所に移動する場合はフォルダ単位で移動してください。

実行例

エクスポート先ファイル名：D:¥diaexp01.bak

ログファイル名：D:¥bkuplog¥diaexp01.log

> eadiaexp  -m D:¥diaexp01.bak -p D:¥bkuplog¥diaexp01.log

データ影響波及分析用データベースのエクスポート処理実行中です。
データ影響波及分析用データベースのエクスポート処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

データ影響波及分析用データベースのエクスポート処理を完了しました。
>

eadiaimpコマンド − データ影響波及分析用データベースのインポート

別のWindowsマシンの環境にデータを複製するために，組み込みデータベースにデータ影響波及分析用データベースをインポートします。

eadiaexpコマンドでデータ影響波及分析用データベースをエクスポートした際に，データ領域番号を指定していた場合は，eadiaexpコマンドで指定した番号のデータ領域にデータをインポートします。このとき，インポートしないデータ領域のデータも含めて，データをインポートする前に，データ影響波及分析用データベース内のデータをすべて削除します。このため，eadiaimpコマンドの実行前に，データ影響波及分析用データベースのバックアップを取得することをお勧めします。

インポートする組み込みデータベースのフォルダがエクスポート時の組み込みデータベースのフォルダと異なる場合でも，データ影響波及分析用データベースをインポートできます。

データ影響波及分析用データベースを保存したエクスポート先ファイルから，一部のプロジェクトだけを抽出してインポートできません。

形式

eadiaimp  ｛-d エクスポート先フォルダ名｜-m エクスポート先ファイル名｝ 〔-p ログファイル名〕〔-y〕

eadiaimp  -h

コマンド引数

-d エクスポート先フォルダ名

データ影響波及分析用データベースに読み込むエクスポートファイルを格納したフォルダ名をローカルドライブの絶対パスで指定します。

-m エクスポート先ファイル名

データ影響波及分析用データベースのエクスポート先ファイル名をローカルドライブの絶対パスで指定します。

-p ログファイル名

eadiaimpコマンドの処理結果を格納するログファイル名をローカルドライブの絶対パスで指定します。省略すると，次に示す形式でログファイルが格納されます。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥logs¥diaimp_yyyymmddhhmm.log

yyyymmddhhmm：エクスポート先ファイルをインポートした西暦年，月，日，時刻を示します。

-y

eadiaimpコマンドを実行すると，データ影響波及分析用データベースのインポートを実行してよいかどうかを確認するメッセージが表示されます。このメッセージを抑止するときに指定します。-yオプションを指定してコマンドを実行すると，確認メッセージが表示されません。

-h

コマンドのヘルプを表示するときに指定します。

-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

戻り値

戻り値

意味

0

正常終了しました。

4

一部のデータ影響波及分析用データベースのインポートに失敗しました。

8

データ影響波及分析用データベースのエクスポートはすべて失敗しました。

上記以外

エラーが発生しました。エラーの内容はイベントログに出力されます。

エラーメッセージについては，「5.5　DBユティリティのメッセージ」を参照してください。

注意

エクスポート先フォルダ名，エクスポート先ファイル名，およびログファイル名には，ローカルドライブのパス名を指定してください。ネットワークドライブのパス名を指定すると，エラーになります。

エクスポート先フォルダ名，エクスポート先ファイル名，およびログファイル名に，存在しないフォルダのパス名，または書き込みができないフォルダのパス名を指定すると，エラーになります。

-mオプションに指定したファイルがエクスポート先ファイルでない場合は，エラーになります。

指定したログファイル名がすでにある場合は，上書きされます。このとき，上書きの確認メッセージは表示されません。

エクスポート先フォルダ名は200文字以内で指定してください。200文字を超えると，エラーになります。

エクスポート先フォルダ名にファイル名を指定した場合，またはエクスポート先ファイル名にフォルダ名を指定した場合，エラーになります。

-dオプションと-mオプションを同時に指定した場合は，エラーになります。

実行例

エクスポート先ファイル名：D:¥diaexp01.bak

ログファイル名：D:¥bkuplog¥diaimp01.log

> eadiaimp  -m D:¥diaexp01.bak -p D:¥bkuplog¥diaimp01.log

データ影響波及分析用データベースのインポート処理を開始します。
インポートされるデータ領域番号は 1 2 3 4 5※ です。
データ影響波及分析用データベース内の格納データはすべて削除されます。

データ影響波及分析用データベースのインポート処理を続行しますか (Y/N)?
-> Y

データ影響波及分析用データベースのインポート処理実行中です。
データ影響波及分析用データベースのインポート処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

データ影響波及分析用データベースのインポート処理を完了しました。
>

注※

データ領域番号はエクスポート先ファイルによって異なります。

eaenvloadコマンド − COBOLソース解析の環境設定情報の読み込み

環境設定情報ファイルから，COBOLソース解析のすべての解析対象プロジェクトと，プロジェクトに含まれるCOBOLソース一覧，解析生成オプションを読み込みます。

eaenvloadコマンドは，COBOLソース解析で作成したすべての解析対象プロジェクトを一括して読み込みます。一部の解析対象プロジェクトだけを環境設定情報ファイルから読み込むことはできません。

eaenvloadコマンドを実行すると，組み込みデータベース内のデータ（解析データを含む）はすべて上書きされます（データ影響波及分析の各種データは上書きされません）。eaenvloadコマンドを実行するときは，データベースのバックアップを事前に取得しておくことをお勧めします。

組み込みデータベースのフォルダが環境設定情報を保存したときの組み込みデータベースのフォルダと異なる場合でも，環境設定情報を保存できます。

形式

eaenvload  ｛-d 環境設定情報の保存先フォルダ名｜-e 環境設定情報ファイル名｝ 〔-p ログファイル名〕〔-y〕

eaenvload  -h

コマンド引数

-d 環境設定情報の保存先フォルダ名

組み込みデータベース内の環境設定情報の保存先フォルダ名をローカルドライブの絶対パスで指定します。

-e 環境設定情報ファイル名

組み込みデータベースに読み込む，環境設定情報ファイル名をローカルドライブの絶対パスで指定します。

-p ログファイル名

eaenvloadコマンドの処理結果を格納するログファイル名をローカルドライブの絶対パスで指定します。省略すると，次に示す形式でログファイルが格納されます。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥logs¥envload_yyyymmddhhmm.log

yyyymmddhhmm：環境設定情報を保存した西暦年，月，日，時刻を示します。

-y

eaenvloadコマンドを実行すると，環境設定情報の読み込みを実行してよいかどうかを確認するメッセージが表示されます。このメッセージを抑止するときに指定します。-yオプションを指定してコマンドを実行すると，確認メッセージが表示されません。

-h

コマンドのヘルプを表示するときに指定します。

-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

戻り値

戻り値

意味

0

正常終了しました。

4

一部の環境設定情報の読み込み処理をスキップしました。

8

環境設定情報の読み込みに失敗しました。

上記以外

エラーが発生しました。エラーの内容はイベントログに出力されます。

エラーメッセージについては，「5.5　DBユティリティのメッセージ」を参照してください。

注意

環境設定情報の保存先フォルダ名，環境設定情報ファイル名，およびログファイル名には，ローカルドライブのパス名を指定してください。ネットワークドライブのパス名を指定すると，エラーになります。

環境設定情報の保存先フォルダ名，環境設定情報ファイル名，およびログファイル名に，存在しないフォルダのパス名，または書き込みができないフォルダのパス名を指定すると，エラーになります。

-eオプションに指定したファイルが環境設定情報ファイルでない場合は，エラーになります。

指定したログファイルがすでにある場合は，上書きされます。このとき，上書きの確認メッセージは表示されません。

環境設定情報の保存先フォルダ名は200文字以内で指定してください。200文字を超えると，エラーになります。

環境設定情報の保存先フォルダ名にファイル名を指定した場合，または環境設定情報ファイル名にフォルダ名を指定した場合，エラーになります。

-dオプションと-eオプションを同時に指定した場合は，エラーになります。

実行例

環境設定情報ファイル名：D:¥envdata01.env

ログファイル名：D:¥envlog¥envload01.log

> eaenvload -e D:¥envdata01.env -p D:¥envlog¥envload01.log

COBOLソース解析用環境設定情報の読み込み処理を開始します。
COBOLソース解析用データベース内の格納データはすべて削除されます。

COBOLソース解析用環境設定情報の読み込み処理を続行しますか (Y/N)?
-> Y

COBOLソース解析用環境設定情報の読み込み処理実行中です。
COBOLソース解析用環境設定情報の読み込み処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

COBOLソース解析用環境設定情報の読み込み処理を完了しました。
>

eaenvsaveコマンド − COBOLソース解析の環境設定情報の保存

COBOLソース解析のすべての解析対象プロジェクトと，プロジェクトに含まれるCOBOLソースファイル一覧，解析生成オプションを環境設定情報ファイルに保存します。保存した環境設定情報は，環境設定情報の読み込みコマンド（eaenvloadコマンド）で，解析/生成環境を読み込めます。

eaenvsaveコマンドは，COBOLソース解析で作成したすべての解析対象プロジェクトを一括して保存します。一部の解析対象プロジェクトだけを抽出して環境設定情報ファイルに保存することはできません。

環境設定情報の対象になる情報と，対象にならない情報を次に示します。

取得対象の環境設定情報

COBOLソース解析の解析対象プロジェクトと，プロジェクトに含まれるCOBOLソースファイル一覧，解析生成オプション

取得対象でない環境設定情報

COBOLソース解析で解析したデータベースの解析データや生成ドキュメント，COBOLソースファイル

データ影響波及分析の各種データ

形式

eaenvsave  ｛-d 環境設定情報の保存先フォルダ名｜-e 環境設定情報ファイル名｝ 〔-p ログファイル名〕

eaenvsave  -h

コマンド引数

-d 環境設定情報の保存先フォルダ名

組み込みデータベース内の環境設定情報の保存先フォルダ名をローカルドライブの絶対パスで指定します。

-e 環境設定情報ファイル名

環境設定情報の保存先ファイル名をローカルドライブの絶対パスで指定します。省略すると，エラーになります。

環境設定情報は1つのファイルにまとまって出力されます。環境設定情報が2GBを超える場合，環境設定情報ファイルの作成に失敗します。easetupコマンドで指定した組み込みデータベースのフォルダ下の容量が2GBを超えている場合は，-eオプションではなく，-dオプションを指定することをお勧めします。

-p ログファイル名

eaenvsaveコマンドの処理結果を格納するログファイル名をローカルドライブの絶対パスで指定します。省略すると，次に示す形式でログファイルが格納されます。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥logs¥envsave_yyyymmddhhmm.log

yyyymmddhhmm：環境設定情報を保存した西暦年，月，日，時刻を示します。

-h

コマンドのヘルプを表示するときに指定します。

-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

戻り値

戻り値

意味

0

正常終了しました。

4

一部の環境設定情報の保存処理をスキップしました。

8

環境設定情報の保存に失敗しました。

上記以外

エラーが発生しました。エラーの内容はイベントログに出力されます。

エラーメッセージについては，「5.5　DBユティリティのメッセージ」を参照してください。

注意

環境設定情報の保存先フォルダ名，環境設定情報ファイル名，およびログファイル名には，ローカルドライブのパス名を指定してください。ネットワークドライブのパス名を指定すると，エラーになります。

環境設定情報の保存先フォルダ名，環境設定情報ファイル名，およびログファイル名に，存在しないフォルダのパス名，または書き込みができないフォルダのパス名を指定すると，エラーになります。

指定した環境設定情報の保存先フォルダ内にファイルやフォルダが存在する場合は，エラーになります。

指定した環境設定情報ファイルおよびログファイルがすでにある場合は，上書きされます。このとき，上書きの確認メッセージは表示されません。

環境設定情報の保存先フォルダ名は200文字以内で指定してください。200文字を超えると，エラーになります。

環境設定情報の保存先フォルダ名にファイル名を指定した場合，または環境設定情報ファイル名にフォルダ名を指定した場合，エラーになります。

-dオプションと-eオプションを同時に指定した場合は，エラーになります。

-dオプションで指定した環境設定情報の保存先フォルダ下に出力されたファイルを削除，修正しないでください。別の場所に移動する場合はフォルダ単位で移動してください。

実行例

環境設定情報ファイル名：D:¥envdata01.env

ログファイル名：D:¥envlog¥envsave01.log

> eaenvsave -e D:¥envdata01.env -p D:¥envlog¥envsave01.log

COBOLソース解析用環境設定情報の保存処理実行中です。
COBOLソース解析用環境設定情報の保存処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

COBOLソース解析用環境設定情報の保存処理を完了しました。
>

ealsコマンド − 組み込みデータベースの状態の表示

組み込みデータベースの状態を表示します。表示する情報を次に示します。

組み込みデータベースの稼働状況

組み込みデータベースがセットアップされた環境

形式

eals

eals  -h

コマンド引数

-h

コマンドのヘルプを表示するときに指定します。

-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

戻り値

戻り値

意味

0

組み込みデータベースは稼働中です（稼働状況：ONLINE）。

4

組み込みデータベースは開始途中またはサービス停止途中です（稼働状況：STARTINGまたはSTOPPING）。

8

プロセス再起動の中断状態です。

12

組み込みデータベースは停止しています（稼働状況：STOP）。

16

組み込みデータベースはセットアップされていません（稼働状況：UNSETUP）。

上記以外

エラーが発生しました。エラーの内容はイベントログに出力されます。

エラーメッセージについては，「5.5　DBユティリティのメッセージ」を参照してください。

実行例

> eals

稼働状況 ONLINE
ポート番号 20411
データベース "D:¥COBOL Analyzer¥DB"
>

説明

稼働状況

組み込みデータベースの稼働状況です。

ONLINE：稼働中

STOP：停止状態

STARTING：開始途中

STOPPING：停止途中

UNSETUP：セットアップされていない状態

ポート番号

利用しているポート番号です。組み込みデータベースがセットアップされていない場合は，「-」が表示されます。

データベース

組み込みデータベースが格納されたフォルダの絶対パスです。組み込みデータベースがセットアップされていない場合は，「-」が表示されます。

earorgコマンド − 組み込みデータベースの再編成

組み込みデータベースを再編成します。

earorgコマンドで組み込みデータベースを再編成する場合，COBOLソース解析用データベース，データ影響波及分析用データベース，またはその両方を指定できます。

形式

earorg 〔-t ｛all｜cblcsa｜cbldia｝〕

earorg  -h

コマンド引数

-t ｛all｜cblcsa｜cbldia｝

組み込みデータベースを再編成する範囲を指定します。

all：組み込みデータベースすべて（デフォルト値）

cblcsa：COBOLソース解析用データベース

cbldia：データ影響波及分析用データベース

-h

コマンドのヘルプを表示するときに指定します。

-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

戻り値

戻り値

意味

0

正常終了しました。

4

再編成は完了しましたが，空き容量が少なくなっています。再度，組み込みデータベースの容量が不足することが考えられます。

8

再編成に失敗しました。

上記以外

エラーが発生しました。エラーの内容はイベントログに出力されます。

エラーメッセージについては，「5.5　DBユティリティのメッセージ」を参照してください。

注意

COBOLソース解析またはデータ影響波及分析で使用するデータが，ドライブの容量に比べて大幅に増加した場合は，組み込みデータベースの再編成を実行しても効果が出ないことがあります。この場合は，ディスクの容量を増やしてください。

earorgコマンドを実行すると，次に示すログファイルが生成されます。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥logs¥earorg.log

earorg.logは保守用のファイルです。トラブルが起こったときに，保守員または問い合わせ窓口に連絡するときに提供してください。

実行例

> earorg

組み込みデータベースの再編成処理実行中です。
組み込みデータベースの再編成処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

組み込みデータベースの再編成処理を完了しました。
>

earstrコマンド − 組み込みデータベースのリストア

トラブル時に状態を回復するために，eabackupコマンドで取得したバックアップファイルから，COBOLソース解析とデータ影響波及分析の環境とデータをWindowsマシンにリストアします。

earstrコマンドは，コマンドを実行するWindowsマシン環境にリストアする目的で使用してください。ほかのWindowsマシンに環境を複製する目的での使用は推奨しません。

バックアップファイルには，COBOL2002 Developer Professionalのバージョン/リビジョンで互換性がありません。リストアするときは，バージョン/リビジョンが同じCOBOL2002 Developer Professionalで取得したバックアップファイルを使用してください。

形式

earstr  〔-t ｛all｜cblcsa｜cbldia｝〕 -b バックアップファイル名〔-p データベース回復情報ファイル名〕

earstr  -h

コマンド引数

-t ｛all｜cblcsa｜cbldia｝

リストアする範囲を指定します。

all：組み込みデータベースすべて（デフォルト値）

cblcsa：COBOLソース解析用データベース

cbldia：データ影響波及分析用データベース

eabackupコマンドの-tオプションおよびearstrコマンドの-tオプションの指定とリストア結果の関係を次に示します。

バックアップ取得時のearstrコマンドの-tオプションの指定

リストア時のeabackupコマンドの-tオプションの指定

省略または-t all

-t cblcsa

-t cbldia

省略または-t all

すべてリストア

COBOLソース解析用データベースだけリストア

データ影響波及分析用データベースだけリストア

-t cblcsa

エラー

COBOLソース解析用データベースだけリストア

エラー

-t cbldia

エラー

エラー

データ影響波及分析用データベースだけリストア

リストアでエラーになった場合は，バックアップを取得した処理結果である，データベース退避情報ファイルを参照して，取得したバックアップの範囲を確認してください。

-b バックアップファイル名

リストアするバックアップファイル名をローカルドライブの絶対パスで指定します。

-p データベース回復情報ファイル名

earstrコマンドの処理結果を格納する，データベース回復情報ファイル名をローカルドライブの絶対パスで指定します。省略すると，次に示す形式でデータベース回復情報ファイルが格納されます。

COBOL2002 Professional Tool Kitのインストール先フォルダ¥logs¥restore_yyyymmddhhmm.log

yyyymmddhhmm：リストアを実行した西暦年，月，日，時刻を示します。

-h

コマンドのヘルプを表示するときに指定します。

-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

戻り値

戻り値

意味

0

正常終了しました。

8

一部のリストアに失敗，またはスキップしました。

12

リストアに失敗しました。

上記以外

エラーが発生しました。エラーの内容はイベントログに出力されます。

エラーメッセージについては，「5.5　DBユティリティのメッセージ」を参照してください。

注意

バックアップファイル名およびデータベース回復情報ファイル名には，ローカルドライブのパス名を指定してください。ネットワークドライブのパス名を指定すると，エラーになります。

バックアップファイル名およびデータベース回復情報ファイル名に，存在しないフォルダのパス名，または書き込みができないフォルダのパス名を指定すると，エラーになります。

実行例

バックアップファイル名：D:¥bkup01.bak

データベース回復情報ファイル名：D:¥rstrlog¥rstrlog01.log

> earstr -b D:¥bkup01.bak -p D:¥rstrlog¥rstrlog01.log

組み込みデータベースのリストア処理実行中です。
組み込みデータベースのリストア処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

組み込みデータベースのリストア処理を完了しました。
>

easetupコマンド − 組み込みデータベースのセットアップ

組み込みデータベースをセットアップします。

セットアップした情報（ポート番号，組み込みデータベースのフォルダパス名）を確認するときは，ealsコマンドを実行してください。

また，次に示すシステムDSNのODBCデータソースを自動で登録します。

COBOL2002ToolKitDB

COBOL2002 Professional Tool Kit(32)，およびCOBOL2002 Professional Tool Kit(64)の32bitツール用のODBCデータソースです。

COBOL2002ToolKitDB64

COBOL2002 Professional Tool Kit(64)の64bitツール用のODBCデータソースです。

セットアップ時に登録されたODBCデータソースの構成を変更する場合は，ODBCデータソースアドミニストレーターを使って変更します。手順については，「3.4　手動でODBCデータソースを登録／変更する」を参照してください。

形式

easetup 〔-p ポート番号〕 -d 組み込みデータベースのフォルダパス名

easetup  -h

コマンド引数

-p ポート番号

組み込みデータベースで使用するTCP/IPのポート番号を指定します。

指定できる値の範囲は，5001〜65535です。この範囲以外のポート番号を指定すると，エラーになります。

-pオプションを省略すると，デフォルト値 20411が仮定されます。

Windowsのservicesファイル（Windowsのインストール先ドライブ:¥Windows¥system32¥drivers¥etc¥services）ですでに指定しているポート番号を指定すると，エラーになります。ポート番号が重複した場合は，-pオプションに指定するポート番号を変更して，easetupコマンドを再実行してください。

-d 組み込みデータベースのフォルダパス名

組み込みデータベースを作成するフォルダを絶対パスで指定します。組み込みデータベースで使用するデータはある程度の容量が必要になるため，Windowsをインストールしたディスク以外のディスクを指定することをお勧めします。

組み込みデータベースのフォルダパス名は，ドライブ名（「A」〜「Z」，「a」〜「z」の1文字＋「:」）で始まり，「A」〜「Z」，「a」〜「z」，「0」〜「9」，「 」（空白），「_」（アンダスコア），「.」（ピリオド）とパスを区切る「¥」で構成される，110文字以内の半角文字列の絶対パスで指定してください。110文字を超えた場合はエラーになります。また，絶対パスで指定しないと，エラーになります。

指定したフォルダが存在する場合，このフォルダの下に組み込みデータベースが作成されます。

指定したフォルダがすでにほかの製品のデータベースとして使用されている場合は，エラーになります。指定したドライブの空き容量がセットアップで必要なファイル容量よりも小さい場合もエラーになります。

注意事項

組み込みデータベースのフォルダは，easetupコマンドを実行する前に作成しておいてください。easetupコマンドの-dオプションに，存在しないフォルダパスを指定すると，自動的にフォルダが作成され，そのフォルダの下に組み込みデータベースが作成されます。-dオプションの入力誤りに注意してください。

-h

コマンドのヘルプを表示するときに指定します。

-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

戻り値

戻り値

意味

0

正常終了しました。

上記以外

エラーが発生しました。エラーの内容はイベントログに出力されます。

エラーメッセージについては，「5.5　DBユティリティのメッセージ」を参照してください。

注意

easetupコマンドの実行中にエラーが発生した場合は，アンセットアップしてください。アンセットアップは，eaunsetupコマンドを実行します。その後，エラー要因を取り除いてから，easetupコマンドを再実行してください。

すでにeasetupコマンドを実行したWindowsマシンでeasetupコマンドを再実行すると，組み込みデータベースのフォルダパス名を変更してもエラーになります。

組み込みデータベースのフォルダパス名には，ローカルドライブを指定してください。ネットワークドライブのパス名を指定すると，エラーになります。

組み込みデータベースのフォルダパス名に，存在しないフォルダのパス名，または書き込みができないフォルダのパス名を指定すると，エラーになります。

実行例

ポート番号：20411

組み込みデータベースのフォルダパス名：D:¥COBOL Analyzer¥DB

> easetup -p 20411 -d "D:¥COBOL Analyzer¥DB"

組み込みデータベースのセットアップ処理実行中です。
組み込みデータベースのセットアップ処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

組み込みデータベースのセットアップ処理を完了しました。
>

eaunsetupコマンド − 組み込みデータベースのアンセットアップ

組み込みデータベースをアンセットアップします。アンセットアップすると，組み込みデータベース一式が使えない状態になります。

セットアップのコマンド（easetupコマンド）がエラーになった場合は，eaunsetupコマンドを実行し，それまで実行したセットアップ処理を取り消してください。

形式

eaunsetup

eaunsetup  -h

コマンド引数

-h

コマンドのヘルプを表示するときに指定します。

-hオプションは必ず単独で指定し，ほかのオプションと一緒に指定しないでください。

戻り値

戻り値

意味

0

正常終了しました。

上記以外

エラーが発生しました。エラーの内容はイベントログに出力されます。

エラーメッセージについては，「5.5　DBユティリティのメッセージ」を参照してください。

注意

eaunsetupコマンドを実行すると，COBOLソース解析およびデータ影響波及分析で設定した内容はすべて削除されます。設定を残す場合は，事前にバックアップを取得しておいてください。

eaunsetupコマンドを実行していない状態でCOBOL2002 Professional Tool Kitをアンインストールすると，Windowsマシンに作成された組み込みデータベースおよび関連ファイルは削除されないまま残ります。COBOL2002 Professional Tool Kitをアンインストールする前に，必ずeaunsetupコマンドを実行してください。

実行例

> eaunsetup

組み込みデータベースのアンセットアップ処理実行中です。
組み込みデータベースのアンセットアップ処理が終了するまでに数分以上かかることがあります。
コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。

組み込みデータベースのアンセットアップ処理を完了しました。
>

付録

付録A　インストール先のフォルダ構成

COBOL2002 Professional Tool Kitのインストール先のフォルダ構成です。

フォルダパスが円記号（¥）で終わっている個所は，フォルダを示します。

表A‒1　COBOL2002 Professional Tool Kitのインストール先のフォルダ構成

フォルダパスとファイル名

説明

インストールフォルダ

COBOL2002 Professional Tool Kitのインストール先フォルダ

デフォルトは次のパス

COBOL2002 Professional Tool Kit(32)をインストールした場合

Windowsのインストール先ドライブ:¥Program Files (x86)¥Hitachi¥COBOL2002 Professional Tool Kit¥

COBOL2002 Professional Tool Kit(64)をインストールした場合

Windowsのインストール先ドライブ:¥Program Files¥Hitachi¥COBOL2002 Professional Tool Kit¥

bin¥

COBOLソース解析，データ影響波及分析，単体テスト支援のフォルダ

Files¥

HTMLファイル形式のソース解析情報用アイコンフォルダ

Script¥

HTMLファイル形式のソース解析情報用のHTML用スクリプト格納フォルダ

Stylesheet¥

HTMLファイル形式のソース解析情報用のスタイルシート格納フォルダ

Template¥

COBOLソース解析の日本語名抽出オプションテンプレート格納フォルダ

XSD¥

ソース解析オプションファイル検証用のXMLスキーマ定義格納フォルダ

XSLT¥

ソース解析情報出力用XSLT格納フォルダ

CBLANALYZER.INI

COBOLソース解析の環境定義ファイル

cblcsaEngine.dll

COBOLソースの解析エンジン

cblcsa.exe

COBOLソース解析のcblcsaコマンド

cblcsaCommon.dll

COBOLソース解析の共通部品

cblcsaDBApi.dll

COBOLソース解析のDBアクセスAPI

cblcsaSetOptions.exe

COBOLソース解析の解析生成オプション設定画面

EAsaiapi.dll

COBOLソース解析情報API

cbldra.exe

データ影響波及分析のcbldraコマンド

cbldia.exe

データ影響波及分析のcbldiaコマンド

cbldiaGUI.exe

データ影響波及分析の実行可能ファイル

cbldiadbapi.dll

プログラム情報データベースアクセス用APIライブラリ

2項関係ファイルアクセス用APIライブラリ

cbldiaAnalyzer.dll

データ影響波及分析の解析ライブラリ

cbluts.exe

単体テスト支援のcblutsコマンド

cblutsGUI.exe

単体テスト支援の実行可能ファイル

cblutsEngine.dll

単体テスト支援のエンジンライブラリ

cblutsCbp.dll

単体テスト支援のCBP解析ライブラリ

cblutsResource.dll

単体テスト支援で共通に利用するリソースライブラリ

ToolkitCommon.dll

Tool Kit共通部品ライブラリ

ToolkitGUICommon.dll

Tool Kit GUI共通部品ライブラリ

ToolkitGUICopyright.dll

Tool Kit GUIコピーライトライブラリ

ToolkitCommon64.dll

Tool Kit共通部品ライブラリ（64bit版のWindowsにCOBOL2002 Professional Tool Kit(64)をインストールした場合だけ）

ToolkitGUICommon64.dll

Tool Kit GUI共通部品ライブラリ（64bit版のWindowsにCOBOL2002 Professional Tool Kit(64)をインストールした場合だけ）

ToolkitGUICopyright64.dll

Tool Kit GUIコピーライトライブラリ（64bit版のWindowsにCOBOL2002 Professional Tool Kit(64)をインストールした場合だけ）

ToolkitIcons.dll

Tool Kitドキュメントアイコン集ライブラリ

DBUtility¥

DBユティリティのフォルダ

bin¥

DBユティリティのコマンド格納フォルダ

eabackup.bat

バックアップコマンド

eadbextr.bat

組み込みデータベースから移行データを退避するコマンド

eadbload.bat

組み込みデータベースを移行データで回復するコマンド

eadiaexp.bat

データ影響波及分析用データベースをエクスポートするコマンド

eadiaimp.bat

データ影響波及分析用データベースをインポートするコマンド

eaenvload.bat

環境設定情報の読み込みのコマンド

eaenvsave.bat

環境設定情報の保存のコマンド

eals.bat

状態表示コマンド

earorg.bat

再編成コマンド

earstr.bat

リストアコマンド

easetup.bat

セットアップコマンド

eaunsetup.bat

アンセットアップコマンド

conf¥

組み込みデータベースの環境定義格納フォルダ

ini¥

組み込みデータベースの環境変数/初期値の定義格納フォルダ

hirdb_e_CT0¥

組み込みデータベースのフォルダ

logs¥

DBユティリティのコマンドを実行したログファイル格納フォルダ

デフォルトの出力先です。

backup_yyyymmddhhmm.log

バックアップ時のログファイル（データベース退避情報ファイル）

yyyymmddhhmmは，バックアップを実行した西暦年，月，日，時刻を示します。

dbextr_yyyymmddhhmm.log

移行データの退避時のログファイル（移行データ退避情報ファイル）

yyyymmddhhmmは，移行データを退避した西暦年，月，日，時刻を示します。

dbload_yyyymmddhhmm.log

移行データの回復時のログファイル（移行データ回復情報ファイル）

yyyymmddhhmmは，移行データを回復した西暦年，月，日，時刻を示します。

diaexp_yyyymmddhhmm.log

データ影響波及分析用データベースのエクスポート時のログファイル

yyyymmddhhmmは，エクスポートを実行した西暦年，月，日，時刻を示します。

diaimp_yyyymmddhhmm.log

データ影響波及分析用データベースのインポート時のログファイル

yyyymmddhhmmは，インポートを実行した西暦年，月，日，時刻を示します。

envload_yyyymmddhhmm.log

環境設定情報の読み込み時のログファイル

yyyymmddhhmmは，環境設定情報の読み込みを実行した西暦年，月，日，時刻を示します。

envsave_yyyymmddhhmm.log

環境設定情報の保存時のログファイル

yyyymmddhhmmは，環境設定情報の保存を実行した西暦年，月，日，時刻を示します。

restore_yyyymmddhhmm.log

リストア時のログファイル（データベース回復情報ファイル）

yyyymmddhhmmは，リストアを実行した西暦年，月，日，時刻を示します。

earorg.log

再編成時のログファイル

odbc32_CTA¥

組み込みデータベース用のODBCドライバフォルダ

__CBA_cmdln

組み込みデータベースのインストール実行結果情報ファイル

付録B　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

付録B.1　関連マニュアル

関連マニュアルを次に示します。必要に応じてお読みください。

COBOL2002 Professional製品

COBOL2002 Professional Tool Kit COBOLソース解析ガイド（4010-1J-816）

COBOL2002 Professional Tool Kit データ影響波及分析ガイド（4010-1J-817）

COBOL2002 Professional Tool Kit 単体テスト支援ガイド（4010-1J-818）

COBOL2002

COBOL2002　ユーザーズガイド（4010-1J-800）

COBOL2002　操作ガイド（4010-1J-801）

COBOL2002　言語 標準仕様編（4010-1J-804）

COBOL2002　言語 拡張仕様編（4010-1J-805）

COBOL2002　Javaプログラム呼び出し機能ガイド（4010-1J-807）

COBOL2002　メッセージ（4010-1J-809）

付録B.2　このマニュアルでの表記

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

マニュアルでの表記

製品名

Excel

Microsoft Excel

Microsoft Office Excel

Windows

Windows 10(x64)

Windows 10 Enterprise 日本語版(64ビット版)

Windows 10 Pro 日本語版(64ビット版)

Windows 11

Windows 11 Pro 日本語版

Windows 11 Enterprise 日本語版

Windows Server 2019

Windows Server 2019 Standard 日本語版

Windows Server 2019 Datacenter 日本語版

Windows Server 2022

Windows Server 2022 Standard 日本語版

Windows Server 2022 Datacenter 日本語版

また，このマニュアルでは，製品名を次のように表記しています。

表記

製品名

COBOL2002

COBOL2002 Net Developer

COBOL2002 Net Developer(64)

Windows SDK

Windows SDK for Windows 11

COBOL2002 Professional Tool Kit(32)とCOBOL2002 Professional Tool Kit(64)を総称して，COBOL2002 Professional Tool Kitと表記しています。

付録B.3　KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

付録C　用語解説

（英字）

COBOL

命令文に英語を使用した，事務処理向けのプログラミング言語です。

日立製作所のCOBOL製品を次に示します。

COBOL85

標準的なCOBOLの仕様に対応する製品です。

COBOL2002

標準的なCOBOLの仕様に加え，オブジェクト指向などの新規格をサポートした製品です。

COBOL正書法

COBOLプログラムのコーディング形式です。次に示す種類があります。

固定形式

行番号領域（1〜6カラム）や標識領域（7カラム）が固定されている形式のことです。

自由形式

行番号領域や標識領域のない形式のことです。

COBOLソース解析

COBOL2002 Professional Tool Kitの機能です。

作成済みのCOBOLプログラムを解析し，プログラムの入出力処理やサブルーチンコールが，プログラム同士でどのように関連しているかを判断するための，ソース解析情報を生成できます。作成者が不明で保守できないCOBOLプログラムの解析などに適用できます。また，老朽化したプログラムの再利用や，オープン化に伴うプログラムの流用に役立つので，プログラムを有効活用できます。

解析対象のCOBOLプログラムは，事前にコンパイルしてエラーがないことを確認してください。

COBOLソース解析用データベース

COBOLソース解析で使用する，COBOLソースファイルの解析結果を格納するためのデータベースのことです。組み込みデータベースに作成されます。

COPY登録集

登録集原文のことです。登録集原文を呼び出すときにCOPY文を使用するので，この名称で表記されます。

CRUD

データベースなどの永続記憶装置で必要とされる4つの基本機能のことです。4つの基本機能とは，Create（生成），Read（読み取り），Update（更新），Delete（削除）です。

CSV

データの各項目をコンマ（，）で区切って並べたファイル形式です。

CUI

COBOL2002 Professional Tool Kitが提供するバッチプログラムのことです。例として，COBOLソース解析ではcblcsaコマンド，単体テスト支援ではcblutsコマンドが該当します。

DBユティリティ

COBOL2002 Developer Professionalの組み込みデータベースを操作するコマンドインタフェースです。組み込みデータベースのセットアップと運用で使用します。

GUI

COBOLソース解析画面や影響波及調査ウィンドウなど，COBOL2002 Professional Tool Kitが提供する画面のことです。

HTML

Webブラウザで表示する用途で使用するマークアップ言語です。

ODBC

データベースにアクセスするためのソフトウェアの標準仕様です。

PAD（Probrem Analysis Diagram：問題解析図）

プログラムの制御構造を木構造（ツリー構造）で表現した図です。3つの基本制御構造（順次，選択，反復）だけでプログラミングする，構造化プログラミングの主旨に合った表記法になっていて，プログラムの構造設計で使用されます。

図であることを明確にするために「PAD図」と呼ばれることもあります。

SQL埋め込みCOBOLソースファイル

埋め込みSQL文を含むCOBOLソースファイルのことです。ODBCインタフェース用の埋め込みSQL文を含むCOBOLソースファイル，およびCOBOL言語用SQLプリプロセサのUAPソースファイルがあります。

SQLプリプロセサ

高級言語のコンパイラでコンパイルできるように，SQL文を高級言語用の記述に変換するプログラムのことです。

（ア行）

移行データ回復情報ファイル

eadbloadコマンドの実行結果を格納するファイルのことです。組み込みデータベースのデータ移行用に，組み込みデータベースの情報を回復した結果が格納されます。

デフォルトのファイル名は，dbload_yyyymmddhhmm.logです。

移行データ退避情報ファイル

eadbextrコマンドの実行結果を格納するファイルのことです。組み込みデータベースのデータ移行用に，組み込みデータベースの情報を退避したファイルの情報が格納されます。

デフォルトのファイル名は，dbextr_yyyymmddhhmm.logです。

一意名呼び出し対応付けファイル

一意名で呼び出している文と，その呼び出し先プログラムを対応付けるファイルのことです。自動的に一意名を解決できないときに作成します。

ウィザード

対話形式で質問に答えていくことで，複雑なアプリケーションソフトの操作を簡単にするGUIの機能のことです。

影響2項関係

調査対象データ項目を処理する実行文で，処理する対象のデータ項目（調査対象）と，実行文の処理結果であるデータ項目の関係のことです。

（カ行）

解析結果CSVファイル

データ影響波及分析で，解析結果をCSV形式で出力したファイルです。

データ影響波及分析のメインウィンドウから出力できます。画面に指定したメモを保存できます。

開発マネージャ

プロジェクトの定義やツールの起動などを支援する，COBOL2002の開発環境を統合する機能です。

COBOL2002 Professional Tool Kitの機能である，COBOLソース解析，データ影響波及分析用データベースの作成，COBOLソースファイルを指定して単体テスト支援のテストプロジェクトの作成ができます。

カバレージ

プログラムをテストする手法のことです。COBOLプログラムの分岐条件が正しく実行されているか，または実行されていない処理がないか，などを統計情報として取得し，COBOLプログラムが正しく作成されているかどうかをテストします。

カバレージには，C0メジャー情報，C1メジャー情報，S1メジャー情報，およびこれらの差分情報があります。

カバレージレポート

単体テスト支援でテストを実行した際のカバレージ情報のことです。

プログラムの処理がとおっているかどうかを確認できます。

環境部（ENVIRONMENT DIVISION）

COBOLプログラムの，ハードウェア環境を定義する部（DIVISION）です。

コンピュータの名前や入出力に使用するドライブなどを定義します。

組み込みデータベース

ソフトウェア製品のデータを格納するために組み込まれたデータベースのことです。COBOL2002 Developer Professionalでは，COBOLソース解析とデータ影響波及分析の設定内容を保持するために組み込みデータベースを備えています。組み込みデータベースでは，データの格納効率を改善するための再編成や，バックアップとリストアもできます。

コメント行の文字列

COBOLプログラムの内容がわかりやすくなるように，コメント行にコーディングした日本語の文字列のことです。

コメント行の文字列をCOBOLソース解析のソース解析情報に出力するときは，［解析生成オプション設定］画面で条件を指定します。

（サ行）

再編成

データベースへのデータの書き込みと削除を繰り返すと，データの格納領域の断片化によって，ランダムな空き領域ができてしまいます。このとき，データの格納順を整えて空き領域を増やすことをデータベースの再編成といいます。組み込みデータベースを使用するときは，定期的な再編成をお勧めします。

作業場所節（WORKING-STORAGE SECTION）

COBOLプログラムのデータ部（DATA DIVISION）に定義する節（SECTION）です。ワークとして使用するデータ格納領域を定義します。

サブシステム

データ影響波及分析用データベースの情報を論理的に区切るための単位のことです。開発マネージャのプロジェクトマスタと対応づけて管理します。

実行単位

ルートプログラムが呼び出すプログラム，およびそのプログラムがさらに呼び出すプログラムの呼び出し関係をすべて収集したプログラムの集まりのことです。

スタックコンパイル

複数のCOBOLプログラムを連続してコンパイルする機能のことです。スタックコンパイルでは1つのCOBOLソースファイルに主プログラム，副プログラムを含めることができ，このCOBOLソースファイルから作成される実行可能ファイルと1対1で対応するため管理しやすくなります。

節（SECTION），セクション

COBOLプログラムを構成する単位です。部（DIVISION）の下位に記述します。

節コメント行

COBOLプログラムの節の内容がわかりやすくなるように，コメント行にコーディングした日本語の節名のことです。

節コメント行を抽出する条件は，COBOLソース解析の［解析生成オプション設定］画面にある［節コメント行抽出］タブに指定します。

ソース解析情報

COBOLソース解析の解析結果のことです。HTMLファイル形式またはCSVファイル形式で格納されます。

（タ行）

単体テスト支援

COBOL2002 Professional Tool Kitの機能です。

プログラム単位のテストである，単体テストの実行に必要なダミープログラムやファイルを自動生成し，テストプロジェクトとして管理できます。テストケースを複数設定できるので，あるテストケースの一部を変更して別のテストケースにするなど，単体テストを効率良く実行できます。

中断点

プログラムの処理をすべて実行するには時間が掛かる，または作成できた処理までの範囲をテストしたい場合などに，COBOLプログラムの処理を命令文で中断するときに設定します。

単体テスト支援では，プログラムを中断したときの値が正しいかどうかを判定するための期待値と値の代入を中断点で設定できます。

調査状態保存ファイル

データ影響波及分析の解析結果を調査する画面構成を保存するファイルです。調査状態保存ファイルには，データ影響波及分析で調査中の画面を保存できるので，翌日に続きを調査，ほかの人に調査を引き継ぐ，などの運用ができます。

調査対象一覧ファイル

データ影響波及分析で調査対象となるデータ項目の一覧をCSV形式で出力したファイルです。

調査対象データ項目

データ影響波及分析で，変更することでプログラムに影響があるかどうかを調査する，開始点となるデータ項目のことです。

調査対象データ項目を含むCOBOLプログラムのことを調査対象プログラムといいます。

データ影響波及分析

COBOL2002 Professional Tool Kitの機能です。

COBOLプログラムのデータ項目に対する修正の影響が，ほかのプログラムにどのように波及するのかを調査できます。大量で複雑な呼び出し関係があるCOBOLプログラムを解析し，GUIの操作でデータ項目に対する修正による影響を調査できます。

データ影響波及分析用データベース

データ影響波及分析で使用する，COBOLソースファイルの解析結果を格納するためのデータベースのことです。組み込みデータベースに作成されます。

データ項目

COBOLプログラムのデータ部（DATA DIVISION）で定義する，プログラムで使用するデータとして定義された領域のことです。レベル番号で階層化できます。

データ部（DATA DIVISION）

COBOLプログラムの処理で使用するデータ領域を定義する部（DIVISION）です。次に示す節（SECTION）を定義します。

ファイル節（FILE SECTION）

実際にデータを格納する領域を定義します。

作業場所節（WORKING-STORAGE SECTION）

一時的に使用する領域を定義します。

連絡節（LINKAGE SECTION）

プログラムからの呼び出しで参照されるデータ項目を定義します。

データベース回復情報ファイル

earstrコマンドの実行結果を格納するファイルのことです。トラブル時に，状態を回復する目的でバックアップファイルを使用した結果が格納されます。

デフォルトのファイル名は，restore_yyyymmddhhmm.logです。

データベース退避情報ファイル

eabackupコマンドの実行結果を格納するファイルのことです。トラブル時に，状態を回復する目的で取得したバックアップファイルの情報が格納されます。

データベース退避情報ファイルの内容を参照すれば，バックアップを取得したファイルの情報，取得したバックアップの範囲（COBOLソース解析用データベースのバックアップか，データ影響波及分析用データベースのバックアップか，またはその両方か）を確認できます。

デフォルトのファイル名は，backup_yyyymmddhhmm.logです。

データ領域

データ影響波及分析用データベースで，複数のサブシステムを格納できる領域のことです。複数の大規模プロジェクトを持つ場合に，プロジェクトを別々のデータ領域に格納することで大容量のデータを扱えます。

テストケース

単体テスト支援の，1件のテストの単位です。テストプロジェクトに複数のテストケースを作成できます。

テストケース結果レポート

1つのテストケースの単体テストを実行した結果を表示するレポートです。

テストデータ

テストケースに含まれるデータ項目の値の代入設定や表示設定など，テスト実行に必要な設定の総称です。

テストプロジェクト

単体テスト支援のテストを管理する単位です。テスト対象のCOBOLソースファイルとテストプロジェクトは1対1の関係です。テストプロジェクトには，複数のテストケースを作成できます。また，複数のテスト実行結果を格納できるので，テストを実施した履歴も管理できます。

テストプロジェクト結果レポート

単体テスト支援で，テストプロジェクトに属する複数のテストケースを一括でテストを実行した結果を一覧で表示するレポートのことです。

手続き部（PROCEDURE DIVISION）

COBOLプログラムの，プログラムの処理を定義する部（DIVISION）です。

登録集原文

COBOLプログラム中でよく利用される標準化した手続き，ファイル記述，レコード記述，または完全な1つのプログラムを，コンパイルするプログラムとは別のファイルにしたデータのことです。

（ハ行）

バックアップ

トラブルに備え，組み込みデータベースの各種情報を複製し格納することです。COBOLソース解析では，組み込みデータベースのバックアップをサポートしています。トラブル対策に加え，別のマシンにリストア（復元）して，作業環境を複製できます。

表

COBOLソース解析での表とは，データベースで使用するSQLの表のことです。

部（DIVISION）

COBOLプログラムを構成する単位です。部（DIVISION）には，次に示す4種類があります。

見出し部（IDENTIFICATION DIVISION）

環境部（ENVIRONMENT DIVISION）

データ部（DATA DIVISION）

手続き部（PROCEDURE DIVISION）

ファイル

ファイル管理記述項のASSIGN句で指定したファイル名（外部装置名，データ名，定数）の総称です。

ファイル管理記述項

COBOLプログラムで，ファイルの属性（順編成ファイル，相対編成ファイル，索引編成ファイルなど）を定義します。ファイル管理記述項は，SELECT句で始め，ASSIGN句で記憶媒体名または記憶装置名を定義します。

ファイル節（FILE SECTION）

COBOLプログラムのデータ部（DATA DIVISION）に定義する節（SECTION）です。実際にデータを格納する領域を定義します。

プログラムコメント行

COBOLプログラムのプログラム名に半角英数字を使用している場合に，プログラムの内容がわかるように，コメント行にコーディングしている日本語の2バイト文字列のことです。

プログラムコメント行を抽出する条件は，COBOLソース解析の［解析生成オプション設定］画面にある［プログラムコメント行抽出］タブに指定します。

プログラム情報フィルタリングファイル

データ影響波及分析で，COBOLソースファイルの解析結果をフィルタリングするためのファイルです。

プログラム名

COBOLプログラムに付ける名前のことで，見出し部（IDENTIFICATION DIVISION）のPROGRAM-IDに指定します。

（マ行）

マイグレーション

システムで使用しているプログラムおよび関連するデータを別のシステムに移して活用することです。企業の基幹システムの変更に伴い，メインフレームのプログラム資産をWindows環境に移植，などの作業が該当します。

未使用資産

未使用のソフトウェア資産のことです。資産分析（資産の棚卸し）によって洗い出される，未使用資産を保守・運用の対象外にすることで，保守・運用工数，コストを削減できます。

見出し部（IDENTIFICATION DIVISION）

COBOLプログラムの，見出しを記述する部（DIVISION）です。見出し部で記述する項目の例を次に示します。

プログラム名（PROGRAM-ID）

メインフレーム

中規模または部門ごとに構築したWindowsまたはUNIXを基盤とするサーバに対し，基幹業務を実行する大型のホストコンピュータのことを指します。日立製作所のメインフレームには基本ソフト（OS）にVOS系（VOS3，VOS1，VOSKなど）を搭載しています。

（ラ行）

リストア

バックアップしたデータを使って，組み込みデータベースを復元することです。COBOLソース解析では，バックアップからの復元に加え，あるWindowsマシンのバックアップを別のWindowsマシンにリストアして，作業環境を複製できます。

リバースエンジニアリング

コーディング済みのCOBOLプログラムを解析し，どのようにプログラムが設計されているのかを導き出す手法のことです。通常のソフトウェア開発工程と逆の手順となることから，リバースエンジニアリングといいます。

ルートプログラム

データ影響波及分析用データベースに登録したCOBOLソースファイルの中で，どのCOBOLソースファイルからも呼び出されないプログラムのことです。

連絡節（LINKAGE SECTION）

COBOLプログラムのデータ部（DATA DIVISION）に定義する節（SECTION）です。プログラムからの呼び出しで参照されるデータ項目を定義します。

索引

C

COBOL2002 Developer Professional[1]

COBOL2002 Developer Professionalの利用環境[1]

COBOL2002 Developer Professionalをアンインストールする[1]

COBOL2002 Developer Professionalをインストールする[1]

COBOL2002 Developer Professionalを構成する機能[1]

COBOL2002 Professional Tool Kit[1]、[2]、[3]、[4]、[5]

COBOLエディタ[1]、[2]

COBOLコンパイラ[1]

COBOL正書法〔用語解説〕[1]

COBOLソース解析[1]、[2]

COBOLソース解析の解析環境を保存して利用する[1]

COBOLソース解析の環境設定情報の保存[1]

COBOLソース解析の環境設定情報の読み込み[1]

COBOLソース解析〔用語解説〕[1]

COBOLソース解析用データベース〔用語解説〕[1]

COBOLプログラム開発環境[1]、[2]

COBOLプログラム開発作業にソース解析情報を活用する[1]

COBOLプログラム資産の有効活用[1]

COBOLプログラムの影響波及の調査[1]

COBOLプログラムの棚卸しの支援[1]

COBOLプログラムの単体テストの効率化[1]

COBOL〔用語解説〕[1]

COPY登録集〔用語解説〕[1]

CRUD〔用語解説〕[1]

CSV〔用語解説〕[1]

CUI〔用語解説〕[1]

D

DATA DIVISION〔用語解説〕[1]

DBユティリティ[1]

DBユティリティ〔用語解説〕[1]

DBユティリティを起動する[1]

DIVISION〔用語解説〕[1]

E

eabackupコマンド[1]、[2]

eadbextrコマンド[1]

eadbloadコマンド[1]

eadiaexpコマンド[1]

eadiaimpコマンド[1]

eaenvloadコマンド[1]

eaenvsaveコマンド[1]

ealsコマンド[1]、[2]

earorgコマンド[1]、[2]

earstrコマンド[1]、[2]

easetupコマンド[1]、[2]

eaunsetupコマンド[1]、[2]

ENVIRONMENT DIVISION〔用語解説〕[1]

F

FILE SECTION〔用語解説〕[1]

G

GUI〔用語解説〕[1]

H

HiRDB Driver Setup画面[1]

HTML〔用語解説〕[1]

I

IDENTIFICATION DIVISION〔用語解説〕[1]

L

LINKAGE SECTION〔用語解説〕[1]

O

ODBCデータソース アドミニストレーター画面[1]

ODBC〔用語解説〕[1]

ODBCレコード定義生成[1]

P

PAD〔用語解説〕[1]

PROCEDURE DIVISION〔用語解説〕[1]

S

SECTION〔用語解説〕[1]

SQL埋め込みCOBOLソースファイル〔用語解説〕[1]

SQLプリプロセサ〔用語解説〕[1]

U

unsetup.errファイル[1]

W

Windowsファイアウォールの例外リストへの登録[1]

WORKING-STORAGE SECTION〔用語解説〕[1]

あ

アンインストール[1]

アンインストール時に問題が起こったときの対処[1]

アンインストール前の準備をする[1]

アンセットアップ[1]、[2]

い

移行データ回復情報ファイル〔用語解説〕[1]

移行データ退避情報ファイル〔用語解説〕[1]

一意名呼び出し対応付けファイル〔用語解説〕[1]

インストール[1]

インストール前の準備をする[1]

う

ウィザード〔用語解説〕[1]

ウィルス対策ソフト実行時の注意[1]

え

影響2項関係〔用語解説〕[1]

影響波及の分析対象[1]

影響波及の分析と調査方法[1]

エラー時の対処[1]

か

解析結果CSVファイル〔用語解説〕[1]

解析できる項目[1]

開発マネージャ[1]

開発マネージャ〔用語解説〕[1]

外部ツール[1]

外部ツールでのソースプログラムの操作[1]

カバレージ[1]

カバレージ〔用語解説〕[1]

カバレージレポート〔用語解説〕[1]

画面定義[1]

環境が壊れてしまったとき[1]

環境部〔用語解説〕[1]

き

既存のCOBOLプログラムを解析してCOBOLプログラムを開発する[1]

く

組み込みデータベース[1]、[2]

組み込みデータベースから移行データの退避[1]

組み込みデータベースに問題が起こったときの対処[1]

組み込みデータベースのアンセットアップ[1]、[2]

組み込みデータベースの回復方法[1]

組み込みデータベースの再作成[1]

組み込みデータベースの再編成[1]、[2]

組み込みデータベースの状態の表示[1]

組み込みデータベースの状態を確認する[1]

組み込みデータベースのセットアップ[1]

組み込みデータベースのバックアップ[1]

組み込みデータベースのリストア[1]

組み込みデータベース〔用語解説〕[1]

組み込みデータベースを移行データで回復[1]

組み込みデータベースを作成する[1]

組み込みデータベースを退避してほかのマシンへ移行する[1]

こ

構成管理ツール[1]、[2]

コマンドの一覧[1]

コマンドの実行で注意すること[1]

コマンドプロンプトを短くしたい場合[1]

コメント行の文字列〔用語解説〕[1]

さ

再編成[1]、[2]

再編成〔用語解説〕[1]

作業場所節〔用語解説〕[1]

サブシステム〔用語解説〕[1]

し

実行支援[1]

実行単位〔用語解説〕[1]

手動でODBCデータソースを登録／変更する[1]

す

スタックコンパイル〔用語解説〕[1]

せ

セクション〔用語解説〕[1]

節コメント行〔用語解説〕[1]

セットアップ[1]

セットアップコマンドを実行する[1]

節〔用語解説〕[1]

そ

ソース解析情報[1]

ソース解析情報の形式[1]

ソース解析情報の保存[1]

ソース解析情報〔用語解説〕[1]

た

単体テスト支援[1]、[2]

単体テスト支援〔用語解説〕[1]

ち

チーム開発のサポート[1]

中断点〔用語解説〕[1]

調査結果の保存[1]

調査状態保存ファイル〔用語解説〕[1]

調査対象一覧ファイル〔用語解説〕[1]

調査対象データ項目〔用語解説〕[1]

て

データ影響波及分析[1]、[2]

データ影響波及分析〔用語解説〕[1]

データ影響波及分析用データベース[1]

データ影響波及分析用データベースのインポート[1]

データ影響波及分析用データベースのエクスポート[1]

データ影響波及分析用データベース〔用語解説〕[1]

データ影響波及分析用データベースをエクスポート/インポートする[1]

データ項目〔用語解説〕[1]

データ部〔用語解説〕[1]

データベース回復情報ファイル〔用語解説〕[1]

データベース退避情報ファイル〔用語解説〕[1]

データ領域〔用語解説〕[1]

テストケース結果レポート〔用語解説〕[1]

テストケースの管理[1]

テストケース〔用語解説〕[1]

テストデータ〔用語解説〕[1]

テストデバッガ[1]、[2]

テストの実行方法[1]

テストプロジェクト結果レポート[1]

テストプロジェクト〔用語解説〕[1]

手続き部〔用語解説〕[1]

デッドコード候補から使われていないソースコードを除外してテスト効率を上げる[1]

と

登録集原文〔用語解説〕[1]

は

ハードウェアの入れ替えに伴う環境の移行[1]

バックアップ[1]、[2]

バックアップ〔用語解説〕[1]

ひ

表〔用語解説〕[1]

ビルド[1]

ふ

ファイル/レコード定義[1]

ファイル管理記述項〔用語解説〕[1]

ファイル節〔用語解説〕[1]

ファイル〔用語解説〕[1]

部〔用語解説〕[1]

プログラム開発フェーズとCOBOL2002 Developer Professionalとの関係[1]

プログラムコメント行〔用語解説〕[1]

プログラム作成支援ツール[1]

プログラム情報フィルタリングファイル〔用語解説〕[1]

プログラム名〔用語解説〕[1]

ほ

ほかのマシンに解析環境を複製する[1]

ま

マイグレーション〔用語解説〕[1]

み

未使用資産〔用語解説〕[1]

見出し部〔用語解説〕[1]

め

メインフレーム〔用語解説〕[1]

メニュー構成[1]

も

問題解析図〔用語解説〕[1]

よ

容量不足に伴う組み込みデータベースの再セットアップ[1]

り

リストア[1]、[2]、[3]

リストア〔用語解説〕[1]

リバースエンジニアリング〔用語解説〕[1]

利用環境[1]

る

ルートプログラム〔用語解説〕[1]

れ

例外リストに登録する[1]

連絡節〔用語解説〕[1]

ろ

ログファイル[1]