imtkmake コマンド

COBOL プログラムベースのサービスインターフェイスを作成してディプロイしたり、エンタープライズサーバーで実行されているディプロイ済みサービスにアクセスするクライアントを生成したりできます。

構文：

imtkmake -defmap          service=service-name
                          src=program-name
                          type=service-type
                         [directives=Compiler-directives]
                         [settings=properties-filename]

imtkmake -generate        service=service-name
                          type=service-type
                         [appdir=directory-name]
                         [appserver=J2EE-application-server-name]
                         [bean=bean-name]
                         [classpath=pathname]
                         [ejbname=ejb-name]
                         [esruntime=esruntime-filename]
                         [exithandler=program-name]
                         [filename]...
                         [@filelistname]
                         [jarname=jar-filename]
                         [namespace=service-namespace]
                         [package=package-name]
                         [sepsession={stateless|stateful}]
                         [serverHost=host-name]
                         [serverPort=port-number]
                         [session={stateless|stateful}]
                         [settings=properties-filename]
                         [style={doclit|rpcenc}]
                         [transaction={application|container}]
                         [transactional={yes|no}]
                         [url=ip-address]

imtkmake -query

imtkmake -queryAppServerList

imtkmake -deploy          type=service-type
                         [carname=car-filename]
                         [password=secure-password]
                         [server=server-name,deployer-name]
                         [settings=properties-filename]
                         [username=secure-username]

imtkmake -showlog         deploydir=deployment-directory

imtkmake -genclient       service=service-name
                          type=service-type
                         [appserver=J2EE-application-server-name]
                         [clientdir=directory-name]
                         [j2eeVersion={1.4|1.5|5|1.6|6}]
                         [namespace=service-namespace]
                         [style={doclit|rpcenc}]
                         [url=ip-address]

imtkmake -genclientwsdl   clientwsdl=wsdl-filename
                         [clientdir=directory-name]
                         [defaultstringsize=string-size]
                         [defaultarraysize=array-size]

imtkmake -help

パラメーター：

-defmap

src= パラメーターで指定されている COBOL プログラムに基づき、デフォルトマッピングを使用してサービスインターフェイスを作成します。

-generate

設定されているパラメーターに基づいてディプロイファイルを生成し、エンタープライズサーバーへのディプロイ用に生成されたファイルが含まれる COBOL アーカイブ (.car) ファイルを生成します。

-query

ディプロイに使用できるエンタープライズサーバーの一覧を表示します。

-queryAppServerList

デフォルトでは、使用できる J2EE 1.4 アプリケーションサーバーの一覧を示します。その他の J2EE バージョンでサポートされているアプリケーションサーバーを表示するには、j2eeversion パラメーターを指定してください。

-deploy

-generate パラメーターを使用して作成された .car ファイルをエンタープライズサーバーにディプロイします。servicename.deploy ディレクトリから、-deploy パラメーターを指定して imtkmake を実行してください。

-showlog

ディプロイログ (deploylog.txt ファイル) の内容を表示します。

-genclient

指定したタイプ (EJB または Web サービスなど) に応じて、サービスインターフェイスからクライアントを生成します。

注：J2EEversion を指定した場合、値 1.5 と 5 は同じとみなされます。同様に、1.6 と 6 も同じとみなされます。

-genclientwsdl

WSDL から COBOL クライアントを生成します。

-help

imtkmake の関数およびパラメーターに関する情報を表示します。

appdir=directory-name

エンタープライズサーバーで実行されているアプリケーションのアプリケーションファイルへのパス。

appserver=J2EE-application-server-name

EJB が生成され、ディプロイされる J2EE アプリケーションサーバーの名前およびバージョン。これにより、生成されるディプロイメント記述子が定義されます。

EJB および EJB クライアントを生成する場合は、このパラメーターは必須です。つまり、 -generate または -genclient 関数を、タイプを EJB に設定して使用する場合に、このパラメーターを指定する必要があります。値にはスペースが含まれるため、引用符で囲む必要があります。例：

"JBoss 5.1.0"
"WebSphere 7.0"

このパラメーターは、他のパラメーターの後に指定する必要があります。

使用できるサーバーの一覧を表示する方法については、-queryAppServerList を参照してください。

bean=bean-name

EJB 生成で、生成される Bean の名前。デフォルトは service-name です。

carname=car-filename

ディプロイする .car ファイルのパスおよび名前。デフォルトでは、このファイルは service.car という名前で、service.deploy ディレクトリに格納されています。同一のコマンドライン上で生成とディプロイを行う場合は、carname= は必要ありません。

classpath=pathname

EJB の生成での、J2EE アプリケーションサーバー上の J2EE 実装クラスのクラスパス。大文字小文字は区別されます。これは、次の .jar ファイルへのパスであり、J2EE アプリケーションサーバーごとに異なります。

