リファレンス・ガイド

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

CICS Runtime Preprocessor

この章では、次の項について説明します。

 

概要

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

 

prepro-cics.pl

前提条件

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

注意: 元のソース・プラットフォームから移行されるプログラムについては、COBOLトランスレータがこれらの条件を保証しますが、保守対象または新規開発のプログラムの場合は、強制的に適用されるようにする必要があります。。
  1. CICS Runtimeをインストールする必要があります。prepro-cics.plが使用する一部のテクニカル・コピー・ファイルは、cpylib CICS Runtimeモジュールのもとで提供されます。
  2. CICS Runtimeコピー・ファイル(cpylib)をコンパイル時にインクルードするため、Micro Focus COBOLコンパイラまたはCobol ITコンパイラに対してコピーブックが格納される場所を示す環境変数COBCPYが正しく設定されている必要があります。
  3. 次のコピー・ファイルは、Working-Storage SectionまたはLocal-Storage Sectionに挿入される必要があります。
    • KIX--INDICSとKIX--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 - 標準入力から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およびDBのTSAM呼出しパス機能をサポートするために、EXEC SQL文を含むCICSプログラムのコンパイル時に、プリプロセッサは、procob (Oracle DBの場合)またはdb2 prep (IBM UDBの場合)コマンドより先に実行される必要があります。

エラー・メッセージ

無効なCICSメッセージ

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

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

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

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

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

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

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

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

Instruction non supported

が生成されます。

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

 

prepro-cics-C.pl

前提条件

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

  1. CICS Runtimeをインストールする必要があります。prepro-cics-C.plが使用する一部のテクニカル・ヘッダー・ファイルは、CICS Runtimeモジュールのincludeディレクトリのもとで提供されます。
  2. prepro-cics-C.plは、CICSおよびDBのTSAM呼出しパス機能をサポートしません。
  3. プログラムにEXEC SQL文が含まれる場合、プリプロセッサはdbプリコンパイラ・コマンド(IBM UDBの場合はdb2 prep、Oracle DBの場合はpro*C)より先に実行される必要があります。

名前

prepro-cics-C.pl - source_fileで指定されるCプログラムを読み取り、変換したCICS命令とともにCプログラムをoutputファイルに出力します。

概要

prepro-cics-C.pl [-help] [-source_format <fixed>] [-o <output file name>] [-B] source_file

説明

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

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

オプション

-help

helpは、prepro-cics-C.plの使用方法を表示します。

-source_format

source_formatは、Cプログラムのソース書式を指定します。2つの可能性があります。

注意: 現在はサポートされているのはfixed書式のみです。

-o

oは、出力ファイルの名前とパスを指定します。

-B

Bは、EXCIプログラムのソースを指定します。

source_file

source_fileは、入力ファイルの名前とパスを指定します。

制限

エラー・メッセージ

prepro-cics-C.plは、次のようなエラー・メッセージを出力することがあります。


  先頭に戻る       前  次