COBOL-UAP作成用プログラムの説明形式
TP1/EEのUAPをCOBOL言語で作成するときは，TP1/EEのライブラリにある関数に対応したCOBOL-UAP作成用プログラムをCALL文で呼び出します。
COBOL-UAP作成用プログラムを次の形式で説明します。
- 〈このページの構成〉
形式
ライブラリにある関数と対応するCOBOL-UAP作成用プログラムを，CALL文で呼び出す形式と，領域の指定方法を示します。
データ名に値を指定するときは，ここで示すPICTURE句のデータ形式に従ってください。指定する値が決まっているときはVALUE句で記述してあります。
一意名で示すファイル名とデータ名には，断りがないかぎり，固有の名称を任意に付けてください。
データ名として指定する文字の長さなどは，コーディングで使うCOBOL言語およびCOBOLコンパイラの仕様に従ってください。
COBOL言語でコーディングするときは，TP1/EEのサンプルにあるCOBOL言語用テンプレートを使えます。このCOBOL言語用テンプレートを，コーディングするプログラムに合わせて修正すれば，DATA DIVISIONを最初からコーディングする手間が省けます。COBOL言語用テンプレートは，インストールディレクトリ/examples/tp1ee/aplib/cobol/ディレクトリの下に，システムサービスごとのファイル名で格納してあります。ファイル名は，次に示す規則で付けてあります。
EEXXX.cbl（XXXは，COBOL-UAP作成用プログラムの下3文字）
機能
COBOL-UAP作成用プログラムの機能について説明します。以降，COBOL-UAP作成用プログラムを，次に示す形式で表記します。
![[図データ]](GRAPHICS/ZU050100.GIF)
UAPで値を設定するデータ領域
DATA DIVISIONに指定するデータのうち，COBOL-UAP作成用プログラムの呼び出し時にデータ領域に値を指定しておくデータ名です。各データ名の説明に従って，値を設定してください。
TP1/EEから値が返されるデータ領域
DATA DIVISIONに指定するデータのうち，CALL文を実行したあとで，TP1/EEから値が返されるデータ名です。CALL文の実行後に，データ名で示すデータ領域の内容を参照してください。
クライアントUAPから値が渡されるデータ領域
サービスプログラムの場合で，クライアントUAPから値が渡されるデータ領域です。このデータ領域の内容を参照して，サービスプログラムの処理をしてください。
サーバUAPから値が返されるデータ領域
同期応答型RPCの場合に，サービスプログラムから値が返されるデータ名です。CBLEERPC('CALL ')を呼び出したUAPでは，ここに示すデータ領域の値を参照できます。
ステータスコード
CALL文を実行したときに返される値を，表形式で説明します。ステータスコードによって，COBOL-UAP作成用プログラムが正常に実行されたかどうかがわかります。エラーが起こったときは，エラーの内容を示します。
COBOL言語のステータスコードは5けたの数字列で，USING句で指定する最初の一意名に含まれます。CALL文でのUSING句で指定する一意名とステータスコードの関係を次に示します。
CALL '呼び出すプログラム名' USING 一意名1 一意名2 ………
![[図データ]](GRAPHICS/ZU050200.GIF)
指定例
指定例が必要な場合に記述します。
注意事項
COBOL-UAP作成用プログラムを使うときの注意を記述します。