JBoss の場合は jboss-j2ee.jar および servlet-api.jar
WebSphere の場合は j2ee.jar
WebLogic の場合は weblogic.jar

clientdir=directory-name

クライアントプログラムを生成するディレクトリ。-genclientwsdl 関数を使用する場合は、WSDL ファイルのディレクトリがデフォルトになります。その他の場合は、サービスがディプロイされたディレクトリがデフォルトになります。

clientwsdl=wsdl-filename

クライアントプログラムの生成に使用する WSDL ファイルの名前。

defaultarraysize=array-size

バインドされていない配列に使用するデフォルトの配列サイズ。

defaultstringsize=string-size

バインドされていないストリングに使用するデフォルトのストリングサイズ。

deploydir=deployment-address

deploylog.txt ファイルの URL。この URL は、-deploy 関数で表示できます。

directives=Compiler-directives

プログラムを正しくコンパイルするために必要な指令。各指令の間はカンマで区切ります。

ejbname=ejb-name

EJB 生成で、生成される EJB の名前。デフォルトは service-nameEJB です。

esruntime=esruntime-filename

ディプロイされたサービスが実行されるときに適用される、ランタイム構成設定が含まれるファイルの名前。ファイルの拡張子は、.rtc である必要があります。

exithandler=program-name

Web サービス生成で、MFRHSOAP 要求ハンドラー内の出口ポイントを処理するユーザー出口プログラムの名前。

@filelistname

.car ファイルにインクルードする必要のある追加ファイルのリストを含むファイルの名前。ファイル名は 1 行に 1 つずつである必要があります。

filename

.car ファイルにインクルードする必要のある追加ファイル。複数のファイルを指定できます。

jarname=jar-filename

EJB 生成で、生成される .jar ファイルの名前。デフォルトは service-name.jar です。

namespace=service-namespace

Web サービス生成、EJB 生成、およびクライアント生成での、サービスネームスペース。Web サービス生成およびクライアント生成では、デフォルトは http://tempuri.org/service-name です。EJB 生成では、デフォルトは service-name です。

package=package-name

EJB 生成での、Bean を含む Java クラスのパッケージ名。大文字小文字は区別されます。デフォルトは com.mypackage.service-name です。

password=secure-password

サービスインターフェイスのセキュアサーバーへのディプロイを可能にするパスワード。このパスワードは、MFDS がパスワードを必要とするように構成されている場合のみ必要です。

sepsession={stateless|stateful}

関連するサービス実行プロセス (Service Execution Process; SEP) 属性の設定。SEP 属性は、transactional=yes の場合のみ意味を持ちます。

server=server-name,deployer-name

ディプロイファイルの宛先。server-name はサービスをディプロイするエンタープライズサーバー、deployer-name はそのエンタープライズサーバー上のディプロイサービスの名前です。このパラメーターを指定しなかった場合、関数によりディプロイに使用できるサーバーの一覧が表示され、いずれか 1 つを選択するように促すプロンプトが表示されます。

serverHost=host-name

J2SE Java Bean 用のエンタープライズサーバーが動作しているホストマシン名。

serverPort=port-number

J2SE Java Bean 用のエンタープライズサーバーリスナーのポート番号。

service=service-name

マップする、または生成するサービスの名前。

session={stateless|stateful}

EJB 生成で、生成される EJB のタイプ。デフォルトは stateless です。

settings=properties-filename

このサービスインターフェイスの設定プロパティが含まれるファイルの名前。

src=program-name

デフォルトマッピングの作成に使用するプログラム。

style={doclit | rpcenc}

WSDL 生成に使用するスタイル。デフォルトは doclit です。

transaction={application|container}

サービスがアプリケーション管理かトランザクション管理かを指定します。デフォルトは application です。

transactional={yes|no}

EJB 生成で、EJB サービスをトランザクションコンテキストで実行するかどうかを設定します。yes に設定した場合、session=stateful がデフォルトになります。

type=service-type

実行するマッピングタイプまたは生成するクライアントタイプ (上述 defmap、genclient、および generate を参照)。service-type には、次のいずれか 1 つを指定できます。

EJB
J2SEbean
WebService

url=ip-address

Web サービス生成およびクライアント生成での、サービスの IP アドレス。WSDL 文書に追加されます。

username=secure-username

サービスインターフェイスのセキュアサーバーへのディプロイを可能にするユーザー名。このユーザー名は、MFDS がユーザー名を必要とするように構成されている場合のみ必要です。

