先生と生徒の会話形式で理解しよう

生徒

「COBOLで変数ってどうやって名前を付けるんですか？ルールはありますか？」

先生

「はい、COBOLでは変数名の付け方にルールがあります。そして、読みやすい名前にすることが大切です。」

生徒

「読みやすいって、どういうことですか？」

先生

「それでは、COBOLの変数命名の基本と、わかりやすい名前を付けるコツを詳しく説明しましょう！」

1. COBOLの変数とは？

COBOLの変数とは、プログラムの中でデータを一時的に保存する「入れ物」のようなものです。たとえば、「年齢」や「金額」などをプログラム中で使いたいとき、その値を保存しておくために使います。

変数は、DATA DIVISION（データ部）の中で定義されます。

2. COBOLの変数命名の基本ルール

COBOLで変数名を付けるときには、次のような命名規則（ルール）があります。

英大文字、数字、ハイフン（-）が使える
先頭は英文字で始める
ハイフン（-）は先頭や末尾には使わない
記号やスペースは使えない（例：!、@、#など）
英小文字は使用できない（COBOLでは通常、英大文字を使います）

たとえば、次のような名前が有効です：

CUSTOMER-NAME
TOTAL-AMOUNT
EMPLOYEE-ID

3. 可読性（読みやすさ）を意識した名前の付け方

変数名は、プログラムを書くときだけでなく、あとで見直すときにもわかりやすいことが大切です。読みやすい名前をつけることで、バグ（間違い）を見つけやすくなり、他の人にも理解しやすくなります。

以下のようなポイントを意識しましょう：

意味のある単語を使う（例：AGE、PRICE、DATEなど）
複数の単語はハイフンで区切る（例：ORDER-NUMBER）
短すぎる名前は避ける（例：X や Y など）

例えば、下記のように変数を定義すると読みやすくなります。


01 CUSTOMER-NAME      PIC X(30).
01 ORDER-NUMBER       PIC 9(5).
01 TOTAL-AMOUNT       PIC 9(7)V99.

4. よくある命名ミスとその注意点

初心者がやってしまいやすいミスには、次のようなものがあります。

ハイフンの使い方のミス：先頭や末尾にハイフンをつけてしまう
英小文字を使う：COBOLでは英大文字が基本です
意味のない名前：A1、DATA1 など、後で見ても何を意味するのかわからない名前

たとえば、以下のような名前は避けましょう：

-NAME（ハイフンが先頭にある）
price（英小文字を使用）
D1（意味が不明）

5. 実際のCOBOLプログラムで使ってみよう

それでは、読みやすい変数名を使った簡単なCOBOLプログラムを見てみましょう。


       IDENTIFICATION DIVISION.
       PROGRAM-ID. NAME-DEMO.
       DATA DIVISION.
       WORKING-STORAGE SECTION.
       01 CUSTOMER-NAME      PIC X(20) VALUE "ヤマダタロウ".
       01 TOTAL-AMOUNT       PIC 9(5)V99 VALUE 12345.67.
       PROCEDURE DIVISION.
           DISPLAY "顧客名：" CUSTOMER-NAME
           DISPLAY "合計金額：" TOTAL-AMOUNT
           STOP RUN.

このプログラムを実行すると、以下のような結果が表示されます。


顧客名：ヤマダタロウ
合計金額：12345.67

6. 命名に役立つヒント集

変数名を考えるときに便利な考え方を紹介します。

何を表しているのかをそのまま名前にする
日本語を英語に変換して使う（例：「年齢」→AGE、「金額」→AMOUNT）
複数の情報を表すときは、それぞれの要素をつなげる（例：「顧客の名前」→CUSTOMER-NAME）

変数名を英語にするのが難しいと感じたら、簡単な単語から覚えていくと良いでしょう。

まとめ

