リファレンス・ガイド

     前  次    新規ウィンドウで目次を開く    PDFとして表示 - 新規ウィンドウ  Adobe Readerを取得 - 新規ウィンドウ
コンテンツはここから始まります

CICS Runtime Preprocessor

 


概要

説明

CICS Runtime Preprocessorは、Oracle Tuxedo Application Runtime for CICSのもとで実行するCOBOLプログラムを準備します。

前提条件

CICSプリプロセッサで処理されるプログラムは次の条件に従っている必要があり、そうでない場合、コンパイル時または実行時にエラーが発生するリスクを想定する必要があります。

注意: 元のソース・プラットフォームから移行されるプログラムについては、COBOLトランスレータがこれらの条件を保証しますが、保守対象または新規開発のプログラムの場合は、強制的に適用されるようにする必要があります。。
  1. CICS Runtime RunTimeをインストールする必要があります。prepro-cics.plが使用する一部のテクニカル・コピー・ファイルは、cpylib CICS Runtime RunTimeモジュールのもとで提供されます。
  2. CICS Runtime RunTimeコピー・ファイル(cpylib)をコンパイル時にインクルードするため、Micro Focus COBOL Compiler-or Cobol IT compilerに対してコピーブックが格納される場所を示す環境変数COBCPYが正しく設定されている必要があります。
  3. 次のコピー・ファイルは、Working-Storage SectionまたはLocal-Storage Sectionに挿入される必要があります。
    • KIX--INDICSKIX--ALL-ARGS、常に
    • KIX--CONDITIONS、常に
    • KIX--DFHRESP、常に
    • KIX--DFHVALUE、プログラムまたはそれがインクルードするコピー・ファイルの1つで、DFHVALUE疑似関数が使用されている場合
  4. 次のコピー・ファイルは、Linkage Sectionに挿入される必要があります。
    • DFHEIBLK
  5. プログラムは、正確に2つのパラメータ、DFHEIBLK(同じ名前のコピー・ファイルにより定義)およびDFHCOMMAREAをとる必要があり、これらはアプリケーションのPROCEDURE DIVISIONに対して適切になるように定義されています。つまり、プログラムは次のようになります。
  6. LINKAGE SECTION. 
      COPY  DFHEIBLK. 
     01  DFHCOMMAREA.
        ....
    PROCEDURE DIVISION USING DFHEIBLK DFHCOMMAREA.

IBM CICSプリプロセッサのNOLINKAGEオプションでコンパイルされるプログラムの場合は、ARTおよびCICS Runtimeプリプロセッサでは(まだ)サポートされていません。

 


prepro-cics.pl

名前

prepro-cics.pl - 標準入力からCobolプログラムファイルを読み取って、変換したCICS命令とともに標準出力に出力する関数。

概要

prepro-cics.pl [-type_output <output type>] [-notrec <notrec behavior>]

説明

prepro-cics.plはCOBOLプログラムを入力として、1行ずつ読み取り、変換したCICS命令とともにファイルを出力します。

prepro-cics.plは、ワンパスのみ実行して、1行ずつ処理します。つまり、標準入力から1行読み取り、1行以上の行を出力し(出力タイプによっては何も出力しない)、さらに次の入力行を読み取ります。この動作のため、コンパイラ内部のプリプロセッサとしての用途と互換性を持つことが可能ですが、入出力に同じファイルを使用することは禁止されます。入力ファイルが終わったときに行を出力する点に注意します。

プリプロセッサは、入力COBOLプログラムが、6列の左マージンを持っていると想定します。出力は固定書式で、荘でない場合、エラー・メッセージが表示されます。

オプション

notrec

notrecは、完全にはサポートされていない命令を処理する手段を指定します。(命令の一部のオプションが認識されないため「notrec」と呼ばれます。)2つの可能性があります。
どちらの場合も、エラー出力にメッセージが表示されます。

type_output

type_outputは、出力が出力される方法を指定します。認識される値は次のとおりです。

debug

すべての行を、ステータス(untouched、modified、deleted、created)とともに出力します。読み取ったすべての行に対して、常に少なくとも1行が出力されます。

orig

すべての行を出力し、削除した行はコメントとして出力します。読み取ったすべての行に対して、常に少なくとも1行が出力されます。

normal(デフォルト)

削除された行以外のすべての行を出力します。読み取ったすべての行について、少なくとも1行が出力されるとはかぎりません。

他のあらゆる値は、「normal」として処理されます。

 


制限

 


エラー・メッセージ

無効なCICSメッセージ

無効なCICS命令が検出されたときに常に出力されるエラー・メッセージは、次の書式を使用します。

サマリーは次のようになります。

IGNOREおよびHANDLE命令メッセージは、非常にシンプルです。

IGNOREは、CONDITIONを伴って作成してください。

CICS命令と一致するルールがない場合、同じキーワードで始まるすべてのコマンドについて、このコマンドがなぜ不適切かを説明するエラー・メッセージが表示されます。

複数のコマンドが一致する場合、プリプロセッサはそのすべてをリストします。ただし、プリプロセッサが変換の前にコマンドの複数該当をチェックするため、これは実際には発生しません。

サポートされていないエラー・メッセージ

CICS命令が不明であるか、「非サポート」または「廃止」と登録されている場合、エラー・メッセージ:

Instruction non supported

が生成されます。

、オプションnotrecに値stopが設定されている場合1つの命令に、複数の認識されないキーワードがあると、同じエラー・メッセージが出力されます。


  先頭に戻る       前  次