COBOL プログラムファイルが含まれるディレクトリにある Enterprise Developer のコマンドプロンプトから imtkmake< /span> を実行します。
このコマンドは、複数の関数を実行します。同一のプログラムに対しては、次の順序で実行する必要があります。
- -defmap
- -generate
- -query (オプション)
- -deploy
- -showlog (オプション)
- -genclient または -genwsdl (またはその両方) (オプション)
次のように、同一のコマンドライン上で複数の関数を組み合わせることができます。
- -defmap と -generate を組み合わせて、デフォルトマッピングからサービスインターフェイスを生成し、後でディプロイするディプロイファイルを生成する。
- -generate と -deploy を組み合わせて、既存のサービスインターフェイス用のディプロイファイルを生成し、そのファイルをエンタープライズサーバーにディプロイする。
- -defmap、-generate、および -deploy を組み合わせて、3 つの関数をすべて実行する。
注：同一のコマンドライン上で複数の関数を組み合わせた場合、共通のパラメーターを繰り返し指定する必要はありません。
コマンドライン関数と、Service Interfaces 機能を組み合わせて使用することができます。例えば、サービスインターフェイスを作成してカスタマイズしたとします。その後、コマンドラインを使用してそのサービスインターフェイスをディプロイすることができます。
Service Interfaces 機能を使用して、[Mapping Properties] ダイアログボックスからサービスインターフェイスのマッピングプロパティを指定した場合、Enterprise Developer は、設定を保持するための XML ファイルを生成します。-generate 関数で settings=properties-filename を使用して、この XML ファイルを指定することができます。マッピングプロパティの XML ファイルには、-generate 関数に関連するオプションパラメーターの値が含まれます。コマンドライン上でこれらのパラメーターのいずれかを指定した場合、マッピングプロパティの XML ファイルに含まれる値はオーバーライドされます。
パラメーターの前に = を付ける代わりに、パラメーターを () で囲むことで、() を区切り文字として使用します。例えば、src=book.cbl ではなく src(book.cbl) とします。
imtkmake -deploy を使用してサービスインターフェイスをディプロイした場合、imtkmake は次の場所を次の順序で検索してディプロイする項目を探し、見つかったディプロイ可能な各項目の最初のインスタンスを使用します。
- MFDS。ディプロイ項目が MFDS 内にある場合、[destination] セクションのあらゆる構成設定が使用されます。例：
```
[destination]
   server=ESDEMO
   listener=Web Services and J2EE
```
- MFDS。ディプロイ項目が MFDS 内に存在しても、構成設定がない場合は、imtkmake は、サービスを所有するエンタープライズサーバーを使用します。

例：

次のコマンドでは、プログラム book.cbl のデフォルトマッピングでサービスインターフェイスが作成されます。

imtkmake -defmap src=book.cbl service=wmapserv type=webservice

次のコマンドでは、wmapserv サービスインターフェイスの Web サービスが生成されます。

imtkmake -generate service=wmapserv
                          type=webservice
                          exithandler=myhandler
                          namespace=http://corpuri.org/wmapserv

次のコマンドでは、JMapServ サービスインターフェイスの EJB が生成されます。

imtkmake -generate service=JMapServ
                          type=ejb
                          bean=JMap
                          classpath=/usr/java131/lib/j2ee.jar
                          ejbname=JMapEJB
                          esruntime=jmapconf.rtc
                          jarname=JMap.jar
                          package=com.corp.jmap
                          session=stateful
                          appserver="WebLogic 10.3.5"

次のコマンドでは、wmapserv サービスインターフェイスの Web サービスが生成され、エンタープライズサーバー ESDEMO にディプロイされます。追加のデータファイル data-files-path\bookfile.dat (Windows) または data-files-path/bookfile.dat (UNIX) がディプロイされます。

Windows プラットフォームの場合：

imtkmake -generate service=wmapserv type=webservice
         -deploy server=ESDEMO,Deployer data-files-path\bookfile.dat

UNIX プラットフォームの場合：

imtkmake -generate service=wmapserv type=webservice
         -deploy server=ESDEMO,Deployer data-files-path/bookfile.dat

次のコマンドでは、wmapserv.car で生成済みの Web サービスが、エンタープライズサーバー ESDEMO にディプロイされます。

imtkmake -deploy carname=wmapserv.car server=ESDEMO,Deployer

このサブミットによるディプロイが成功したかどうかは、202 戻りコードと、応答メッセージ内に URL が存在しているかどうかでわかります。

次のコマンドでは、URL http://10.120.72.229:47704/uploads/cw_diYLq から deploylog.txt ファイルが表示されます。

imtkmake -showlog deploydir=http://10.120.72.229:47704/uploads/cw_diYLq

次のコマンドでは、サービス wmapserv の COBOL クライアントプログラムが作成されます。

imtkmake -genclient type=webservice service=wmapserv

次のコマンドでは、サービスの WSDL ファイルを使用して、サービス wmapserv の COBOL クライアントプログラムが作成されます。

Windows プラットフォームの場合：

imtkmake -genclientwsdl clientwsdl=wmapserv.wsdl

UNIX プラットフォームの場合：

imtkmake -genclientwsdl clientwsdl=$PWD/wmapserv.wsdl clientdir=$PWD

imtkmake コマンド

構文：

パラメーター：

コメント：

例：