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

生徒

「COBOLのプログラムを動かすときに使うJCLというものが、複雑で読みにくいと感じています。連携部分を分かりやすくする方法はありますか？」

先生

「JCLはプログラムに指示を出す大切な役割を持っていますが、確かに書き方次第で読みやすさが大きく変わりますね。」

生徒

「初心者でも後から見返してすぐに理解できるような、JCL連携のコツを教えてほしいです！」

先生

「可読性を向上させるベストプラクティスを、基本的な仕組みから一つずつ丁寧に解説していきましょう！」

1. JCLとは何か？COBOLプログラムとの関係性

プログラミング未経験の方にとって、COBOLプログラムそのものよりも謎に包まれているのがJCL（ジェイシーエル）かもしれません。JCLとは「Job Control Language」の略で、日本語では「ジョブ制御言語」と呼ばれます。簡単に言えば、コンピュータに対する「作業指示書」のことです。

パソコンを触ったことがない方に例えるなら、COBOLプログラムが「料理人」だとすると、JCLは「レストランの注文票」のようなものです。「どの食材（データ）を使って」「どの調理器具（プログラム）を動かし」「出来上がった料理（結果）をどこに運ぶか」という一連の指示をJCLが担当します。

COBOLプログラムは単体では動けません。JCLが「このファイルを開いてください」と指示を出して初めて、プログラムは計算を開始できます。このJCLとCOBOLが情報をやり取りする部分を「連携部」と呼びます。ここが整理されていないと、トラブルが起きたときにどこに問題があるのか分からなくなってしまうため、読みやすさ（可読性）を保つことが非常に重要なのです。

2. ファイル名の定義とSELECT句の標準化

COBOLプログラムの中でファイルを扱う際、最初に行うのがSELECT句（セレクトく）による定義です。ここでは、プログラム内で使う「論理名（仮の名前）」と、JCLで指定する「外部名（本当の名前）」を結びつけます。

可読性を高めるためのベストプラクティスは、この名前に一貫性を持たせることです。例えば、売上データを読み込むならプログラム内ではSALES-FILEとし、JCL側でもSALESという名前を使うようにルール化します。バラバラな名前を付けてしまうと、指示書と現場の連携が取れなくなり、パニックの原因になります。

初心者のうちは、この対応関係をしっかり意識しましょう。プログラムの中に書かれた名前が、JCLのどの部分に対応しているのかを一目で分かるようにしておくことが、ミスを防ぐ最大の防御策となります。名前の付け方一つで、プログラムの品質は大きく変わるのです。


* プログラム内でのファイル定義の例
INPUT-OUTPUT SECTION.
FILE-CONTROL.
    SELECT IN-FILE ASSIGN TO SYS001.
    SELECT OUT-FILE ASSIGN TO SYS002.

3. JCLのDD文と外部名の対応ルール

JCL側でファイルなどの資源を指定する場所をDD文（ディーディーぶん）と呼びます。DDは「Data Definition」の略です。先ほどのCOBOL側の定義でASSIGN TO SYS001と書いた場合、JCL側でも//SYS001 DD ...という行を作成しなければなりません。

この時のポイントは、SYS001のような無機質な番号だけでなく、可能な限り役割が分かる名前を使うか、コメントを添えることです。標準的なコーディング規約では、入力ファイルにはIN、出力ファイルにはOTといった接頭辞を付けるルールがよく採用されます。

パソコン初心者の方には、DD文は「箱にラベルを貼る作業」だと考えてください。中身がリンゴなのかミカンなのか、外側にしっかり書いておかないと、後で箱を開けるときに困りますよね。JCLのDD文を丁寧に書くことは、システム全体の「中身の見える化」につながります。


//STEP01   EXEC PGM=SALESPROG
//SYS001   DD DSN=USER.DATA.INPUT,DISP=SHR
//SYS002   DD DSN=USER.DATA.OUTPUT,DISP=(NEW,CATLG)
//SYSOUT   DD SYSOUT=*

4. パラメータ情報の受け渡しとACCEPT文

プログラムを動かす際、ファイルだけでなく「今日の日付」や「処理モード」といった短い情報を外から教えたいことがあります。これを「パラメータ」と呼びます。JCLからこのパラメータを渡すには、PARM（パルム）指定という機能を使います。

COBOL側でこの情報を受け取るには、ACCEPT（アクセプト）文という命令を使います。可読性を高める手順としては、受け取った直後にその内容を画面に表示（DISPLAY）させるコードを書いておくのがベストです。これにより、後でログを見たときに「どんな指示でプログラムが動いたのか」がはっきりと記録に残ります。

「何も言わずに黙々と作業する」よりも「指示を受けました、これから○○の作業をします」と宣言するプログラムの方が、使う人にとって親切です。難しい用語ですが、パラメータは「今日のおすすめメニュー」のような、その時々で変わる特別な注文だと理解しておきましょう。


* JCLからパラメータを受け取る例
DATA DIVISION.
WORKING-STORAGE SECTION.
01 WK-PARAM  PIC X(10).
PROCEDURE DIVISION.
    ACCEPT WK-PARAM FROM SYSIN.
    DISPLAY "受け取ったパラメータ: " WK-PARAM.

5. リターンコード（終了ステータス）の統一管理

