ページの先頭行へ戻る
Interstage Business Application Server アプリケーション開発ガイド
FUJITSU Software
第3部 サーバアプリケーション編 > 第9章 サーバアプリケーションの開発（COBOL） > 9.4 新規作成時の手順 > 9.4.4 アプリケーション情報入力ファイルの作成・修正
前次

9.4.4 アプリケーション情報入力ファイルの作成・修正

アプリケーション情報入力ファイルは、XML形式で記述します。
使用可能なタグを以下に示します。タグ名および値は、大文字と小文字が区別されます。
アプリケーション情報入力ファイルのタグの記述形式については、“Interstage Business Application Server リファレンス”の“アプリケーション情報入力ファイルリファレンス”を参照してください。

タグ名

概要

apfw-app

アプリケーションインタフェース情報定義の定義を表します。

server

サーバアプリケーションの定義を記述します。

target

サーバアプリケーションのアプリケーション名を記述します。
アプリケーション名は、アプリケーション連携実行基盤からの呼出し名として使用します。

library

サーバアプリケーションのライブラリ名を記述します。
ライブラリの格納先は、ワークユニット定義に記述します。

comment

生成したソースファイルの先頭に注釈行として挿入する情報を格納したファイルのパスを含むファイル名を記述します。

userwork

サーバアプリケーションのインタフェースにアプリケーション作業域、アプリケーション作業域長を追加するかどうかを記述します。

pre

サーバアプリケーションで前処理を使用するかどうかを記述します。

post

サーバアプリケーションで後処理を使用するかどうかを記述します。

error

サーバアプリケーションでエラー処理を使用するかどうかを記述します。

posttrn

サーバアプリケーションでトランザクション後メッセージ編集処理を使用するかどうかを記述します。

result_info

サーバアプリケーションのインタフェースに、処理結果情報、および例外情報を追加するかどうかを記述します。

cobol

COBOL登録集の解析、およびCOBOL登録集の生成方法の定義を記述します。

base_name

COBOL実行基盤インタフェースソースを生成する際に付加するプレフィックス名を記述します。

source_format

入力するCOBOL登録集の正書法の形式を記述します。

initialize

未設定データの初期化を行うか否かを記述します。

invalid_marker

サーバアプリケーションで未設定データ判定処理を使用するかどうかを記述します。

wstring_ucs2be

サーバ側の文字コードがUNICODE(UCS2)の場合、日本語項目のエンディアンをビッグエンディアンとして取り扱うかどうかを記述します。

binary_as_string

COBOLの整数型の2進データ項目をJavaのString型にマッピングして取り扱うかどうかを記述します。

operation

name属性値にサーバアプリケーションのCOBOLプログラムのプログラム名を記述します。

return_value

サーバアプリケーションのPROGRAM-STATUSの値を返却値として使用するかどうかを記述します。

parameter

サーバ側のCOBOLプログラムに渡すパラメタの名前を指定します。

copyfile

name属性値に呼び出すプログラムのパラメタの定義をしたCOBOL登録集のパスを含むファイル名を記述します。

businessName

業務名を記述します。Webサービスアプリケーションを作成する場合のみ記述します。Webサービスアプリケーションを作成しない場合は記述しないでください。

client

クライアントアプリケーションの定義を記述します。（注）

bean

bean生成に必要な定義を記述します。

package

beanを生成する際に、生成するパッケージ名を記述します。

注）<client>タグの記述については、“第4章 クライアントアプリケーションの開発（Java）”の“4.2.2 アプリケーション情報入力ファイルの作成”を参照してください。

注意

  • 記述可能な個数を超えて同じタグを記述した場合は、先に記述されているタグが有効になります。

  • タグに同じ属性を複数記述した場合は、最初に記述した属性の値が有効になります。

■アプリケーション情報入力ファイルの記述例

Linuxを使用する場合の、アプリケーション情報入力ファイルの記述例を示します。
例は、以下の条件に基づいて記述されています。

