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

生徒

「会社でCOBOLのプログラムを書くときに、書き方のルールを決めようって話が出たんですけど、自由に書いちゃダメなんですか？」

先生

「自由に書けるのは楽しいですが、お仕事では『コーディング規約』という共通のルールを守ることがとても大切なんですよ。」

生徒

「ルールがあると、どんな良いことがあるんでしょうか？具体的な作り方も気になります！」

先生

「規約があることで、他の人が書いたプログラムも読みやすくなり、ミスも減ります。今日はその重要性と策定方法を丁寧に解説しますね！」

1. コーディング規約とは何か

コーディング規約（こーでぃんぐきやく）とは、プログラミングを行う際に、プログラムの書き方について定めた「社内ルール」のことです。プログラミング言語には自由な書き方ができる部分がたくさんありますが、そこをあえて統一するのが規約の役割です。

パソコンを触ったことがない方向けに例えると、「公用文の書き方」や「会社の伝票の書き方」のようなものです。人によって「日付を令和で書くか、西暦で書くか」がバラバラだと、後でまとめるのが大変ですよね。それと同じで、プログラムも「誰が書いても同じスタイルに見える」ようにルールを決めておくのです。

COBOL（コボル）は特に歴史が長く、数十年前に書かれたプログラムを今の人が直すことも珍しくありません。そのため、時代を超えて誰もが理解できるようなルールが必要不可欠なのです。

2. なぜ企業内に独自のルールが必要なのか

COBOLそのものに世界共通の標準規格（ルール）はありますが、それだけでは不十分です。なぜなら、標準規格は「できること」を定義しているだけで、「どう書くのが一番読みやすいか」までは決めていないからです。

企業内に独自のコーディング規約が必要な理由は主に以下の3つです。

保守性の向上：誰が書いたプログラムでも、パッと見て内容が理解できれば、修正や点検がスムーズに進みます。
品質の安定：「こういう書き方はエラーが起きやすいから禁止」といったルールを盛り込むことで、初心者が書いたコードでも一定の品質を保てます。
引き継ぎの短縮：担当者が変わったときに、書き方がバラバラだと解読に時間がかかります。ルールが統一されていれば、すぐに作業に入れます。

特にCOBOLは、銀行や公共機関など、一分の隙も許されない重要なシステムで使われることが多いため、こうした「守りのルール」が非常に重視されます。

3. 規約で定めるべき具体的な項目

具体的にどんなルールを決めるのか、いくつかの例を見てみましょう。

まず代表的なのが「命名規則（めいめいきそく）」です。これは、プログラムの中で使うデータの「箱（変数）」にどんな名前を付けるか、というルールです。例えば、「売上金額なら必ず SALES-AMOUNT と書く」といった決まりです。

次に、「インデント（字下げ）」のルールです。プログラムの行の始まりにスペースを入れて、見た目を整えることです。以下のコードは、インデントを整えた綺麗な書き方の例です。


IF SALES-AMOUNT > 1000000 THEN
    DISPLAY "大型注文です。"
    MOVE "GOLD" TO CUSTOMER-RANK
ELSE
    DISPLAY "通常注文です。"
    MOVE "NORMAL" TO CUSTOMER-RANK
END-IF.

実行結果は以下のようになります。


大型注文です。

このように、どこからどこまでが「IF文（条件分岐）」の中身なのかが一目で分かるようにするのが、規約の大きな目的です。

4. 初心者でもわかるプログラムの「見た目」のルール

プログラミング未経験の方にとって、暗号のように見えるコードも、ルールがあれば整然として見えます。規約では「大文字で書くか、小文字で書くか」も決めます。古くからのCOBOLの現場では、すべて大文字で書くというルールが多いですが、最近では見やすさを重視して小文字を混ぜることもあります。

また、「コメント」の入れ方も重要です。コメントとは、コンピューターには無視される、人間向けのメモのことです。以下のプログラムを見てください。


*--- 消費税の計算を行う処理 ---*
COMPUTE TAX-AMOUNT = UNIT-PRICE * 0.10.
*--- 計算結果を画面に表示する ---*
DISPLAY "消費税額: " TAX-AMOUNT.

実行結果は以下の通りです。


消費税額: 00000050

このように、「何をしている処理か」を日本語で書き残すルールを作ることで、後で読み返したときに迷わずに済みます。規約では「このメモを必ずプログラムの冒頭に入れること」といった指示を出します。

5. コーディング規約の策定方法：ステップ1

では、実際に会社で規約を作るにはどうすればいいでしょうか。まずは「現状の調査」から始めます。