JCLは、複数のプログラムを順番に動かすことができます。このとき、前のプログラムが成功したか失敗したかによって、次のプログラムを動かすかどうかを判断します。この成功・失敗を伝える数字が「リターンコード」です。COBOLではRETURN-CODEという特別な箱に数字を入れることで、JCLに結果を報告します。

標準化のルールとして、「0なら成功」「4なら軽い注意」「8以上なら大失敗」という風に数字の意味を統一します。バラバラな基準で数字を返すと、JCL側で「今回は8だけど動かしていいのかな？」と迷ってしまいます。ルールを鉄の掟として守ることが、システム全体の安全性を高めます。

これは学校のテストの点数と同じです。80点以上なら合格、というルールが事前に決まっているからこそ、結果を見てすぐ次の方針が立てられるのです。プログラムも、結果の報告方法（リターンコード）を整えることで、JCLとの連携がスムーズになります。


* リターンコードを設定して終了する例
IF ERR-COUNT > 0
    MOVE 8 TO RETURN-CODE
ELSE
    MOVE 0 TO RETURN-CODE
END-IF.
STOP RUN.

6. 条件付実行とステップの構造化

JCLの中には、複数の処理ステップ（STEP）を書くことができます。可読性を向上させるためには、このステップ名にも意味のある名前を付け、各ステップが何をしているかを明確にする必要があります。例えば、STEP1とするよりもS-FORMAT（初期化ステップ）、S-MAIN（本処理ステップ）とした方が親切です。

また、前のステップでリターンコードが8だった場合は実行しない、といった「条件付実行」の機能もJCLにはあります。これを活用することで、異常な状態で無理やり処理を続けてデータを壊してしまうリスクを防げます。プログラムの連携部を美しく保つことは、単に見栄えを良くするだけでなく、データの安全を守ることにも直結します。

パソコンを触ったことがない方には、これは工場の流れ作業のようなものだと思ってください。前の工程で部品が壊れていたら、次の工程には進みませんよね。JCLは、そうした「安全装置」の役割も果たしているのです。構造化されたJCLは、非常に高い信頼性を誇ります。

7. カタログ式プロシージャの活用による簡素化

同じようなJCLの書き方を何度も繰り返すのは、効率が悪く間違いの元です。そこで、よく使うJCLのパターンをあらかじめ登録しておき、一行で呼び出せるようにしたものを「カタログ式プロシージャ」と呼びます。

これを使うことで、個別のJCLは非常に短くスッキリしたものになります。可読性が向上するだけでなく、一箇所を直せばそれを使っている全てのJCLに修正が反映されるため、メンテナンスが格段に楽になります。複雑な設定はプロシージャの中に隠し、使う側は最小限の情報（ファイル名など）だけを渡すように設計するのが、プロのやり方です。

これはスマートフォンの「ショートカット機能」のようなものです。複雑な操作を指一本で呼び出せるように、JCLもプロシージャ化することで、誰でも間違いなく安全に操作できるようになります。標準化された環境は、初心者がミスを犯しにくい優しい環境でもあります。

8. 実行ログ（SYSOUT）の見やすさを意識したDISPLAY

JCLとCOBOLの連携がうまくいっているかを確認する唯一の手段は、実行ログ（SYSOUT）を見ることです。プログラムの中でDISPLAY文を使うときは、ただ値を出すのではなく、何の項目なのか、今の状態は何なのかというラベルを必ず付けるようにしましょう。

例えば、単に「100」と出すのではなく「SALES-COUNT = 100」と出すべきです。また、処理の開始時と終了時には必ずメッセージを出すようにします。これにより、万が一途中で止まってしまった場合でも、ログの最後を見ればどこまで処理が進んでいたのかがすぐに分かります。

ログは、未来の自分や後輩への「伝言板」です。言葉足らずな伝言よりも、丁寧で具体的な伝言の方が、受け取った人は助かりますよね。JCLの出力結果を見ただけで、プログラムがどのような一生を終えたのかがドラマのように読み取れる。そんな可読性の高い連携を目指しましょう。


    START: MAIN-PROCESS (2026-03-10 10:00)
    READING INPUT... DONE (TOTAL 500)
    WRITING OUTPUT... DONE
    SUCCESS: RETURN-CODE = 0000
    END: MAIN-PROCESS (2026-03-10 10:01)

9. コメントとドキュメントの同期

最後に、JCLとCOBOLプログラムの両方に、お互いの関係を示すコメントをしっかり書き残しましょう。JCL側には「このステップで動かしているのは○○のプログラムで、このファイルを使用する」といった情報を書き、COBOL側には「JCLのDD名○○からこのデータを受け取る」と記します。

プログラムと指示書が別々のファイルにあるため、時間が経つと両者の関係が忘れ去られてしまいがちです。これを防ぐために、常に情報を同期させておくことが標準化手順の仕上げとなります。最新の情報を一箇所にまとめることで、後から調査する人の負担を大幅に減らすことができます。

一貫性のある名前、丁寧なログ、そして心のこもったコメント。これらが組み合わさることで、初めて「可読性が高い」と言える連携部が完成します。初心者の方は、まずはお手本となる先輩のJCLをじっくり観察し、どのようにルールが守られているかを探してみることから始めてみてください。地味な作業の積み重ねこそが、立派なエンジニアへの道しるべとなります。