COBOLの変数名の付け方は、ただルールを守るだけではなく、のちのち読み返したときにすぐ意味が理解できるように工夫することがとても重要です。とくに業務システムでは数多くのデータ項目が存在し、ひとつひとつの変数が何を表しているのかを明確に示す名前にしておくことで、保守作業が格段にやりやすくなります。変数名は、プログラムを長く運用していくうえで品質と作業効率を大きく左右する要素であり、読み手が迷わず理解できるかどうかが成功の鍵になります。また、COBOLの命名規則では英大文字・数字・ハイフンが基本であり、英小文字や特殊記号を使わないという制約がありますが、その制約の中でも工夫次第でとても整理された名前をつけることができます。たとえば、情報を正確に表す英単語を選んで組み合わせたり、ハイフンを使って単語同士を区切り、視認性を高めたりすることで、一目で役割がわかる変数名になります。とくに業務ロジックが複雑になるほど、変数名はコード全体の理解を助ける重要な役割を果たします。プログラムの処理内容がわかりやすくなる変数名の付け方として、項目をそのまま英単語に変換し、さらに複数の要素を含む場合は順番を工夫して並べるという方法がよく使われます。顧客番号であれば CUSTOMER-NUMBER、入金金額であれば DEPOSIT-AMOUNT など、意味が明確な形にすることで、読み間違いや理解の齟齬が起こりにくくなります。こうした小さな積み重ねが大規模なプログラムでは大きな違いになり、作業のスピードと正確さに大きく影響します。また、命名の段階で曖昧な表現を避けるのも大切です。たとえば DATA1 や A といった意味の乏しい名前では、何を表しているのかを読み取ることが難しく、修正作業に余計な時間がかかってしまいます。逆に、役割を明確にした名前に統一しておけば、コード全体の構造も理解しやすくなり、ほかの開発者が加わったときでもスムーズに引き継ぐことができます。ここでは、読みやすい命名のコツを踏まえつつ、実際のプログラム内でどのように変数を定義すればよいか、再度サンプルを使って整理してみます。

読みやすい変数名を使ったサンプルコード


*> 顧客情報を扱う変数名の例
01 CUSTOMER-NAME         PIC X(30).
01 CUSTOMER-ADDRESS      PIC X(50).
01 ORDER-AMOUNT          PIC 9(7)V99.
01 PAYMENT-STATUS        PIC X(10).

*> 変数を使った簡単な処理例
IF PAYMENT-STATUS = "PAID"
    DISPLAY "入金済みのお客様です。"
ELSE
    DISPLAY "未入金のお客様です。"
END-IF

このように、顧客に関する情報であれば CUSTOMER-〜 と統一したり、金額や区分値に関するものは AMOUNT や STATUS を適切に組み合わせたりすることで、プログラム全体の流れが明確になり、処理の意図も自然と理解しやすくなります。また、帳票番号や商品番号など、業務ごとに登場する固有の情報も、業務単語に基づいて正確な名称にすることが望まれます。名前づけの工夫は、長く使われる基幹システムほど価値を発揮し、ミスを防ぎながら安定した処理を実現する基盤になります。さらに、変数名を考えるときは「その変数がどんな情報を持つのか」「どの処理で使われるのか」を事前に整理しておくことも重要です。情報の用途があいまいなまま変数を定義してしまうと、後から仕様変更が入ったときに混乱しやすくなります。業務内容と密接に関わる項目を扱うCOBOLでは、こうした命名の基礎がコードの可読性と安全性に直結するため、初心者のうちから丁寧に意識しておくと大きな効果があります。また、同じ種類の変数を複数持つ場面では、共通の接頭語をつけて分類すると整理がしやすくなります。たとえば売上に関する項目は SALES-〜、請求に関する項目は BILL-〜 といった具合にまとまりを作ると、コードを追っているときにもどのグループに属するデータなのかが一目で判断できます。こうした構造化された命名は、チーム開発においても非常に役立ちます。命名の工夫がプログラム全体の質を高めることは多くの業務開発者が実感しており、初心者がまず身につけておくべき基本のひとつです。長く運用されるシステムほど、読みやすさと正確な表現をもった変数名が重要になります。今回のテーマで押さえたポイントは、他の処理を作るときにも幅広く応用できる基盤となるはずです。

先生と生徒の振り返り会話

生徒

「変数名って思っていたより大事なんですね。ただ動けば良いというわけじゃなくて、読みやすさがすごく重要だと感じました。」

先生

「その通りです。変数名はプログラムの理解を助ける大事な手がかりになります。読みやすい名前を付けておけば、あとで見たときにも迷わず理解できますよ。」

生徒

「英大文字やハイフンのルールも覚えました。意味のある英単語を組み合わせることで、どんな情報なのかすぐわかりますね。」

先生

「ええ。COBOLでは業務データを扱うことが多いので、命名の工夫ひとつで可読性が大きく変わります。今日学んだことをこれからのプログラムにもぜひ活かしていきましょう。」