会社にすでにある古いプログラムをいくつか集めて、どのような書き方が主流になっているかを確認します。全く新しいルールを作ってしまうと、これまでのプログラムと見た目が違いすぎて、かえって混乱を招くからです。これを「棚卸し」と言います。お部屋の片付けをする前に、どんな服を持っているか全部出すのと似ていますね。

この段階では、ベテランエンジニアに「長年守ってきた暗黙の了解」を聞き出すことも大切です。文書になっていないけれど、みんなが守っている良い習慣が隠れていることが多いからです。

6. コーディング規約の策定方法：ステップ2

現状がわかったら、次は「標準案の作成」です。ここでは欲張りすぎず、まずは基本的な部分から決めていきましょう。最初から数百ページもあるルールブックを作っても、誰も守れません。

特に重要なのは、数値の扱い方です。COBOLは計算の正確さが命ですので、数値を入れる箱（データ項目）の定義方法を統一します。例えば、以下のように「数字を入れるときは必ず9桁にする」といったルールです。


DATA DIVISION.
WORKING-STORAGE SECTION.
* ルール：金額項目は必ず PIC 9(9) で定義する
01 TOTAL-SALES PIC 9(9) VALUE 0.
01 ITEM-PRICE  PIC 9(9) VALUE 1500.

PROCEDURE DIVISION.
    ADD ITEM-PRICE TO TOTAL-SALES.
    DISPLAY "現在の合計額: " TOTAL-SALES.
    STOP RUN.

実行結果は以下のようになります。


現在の合計額: 000001500

このように桁数を揃えるルールを作ることで、計算ミスや桁溢れ（数字が入り切らなくなること）を防ぐことができます。

7. 専門用語のやさしい解説

ここで、少し難しいIT用語を整理しておきましょう。

リファクタリング：プログラムの動き（結果）は変えずに、中身を規約通りに綺麗に書き直すことです。お部屋の模様替えのようなものです。
コードレビュー：書いたプログラムを、他の人がチェックすることです。規約が守られているか、ミスがないかを第三者の目で見ます。
定数（ていすう）：消費税率など、プログラムの中で変わらない決まった値のことです。規約ではこれに分かりやすい名前を付けることが推奨されます。
ブラックボックス：中身がどうなっているか分からない状態のことです。規約がないと、数年後のプログラムはこの状態になってしまいます。

8. 策定後の運用と形骸化の防止

せっかく規約を作っても、誰も守らなくなってしまっては意味がありません。これを形骸化（けいがいか）と言います。中身がない「名前だけのルール」になってしまうことです。

形骸化を防ぐためには、以下の工夫が必要です。

定期的な見直し：新しい技術が入ってきたら、ルールも柔軟に更新します。古臭いルールばかりだと、現場が困ってしまいます。
チェックツールの活用：人間が目で見るだけでなく、コンピューターに「ルール違反がないか」を自動で探させるソフトを導入します。
教育の実施：新しく入った人に、なぜこのルールがあるのかを丁寧に説明します。納得感があれば、みんな喜んで守ってくれます。

規約は「縛るための道具」ではなく、「みんなで楽をするための共通言語」だと捉えるのが、運用のコツです。

9. 文字列操作で学ぶ共通ルールの例

規約では、文字の扱い方も細かく決めます。例えば、「メッセージを表示するときは、必ず特定の形式に合わせる」といった具合です。次のプログラムは、規約に沿って名前を丁寧に編集する例です。


IDENTIFICATION DIVISION.
PROGRAM-ID. FORMAT-NAME.
DATA DIVISION.
WORKING-STORAGE SECTION.
01 RAW-NAME    PIC X(10) VALUE "SUZUKI".
01 FORMAT-NAME PIC X(20).

PROCEDURE DIVISION.
* 規約：名前の後ろには必ず「様」を連結して表示すること
    STRING "顧客名: " RAW-NAME " 様" DELIMITED BY SIZE
           INTO FORMAT-NAME.
    DISPLAY FORMAT-NAME.
    STOP RUN.

実行結果は以下のようになります。


顧客名: SUZUKI     様

こうした細かいルールが、システムの「おもてなし」の品質を作っています。規約があることで、どのプログラムから出力されても同じ丁寧なメッセージがユーザーに届くようになるのです。

10. 規約は会社の資産を守る盾

COBOLのプログラムは、何十年も会社を支える大切な資産です。コーディング規約は、その資産が古くなってボロボロにならないように守る「盾」のような存在です。一見、面倒な決まり事に見えるかもしれませんが、それを守り続けることで、将来のエンジニアたちが「このプログラムは読みやすくて助かる！」と笑顔になれるのです。

これからプログラミングに触れる方も、すでにバリバリ書いている方も、今一度「自分たちのルール」を見直してみてはいかがでしょうか。丁寧なルール作りが、確かなシステムと、働きやすい職場を作っていきます。