<?xml version="1.0" encoding="UTF-8"?>
<apfw-app>
    <!-- サーバアプリケーションの定義を記述します。-->
    <server>
        <!-- サーバアプリケーションのアプリケーション名を指定します。-->
        <!-- 省略できません。省略した場合はツールの実行時にエラー復帰します。 -->
        <target name="ap01" />

        <!-- サーバアプリケーションのライブラリ名を指定します。-->
        <!-- 省略できません。省略した場合はツールの実行時にエラー復帰します。 -->
        <library name="libserverapl.so" />

        <!-- 生成されるファイルの先頭に指定したファイル内容をコメントとして出力します。 -->
        <!-- 省略可能です。省略した場合はコメントを出力しません。 -->
        <comment>C:\sample\xxx.txt</comment>

        <!-- アプリケーション作業域の使用有無を指定します。 -->
        <!-- 省略可能です。省略した場合はアプリケーション作業域を使用しません。 -->
        <userwork flag="ON" />

        <!-- 処理結果情報の使用有無を指定します。 -->
        <!-- 省略可能です。省略した場合は処理結果情報を使用します。 -->
        <result_info flag="ON" />

        <!-- 前処理の使用有無を指定します。 -->
        <!-- 省略可能です。省略した場合は前処理を使用しません。 -->
        <pre flag="ON" />

        <!-- 後処理の使用有無を指定します。 -->
        <!-- 省略可能です。省略した場合は後処理を使用しません。 -->
        <post flag="ON" />

        <!-- エラー処理の使用有無を指定します。 -->
        <!-- 省略可能です。省略した場合はエラー処理を使用しません。 -->
        <error flag="ON" />

        <!-- トランザクション後メッセージ編集処理の使用有無を指定します。 -->
        <!-- 省略可能です。省略した場合はトランザクション後メッセージ編集処理を使用しません。 -->
        <posttrn flag="ON" />

        <!-- COBOLに固有の定義をします。 -->
        <cobol>
            <!-- COBOL実行基盤インタフェースソースを生成する際に付加するプレフィックス名を指定します。  -->
            <base_name>sample</base_name>
            <!-- COBOLプログラムのプログラム名を指定します。 -->
            <operation name="SERVER_APL">
                <!-- パラメタがある場合、パラメタの入出力指定および名前を指定します。 -->
                <parameter direction="IN">IN_DATA</parameter>
            </operation>
            <!-- パラメタを定義したCOBOL登録集のパスおよびファイル名を指定します。 -->
            <copyfile name="C:\sample\PARAM.cbl"></copyfile>
        </cobol>
    </server>

    <!-- クライアントアプリケーションの定義を記述します。-->
    <client>
        <!-- 生成されるファイルの先頭に指定したファイル内容をコメントとして出力します。 -->
        <!-- 省略可能です。省略した場合はコメントを出力しません。 -->
        <comment>C:\sample\xxx.txt</comment>

        <!-- beanの固有定義を定義します。 -->
        <!-- クライアントアプリケーションにbeanを使用しない場合、定義の必要はありません。-->
        <bean>
            <package>samplepkg</package>
        </bean>

    </client>

</apfw-app>

以下のディレクトリに、サンプルが格納されています。

/opt/FJSVibs/sample/appinfo/COBOL/appinfo.xml

[Interstageのインストールディレクトリ]\BAS\sample\appinfo\COBOL\appinfo.xml

◆必須の定義情報

アプリケーションインタフェース情報入力ファイルには、以下の定義情報が必須になります。

生成されるCOBOL実行基盤インタフェースソースファイルの先頭に、指定したファイル内容でコメントを付ける場合は、以下の定義情報が必要になります。

COBOLでサーバアプリケーションを作成する場合、以下の定義情報が必要になります。

サーバアプリケーションでパラメタを使用する場合、以下の定義情報が必要になります。

◆アプリケーション作業域

アプリケーション作業域を使用する場合、以下の定義情報が必要になります。

注意

アプリケーション作業域を使用する場合、あわせて運用時の設定として、アプリケーション連携実行基盤定義ファイルでアプリケーション作業域のサイズも指定する必要があります。
設定方法の詳細は、“Interstage Business Application Server セットアップガイド”の“アプリケーション連携実行基盤定義ファイルの作成”を参照してください。

◆処理結果情報

処理結果情報を使用しない場合、以下の定義情報が必要になります。

◆前処理、後処理、エラー処理、およびトランザクション後メッセージ編集処理

前処理を使用する場合、以下の定義情報が必要になります。

後処理を使用する場合、以下の定義情報が必要になります。

エラー処理を使用する場合、以下の定義情報が必要になります。

トランザクション後メッセージ編集処理を使用する場合、以下の定義情報が必要になります。

上記で説明したタグの詳細、および上記以外のタグについては、“Interstage Business Application Serverリファレンス”の“アプリケーション情報入力ファイルリファレンス”を参照してください。

前次
Copyright 2021 FUJITSU LIMITED